User Exits › Exit Routine Programming Considerations › GCMCMDXT › 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 exit parameter list, in the following format:

+0

Contains the address of the GCMCMDXT parameter list. It is not used for initialization calls.

+4

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

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

GCMCMDXT Parameter List (mapped by the MIMCMDXP macro)

+0

Contains the address of the bit mask for targeted systems.

+4

Contains the address of the command text buffer.

+8

Contains the true length of the command text buffer.

+A

Contains the origin of the command. If the high-order-bit is on, the command was issued by a CMS user. If it is off, the command was issued at the MIMGR console.

+C

Contains the address of an eight-byte field containing the user ID (left-justified) of the CMS user issuing the command. This field is not valid when the command has been issued at the MIMGR console.

+10

Contains the address of the console authority flags. See the link authority flag definitions below.

GCMCMDXT Link Authority Flags

The link authority flags for the +10 offset consist of 2 bytes of flags.

The first flag byte is defined as follows:

X'80' SYS authority 
X'40' IO authority 
X'20' CONS authority 
X'04' INFO authority 
X'02' MASTER authority 
X'01' NO authority 
X'00' INFO authority

The second flag byte is defined as follows:

X'02' OPERPRIV authority 
X'01' USERPRIV authority

Return Code, Register 15

0

This code indicates that this command should be processed as usual.

4

This code indicates that CA MIC should reject this command and issue message MIM3029 to notify the user that the command has been rejected.

8

This code indicates that CA MIC should reject this command but should not issue a message about the rejection.

Note: Upon return, you must restore all registers except 0, 1, and 15.