Service summary

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:
  1. A program running in primary ASC mode when PASN=HASN=SASN can issue any of the services listed in the table.
  2. 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.

  3. Callable services do not check the SYSSTATE or SPLEVEL global variables.
Table 1. Service Summary
Service 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:
  1. 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.

  2. CALLRTM TYPE=MEMTERM can be issued in cross memory mode. For CALLRTM TYPE=ABTERM, see the CALLRTM macro description.
  3. 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.

  4. IBM recommends that AR mode callers use the STORAGE macro instead of using GETMAIN or FREEMAIN.
  5. 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).
  6. If you use the HSPALET parameter, the HSPSERV macro checks SYSSTATE.
  7. 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.
  8. 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.
  9. Both SDUMP and SDUMPX can be issued in cross memory mode only if you specify BRANCH=YES.
  10. Only TIMEUSED LINKAGE=SYSTEM can be issued in AR ASC mode. TIMEUSED LINKAGE=BRANCH cannot be issued in AR ASC mode.
  11. 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.
  12. 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.
  13. 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.
  14. For CSVDYNEX CALL, RECOVER, and QUERY requests, any PASN, any HASN, any SASN. For all other requests, PASN=HASN=SASN.
  15. When the caller of the IAZXJSAB macro specifies the ASCB parameter, any PASN, any HASN, any SASN; otherwise, PASN=HASN is required.
  16. The 64 bit entry names are as follows:
    • ISGLCR64
    • ISGLID64
    • ISGLOB64
    • ISGLRE64
    • ISGLPB64
    • ISGLPR64
Parent topic: Using the services