CEMT INQUIRE SYSTEM

Retrieve information about the CICS® system.

In the CICS Explorer, the Regions operations view provides a functional equivalent to this command.

Description

The INQUIRE SYSTEM command returns information about the CICS system.

Input

Press the Clear key to clear the screen, and type CEMT INQUIRE SYSTEM. The resulting display lists the current status. You can tab to the highlighted or blank fields and overtype them with the required values.

You can tab to the highlighted or blank fields and overtype them with the required values:

Overtype your changes on the INQUIRE screen after moving the cursor to the appropriate field (see Figure 1).
Use the CEMT SET SYSTEM command.

Sample screen

Figure 1. CEMT INQUIRE SYSTEM screen

  inq system                                                                   
 STATUS:  RESULTS - OVERTYPE TO MODIFY                                         
   Aging( 1000 )                  Progautoctlg( Ctlgmodify )       
   Akp( 04000 )                   Progautoexit( DFHPGADX )     
   Cicstslevel(050300)            Progautoinst( Autoactive )                   
   Cmdprotect(Nocmdprot)          Reentprotect(Reentprot)       
   Db2conn()                      Release(0700 )
   Debugtool( Nodebug )           Runaway( 0005000 )                                
   Dfltuser(WALSH)                Scandelay( 0500 )        
   Dsalimit( 07340032 )           Sdtran(CESD)                                 
   Dsrtprogram( NONE     )        Sosabovebar(Notsos)                          
   Dtrprogram( DFHDYP   )         Sosaboveline(Notsos)                         
   Dumping( Sysdump )             Sosbelowline(Notsos)                         
   Edsalimit( 0268435456 )        Storeprotect(Active)                         
   Forceqr( Noforce )             Time( 0001000 )                                   
   Logdefer( 00030 )              Tranisolate(Active)                               
   Maxtasks( 075 )
   Memlimit(Nolimit)                                                           
   MQconn ( )
   Mrobatch( 001 )                                                             
   Oslevel(011300)                                                             
                                                  
                                                                               
                                                     SYSID=HT63 APPLID=CICSHT63
  RESPONSE: NORMAL                             TIME:  16.00.11  DATE: 10.03.01 
PF 1 HELP       3 END       5 VAR        7 SBH 8 SFH 9 MSG 10 SB 11 SF

CEMT INQUIRE SYSTEM

Displayed fields

AGING (value)

Displays the time factor for CICS to use in the priority aging algorithm to increment the priority of a task. The value is expressed as milliseconds per unit of priority, and is in the range 0 - 65535.

The priority aging factor is defined initially by the PRTYAGE system initialization parameter, in which the value represents the number of milliseconds that must elapse before the priority of a waiting task can be adjusted upward by 1. See PRTYAGE.

You can reset this value by overtyping it with a different value.

AKP (value)

Displays the activity keypoint trigger value, which is the number of write requests to the CICS system log stream output buffer between the taking of keypoints. The value can be zero, meaning that activity keypointing is turned off, or be in the range 50 - 65535.

You can reset this value by overtyping it with a different value.

CICSTSLEVEL (value)

Displays a 6-character value identifying the version, release, and modification level of the CICS Transaction Server for z/OS® product under which the CICS region is running. The value is of the form vvrrmm. For example, CICS Transaction Server for z/OS, Version 5 Release 3 returns 050300.

CMDPROTECT (value)

Displays whether command protection, which validates start addresses passed on in CICS commands, is active (that is, whether the CMDPROT system initialization parameter specifies YES or NO). The values are as follows:

CMDPROT: Command protection is active. CICS checks to ensure that the task itself has write access to the storage referenced on the command before writing to the storage on behalf of the task.
NOCMDPROT: Command protection is not active. CICS does not check to ensure that the task itself has write access to the storage referenced on the command before writing to the storage on behalf of the task.

DB2CONN (value)

Displays the name of the currently installed DB2CONN resource definition. Only one DB2CONN definition can be installed at a time. The DB2CONN resource definition specifies the attributes of the connection between CICS and DB2®.

DEBUGTOOL(value)

Displays whether you can use debugging profiles to select the programs that run under the control of a debugging tool. The following debugging tools use debugging profiles:

Debug Tool, for compiled language application programs (programs written in COBOL, PL/I, C, C++, and Assembler)
Remote debugging tools (for compiled language application programs and Java™ programs)

Other debugging mechanisms, for example the CICS Execution Diagnostic Facility (CEDF), do not use debugging profiles.

The values are as follows:

