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

Register Usage at Entry:

Common Parameter List

R1

This register contains the address of the parameter list, in the following format:

+0

Contains the TPCRECXT parameter list.

+4

Contains the TPCRECXT communication word. The content of this word is set by the exit during its initialization call and is passed unchanged for all subsequent calls.

+8

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

+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 routine.

All other registers are undefined.

TPCRECXT Exit-specific Parameter List

This parameter list is mapped by the X35LIST and X35DEV DSECTs. The field descriptions note which fields can be updated by the exit routine. No other fields can be updated.

+0

X35SIOTA

Contains the address of the Step I/O Table (SIOT) for the current job.

+4

X35CANDC

Contains the number of devices in the X35DLIST DSECT.

+8

X35EXTC

Contains the number of devices in the X35DLIST DSECT that are varied as dedicated on external systems.

+C

X35NAVC

Contains the number of devices in the X35DLIST DSECT that are varied as not available on the local system.

+10

X35FLAG1

Contains flags that describe the options on the MIM2060 message. You can use this field to modify the allowable responses to allocation recovery message MIM2060:

X35DVNMO

DEVICE NAME is an option

X35WAITO

WAIT is an option.

You can use the exit to modify this field. You can eliminate any option. However, you cannot add either option if it is not already provided.

+11

X35FLAG2

Contains flags used to describe how TPCF is to respond to allocation recovery messages IEF238D and IEF433D:

X35DVNMR

Reply to IEF238D with a device name, which you can find in field X35UNITR (+14). If you activate this bit, then place the device name in the X35UNITR field.

X35WAITR

Reply WAIT to IEF238D.

X35CANCR

Reply CANCEL to IEF238D.

X35OPERR

Let the operator reply to MIM2060.

X35433H

Reply HOLD to IEF433D.

X35433NH

Reply NOHOLD to IEF433D.

X35433O

Let operator reply to IEF433D.

Note: You can use the exit to modify this field. You must use a valid reply as defined in X35FLAG1 (+10).

+12

X35FLAG3

Contains flags used to describe elimination logic of devices that are listed on MIM2042 messages:

X35XEXT

Eliminate externally dedicated devices from MIM2042.

X35XNAV

Eliminate not available devices from MIM2042.

Note: You can use the exit routine to modify this field.

+13

X35FLAG4

This is reserved for future releases of CA MIM.

+14

X35UNITR

Contains the three- or four-character, left-justified device name to reply to IEF238D message if the X35DVNMR bit is on in flag X35FLAG2 (+11). The device name must be found in the X35DLIST device list.

Note: You can use the exit routine to modify this field.

+18

X35DLIST

Contains the sequential list of offline devices created from IEF247I device lists. Each entry in this list is defined by the X35DEV DSECT:

+0 X35UNIT-Contains the three-character, left-justified device name that appears in the list.

+4 X35STAT1–Contains the status flags:

• X35DEDH–Dedicated here (to this system).
• X35DEDT–Dedicated there (to another system).
• X35NAV–Not available.

+5 X35STAT2–Contains the status flag:

• X35PREFR–A preference was specified.

+6 X35PREF–Contains the half-word preference value of the device if flag X35PREFR is on in field X35STAT2 (+5). This value is not the same as the value entered on the TPCF VARY device, PREFERENCE command. You can calculate the preference value for the device specified on the VARY command from the X35PREF (+6) field for that device with this equation:

Preference value = X'2710' - X35PREF

+8 X35STAT3– Contains the status flags:

• X35NOMAN–Device not managed by CA MIA.
• X35JRES –Device reserved for the current job name.
• X35NACC– Device in NOT ACCESSIBLE list.
• X35OFFL–Device in OFFLINE list.

+9 X35STAT4–Contains status flags. You can use the following flags to selectively override the elimination logic defined in flag X35FLAG3 (+12):

• X35ELIMY–Eliminate from MIM2042.
• X35ELIMN –Do not eliminate from MIM2042.

Note: You can use the exit routine to modify this field.