gtpg2m57General Macros

UATBC-MDBF User Attribute Reference Request

This general macro provides addressability to an SSU slot in the Subsystem User Table (MS0UT) for both C-type and E-type programs. The macro determines the requested SSU slot address and places it in a user-specified register so that upon return, the user can access the data in the SSUT via the MS0UT macro.

Format




label
A symbolic name can be assigned to the macro statement.

IDLOC
This is a required parameter that specifies the location of the SS/SSU ID to be used as input to the UATBC macro. Upon return, the general register specified by 'Rx' will contain the SSUT slot address of the specified SSU, adjusted for the SSUT header.

The valid request types are listed below.

(E,SSI,Rx)
This specifies that the input SS ID is supplied in the ECB field CE1DBI.

(E,SSU,Rx)
This specifies that the input SSU ID is supplied in the ECB field CE1SSU.

(R,SSI,Rx)
This specifies that the input SS ordinal number is supplied in the rightmost byte of 'Rx'. The high-order 3 bytes of 'Rx' are irrelevant.

(R,SSU,Rx)
This specifies that the input SSU ordinal number is supplied in the rightmost byte of 'Rx'. The high-order 3 bytes of 'Rx' are irrelevant.

(N,SSI,Rx)
This specifies that the input SS name is supplied in 'Rx'. The SS name must be a maximum of 4 characters, left justified, and padded with blanks on the right.

(N,SSU,Rx)
This specifies that the input SSU name is supplied in 'Rx'. The SSU name must be a maximum of 4 characters, left justified, and padded with blanks on the right.

EXCD=address
This is the address of a user exit routine to which control will be passed if the 'exceeded' condition is raised. This parameter is optional, but if omitted and the condition is raised, a system error is taken. This parameter is invalid if used with IDLOC=(N...).

INVLID=address
This is the address of a user exit routine to which control will be passed if the 'invalid' condition is raised. This parameter is optional, but if omitted and the condition is raised, a system error is taken. This parameter is ignored when IDLOC=(R...).

NOTAVL=address
This is the address of a user exit routine to which control will be passed if the 'not available' condition is raised. This parameter is optional, but if omitted and the condition is raised, a system error is taken.

NAME=Ry
This is the general register that is to contain the SS name, left justified, upon return. This SS is the parent SS of the SSU whose adjusted slot address is being returned by the UATBC macro. This parameter is optional.

COUNT=Rz
This is the general register that is to contain a number of SSUs upon return. If IDLOC=(x,SSI,x) is coded, this number is the total number of SSUs in the specified SS. If IDLOC=(x,SSU,x) is coded, this number is the number of SSUs remaining in the parent SS of the specified SSU, including the specified SSU itself. This parameter is optional.

Entry Requirements

Return Conditions

Programming Considerations

Examples

None.