DEBUG: You can use CICS debugging profiles to select the programs that run under the control of a debugging tool.
NODEBUG: You cannot use CICS debugging profiles to select the programs that run under the control of a debugging tool.

For more information about debugging profiles, see Debugging profiles.

DFLTUSER (value)

Displays the user ID of the default user for this instance of the CICS region.

DSALIMIT (value)

Displays the maximum amount of storage, as a total number of bytes, within which CICS can dynamically allocate storage for the four individual DSAs that reside below 16 MB (below the line). For more information, see DSALIM system initialization parameter.

If this parameter specifies a value lower than the current limit, CICS might not implement the new limit immediately, but attempts to do so over time as dynamic storage is freed in the individual DSAs.

You can reset this value by overtyping it with a different value.

DSRTPROGRAM (pgrmid)

Displays the name of the distributed routing program.

You can reset this value by overtyping it with a different value.

DTRPROGRAM (pgrmid)

Displays the name of the dynamic routing program.

You can reset this value by overtyping it with a different value.

DUMPING(value)

Displays whether CICS system dumps are suppressed. The values are as follows:

NOSYSDUMP: System dumps are suppressed.
SYSDUMP: System dumps are not suppressed.

These values are set by the SIT parameter DUMP=YES or DUMP=NO.

EDSALIMIT (value)

Displays the maximum amount of storage, as a total number of bytes, within which CICS can dynamically allocate storage for the individual DSAs that reside above 16 MB but below 2 GB (above the line). For more information, see EDSALIM system initialization parameter.

You can reset this value by overtyping it with a different value.

FORCEQR (value)

Displays whether CICS forces all CICSAPI user application programs that are defined as threadsafe to run on the quasi-reentrant (QR) TCB. The values are as follows:

FORCE: CICS forces all user application programs specified with the CONCURRENCY(THREADSAFE) attribute to run under the QR TCB, as if they were specified with CONCURRENCY(QUASIRENT). The FORCE option does not apply to certain programs, for example OPENAPI programs, or C or C++ programs compiled with XPLINK. For details, see FORCEQR system initialization parameter.
NFORCE: CICS honors the CONCURRENCY(THREADSAFE) attribute on CICSAPI user application programs, and allows user programs to run on an open TCB to avoid unnecessary TCB switching.

LOGDEFER (value)

Displays the log deferral interval in milliseconds, which is the period of time used by CICS Log Manager when determining how long to delay a forced journal write request before invoking the MVS™ system logger. It is in the range 0-65535. This interval is the period of time used by CICS Log Manager to determine how long to delay a forced journal write request before invoking the MVS system logger. The value is in the range 0 - 65535. For more information, see LGDFINT system initialization parameter.

You can reset this value by overtyping it with a different value.

MAXTASKS (value)

Displays the maximum number of user tasks, running, dispatchable, and suspended, allowed at any one time in the CICS system. The value is in the range 1 - 2000.

You can reset this value by overtyping it with a different value.

Note: If you reset this value, the value assigned to MAXTASKS might be less than the requested value, because of CICS storage constraints. If this situation occurs, the message CEILING REACHED is displayed when the request is made.

MEMLIMIT (value)

Displays the limit of storage above the bar for use by the CICS region. A value of NOLIMIT indicates that no limit is imposed on the amount of storage that the region can attempt to use.

MQCONN(value)

Displays the name of the MQCONN resource definition that is currently installed for the CICS region. If no MQCONN resource definition is currently installed, the field is blank. Only one MQCONN resource definition can be installed at a time in a CICS region. The MQCONN resource definition specifies the attributes of the connection between CICS and WebSphere® MQ.

MROBATCH (value)

Displays the number of MRO requests from connected regions that are batched before this region is posted. The value is in the range 1 - 255.

You can reset this value by overtyping it with a different value.

OSLEVEL (value)

Displays the version, release, and modification level of z/OS on which CICS is running. The value is of the form vvrrmm. For example, for z/OS, Version 1 Release 13 Modification 0, the value is 011300.

PROGAUTOCTLG

Displays whether autoinstalled program definitions are cataloged. The values are as follows:

CTLGALL: All autoinstalled program definitions are cataloged and restored on a warm or emergency start.
CTLGMODIFY: Autoinstalled program definitions are cataloged only if they are modified (for example, by a CEMT SET PROGRAM command), so that the modified definitions are restored on a warm or emergency restart.
CTLGNONE: No autoinstalled program definitions are cataloged. They are autoinstalled again after a warm or emergency start.

You can reset this value by overtyping it with a different value.

PROGAUTOEXIT (value)

Displays the name of the user-provided program that the program autoinstall code calls to select or modify a model definition.

