|
Table 1 lists
services described in the following:
For each service, the table indicates: - Whether a program in AR ASC mode can issue the service
- Whether a program in cross memory mode can issue the service
- Whether the macro checks the SYSSTATE global macro variables
- Whether the macro can be issued in 64-bit addressing mode
Note: - A program running in primary ASC mode when PASN=HASN=SASN can
issue any of the services listed in the table.
- Cross memory mode means that at least one of the following conditions
is true:
- PASN¬=SASN
- The primary address space (PASN) and the secondary address space
(SASN) are different.
- PASN¬=HASN
- The primary address space (PASN) and the home address space (HASN)
are different.
- SASN¬=HASN
- The secondary address space (SASN) and the home address space
(HASN) are different.
For more information about functions that are available
to programs in cross memory mode, see z/OS MVS Programming: Extended Addressability Guide.
- Callable services do not check the SYSSTATE or SPLEVEL global
variables.
Table 1. Service
SummaryService |
Can be issued in AR ASC mode |
Can be issued in cross memory mode |
Checks SYSSTATE |
Can be issued in 64-bit AMODE |
---|
ALESERV |
Yes |
Yes |
No |
No |
ASCRE |
Yes |
Yes |
Yes |
No |
ASDES |
Yes |
Yes |
Yes |
No |
ASEXT |
Yes |
Yes |
No |
No |
ATSET |
No |
Yes |
Yes |
No |
ATTACH |
Yes (See note 1) |
No |
Yes |
No |
ATTACHX |
Yes |
No |
Yes |
Yes |
AXEXT |
No |
Yes |
Yes |
No |
AXFRE |
No |
Yes |
Yes |
No |
AXRES |
No |
Yes |
Yes |
No |
AXREXX |
No |
Yes |
Yes |
Yes |
AXSET |
No |
Yes |
Yes |
No |
BPXEKDA |
Yes |
No |
Yes |
No |
BPXESMF |
Yes |
No |
Yes |
No |
CALLDISP |
No |
Yes |
No |
Yes |
CALLRTM |
No |
Yes (See note 2) |
No |
No |
CHANGKEY |
No |
Yes |
No |
No |
CIRB |
No |
No |
No |
No |
CMDAUTH |
No |
No |
No |
No |
CNZMXURF |
No |
Yes |
No |
No |
CNZTRKR |
No |
Yes |
No |
No |
COFCREAT |
Yes |
Yes |
Yes |
No |
COFDEFIN |
Yes |
Yes |
Yes |
No |
COFIDENT |
Yes |
Yes |
Yes |
No |
COFNOTIF |
Yes |
Yes |
Yes |
No |
COFPURGE |
Yes |
Yes |
Yes |
No |
COFREMOV |
Yes |
Yes |
Yes |
No |
COFRETRI |
Yes |
Yes |
Yes |
No |
COFSDONO |
No |
No |
Yes |
No |
CONFCHG |
No |
No |
Yes |
No |
CPF |
No |
No |
No |
No |
CPOOL |
No |
Yes |
Yes |
No |
CPUTIMER |
No |
Yes |
Yes |
No |
CSRSI |
No |
Yes |
No |
No |
CSRUNIC |
Yes |
Yes |
No |
No |
CSVAPF |
Yes (See note 11) |
Yes (See note 12) |
Yes |
No |
CSVDYNEX |
Yes (See note 13) |
Yes (See note 14) |
Yes |
No |
CTRACE |
No |
No |
Yes |
No |
CTRACECS |
Yes |
No |
Yes |
No |
CTRACEWR |
Yes |
Yes |
Yes |
No |
DATOFF |
Yes |
No |
No |
No |
DEQ |
No |
Yes |
Yes |
Yes |
DIV |
Yes |
No |
Yes |
No |
DOM |
No |
No |
No |
Yes |
DSPSERV |
Yes |
Yes |
Yes |
Yes |
DYNALLOC |
No |
No |
No |
Yes |
EDTINFO |
No |
Yes |
Yes |
Yes |
ENFREQ |
No |
No |
No |
No |
ENQ |
No |
Yes |
Yes |
Yes |
ESPIE |
No |
No |
No |
Yes |
ESTAE (See note 3) |
No |
No |
Yes |
No |
ESTAEX |
Yes |
Yes |
Yes |
Yes |
ETCON |
No |
Yes |
Yes |
No |
ETCRE |
No |
Yes |
Yes |
No |
ETDEF |
Yes |
Yes |
No |
No |
ETDES |
No |
Yes |
Yes |
No |
ETDIS |
No |
Yes |
Yes |
No |
EVENTS |
No |
No |
No |
No |
EXTRACT |
No |
No |
No |
No |
FESTAE |
No |
No |
No |
No |
FREEMAIN |
Yes (See note 4) |
Yes |
Yes |
Yes |
GETDSAB |
No |
No |
Yes |
No |
GETMAIN |
Yes (See note 4) |
Yes |
Yes |
Yes |
GQSCAN |
No |
Yes |
No |
No |
GTRACE |
No |
Yes |
No |
Yes |
HSPSERV |
Yes |
Yes (See note 5) |
(See note 6) |
No |
IARCP64 |
Yes |
Yes |
Yes |
Yes |
IARR2V |
Yes |
Yes |
No |
No |
IARSUBSP |
Yes |
Yes |
Yes |
No |
IARST64 |
Yes |
Yes |
Yes |
Yes |
IARVSERV |
Yes |
Yes |
Yes |
No |
IARV64 |
Yes |
Yes |
Yes |
Yes |
IAZXCTKN |
Yes |
Yes |
Yes |
No |
IAZXJSAB |
Yes |
Yes (See note 15) |
Yes |
No |
IEAARR |
Yes |
Yes |
Yes |
Yes |
IEAFP |
Yes |
Yes |
Yes |
No |
IEALSQRY |
Yes |
Yes |
Yes |
No |
IEAMETR |
Yes |
Yes |
Yes |
No |
IEAMRMF3 |
No |
Yes |
No |
No |
IEAMSCHD |
Yes |
Yes |
Yes |
No |
IEANTCR |
Yes |
Yes |
N/A |
No |
IEANTDL |
Yes |
Yes |
N/A |
No |
IEANTRT |
Yes |
Yes |
N/A |
No |
IEARBUP |
Yes |
Yes |
Yes |
No |
IEATDUMP |
Yes |
No |
Yes |
No |
IEATEDS |
Yes |
Yes |
Yes |
No |
IEATXDC |
Yes |
Yes |
Yes |
Yes |
IEAVAPE |
No |
Yes |
No |
No |
IEAVAPE2 |
No |
Yes |
No |
No |
IEAVDPE |
No |
Yes |
No |
No |
IEAVDPE2 |
No |
Yes |
No |
No |
IEAVPSE |
No |
Yes |
No |
No |
IEAVPSE2 |
No |
Yes |
No |
No |
IEAVRLS |
No |
Yes |
No |
No |
IEAVRLS2 |
No |
Yes |
No |
No |
IEAVRPI |
No |
Yes |
No |
No |
IEAVRPI2 |
No |
Yes |
No |
No |
IEAVTPE |
No |
Yes |
No |
No |
IEAVXFR |
No |
Yes |
No |
No |
IEAVXFR2 |
No |
Yes |
No |
No |
IEA4APE |
No |
Yes |
No |
Yes |
IEA4APE2 |
No |
Yes |
No |
Yes |
IEA4DPE |
No |
Yes |
No |
Yes |
IEA4DPE2 |
No |
Yes |
No |
Yes |
IEA4PSE |
No |
Yes |
No |
Yes |
IEA4PSE2 |
No |
Yes |
No |
Yes |
IEA4RLS |
No |
Yes |
No |
Yes |
IEA4RLS2 |
No |
Yes |
No |
Yes |
IEA4RPI |
No |
Yes |
No |
Yes |
IEA4RPI2 |
No |
Yes |
No |
Yes |
IEA4TPE |
No |
Yes |
No |
Yes |
IEA4XFR |
No |
Yes |
No |
Yes |
IEA4XFR2 |
No |
Yes |
No |
Yes |
IEECMDS |
Yes |
Yes |
Yes |
No |
IEEQEMCS |
Yes |
Yes |
Yes |
No |
IEEVARYD |
No |
No |
Yes |
No |
IEFPPSCN |
No |
No |
Yes |
No |
IEFQMREQ |
No |
No |
No |
No |
IEFSSI |
Yes |
No |
No |
No |
IEFSSVT |
Yes |
No |
No |
No |
IEFSSVTI |
Yes |
Yes |
No |
No |
IFAQUERY |
Yes |
Yes |
No |
No |
IOCINFO |
Yes |
Yes |
No |
No |
IOSADMF |
No |
No |
Yes |
No |
IOSCAPF |
No |
Yes (See note 7) |
Yes |
No |
IOSCAPU |
Yes |
Yes (See note 7) |
Yes |
No |
IOSCDR |
No |
No |
Yes |
No |
IOSCHPD |
Yes |
Yes |
Yes |
No |
IOSCMXA |
No |
Yes (See note 7) |
Yes |
No |
IOSCMXR |
No |
Yes (See note 7) |
Yes |
No |
IOSDCXR |
No |
Yes (See note 7) |
Yes |
No |
IOSENQ |
Yes |
Yes |
Yes |
No |
IOSINFO |
No |
No |
No |
No |
IOSLOOK |
No |
No |
No |
No |
IOSPTHV |
No |
No |
Yes |
No |
IOSSPOF |
No |
Yes |
Yes |
Yes |
IOSUPFA |
No |
Yes |
Yes |
No |
IOSUPFR |
No |
Yes |
Yes |
No |
IOSVRYSW |
Yes |
Yes |
Yes |
No |
IOSWITCH |
Yes |
Yes |
Yes |
No |
IOSZHPF |
Yes |
Yes |
Yes |
No |
IRDFSD |
Yes |
Yes |
Yes |
No |
IRDFSDU |
Yes |
Yes |
Yes |
No |
ISGADMIN |
Yes |
Yes |
Yes |
Yes |
ISGECA |
Yes |
Yes |
Yes |
Yes |
ISGENQ |
Yes |
Yes |
Yes |
Yes |
ISGLCRT (See note 16) |
No |
Yes |
N/A |
No |
ISGLID (See note 16) |
No |
Yes |
N/A |
Yes |
ISGLOBT |
No |
Yes |
N/A |
No |
ISGLREL |
No |
Yes |
N/A |
No |
ISGLPRG |
No |
Yes |
N/A |
No |
ISGQUERY |
Yes |
Yes |
Yes |
Yes |
ITTFMTB |
No |
No |
No |
No |
ITZXFILT |
No |
Yes |
Yes |
No |
IWMCLSFY |
No |
Yes |
Yes |
No |
IWMCONN |
No |
Yes |
Yes |
No |
IWMDISC |
No |
Yes |
Yes |
No |
IWMECQRY |
No |
Yes |
Yes |
No |
IWMECREA |
No |
Yes |
Yes |
No |
IWMEDELE |
No |
Yes |
Yes |
No |
IWMMABNL |
No |
Yes |
No |
No |
IWMMCHST |
No |
Yes |
No |
No |
IWMMCREA |
No |
Yes |
Yes |
No |
IWMMDELE |
No |
Yes |
Yes |
No |
IWMMEXTR |
No |
Yes |
Yes |
No |
IWMMINIT |
No |
Yes |
No |
No |
IWMMNTFY |
No |
Yes |
Yes |
No |
IWMMRELA |
No |
Yes |
Yes |
No |
IWMMSWCH |
No |
Yes |
Yes |
No |
IWMMXFER |
No |
Yes |
No |
No |
IWMPQRY |
Yes |
Yes |
Yes |
No |
IWMRCOLL |
Yes |
Yes |
Yes |
No |
IWMRPT |
No |
Yes |
Yes |
No |
IWMRQRY |
Yes |
Yes |
Yes |
No |
IWMSRDRS |
No |
Yes |
Yes |
No |
IWMSRSRG |
No |
Yes |
Yes |
No |
IWMSRSRS |
No |
Yes |
Yes |
No |
IWMWMCON |
No |
Yes |
Yes |
No |
IWMWQRY |
Yes |
Yes |
Yes |
No |
IWMWQWRK |
No |
Yes |
Yes |
No |
IXCCREAT |
Yes |
Yes |
Yes |
No |
IXCDELET |
Yes |
Yes |
Yes |
No |
IXCJOIN |
Yes |
No |
Yes |
No |
IXCLEAVE |
Yes |
No |
Yes |
No |
IXCMG |
Yes |
Yes |
Yes |
No |
IXCMOD |
Yes |
Yes |
Yes |
No |
IXCMSGI |
Yes |
No |
Yes |
No |
IXCMSGO |
Yes |
Yes |
Yes |
No |
IXCQUERY |
Yes |
Yes |
Yes |
No |
IXCQUIES |
Yes |
No |
Yes |
No |
IXCSETUS |
Yes |
Yes |
Yes |
No |
IXCTERM |
Yes |
Yes |
Yes |
No |
IXGBRWSE |
Yes |
Yes |
Yes |
Yes |
IXGCONN |
Yes |
Yes |
Yes |
Yes |
IXGDELET |
Yes |
Yes |
Yes |
Yes |
IXGWRITE |
Yes |
Yes |
Yes |
Yes |
LLACOPY |
No |
No |
Yes |
No |
LOAD |
Yes |
No |
No |
Yes |
LOADWAIT |
No |
Yes |
Yes |
No |
LOCASCB |
Yes |
Yes |
Yes |
No |
LXFRE |
No |
Yes |
Yes |
No |
LXRES |
No |
Yes |
Yes |
No |
MCSOPER |
Yes |
No |
Yes |
No |
MCSOPMSG |
Yes |
No |
Yes |
No |
MGCR |
No |
No |
No |
No |
MGCRE |
No |
No |
No |
No |
MIHQUERY |
Yes |
No |
Yes |
No |
MODESET |
No |
Yes |
No |
Yes |
NIL |
Yes |
Yes |
Yes |
No |
NMLDEF |
No |
No |
No |
No |
NUCLKUP |
No |
No |
No |
No |
OIL |
Yes |
Yes |
Yes |
No |
OUTADD |
No |
No |
No |
No |
OUTDEL |
No |
No |
No |
No |
PCLINK |
No |
Yes |
No |
No |
PGANY |
No |
No |
No |
No |
PGFIX |
No |
Yes |
No |
No |
PGFIXA |
No |
No |
No |
No |
PGFREE |
No |
Yes |
No |
No |
PGFREEA |
No |
No |
No |
No |
PGSER |
Yes (See note 8) |
Yes (See note 8) |
No |
Yes |
POST |
No |
Yes |
No |
Yes |
PTRACE |
No |
Yes |
No |
No |
PURGEDQ |
No |
No |
No |
No |
QEDIT |
No |
No |
No |
No |
RESERVE |
No |
No |
No |
Yes |
RESMGR |
Yes |
Yes |
No |
No |
RESUME |
No |
Yes |
No |
No |
RISGNL |
No |
Yes |
No |
No |
SCHEDIRB |
Yes |
No |
Yes |
No |
SCHEDULE |
Yes |
Yes |
Yes |
No |
SCHEDXIT |
No |
Yes |
No |
No |
SDUMP |
Yes (See note 1) |
Yes (See note 9) |
Yes |
No |
SDUMPX |
Yes |
Yes (See note 9) |
Yes |
Yes |
SETFRR |
Yes |
Yes |
Yes |
No |
SETLOCK |
Yes |
Yes |
Yes |
No |
SETRP |
Yes |
Yes |
Yes |
Yes |
SJFREQ |
No |
Yes |
No |
No |
SPIE |
No |
No |
No |
No |
SPOST |
No |
No |
No |
No |
SRBSTAT |
No |
Yes |
No |
No |
SRBTIMER |
No |
No |
No |
No |
STATUS |
Yes |
Yes |
No |
No |
STORAGE |
Yes |
Yes |
No |
Yes |
SUSPEND |
No |
Yes |
No |
No |
SVCUPDTE |
No |
No |
No |
No |
SWAREQ |
No |
No |
No |
No |
SWBTUREQ |
No |
No |
No |
No |
SYMREC |
No |
Yes |
Yes |
No |
SYNCH |
Yes (See note 1) |
No |
Yes |
No |
SYNCHX |
Yes |
No |
Yes |
Yes |
SYSEVENT |
No |
No |
No |
No |
TCBTOKEN |
Yes |
Yes |
No |
No |
TCTL |
No |
No |
No |
No |
TESTAUTH |
No |
No |
No |
No |
TIMEUSED |
Yes (See note 10) |
Yes |
No |
Yes |
T6EXIT |
No |
No |
No |
No |
UCBINFO |
Yes |
Yes |
Yes |
No |
UCBLOOK |
Yes |
Yes |
Yes |
No |
UCBPIN |
Yes |
Yes |
Yes |
No |
UCBSCAN |
Yes |
Yes |
Yes |
No |
VSMLIST |
No |
Yes |
Yes |
No |
VSMLOC |
No |
Yes |
Yes |
No |
VSMREGN |
No |
Yes |
No |
No |
WAIT |
No |
Yes |
No |
Yes |
WTL |
No |
No |
No |
No |
WTO |
No |
No |
No |
Yes |
WTOR |
No |
No |
No |
Yes |
Notes: - Primary mode callers can use either macro in the following
macro pairs:
- ATTACH or ATTACHX
- SDUMP or SDUMPX
- SYNCH or SYNCHX
IBM® recommends that programs in AR ASC mode
use the X-macros (ATTACHX, SDUMPX, and SYNCHX). If, however, a program
in AR mode issues ATTACH, SDUMP, or SYNCH after issuing SYSSTATE ASCENV=AR,
the system substitutes the corresponding X-macro and issues a message
telling you that it made the substitution.
- CALLRTM TYPE=MEMTERM can be issued in cross memory mode.
For CALLRTM TYPE=ABTERM, see the CALLRTM macro description.
- The only programs that can use ESTAE are programs
that are in primary mode with (PASN=HASN=SASN).
IBM recommends you
always use ESTAEX unless your program and your recovery routine are
in 24-bit addressing mode, or your program requires a branch entry.
In these cases, you should use ESTAE.
- IBM recommends that AR mode callers use the STORAGE
macro instead of using GETMAIN or FREEMAIN.
- For HSPSERV SREAD and HSPSERV SWRITE, PASN=HASN=SASN
for a non-shared standard hiperspace for which an ALET is not used
(that is, the HSPALET parameter is omitted).
- If you use the HSPALET parameter, the HSPSERV macro
checks SYSSTATE.
- If the input UCB is captured, the IOSCAPF, IOSCMXA,
IOSCMXR, and IOSDCXR macros can be issued in cross memory mode only
if the UCB is captured in the primary address space. IOSCAPU CAPTOACT
without the ASID parameter also can be issued in cross memory mode
if the UCB was captured in the primary address space. IOSCAPU CAPTUCB
and IOSCAPU UCAPTUCB cannot be issued in cross memory mode.
- PGSER can be issued in AR ASC mode only if you specify
BRANCH=Y. PGSER can be issued in cross memory mode only if you specify
BRANCH=Y or BRANCH=SPECIAL.
- Both SDUMP and SDUMPX can be issued in cross memory
mode only if you specify BRANCH=YES.
- Only TIMEUSED LINKAGE=SYSTEM can be issued in AR ASC
mode. TIMEUSED LINKAGE=BRANCH cannot be issued in AR ASC mode.
- For a QUERY request, CSVAPF can be issued only in primary
mode. For all other requests, CSVAPF can be issued in primary or AR
mode.
- For CSVAPF with the ADD, DELETE, and DYNFORMAT requests,
PASN = HASN = SASN. For CSVAPF with the QUERY, QUERYFORMAT, and LIST
requests, any PASN, any HASN, any SASN.
- For a QUERY or a CALL request with FASTPATH=YES, CSVDYNEX
can be issued only in primary mode. For all other requests, CSVDYNEX
can be issued in primary or AR mode.
- For CSVDYNEX CALL, RECOVER, and QUERY requests, any
PASN, any HASN, any SASN. For all other requests, PASN=HASN=SASN.
- When the caller of the IAZXJSAB macro specifies the ASCB
parameter, any PASN, any HASN, any SASN; otherwise, PASN=HASN is required.
- The 64 bit entry names are as follows:
- ISGLCR64
- ISGLID64
- ISGLOB64
- ISGLRE64
- ISGLPB64
- ISGLPR64
|