Retrieves CICS system information.

Sintaxe:

The command options are sequenced alphabetically (A through M):

INQUIRE SYSTEM
 
>>-INQUIRE SYSTEM----------------------------------------------->
 
   .----------------------------------------------.
   V                                              |
>----+------------------------------------------+-+------------><
     +-AKP(data-area)---------------------------+
     +-APPLID(data-area)------------------------+
     +-CDSASIZE(data-area)----------------------+
     +-CICSSTATUS(cvda)-------------------------+
     +-CICSSYS(data-area)-----------------------+
     +-CMDPROTECT(cvda)-------------------------+
     +-DATEFORM(data-area)----------------------+
     +-DFLTREMSYS(data-area)--------------------+
     +-DFLTUSER(data-area)----------------------+
     +-DSALIMIT(data-area)----------------------+
     +-DTRPROGRAM(data-area)--------------------+
     +-DUMPING(cvda)----------------------------+
     +-ECDSASIZE(data-area)---------------------+
     +-EDSALIMIT(data-area)---------------------+
     +-ERDSASIZE(data-area)---------------------+
     +-ESDSASIZE(data-area)---------------------+
     +-EUDSASIZE(data-area)---------------------+
     +-GMMTEXT(data-area)--GMMLENGTH(data-area)-+
     +-GMMTRANID(data-area)---------------------+
     +-INITSTATUS(cvda)-------------------------+
     +-INTROINTVL(data-area)--------------------+
     +-JOBNAME(data-area)-----------------------+
     +-LOCALE(data-area)------------------------+
     +-MAXREGIONPOOL(data-area)-----------------+
     +-MAXSERVER(data-area)---------------------+
     +-MAXTASKS(data-area)----------------------+
     +-MAXTASKSHPOOL(data-area)-----------------+
     +-MINSERVER(data-area)---------------------+
     '-MROBATCH(data-area)----------------------'
 
 

The remaining options are sequenced alphabetically (O through X):

   .-----------------------------.
   V                             |
>>---+-------------------------+-+-----------------------------><
     +-OPREL(data-area)--------+
     +-OPSYS(data-area)--------+
     +-PROGAUTOCTLG(cvda)------+
     +-PROGAUTOEXIT(data-area)-+
     +-PROGAUTOINST(cvda)------+
     +-PRTYAGING(data-area)----+
     +-RDSASIZE(data-area)-----+
     +-REENTPROTECT(cvda)------+
     +-REGIONTHRESH(data-area)-+
     +-RELEASE(data-area)------+
     +-RUNAWAY(data-area)------+
     +-SCANDELAY(data-area)----+
     +-SDSASIZE(data-area)-----+
     +-SDTRAN(data-area)-------+
     +-SECURITYMGR(cvda)-------+
     +-SHUTSTATUS(cvda)--------+
     +-SOSSTATUS(cvda)---------+
     +-STARTUP(cvda)-----------+
     +-STARTUPDATE(data-area)--+
     +-STOREPROTECT(cvda)------+
     +-SYSID(data-area)--------+
     +-TASKSHTHRESH(data-area)-+
     +-TIME(data-area)---------+
     +-TRANISOLATE(cvda)-------+
     +-UDSASIZE(data-area)-----+
     +-XPRECVTIMEOUT(ptr-ref)--+
     '-XRFSTATUS(cvda)---------'
 
 

For more information about the use of CICS-value data areas (CVDAs), see Appendix F, CVDAs recognized by the translator.

Descrição:

The INQUIRE SYSTEM command returns information about the CICS system under which the task that is issuing the command is running.

Some of the options in this command correspond to options that are in the Region Definitions (RD) and take their initial values from the RD.
Some of these can be changed by a subsequent SET SYSTEM command or its CEMT equivalent.
Other options return information about the CICS, UNIX^(R), or Windows release levels, and still others return information that is determined only by the current state of the system.
Some options are included for compatibility with other CICS products and return null or fixed values.

Opções:

AKP(data-area)
• Returns a 32-bit binary field that gives the trigger value for the activity keypoint, which is the number of logging operations between the taking of keypoints.

APPLID(data-area)
• Returns an eight-character string that shows the name of the local system.