You can reset this value by overtyping it with a different value.

PROGAUTOINST

Displays whether autoinstall for programs is active or inactive. The values are as follows:

AUTOACTIVE: Autoinstall for programs is active. On first use, if a program, map set, or partition set is not defined, the definition is created dynamically.
AUTOINACTIVE: Autoinstall is not active. If a program is not defined, a PGMIDERR or transaction abend occurs when it is referenced.

You can reset this value by overtyping it with a different value.

REENTPROTECT (value)

Displays whether read-only storage is in use for reentrant programs (that is, whether the RENTPGM system initialization parameter specifies PROTECT or NOPROTECT). The values are as follows:

NOREENTPROT: CICS allocates storage for the read-only DSAs (RDSA and ERDSA) from CICS-key storage. Reentrant programs do not have the protection of residing in read-only storage, and can be modified by programs executing in CICS key.
REENTPROT: CICS allocates storage for the RDSA and ERDSA from key-0, non-fetch protected, storage. CICS loads reentrant programs into this storage, and the programs are protected by residing in read-only storage.

RELEASE (value) (SUPPORTED FOR COMPATIBILITY ONLY)

Displays a 4-digit number (value 0700 for this release of CICS TS) that represents the level of the CICS code running this region.

This field is maintained for compatibility with previous releases of CICS only. As an exclusive element of CICS Transaction Server for z/OS, CICS does not have a product version and release number of its own. To determine the release number of the product, see the CICSTSLEVEL value.

RUNAWAY (value)

Displays the interval, in milliseconds, for which a task can have control before it is assumed to be looping.

If you reset this value, you can specify 0 or a value in the range 500 - 2700000. The value you specify is rounded down to a multiple of 500.

CICS purges a task if the task has not given up control after this interval (that is, CICS assumes that the task is looping). If you specify zero, runaway task control is inoperative (that is, tasks do not get purged if they appear to be looping). The value is independent of, and can be less than, the TIME value.

CICS runaway-task detection is based upon task time (that is, the interval is reset each time a task receives control of the processor, and is then decremented while the task is in control). You do not, therefore, need to allow for the effect of other jobs when setting the runaway value.

You can reset this value by overtyping it with a different value.

SCANDELAY (value)

Displays the maximum number of milliseconds between the receipt of a z/OS Communications Server request, and the time when CICS begins to process the request. The number is in the range 0 - 5000, and is less than or equal to the TIME value.

In the summary report of the dispatcher statistics, the SCANDELAY value is referred to as the ICVTSD time value.

You can reset this value by overtyping it with a different value.

SDTRAN (value)

Displays the 4-character name of the transaction to be run at the beginning of normal or immediate shutdown. This value can be the name of a user-supplied transaction, or the CICS-supplied default transaction, CESD.

SOSABOVEBAR(value)

Displays whether CICS is short on storage in the dynamic storage areas above the bar.

NOTSOS: CICS is not short on storage in any of the dynamic storage areas above the bar.
SOS: CICS is short on storage in at least one of the dynamic storage areas above the bar.

SOSABOVELINE(value)

Displays whether CICS is short on storage in the dynamic storage areas above 16 MB but below 2 GB (above the line).

NOTSOS: CICS is not short on storage in any of the dynamic storage areas above 16 MB but below 2 GB.
SOS: CICS is short on storage in at least one of the dynamic storage areas above 16 MB but below 2 GB.

SOSBELOWLINE(value)

Displays whether CICS is short on storage in the dynamic storage areas below 16 MB (below the line).

NOTSOS: CICS is not short on storage in any of the dynamic storage areas below 16 MB.
SOS: CICS is short on storage in at least one of the dynamic storage areas below 16 MB.

STOREPROTECT (value)

Displays whether storage protection is active in the CICS region. The values returned are:

ACTIVE: CICS is operating with the CICS storage protection facility.
INACTIVE: CICS is operating without the CICS storage protection facility.

See STGPROT system initialization parameter for more information about CICS storage protection.

TIME (value)

Displays the interval, in milliseconds, for which CICS releases control to the operating system if no transactions are ready to resume processing. This interval is known as the region exit interval.

The value can be in the range 100 - 3600000, and must be greater than or equal to the SCANDELAY value.

In the summary report of the dispatcher statistics, the TIME value is referred to as the ICV time value.

You can reset this value by overtyping it with a different value.

TRANISOLATE

Displays the status of transaction isolation. The values returned are:

ACTIVE: Transaction isolation is active in the CICS region.
INACTIVE: CICS is running without transaction isolation, either because the support is not available, or it was not requested at CICS initialization.