Summary of macro interfaces

Table 1 shows the MVS™ programming rules for using the macros described in this manual.

In Table 1, a dash (-) indicates that the category does not apply to the macro because the macro does not generate executable code. The addressing mode of the program that accesses the data generated by the macro must agree with the residence of the data.

Table 1. MVS interface rules for using macro interfaces
Macro (X) May be issued in

(P) May be issued by a program
(I) Input may be

24-bit mode 31-bit mode Below 16MB Above 16MB
CALLTSSR X X P P
GETLINE X X I,P I,P
GTSIZE X X P P
GTTERM X   P  
IKJENDP - - P P
IKJIDENT - - P P
IKJKEYWD - - P P
IKJNAME - - P P
IKJOPER - - P P
IKJPARM - - P P
IKJPOSIT - - P P
IKJRLSA X X P P
IKJRSVWD - - P P
IKJSUBF - - P P
IKJTERM - - P P
IKJUNFLD - - P P
IKJTSMSG - - P P
PUTGET X X I,P I,P
PUTLINE X X I,P I,P
RTAUTOPT X X P P
SPAUTOPT X X P P
STACK X X I,P I,P
STATTN X   I,P  
STAUTOCP X X P P
STAUTOLN X   I,P  
STAX X X I,P  
STBREAK X   I,P  
STCC X   I,P  
STCLEAR X   I,P  
STCOM X   I,P  
STFSMODE X   I,P  
STLINENO X   I,P  
STSIZE X   I,P  
STTIMEOU X   I,P  
STTMPMD X   I,P  
STTRAN X   I,P  
TCLEARQ X   I,P  
TGET X X I,P  
TPG X X I,P  
TPUT X X I,P
Notes:
CALLTSSR
The CALLTSSR macro instruction can be issued in either 24-bit or 31-bit addressing mode. See Invoking TSO/E service routines with CALLTSSR for more information on issuing the CALLTSSR macro.
GETLINE, PUTGET, PUTLINE, STACK
The GETLINE, PUTGET, PUTLINE, and STACK macros can be issued in either 24-bit or 31-bit addressing mode. These routines return control in the same addressing mode in which they are invoked. Input passed to these routines can reside above or below 16 MB in virtual storage. However, if you use the STACK macro, the list source descriptor (LSD) must reside below 16 MB.
IKJTSMSG
The IKJTSMSG macro can be issued by a program loaded below or above 16 MB in virtual storage. Refer to Using the TSO/E message handling routine IKJEFF02 for a description of the standard and extended formats of the input parameter list for IKJEFF02.

If the parse service routine is invoked in 31-bit addressing mode, the parse parameter list, mapped by IKJPPL, can reside above 16 MB in virtual storage and the parse macro instructions can be issued by a program loaded above 16 MB. See above for a list of the parse macros and their linkage requirements. The IKJRLSA parse macro can be issued in either 24- or 31-bit addressing mode.

STAX
A program can issue the STAX macro in either 24- or 31-bit addressing mode. Refer to Using the STAX service routine to handle attention interrupts for specific restrictions.
TGET, TPUT, TPG
The TGET, TPUT, and TPG macros can be issued in either 24- or 31-bit addressing mode. All input passed to them must reside below 16 MB in virtual storage.
Terminal Control Macros
With a few exceptions, terminal control macros must be issued in 24-bit addressing mode. The exceptions are the GTSIZE, RTAUTOPT, SPAUTOPT, and STAUTOCP terminal control macros, which can be issued in 31-bit addressing mode. See above for a list of the terminal control macros and their linkage requirements.