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

Register Usage at Entry:

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

R1

Contains the address of the parameter list, in the following format:

+0

Contains the parameter list of the GCMRCVXT exit routine.

+4

Contains the address of the communication word of the 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.

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 GCMRCVXT routine. All other registers are undefined.

GCMRCVXT Exit-specific Parameter List (mapped by the GCMRCVXP macro in CAI.CBTDMAC)

+0

Fullword containing the address of the sixteen-byte system mask that represents the system from which this cross-system command was issued.

+4

Fullword containing the address of the command text.

+8

One-byte unsigned integer containing the length of the command text.

+9

(One byte reserved for pre-Version 4.1 and above user exit compatibility)

+A

Two bytes containing the MCS command authority of the command source defined as follows:

Byte 1:
B'00000000'-INFO authority
B'10000000'-SYS authority
B'01000000'-IO authority
B'00100000'-CONS authority
B'00000010'-MASTER authority
B'00000001'-(No authority)

Byte 2: (z/VM authority-Not applicable on CA MIC):
B'00000010'-z/VM OPERPRIV authority
B'00000001'-z/VM USERPRIV authority

+C

(Fullword reserved for pre-Version 4.1 and above user exit compatibility)

+10

(Eight bytes reserved)

+18

Fullword containing the four-byte console ID.

+1C

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)
255 (Not available)

+1D

(Three bytes reserved)

+20

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

+28

Eight-byte CART. Binary zeros if not specified or not available.

+30

(Eight bytes reserved)

+38

GCMRCVXT user exit parmlist eye catcher containing GCMRCVXT.