gtpg2m5pGeneral Macros

WGTAC-Locate Terminal Entry

This general macro has two functions. The primary function is to locate the entry for a specific line number, interchange address, terminal address (LNIATA) in the terminal address table (WGTA). It also provides the user with the address and the equates for a table describing the (WGTA parameter table).

Format




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

access
The valid options for ACCESS are either 'R' or 'W'

R
If the parameter is omitted the default value is 'R'. The R option requests the CINFC macro to be issued with the fast option. (This does not change the storage protect key.)

W
When the W option is used, the CINFC macro is issued with the write option. (This causes a storage protect key of zero to be placed in the current PSW.) This is the normal usage of the macro. It is issued whenever the user wants to find the address of a specific LNIATA entry in the terminal address subtable.

TABLE
The omission of TABLE is the normal case. This parameter is coded 'TABLE' when a user wants to find the address in the control program of a table describing the WGTA table.

MASKED
MASKED is coded 'MASKED' when it is used. This parameter can be used only by C-type segments and is rejected if it is used by E-type (ECB) segments. If MASKED is coded, the ACCESS and TABLE parameters are ignored. This parameter provides an alternate entry point to the WGTAC service routine for C-type segments.

Segments that use the masked parameter must be running with a storage key that allows alteration of protected storage (key of 0 or F). Use of this parameter allows the interrupt processing routines to run the WGTAC macro.

MODEC
Correct values are:

YES
WGTAC macro generation issues a MODEC macro to put the user into 31-bit addressing mode. This is necessary to access the WGTA if it resides above the 16-megabyte boundary. YES is the default when MODEC is omitted.

NO
WGTAC macro generation does not issue a MODEC. The user is in control of setting the mode.

WGTAC will return in 31-bit mode regardless of the setting of the MODEC parameter if it is invoked in 31-bit mode. If it is invoked in 24-bit mode, it will return in 31-bit mode, unless MODEC is NO, the TABLE parameter is specified and the MASKED parameter is not specified when it will return in 24-bit mode.

Entry Requirements

Return Conditions

Programming Considerations

Examples