CDSASIZE(data-area)
• Returns the current size in bytes of the CICS storage.
• The value that is returned is the value of the RegionPoolSize attribute.

CICSSTATUS(cvda)
• Returns a CVDA value that identifies the current execution status of CICS.
• The CVDA values are:
  • ACTIVE
    • CICS is fully active.
  • FINALQUIESCE
    • CICS is in the final quiesce stage of shutdown.
    • The second-stage shutdown programs are run during this stage.
  • FIRSTQUIESCE
    • CICS is in the first quiesce stage of shutdown.
    • The first-stage shutdown program is run during this stage.
  • STARTUP
    • CICS is starting up but is not yet fully active.
    • Programs in the program list table for program initiation are run during startup.

CICSSYS(data-area)
• Returns a one-character value that identifies the operating system for which the running CICS system has been built.

CMDPROTECT(cvda)
• Returns a CVDA value that indicates whether command protection is active.
• The CVDA values are:
  • CMDPROT
    • Command protection is active.
  • NOCMDPROT
    • Command protection is not active.
    • TXSeries for Multiplatforms always returns this value.

DATEFORM(data-area)
• Returns a six-character string that shows the default date format that is used when an EXEC CICS FORMATTIME command is issued.
• Possible values are YYMMDD, DDMMYY, and MMDDYY.

DFLTREMSYS(data-area)
• Returns the four-character name of the default remote system.
• The LocalSysId attribute is the default value that is passed to the dynamic transaction routing (DTR) exit
• when no RemoteSysId attribute is defined in the Transaction Definition (TD) stanza entry for the transaction.

DFLTUSER(data-area)
• Returns the eight-character identifier of the default user for this CICS region.

DSALIMIT(data-area)
• Returns the current size in bytes of the read-only storage.
• The value that is returned is the size of the RegionPoolStorage attribute.

DTRPROGRAM(data-area)
• Returns the eight-character name of the dynamic-routing exit program, which is user exit 25.
• If an exit has not been defined, spaces are returned.

DUMPING(cvda)
• Returns a CVDA value that indicates whether the taking of CICS system dumps is suppressed.
• The CVDA values are:
  • NOSYSDUMP
    • System dumps are suppressed.
  • SYSDUMP
    • System dumps are not suppressed.

ECDSASIZE(data-area)
• Returns the current size in bytes of the CICS storage area.
• The value of the RegionPoolSize attribute is returned.

EDSALIMIT(data-area)
• Returns the current size in bytes of the CICS storage area.
• The returned value is the sum of the values of the RegionPoolSize and TaskSharedPoolSize attributes.

ERDSASIZE(data-area)
• Returns, in bytes, the current size of the CICS user storage area.
• The value of the TaskSharedPoolSize attribute is returned.

ESDSASIZE(data-area)
• Returns, in bytes, the current size of the CICS shared storage area.
• The value of the TaskSharedPoolSize attribute is returned.

EUDSASIZE(data-area)
• Returns, in bytes, the current size of the CICS shared storage area.
• The value of the TaskSharedPoolSize attribute is returned.

GMMLENGTH(data-area)
• Returns a 16-bit binary field that gives the length in bytes of the "good morning" message text.
• TXSeries for Multiplatforms always returns a value of zero.

GMMTEXT(data-area)
• Returns the "good morning" message text in the data-area that you provide, which must be long enough to accommodate it.
• This field is unchanged by the CICS code because there is nothing to return.

GMMTRANID(data-area)
• Returns the four-character name of the initial transaction that is to be run on all terminals.
• Only spaces are returned.
• TXSeries for Multiplatforms ignores the GMMTRANID facility.

INITSTATUS(cvda)
• Returns a 32-bit binary field that gives the initialization status of the CICS system.
• The CVDA values are:
  • FIRSTINIT
    • CICS initialization is in the first stage.
  • INITCOMPLETE
    • CICS initialization is complete.
  • SECONDINIT
    • CICS initialization is in the second stage.
  • THIRDINIT
    • CICS initialization is in the third stage.

INTROINTVL(data-area)
• Returns a 16-bit binary field that indicates the introspection interval; that is, the interval of time that is taken between checks of region consistency. The value is expressed in minutes.

LOCALE(data-area)
• Returns a 32-character data area that indicates the region-wide locale.
• Refer to your operating system documentation for more information about locales.

