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


dfhs3_SAIQinquire_system.html | Timestamp icon Last updated: Monday, 5 June 2017