REMOVE-RFA-CONNECTION

Clear down RFA connection and terminate partner task

Component:	RFA
Functional area:	Pubset and MRSCAT management
Domain:	MULTI-CATALOG-AND-PUBSET-MGMT
Privileges:	STD-PROCESSING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT

This command is available only to users who have the RFA software product (see also the “RFA” manual [31]).

Function

The command REMOVE-RFA-CONNECTION clears down one or all RFA connections previously set up with the SET-RFA-CONNECTION command. When the last RFA connection to a remote processor is cleared down, the partner task on the remote processor is simultaneously terminated.
When the local user task is terminated (EXIT-JOB or LOGOFF), the system automatically clears down all RFA connections set up during the current task.

The REMOVE-RFA-CONNECTION command is rejected if a program is loaded.

The user can issue the SHOW-RFA-CONNECTIONS command to get information on still existing RFA connections.

Note

More than one SET-RFA-CONNECTION command can be issued for a single catalog ID. The same number of REMOVE-RFA-CONNECTION commands must be issued to clear down a connection as SET-RFA-CONNECTION commands were issued.

Format

REMOVE-RFA-CONNECTION                                                                                                                      

CATALOG-ID = <cat-id 1..4> / *ALL

Operands

CATALOG-ID = <cat-id 1..4> / *ALL
Catalog ID to which the RFA connection is to be cleared down. Specifying *ALL lets all RFA connections be cleared. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	RFA0002	Command executed
1	0	RFA0002	No RFA connection exists which can be cleared down
	64	RFA0025	Program loaded
	64	RFA0027	Configuration error