JOBNAME(data-area)
• CICS/ESA^(R) returns the system job name of the CICS region.
• TXSeries for Multiplatforms returns the region name.

MAXREGIONPOOL(data-area)
• Returns a 32-bit binary field that indicates the maximum number of bytes that are available in region pool storage.

MAXSERVER(data-area)
• Returns a 16-bit binary field that indicates the maximum number of application servers.

MAXTASKS(data-area)
• Returns a 32-bit binary field that gives the maximum number of tasks that can be eligible for dispatch at any one time in this CICS system.
• The value that is returned is the maximum number of transactions that can be waiting to run in a queue.

MAXTASKSHPOOL(data-area)
• Returns a 32-bit binary field that indicates the maximum number of bytes that are available in task-shared pool storage.

MINSERVER(data-area)
• Returns a 16-bit binary field that indicates the minimum number of application servers.

MROBATCH(data-area)
• Returns a 32-bit binary field that gives the number of events that must occur, from a list of multiregion operations (MRO) and Direct Access Storage Device Input/Output (DASD I/O) events on which CICS is waiting, before CICS is posted explicitly to process them.
• TXSeries for Multiplatforms always returns a value of zero.

OPREL(data-area)
• Returns a 16-bit binary field that gives the release number of the operating system under which CICS is currently running.

OPSYS(data-area)
• Returns a one-byte character that represents the type of operating system on which the transaction is currently running.
• The following values are returned:
  • A represents CICS for AIX.
  • H represents CICS for HP-UX.
  • L represents CICS for Solaris.
  • N represents CICS for Windows.

PROGAUTOCTLG(cvda)
• Returns a CVDA value that indicates whether and when autoinstalled program definitions are cataloged.
• The CVDA values are:
  • CTLGALL
    • Definitions are cataloged both when installed and when modified.
  • CTLGMODIFY
    • Definitions are cataloged only when modified.
  • CTLGNONE
    • Definitions are not cataloged.
• TXSeries for Multiplatforms always returns the CTLGNONE value.

PROGAUTOEXIT(data-area)
• Returns the eight-character name of the user-provided program that is called by the CICS program autoinstall code to provide a model definition.
• If the autoinstall user exit program is installed, the program name is returned. Otherwise, spaces are returned.

PROGAUTOINST(cvda)
• Returns a CVDA value that indicates whether autoinstall for programs is active or inactive.
• When a task requests a program that is not defined, CICS attempts to create a definition for it automatically.
• The CVDA values are:
  • AUTOACTIVE
    • Autoinstall for programs is active.
  • AUTOINACTIVE
    • Autoinstall for programs is not active.

PRTYAGING(data-area)
• Returns a 32-bit binary field that gives the rate at which CICS increases the priority of a task that is waiting for dispatch.
• TXSeries for Multiplatforms always returns a value of zero.

RDSASIZE(data-area)
• Returns, in bytes, the current size of the total amount of read-only memory that is available in the system, in 32-bit binary form.
• TXSeries for Multiplatforms returns the value of the RegionPoolSize attribute.

REENTPROTECT(cvda)
• Returns a CVDA value that indicates whether program storage is protected from being overwritten by other tasks.
• The CVDA values are:
  • REENTPROT
    • Program storage is protected.
  • NOREENTPROT
    • Program storage is not protected.
• TXSeries for Multiplatforms always returns the NOREENTPROT value.

REGIONTHRESH(data-area)
• Returns a 16-bit binary field that indicates the region pool storage threshold value.
• This is expressed as a percentage.

RELEASE(data-area)
• Returns a four-character string that gives the version and release numbers of the CICS code that is running.

RUNAWAY(data-area)
• Returns a 32-bit binary field that gives the default value for runaway task time.
• The value of the MaxTaskCPU attribute is returned.

SCANDELAY(data-area)
• Returns a 32-bit binary field that gives the maximum number of milliseconds between the time at which a user task makes a terminal I/O request and the time at which the task is dispatched.
• TXSeries for Multiplatforms always returns a value of zero.

SDSASIZE(data-area)
• Returns, in bytes, the current size of shared memory that is available.
• The value of the TaskSharedPoolSize attribute is returned.

