gtps1m1qSystem Macros

CFDISC-Disconnect from a Coupling Facility List or Cache Structure

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




CONTOKEN=contoken
Specifies the connect token that was returned by the CFCONC macro. The connect token uniquely identifies the connection to a CF list or cache structure in your processor configuration. See CFCONC-Connect to a Coupling Facility List or Cache Structure for more information about the CFCONC macro.

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:

Return Code
Equate Symbol

 0 
ICFRRCOK

 4 
ICFRRCWARNING

 8 
ICFRRCPARMERROR

 C 
ICFRRCENVERROR

 10 
ICFRRCCOMPONENT.

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:

  1. Verify that your program did not overlay the CFDISC parameter list storage.
  2. Verify that your program was assembled with the correct macro library for the TPF system.
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:

  1. Let all outstanding requests for the CF structure end.
  2. Issue the CFDISC macro again.
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:

  1. Wait until CF restart has completed successfully.
  2. Issue the disconnect request again.
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

None.