gtps1m1q | System Macros |
Use this system macro to disconnect from a coupling facility (CF) list or cache structure on a CF when you no longer require access to it. See TPF Database Reference for more information about disconnecting from a CF list or cache structure.
Format
|
To code, specify the name or address of the 16-character field that contains the connect token.
Entry Requirements
The CFDISC macro must be issued from an E-type program.
Return Conditions
When the CFDISC macro returns control to your program you will receive a return code in the high-order 2 bytes of register 15 (R15) and a reason code in the low-order 2 bytes of R15. All other registers remain unchanged.
Table 2 shows the hexadecimal return code, reason code, and equate symbol associated with each reason code. The ICFEQ DSECT provides equate symbols for the return and reason codes. The following are the equate symbols associated with each hexadecimal return code:
Table 2. Return and Reason Codes for the CFDISC Macro
Hexadecimal Return Code | Hexadecimal Reason Code | Equate Symbol Meaning and Action |
---|---|---|
0000 | 0000 | Equate Symbol: None.
Meaning: The request to disconnect from a CF structure is successful. The connect token is no longer valid and will be rejected for any subsequent disconnect requests. Action: None. |
0008 | 0801 | Equate Symbol: ICFRRCBADPARMLIST
Meaning: A program error occurred because the address of the CFDISC parameter list is zero. Action: Verify that the address of the CFDISC parameter list is not corrupted. |
0008 | 0804 | Equate Symbol: ICFRRCBADVERSIONNUM
Meaning: A program error occurred because the CFDISC parameter list contains a version number that is not valid. Action: Do the following:
|
0008 | 080A | Equate Symbol: ICFRRCBADCONTOKEN
Meaning: A program error occurred because the requesting processor specified a connect token that is not valid. Action: Correct your program to use the original connect token that was received in the CFCONC answer area after the connection request was issued. See CFCONC-Connect to a Coupling Facility List or Cache Structure for more information about the CFCONC macro. |
0008 | 080B | Equate Symbol: ICFRRCCONNINUSE
Meaning: A program error occurred because the requesting processor tried to disconnect from a CF structure that was still in use. Action: Do the following:
|
0008 | 08F2 | Equate Symbol: ICFRRCRESTARTINCOMPLETE
Meaning: An error occurred because CF restart has not yet completed. The disconnect request is rejected because the TPF system has not yet completed CF restart. Action: Do the following:
|
000C | 0CF0 | Equate Symbol: ICFRRCAUTHLOCKERROR
Meaning: The disconnect request was rejected because the CF lock was not obtained because of an error that occurred. This error occurs when the CF fails to respond to CF commands. Action: None. |
Programming Considerations
Examples