SAIQ gate, INQUIRE_SYSTEM function
The INQUIRE_SYSTEM function of the SAIQ gate is used to inquire upon system data values owned by the application domain.
Input Parameters
- GMMTEXT
- Optional Parameter
- A token identifying the text of the "good-morning" message.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- ABEND
- INQ_FAILED
- LOOP
- The following values are returned when RESPONSE is EXCEPTION:
- LENGTH_ERROR
- UNKNOWN_DATA
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- CICSREL
- Optional Parameter
- The CICS® release and modification number
- CICSSTATUS
- Optional Parameter
- The initialization or termination status of the CICS system.
- Values for the parameter are:
- ACTIVE
- FINALQUIESCE
- FIRSTQUIESCE
- INITIALIZING
- CICSSYS
- Optional Parameter
- A character that indicates the system for which this system was built. Only set by CICS for MVS™.
- CICSTSLEVEL
- Optional Parameter
- The level of CICS Transaction server.
- COLDSTATUS
- Optional Parameter
- An indication of whether CICS was started with a COLD or INITIAL start.
- Values for the parameter are:
- COLD
- INITIAL
- NOTCOLD
- CWA
- Optional Parameter
- The address of the common work area.
- CWALENGTH
- Optional Parameter
- The length of the common work area.
- DATE
- Optional Parameter
- The date represented as a packed decimal number integer of the
form 0cyyddds where
- yy is the year
- ddd is the day
- c is the century, where 0 indicates 1900-1999, 1 indicates 2000-2099, and 2 indicates 2100-2199.
- s is a positive sign
- DTRPRGRM
- Optional Parameter
- The name of the dynamic routing program.
- GMMLENGTH
- Optional Parameter
- the length of the "good-morning" message text.
- GMMTRANID
- Optional Parameter
- The transaction that generates the "good morning" message.
- INITSTATUS
- Optional Parameter
- The status or phase of initialization.
- Values for the parameter are:
- FIRSTINIT
- INITCOMPLETE
- SECONDINIT
- THIRDINIT
- JOBNAME
- Optional Parameter
- The eight-character MVS job name for the local CICS region.
- OPREL
- Optional Parameter
- The release number of the operating system currently running. The value is ten times the formal release number. For example, "21" represents Release 2.1.
- OPSYS
- Optional Parameter
- A one-character identifier indicating the type of operating system currently running. A value of "X" represents MVS.
- OSLEVEL
- Optional Parameter
- The version, release, and modification of z/OS® that is running, each in character form, two bytes each.
- PLTPI
- Optional Parameter
- The two-character suffix of the program list table, which contains a list of programs to be run in the final stages of system initialization.
- SDTRAN
- Optional Parameter
- The shutdown transaction.
- SECURITYMGR
- Optional Parameter
- Indicates whether an external security manager (such as RACF®) is active in the CICS region, or whether no security is being used.
- Values for the parameter are:
- EXTSECURITY
- NOSECURITY
- SHUTSTATUS
- Optional Parameter
- The shutdown status of the local CICS region.
- Values for the parameter are:
- CANCELLED
- CONTROLSHUT
- NOTSHUTDOWN
- SHUTDOWN
- STARTUP
- Optional Parameter
- The type of startup used for the local CICS region.
- Values for the parameter are:
- AUTOSTART
- COLDSTART
- EMERGENCY
- STANDBY
- WARMSTART
- STARTUPDATE
- Optional Parameter
- A four-character packed-decimal value indicating the date on which the local CICS region was started.
- TERMURM
- Optional Parameter
- The eight-character name of the terminal autoinstall program.
- TIMEOFDAY
- Optional Parameter
- A four-character packed-decimal value indicating the time at which the local CICS region was started (hhmmsstc, where hh=hours, mm=minutes, ss=seconds, c is the sign).
- XRFSTATUS
- Optional Parameter
- Indicates whether the local CICS region is a PRIMARY (active) or TAKEOVER (alternate) XRF CICS region, or has no XRF support.
- Values for the parameter are:
- NOXRF
- PRIMARY
- TAKEOVER