User Exits › EXIT Routine Programming Considerations › GCMCMDXT Exit › Register Usage at Entry:

Register Usage at Entry:

Common Parameter List (mapped by UXPARM macro in CAI.CBTDMAC)

R1

Contains the common exit parameter list, in the following format:

+0

Contains the address of the GCMCMDXT parameter list.

+4

Contains the address communication word of the GCMCMDXT routine. During its initialization call, the routine sets the contents of the word. The contents are passed unchanged for all subsequent calls to this routine.

+8

Contains the full word of flags used to pass status information to the routine.

+C

Contains the global communication word.

R9

This register is reserved.

R11

This register is reserved.

R13

Contains the address of the standard save area.

R14

Contains the return address for CA MIM.

R15

Contains the entry point address for the GCMCMDXT routine.

Note: All other registers are undefined.

GCMCMDXT Exit-specific Parameter List (mapped by MIMCMDXP macro in CAI.CBTDMAC)

+0

Fullword containing the address of the sixteen-byte bit-mask of systems targeted for this cross-system command. The bits, from high order to low order, represent the system indexes of the targeted systems.

+4

Fullword containing the address of the command text.

+8

Halfword containing the length of the command text.

+A

(Two bytes reserved for user exit compatibility)

+C

Fullword containing the address of the CA MIM message routine that you can use to send a message to the cross-system command issuer. If you want to use this routine, then make sure your exit provides a save area of at least 72 fullwords and that registers 9 and 11 are the same as on entry to your exit when you branch to the message routine.

+10

Fullword containing the address of the MCS authority flag bytes.

+14

(Twelve bytes reserved)

+20

Fullword containing the 4-byte console ID.

+24

One-byte unsigned integer containing the command source type defined as follows:

0-Real MCS console
4-Extended MCS (EMCS) console with migration ID
8-Extended MCS (EMCS) console
12-Subsystem console
16-Product (N/A)
20-TSO user
24-INSTREAM (JCL converter)
28-INTERNAL (no console)

+25

(Three bytes reserved)

+28

Eight-byte command source name. Can be console name, TSO user ID, INSTREAM, or INTERNAL depending on command source type.

+30

Eight-byte Command and Response Token (CART).

+38

(Sixteen bytes reserved)

+48

Eight-byte GCMCMDXT user exit parameter list eye catcher “GCMCMDXT.”