SDTRAN(data-area)
• Returns the four-character name of the transaction that is to be run at the beginning of a normal or an immediate shutdown procedure.
• The transaction name that is returned is always the CROW transaction identifier.

SECURITYMGR(cvda)
• Returns a CVDA value that identifies whether an external security manager is active in the system, or whether internal CICS security is being used.
• The CVDA values are:
  • EXTSECURITY
    • An external security manager is active.
  • CICSSECURITY
    • Internal CICS security via the SNT is being used.

SHUTSTATUS(cvda)
• Returns a CVDA value that indicates the shutdown status of CICS (see the CICSSTATUS option CICSSTATUS option, INQUIRE SYSTEM command).
• The CVDA values are:
  • CANCELLED
    • CICS is canceled.
    • TXSeries for Multiplatforms never returns this value.
  • CONTROLSHUT
    • CICS is performing a normal controlled shutdown.
  • NOTAPPLIC
    • CICS is not shutting down.
  • SHUTDOWN
    • CICS is performing an immediate shutdown.

SOSSTATUS(cvda)
• Returns a CVDA value that indicates whether CICS is short on storage.
• The CVDA values are:
  • NOTSOS
    • CICS is not short on storage.
  • SOS
    • CICS is short on storage.
  • SOSABOVE
    • CICS is short on storage in at least one dynamic storage area above 16 MB.
    • TXSeries for Multiplatforms never returns this value.
  • SOSBELOW
    • CICS is short on storage in at least one dynamic storage area below 16 MB.
    • TXSeries for Multiplatforms never returns this value.

STARTUP(cvda)
• Returns a CVDA value that indicates how the current execution of CICS started.
• The CVDA values are:
  • COLDSTART
    • CICS performed a cold start.
  • EMERGENCY
    • CICS performed an emergency restart.
  • WARMSTART
    • CICS performed a warm restart following the normal shutdown of the previous run.

STARTUPDATE(data-area)
• Returns a four-byte packed-decimal field that contains the date on which the current execution of CICS started.
• The date is in the form 0cyyddd+, where c. is the century code (0 for the 1900s, 1 for 2000-2099), yy is the low-order two digits of the year, and ddd is the sequential day of the year.

STOREPROTECT(cvda)
• Returns a CVDA value that indicates whether storage protection is active or not.
• The CVDA values are:
  • ACTIVE
    • Storage protection is active.
  • INACTIVE
    • Storage protection is not active.
• The returned value is based on the value of the SafetyLevel attribute in the RD stanza.

SYSID(data-area)
• Returns a four-character string that gives the LocalSysId attribute of the local region.

TASKSHTHRESH(data-area)
Returns a 16-bit binary field that indicates the task-shared pool storage threshold value.
This is expressed as a percentage.

TIME(data-area)
• Returns a 32-bit binary field that gives the maximum interval in milliseconds for which CICS gives control to the operating system if no tasks are ready for dispatch.
• TXSeries for Multiplatforms always returns a value of zero.

TRANISOLATE(cvda)
• Returns a CVDA value that indicates whether transaction isolation is active or not.
• The CVDA values are:
  • ACTIVE
    • Transaction isolation is active.
    • TXSeries for Multiplatforms always returns this value.
  • INACTIVE
    • Transaction isolation is not active.

UDSASIZE(data-area)
• Returns, in bytes, the current size of private memory that is available, in 32-bit binary form.
• The value that is returned is the value of the TaskSharedPoolSize attribute.

XPRECVTIMEOUT(ptr-ref)
• Returns a pointer reference that is set to the address of the data area that contains the interval, in seconds, that CICS waits before timing out receive operations between CICS application servers and list processes.
• The default value that is returned is the value of the Region Definitions (RD) XPRecvTimeout attribute.

XRFSTATUS(cvda)
• Returns a CVDA value that indicates whether the current execution of CICS started as an active or alternate region under the extended recovery facility (XRF).
• The CVDA values are:
  • NOTAPPLIC
    • CICS is running without XRF support.
    • TXSeries for Multiplatforms always returns this value.
  • PRIMARY
    • CICS started as the active region.
  • TAKEOVER
    • CICS started as the alternate region.

Condições:

INVREQ
• RESP2 values:
  • The XPRECVTIMEOUT value is less than 0 (RESP2=33).