Description status: Functional area: Domain: Privileges: | MSCF V 21.0A Pubset and MRSCAT management MULTI-CATALOG-AND-PUBSET-MGMT TSOS |
Routing code: | R |
Function
The STOP-MSCF-CONNECTION command clears down a connection to a partner system. In addition, the flagged connection request for this partner is deleted, i.e. the local system will reject future connection requests from the partner system.
Format
STOP-MSCF-CONNECTION |
PROCESSOR-NAME = <alphanum-name 1..8> ,FORCED = *NO / *YES |
Operands
PROCESSOR-NAME = <alphanum-name 1..8>
Name of the partner system to which a connection is to be cleared down.
FORCED = *NO / *YES
Specifies whether or not execution of the command is to be forced.
Before the connection to the partner is cleared down, MSCF checks whether this connection is still required by the local system. It is required if both systems are sharing a pubset or one of the two systems is the master system. In this situation, the connection clear-down is rejected, but can be forced by specifying FORCED = *YES. The connection should subsequently be re-established with the START-MSCF-CONNECTION command.
The FORCED = *YES operand should as a rule be used on a restricted basis and only in acute error situations.
Return codes
| (SC2) | SC1 | Maincode | Bedeutung |
|---|---|---|---|
| 0 | CMD0001 | Command executed without errors | |
| 1 | CMD2201 | Parameter error | |
| 2 | CMD2202 | MSCF subsystem not defined | |
| 3 | CMD2203 | Installation error | |
| 32 | MCS0025 | Internal error (REQM, bourse call) | |
| 64 | CMD0216 | User is not privileged | |
| 64 | MCS0009 | Local system specified as partner | |
| 64 | MCS0021 | Command can only be executed in conjunction with the FORCED=*YES operand | |
| 65 | CMD2241 | MSCF subsystem is not loaded | |
| 65 | MCS0003 | MSCF subsystem currently being loaded | |
| 65 | MCS0004 | MSCF subsystem currently being unloaded | |
| 66 | CMD2242 | No connection to the MSCF subsystem | |
| 128 | CMD2280 | MSCF subsystem temporarily unavailable | |
| 129 | CMD2281 | MSCF subsystem unavailable for an extended period | |
| 130 | CMD2282 | MSCF subsystem unavailable for an undefined period |