User Exits › Exit Routine Programming Considerations › GCMRCVXT › Entry Environment

Entry Environment

Supervisor state, problem program key, AMODE 31. Use this environment at entry and restore it upon return.

Register Usage at Entry

Common Parameter List

R1

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

+0

Contains the address of the GCMRCVXT exit routine parameter list. It is not used for initialization calls.

+4

Contains the routine communication word. During its initialization call, the routine may set the word contents. The contents are passed unchanged for all subsequent calls to this routine.

+8

Contains the fullword of flags used to pass status information to the routine. The first byte X'80' bit is set on for the initialization call.

+C

Contains the global communication word. The value of this word can be set by the MIMINIXT exit.

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 Parameter List (mapped by the GCMRCVXP macro)

+0

Contains the address of the bit mask for the originating system.

+4

Contains the address of the command text buffer.

+8

Contains the true length of the command text.

+9

This offset identifies the source of the command.
X'08' means the command was issued from an MCS console.
X'04' means the command was issued by a CMS or TSO user.
X'02' means it was issued by a product.
X'01' means it was issued by an extended console.

+A

Contains the user link authority flags. For a description, see GCMCMDXT Link Authority Flags.

+C

Contains the address of a field identifying the origin of the command. The origin can be a console ID, a CMS or TSO user ID, a product name, or an extended console. If the command was issued through a linkage created for all users, the origin will be ALL.

+10

Contains a flag byte as follows:
X'80' CP command
X'40' MI command
X'08' MCS console

Return Code, Register 15

0

Indicates that this command should be processed normally.

4

Indicates that CA MIC should reject this command and issue a message to notify the issuing user (on the originating system) that the command was rejected.

Note: You must restore all registers (except 0, 1, and 15) upon return.