gtps1m1sSystem Macros

CFRQC-Coupling Facility Request

Use this system macro to access coupling facility (CF) control program (CP) routines for entry control block segments that are controlled by the entry control block (ECB). The CF CP routines allow these segments to:

Format




label
A symbolic name can be assigned to the macro statement.

REQUEST
Indicates the type of request you want to perform. The type must be one of the following values:

ACTSDA
Activates the CF SDA.

READFP
Reads the parameters for a CF.

SETLOCK
Locks or unlocks the CF lock. The CF lock is used to serialize operations on the CF.

READSID
Allows the list structure user to read the structure ID vector.

ALLOC
Allocates a CF list structure.

ATTUSER
Attaches a list structure user to a CF list structure.

DETUSER
Detaches a list structure user from a CF list structure.

READLSC
Reads list structure controls for a CF list structure and returns user structure controls and the user ID vector.

DEFVECT
Defines a list notification vector.

RELVECT
Releases a list notification vector.

CLEAN
Removes CF list structures that are not allocated fully.
Note:
If you specify ALLOC, ATTUSER, CLEAN, or DETUSER for the REQUEST parameter, the CF lock must be held.

(reg)
Register (R0-R7) that contains the value for the type of request you want to perform. The request type must be one of the these values:

 ICFREQACTSDA 
ICFREQREADFP

 ICFREQSETLOCK 
ICFREQALLOC

 ICFREQATTUSER 
ICFREQDETUSER

 ICFREQREADLSC 
ICFREQDEFVECT

 ICFREQRELVECT 
ICFREQCLEAN

Equates for these values are defined in the ICFEQ DSECT.

BLOCK
Specifies the address of the data block for your request. The format of the input data block is provided with the IFAPI data macro. See that data macro for the correct parameter format.

Specify one of the following:

addr
The address of the RS-type name or address of a data block.

reg
A pointer to a data block.

Entry Requirements

None.

Return Conditions

Programming Considerations

None.

Examples