MVS™ provides the following
macros that the service provider uses to create, disconnect, or destroy
the environment (tables, linkages, and indexes) needed for cross
memory communication. This section discusses when and how to use these
macros. For detailed information about the macro's syntax and parameters,
see one of the following:
A brief description of each macro follows.
- ATSET (Set Authority Table): Sets PT and SSAR authority in the
home address space's authority table entry that corresponds to a specified
authorization index.
- AXEXT (Extract Authorization Index): Returns the authorization
index (AX) value of a specified address space.
- AXFRE (Free Authorization Index): Frees one or more authorization
index (AX) values by returning them to the system.
- AXRES (Reserve Authorization Index): Reserves one or more
authorization index (AX) values for use by the caller of the macro.
- AXSET (Set Authorization Index): Sets the authorization
index (AX) of the home address space to the value specified by the
caller of the macro.
- ETCON (Connect Entry Table): Connects one or more entry tables
to specified linkage table indexes in the home address space.
- ETCRE (Create Entry Table): Builds a program call (PC) entry table
from PC routine definitions that the service provider defined by issuing
the ETDEF macro or by defining the entry definitions directly.
- ETDEF (Create Entry Table Descriptor): Builds or modifies the
PC routine definitions that ETCRE uses as input.
- ETDES (Destroy Entry Table): Destroys an entry table.
- ETDIS (Disconnect Entry Table): Disconnects one or more
entry tables from the home address space's linkage table.
- LXFRE (Free a Linkage Index): Frees one or more previously reserved
linkage indexes.
- LXRES (Reserve a Linkage Index): Reserve one or more linkage
indexes for future use.
- PCLINK (Stack, Unstack, or Extract Program Call Linkage Information):
Basic PC routines that receive control in supervisor state can issue
- Save the user's environment after the PC routine gets control.
- Restore the user's environment before issuing the PT instruction
to return control to the user.
- Retrieve information from a saved environment.