CICS regions - CICSRGN

The CICS region (CICSRGN) views display information about CICS systems being managed by CICSPlex SM. When a CICS system is part of an extended recovery facility (XRF) configuration, the information displayed is for the active CICS system in the configuration.

Supplied views

To access from the main menu, click:

CICS operations views > CICS region operations views > CICS regions

Table 1. Views in the supplied CICS region (CICSRGN) view set
View Notes
CICS region

EYUSTARTCICSRGN.DELETSHIPPED

Delete redundant terminal definitions from the selected CICS system
CICS region

EYUSTARTCICSRGN.DETAIL1

Detailed view about trace and dump information for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAIL10

Detailed view of TCBs.
CICS region

EYUSTARTCICSRGN.DETAIL2

Detailed view about transaction activity for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAIL3

Detailed view about autoinstall details for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAIL5

Detailed view about communications and connections for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAIL6

Detailed view about settings for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAIL7

Detailed view about logging and journaling activity for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAIL8

Detailed view about system and transaction dumps for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAIL9

Detailed view about jobname for a CICS region.
CICS region

EYUSTARTCICSRGN.DETAILED

Detailed general information about a selected CICS system.
CICS region

EYUSTARTCICSRGN.RESETTIME

Reset internal clock of the selected CICS system.
CICS region

EYUSTARTCICSRGN.SECREBUILD

Rebuild the in-storage external security manager (ESM) profiles for a CICS system, provided they reside in local storage. The copies of the profiles that reside in the managing CMAS are also rebuilt. Note:This action cannot rebuild ESM profiles that reside in global storage. You must use the facilities provided by your ESM to refresh those profiles.
CICS region

EYUSTARTCICSRGN.SET

Change the attributes of a selected CICS region.
CICS region

EYUSTARTCICSRGN.SHUTDOWN

Shut down a selected CICS system.

Specify the type of shutdown, whether or not you want a dump to be taken, whether or not the CICS system should be restarted automatically, and, optionally, the 2-character suffixes of the program list table (PLT) and transaction list table (XLT) to be used.

You can also specify a shutdown assist transaction name. This transaction will override the transaction specified in the SDTRAN system initialization parameter. Alternatively, you can select No shutdown assist transaction to shut down the CICS system without any transaction.

CICS region

EYUSTARTCICSRGN.SNAP

Request a system dump.

Specify a 1- to 8-character dump code and, optionally, a 1- to 8-character caller ID and a title of up to 79 characters.

CICS region

EYUSTARTCICSRGN.SSLREBUILD

Rebuild the z/OS SSL environment. This will refresh the key ring cache which allows new or revised SSL certificates to be used without performing a CICS restart.
CICS region

EYUSTARTCICSRGN.STATISTICS

Request statistical data for the CICS system to a system management facility (SMF) data set.

To request statistics for all resources in a CICS system, select the Collect all statistics field. To request statistics for selected resources, select one or more individual resource fields. You can also reset the statistics after they have been collected by selecting Reset statistics counters.

CICS region

EYUSTARTCICSRGN.SWITCH

Set automatic switching for auxiliary trace data sets when full.
CICS region

EYUSTARTCICSRGN.TABULAR

Tabular information about CICS systems.
CICS region

EYUSTARTCICSRGN.TABULAR1

Tabular information about CICS system and transaction dumps.

Actions

Table 2. Actions available for CICSRGN views
Action Description
ARMRESTART Request an MVS CANCEL of the CICS system with an ARM restart. Note that this action will complete successfully even if the MVS CANCEL command fails. The user ID associated with the CMAS (not the API user) must have the appropriate security access in order to issue the MVS CANCEL command successfully.

This action is not available in an SMSS.

DELETSHIPPED Delete redundant terminal definitions from the selected CICS system
RESETTIME Reset internal clock of the selected CICS system.
SECREBUILD Rebuild the in-storage external security manager (ESM) profiles for a CICS system, provided they reside in local storage. The copies of the profiles that reside in the managing CMAS are also rebuilt. Note:This action cannot rebuild ESM profiles that reside in global storage. You must use the facilities provided by your ESM to refresh those profiles.
SET Change the attributes of a selected CICS region.
SHUTDOWN Shut down a selected CICS system.

Specify the type of shutdown, whether or not you want a dump to be taken, whether or not the CICS system should be restarted automatically, and, optionally, the 2-character suffixes of the program list table (PLT) and transaction list table (XLT) to be used.

You can also specify a shutdown assist transaction name. This transaction will override the transaction specified in the SDTRAN system initialization parameter. Alternatively, you can select No shutdown assist transaction to shut down the CICS system without any transaction.

SNAP Request a system dump.

Specify a 1- to 8-character dump code and, optionally, a 1- to 8-character caller ID and a title of up to 79 characters.

SSLREBUILD Rebuild the z/OS SSL environment. This will refresh the key ring cache which allows new or revised SSL certificates to be used without performing a CICS restart.
STATISTICS Request statistical data for the CICS system to a system management facility (SMF) data set.

To request statistics for all resources in a CICS system, select the Collect all statistics field. To request statistics for selected resources, select one or more individual resource fields. You can also reset the statistics after they have been collected by selecting Reset statistics counters.

SWITCH Set automatic switching for auxiliary trace data sets when full.

Fields

Table 3. Fields in CICSRGN views
Field Attribute name Description
Number of currently allocated HP pool TCBs ACTHPTCBS The actual number of H8 mode open TCBs currently allocated to user tasks.
Number of currently allocated JVM pool TCBs ACTJVMTCBS The actual number of J8 and J9 mode open TCBs currently allocated to user tasks. This attribute is obsolete from CICS Transaction Server 5.1 onwards.
Number of currently allocated Open pool TCBs ACTOPENTCBS The total number of L8 and L9 mode open TCBs currently allocated to user tasks.
Number of currently allocated SSL pool TCBs ACTSSLTCBS The total number of S8 mode open TCBs currently allocated to user tasks.
Number of currently allocated JVM server thread TCBs ACTTHRDTCBS The total number of T8 mode open TCBs currently allocated to the enabled JVM server runtime environments.
Number of currently allocated XPLink pool TCBs ACTXPTCBS The total number of X8 and X9 mode open TCBs currently allocated to user tasks.
Number of current autoinstall requests AINSCREQ The number of autoinstall requests that are currently being processed.
Maximum number of autoinstall requests AINSMREQ The maximum number of autoinstall requests that are allowed to queue at any one time.

Input Values: 0 - 999

Autoinstall program name AINSPROG The name of the program that controls the autoinstall process for this system.

Input Values: Any valid program name

Autoinstall enabled status AINSSTAT The status of the autoinstall process (ENABLED or DISABLED).
Activity keypoint (AKP) frequency AKP The activity keypoint (AKP) trigger value, which is the number of logging operations between the taking of keypoints.

Input Values: 50 - 65535

This field is not modifiable when it contains a value of N/A, which means the activity keypoint facility is not active in the CICS system.

Maximum number of active tasks AMAXTASKS The maximum number of active tasks allowed in the system at one time.

Input Values: 2 - 999

VTAM application ID APPLID The VTAM application ID of this CICS system.
Auxiliary trace status AUXSTATUS The status of auxiliary tracing in this CICS system.

Input Values: AUXSTART, AUXSTOP, AUXPAUSE

Number of BMS 3270 validation errors abended BMSVALABCNT The total number of times invalid 3270 data was received on a BMS command, where the validation URM chose to abend the task.
BMS 3270 validation BMSVALIDATE Whether BMS 3270 validation is enabled.
Number of BMS 3270 validation errors ignored BMSVALIGCNT The total number of times invalid 3270 data was received on a BMS command, which the validation URM chose to ignore.
Number of BMS 3270 validation errors logged BMSVALLGCNT The total number of times invalid 3270 data was received on a BMS command, which the validation URM chose to log.
CICS status CICSSTATUS The current status of this CICS system:
  • STARTUP - CICS is starting up but is not yet fully active. Programs in the program list table for program initiation (PLTPI) are run during startup.
  • FIRSTINIT - CICS is in the first stage of initialization.
  • SECONDINIT - CICS is in the second stage of initialization. This stage corresponds to the period when first phase PLTPI programs are run; that is those programs in a PLT that are defined before the DFHDELIM statement.
  • THIRDINIT - CICS is in the third stage of initialization. This stage corresponds to the period when second phase PLTPI programs are run; that is those programs in a PLT that are defined after the DFHDELIM statement.
  • INITCOMPLETE - CICS initialization is complete.
  • ACTIVE - CICS is fully active.
  • FIRSTQUIESCE - CICS is in the first quiesce stage of shutdown. Programs in the first stage of the program list table for shutdown (PLTSD) are run during this stage.
  • FINALQUIESCE - CICS is in the final quiesce stage of shutdown. Programs in the second stage of the PLTSD are run during this stage.
  • CONTROLSHUT - CICS is in the process of a normal shutdown with a warm keypoint.
  • SHUTDOWN - CICS is in the process of an immediate shutdown.
  • CANCELLED - CICS is in the process of an uncontrolled shutdown.
CICS operating system ID CICSSYS The CICS operating system identification code.
Command protection status CMDPROTECT Indicates whether command protection, which validates the starting addresses passed from CICS commands, is active:
  • CMDPROT - Command protection is active.
  • NOCMDPROT - Command protection is not active.
Cold start status COLDSTATUS The system's cold start state (COLD, INITIAL, or NOTAPPLIC).
Autoinstall console status CONSOLES Indicates whether CICS is to autoinstall an MVS console when it receives an MVS MODIFY command from a console that is not currently defined.

Input values: NOAUTO, FULLAUTO, PROGAUTO

Separate conversational task performance records CONVERSEST Indicates whether conversational tasks have separate performance class records produced for each pair of terminal I/O requests.

Input Values: CONVERSE, NOCONVERSE

Total CPU time used CPUTIME The amount of CPU time, in seconds, used by this CICS since startup.
CICS Transaction Server level CTSLEVEL The level of the CICS Transaction Server that this CICS system is running.
Current number of active user transactions CURACTVUSRTR The number of user transactions currently active in the transaction class.
Current auxiliary trace dataset CURAUXDS Identifies the current auxiliary trace data set (A or B).
Current number of queued user transactions CURQUEDUSRTR The number of user transactions queued and waiting for entry into the transaction class.
Time currently queued transactions waiting CURQUETIME The amount of time that currently queued transactions have spent waiting for this transaction class.
Current number of user tasks eligible for dispatch CURRAMAX The current number of user tasks that are eligible for dispatching.
Current dump data set CURRENTDDS Indicates which of the dump data sets is active (A or B).
Current number of tasks CURRTASKS The current number of active user tasks in the system.

The number shown may exceed the current value of MAXTASKS because the count includes tasks that are unable to start because the MAXTASKS limit or the MAXIMUM limit of a transaction class has been reached.

Number of MVS task control blocks (TCBs) CUTCBCNT The number of MVS task control blocks (TCB) attached by CICS in this region.
Dump data set open status DDSOSTAT Indicates whether the active CICS dump data set is open or closed.

Input Values: OPEN, CLOSED, SWITCH

Dump data set switch type DDSSSTAT Indicates whether there is to be an automatic switch to the inactive dump data set when the active dump data set becomes full.

Input Values: SWITCHNEXT, NOSWITCH

Debugging profiles status DEBUGTOOL Indicates whether or not debugging profiles are used to select the programs that will 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, such as the CICS Execution Diagnostic Facility (CEDF) do not use debugging profiles.
Default remote system DFLTREMSYS The default remote system for this CICS system.
Default user ID DFLTUSER The default user ID associated with the CICS system.
Minimum terminal idle-time before deletion DSIDLE The minimum time that an inactive shipped terminal definition must remain installed in this region. When the CICS timeout delete mechanism is invoked, only those shipped definitions that have been inactive for longer than this time are deleted.
Idle terminal check interval DSINTERVAL The interval between invocations of the CICS timeout delete mechanism. The timeout delete mechanism removes any shipped terminal definitions that have not been used for longer than the time displayed by the IDLE option.
Distributed routing program DSRTPROGRAM The name of the program controlling the distributed routing of transactions in this system.
Dynamic routing program name DTRPROGRAM The name of the program controlling the dynamic routing of transactions in this system.

Input Values: Any valid program name

Statistics end-of-day time ENDOFDAY The end-of-day time for recording CICS statistics. At end-of-day, the statistics counters are written out to an SMF data set and the counters are reset. The end-of-day time is expressed as a local time.

Input Values: 00:00:00 - 23:59:59

SYSEVENT monitoring status EVENTCLASS Indicates whether the sysevent class of CICS monitoring data is being collected.

Input Values: EVENT, NOEVENT

Exception class monitoring status EXCEPTCLASS Indicates whether the execption class of CICS monitoring data is being collected.

Input Values: EXCEPT, NOEXCEPT

Exit wait time EXITTIME The maximum interval, in milliseconds, for which CICS gives control to the operating system if no transactions are ready to execute.

Input Values: 100 - 3600000

External security status EXTSEC Indicates whether an external security manager (ESM) is active in this system.
Force quasi-reentrancy FORCEQR Specifies whether you want to force all user application programs specified as CONCURRENCY(THREADSAFE) to run under the CICS QR TCB, as if they were specified as CONCURRENCY(QUASIRENT) programs.

This allows you, in a test environment, to run incompletely tested threadsafe application programs that have proved to be non-threadsafe.

FORCEQR applies to all programs defined as threadsafe that are not invoked as task-related user exits, global user exits, or user-replaceable modules.
  • FORCE - All user programs defined as threadsafe are to be forced to run under the CICS QR TCB, as if they were specified as CONCURRENCY(QUASIRENT) programs.
  • NOFORCE - CICS is to honor the CONCURRENCY(THREADSAFE) attribute defined on program resource definitions, and allows user application programs to run on an open TCB to avoid unnecesary TCB switching.
Performance record interval FREQUENCY The interval for which CICS automatically produces a transaction performance class record for any long-running transaction.

Input Values: 0, 00:15:00 - 24:00:00

Web domain garbage collection interval GARBAGEINT The interval, in minutes, at which the web garbage collection task runs to clean up Web 3270 state data for which the terminal timeout interval has expired.

Input Values: 1 - 6000

Good morning message length GMMLENGTH The length of the good morning message that appears when a user signs on to native CICS.
Good morning message GMMTEXT The text of the good morning message that appears when a user signs on to native CICS.
Good morning transaction ID GMMTRANID The 4-character identifier of the CICS good morning transaction.
CICS registered generic name GRNAME The Generic Resource group name under which this CICS region requests registration to VTAM.
Generic resource registration status GRSTATUS The status of VTAM Generic Resource registration.

If you set the status to DEREGISTERED you may also need to end affinities. See the CICS Intercommunication Guide for further information.

  • DEREGERROR - Deregistration was attempted but was unsuccessful, and there has been no attempt to reregister.
  • DEREGISTERED - Deregistration was successfully accomplished.
  • NOTAPPLIC - CICS is not using the generic resource feature; GRNAME is not set or is set to blanks.
  • REGERROR - Registration was attempted but was unsuccessful, and there has been no attempt to deregister.
  • REGISTERED - Registration was successful and there has been no attempt to deregister.
  • UNAVAILABLE - VTAM does not support the generic resource function.
  • UNREGISTERED - CICS is using the generic resource function but no attempt, as yet, has been made to register.
Generalized Tracing Facility (GTF) trace status GTFSTATUS The status of CICS tracing to the MVS Generalized Tracing Facility (GTF).

Input Values: GTFSTART, GTFSTOP

Identity class status IDNTYCLASS Indicates whether the identity class of monitoring data is to be recorded when monitoring is active. Values are:
  • NOIDNTY - Identity data is not to be recorded.
  • IDNTY - Identity data is to be recorded.
Initial dump data set INITIALDDS Indicates which of the dump data sets is to be used during the next CICS initialization. A value of X means whichever dump data set (A or B) was not in use the last time CICS shut down (either normally or abnormally) is to be opened first.

Input Values: A, B, X

Initialization status INITSTATUS The initialization status of the CICS system:
  • INITCOMPLETE - Initialization is complete.
  • SECONDINIT - Second stage of CICS initialization.
  • THIRDINIT - Third stage of CICS initialization.
Statistics recording interval INTERVAL The interval during which the CICS statistics counters are incremented. At the end of each interval, the accumulated statistics are recorded and the counters are reset.

Input Values: 00:01:00 - 24:00:00

Internal trace status INTSTATUS The status of internal tracing in this CICS system.

Input Values: INTSTART, INTSTOP

Transactions run since last CICS statistics reset INTVTRANS The number of tasks run since the last CICS statistics reset.
Interregion communication (IRC) status IRCSTAT The status of interregion communication (IRC) in the system.

Input Values: OPEN, CLOSED, IMMCLOSE

MVS job ID JOBID The MVS job ID of this CICS system.
MVS job name JOBNAME The MVS job name of this CICS system.
Last statistics reset time LASTRESET The last time CICS statistics were reset. This is expressed as local time.
LIBRARY search order updates LDGLBSOU The number of LIBRARY search order updates.
LIBRARY search order update time LDGLSORT The amount of time spent updating the LIBRARY search order.
Load requests waited due to search order update LDGLWSOU The number of waits for a program load due to LIBRARY search order updates.
Number of times maximum suspended tasks reached LOADHWMC The number of times the maximum number of suspended tasks was reached.
Peak number of tasks waiting for load requests LOADHWMW The maximum number of tasks suspended and waiting for loader domain requests to be satisfied at any one time.
Number of programs on not-in-use queue LOADPNIU The number of programs on the not-in-use (NIU) queue.
Number of load requests LOADREQS The number of times the loader has issued an MVS LOAD request to load programs from the DFHRPL library concatenation, or a dynamic program LIBRARY, into CICS-managed storage.
Number of reclaims from not-in-use queue LOADRNIU The number of reclaims CICS has made from the Not-in-Use (NIU) queue. Reclaims occur when a request is issued for programs currently in the NIU queue.
Total loading time LOADTIME The time taken for all library load requests.
Total time to remove not-in-use programs LOADTNIU The total amount of time spent waiting on those transactions that were queued in the transaction class.
Total load waiting time LOADWAIT The total amount of time suspended tasks spent waiting for loader domain requests to be satisfied.
Number of tasks waiting for load requests LOADWCNT The total number of tasks that have been suspended and forced to wait for loader domain requests to be satisfied.
Number of LUs currently logged on LUCURR The number of logical users currently logged on.
Highest number of LUs logged on at any one time LUHWM The highest number of logical users logged on at any one time.
Maximum number of HP pool TCBs MAXHPTCBS The maximum number of H8 mode open TCBs that CICS is allowed to attach and maintain in its pool of H8 mode TCBs.
Maximum number of JVM pool TCBs MAXJVMTCBS The maximum number of J8 and J9 mode open TCBs that CICS is allowed to attach and maintain in its pool of J8 mode TCBs. This attribute is obsolete from CICS Transaction Server 5.1 onwards.
Maximum number of Open pool TCBs MAXOPENTCBS The maximum number of L8 and L9 mode open TCBs that can exist concurrently in the CICS region. In CICS Transaction Server 5.1, the value is set by CICS and is not alterable.
Maximum number of SSL pool TCBs MAXSSLTCBS The maximum number of S8 mode open TCBs that can exist concurrently in the CICS region.
Maximum number of active and suspended tasks MAXTASKS The maximum number of tasks, both active and suspended, allowed in the system at one time.

Input Values: 1 - 999 (CICS TS version 4.2 and earlier) or 10 - 2000 (CICS TS version 5.1 onwards)

CICSPlex SM uses a minimum of 6 tasks and may use as many as 16, depending on:
  • How much resource monitoring is active
  • How many real-time analysis status definitions (STATDEFs) are active
Make sure the value in this field is high enough to accommodate all possible CICSPlex SM activity at your enterprise.
Maximum number of JVM server thread TCBs. MAXTHRDTCBS The maximum number of T8 mode open TCBs that CICS is allowed to attach and maintain in its pool of T8 mode TCBs. It is the sum of the maximum number of threads for each JVMSERVER, up to a limit of 2000. For each JVMSERVER the value of threadlimit+1 is taken.
Number of times MAXTASK limit reached MAXTRCNT The number of times the MAXTASK limit has been reached.
Maximum number of XPLink pool TCBs MAXXPTCBS The maximum number of X8 and X9 mode open TCBs that can exist concurrently in the CICS region. In CICS Transaction Server 5.1 this value is set by CICS and it is not alterable.
Maximum amount of above the bar storage MEMLIMIT Maximum amount of above the bar storage that CICS can use.

A value of 'N/A' means there is no limit to the amount of storage above the bar that CICS can use.

Time zone for performance class records MONRPTTIME The time stamp format for performance class records as either Greenwich mean time (GMT) or local time (LOCAL).
Monitor status MONSTAT The status of CICS monitoring in the system.

Input Values: ON, OFF

Number of MRO requests to be batched MROBATCH The number of MRO requests from connected systems that are to be batched before this system is posted.

Input Values: 1 - 255

MVS system ID MVSSYSID The SMF ID of the MVS system where this CICS is running.
MVS system name MVSSYSNAME The name of the MVS system where this CICS is running.
Next statistics recording time NEXTTIME The time at which CICS statistics are next recorded and reset. This time is either the expiration of the current interval or the end-of-day time, whichever is earlier. This is expressed as local time.
Operating system release OPREL The operating system release that the CICS system is running under.
Operating system OPSYS The name of the operating system that the CICS system is running under.
OS/390 level OSLEVEL The level of the OS/390 operating system running on the machine where this CICS system is running. If you are running a CICS that has this field available and a level of MVS earlier than OS/390, blanks are displayed in this field.
Number of page-in requests PAGEIN The number of page-in requests made by this CICS since startup.
Number of page-out requests PAGEOUT The number of page-out requests made by this CICS since startup.
Peak number of user tasks eligible for dispatch PEAKAMAX The highest number of user tasks concurrently eligible for dispatching at any one time.
Peak number of tasks in system PEAKTASKS The highest number of tasks concurrently in the system at any one time.
Peak number of active user transaction PEKACTVUSRTR The highest number of active user transactions in the transaction class at any one time.
Peak number of queued user transactions PEKQUEDUSRTR The highest number of queued user transactions in the transaction class at any one time.
Performance class monitoring status PERFCLASS Indicates whether the performance class of CICS monitoring data is being collected.

Input Values: PERF, NOPERF

Last reset time PLASTRESET The last reset time expressed in local time.
Number of programs removed by compression PRGMRCMP The number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) facility.
Number of program uses PRGMUCNT The number of uses of any program by this CICS system.
Number of waiting loader requests PRGMWAIT The current number of tasks that are suspended while waiting for loader domain requests to be satisfied.
Number of program autoinstall attempts PROGAUTOATTM The number of program autoinstall attempts.
Autoinstalled-program catalog type PROGAUTOCTLG Indicates whether autoinstalled program definitions should be cataloged.

Input Values: CTLGALL CTLGMODIFY, CTLGNONE

Autoinstall program exit name PROGAUTOEXIT The name of the user-provided program that is called by the program autoinstall code to select or modify a model definition. The default name is DFHPGADX.
Number of failed program autoinstall attempts PROGAUTOFAIL The number of program autoinstall requests that have failed.
Status of autoinstall for programs PROGAUTOINST Indicates whether or not autoinstall is active for programs.

Input Values: AUTOACTIVE, AUTOINACTIVE

Number of times autoinstall prog request rejected PROGAUTOXREJ The number of times autoinstall program request were rejected.
Number of persistent sessions already unbound PRSSERRORCNT The total number of persistent sessions that were already unbound when CICS tried to restore them.
Number of CICS persistent-session inquiries PRSSINQCNT The total number of times CICS issued an INQUIRE OPTCD=PERSESS.
Number of VTAM sessions that persisted PRSSNIBCNT The total number of VTAM sessions that persisted.
Number of persistent sessions successfully restored PRSSOPNCNT The total number of persistent sessions that were successfully restored.
Number of persistent sessions that were terminated PRSSUNBNDCNT The number of persistent sessions that were terminated.
Priority aging value PRTYAGING A factor used internally to relate a task's priority to its wait time.

Input Values: 0 - 65535

Persistent session delay interval PSDINTERVAL The persistent session delay interval, which determines if, and for how long, sessions are held in recovery-pending state after a CICS failure.

Input Values: 00:00:00 - 23:59:59

Persistent session type PSTYPE Specifies if CICS is running with VTAM single node persistent sessions (SNPS), multi node persistent sessions, or no persistent sessions (NOPS).
Number of times LIBRARY reopened and load retried RDEBRBLD The number of times the loader received an end-of-extent condition during a LOAD, successfully closed and re-opened the DFHRPL or dynamic LIBRARY concatenation and retried the load.
Real storage in use REALSTG The number of 1 kilobyte frames of real storage currently in use by this CICS.
Interval statistics recording status RECORDING Controls the recording of interval and unsolicited statistics. End-of-day and requested statistics are always recorded, regardless of this value.

Input Values: ON, OFF

Reentrant program protection status REENTPROTECT Indicates whether storage for reentrant programs (the RDSA and ERDSA) is in key 0 or CICS key. MVS key 0 storage is write protected from programs running in CICS key or user key; programs in CICS key storage are protected only from those running in user key when CICS key and user key are different (that is, when storage protection is active):
  • REENTPROT - Read-only DSAs are in key 0 storage.
  • NOREENTPROT - Read-only DSAs are in CICS-key storage.
Region user ID REGIONUSERID The user ID the CICS region is running under.
CICS Release RELEASE The CICS release of the displayed CICS system.
Record level sharing (RLS) status RLSSTATUS Indicates whether the VSAM record level sharing (RLS) facility is active for this CICS system:
  • RLSACTIVE - CICS has registered with an SMSVSAM server and RLS is currently active.
  • RLSINACTIVE - CICS has registered with an SMSVSAM server, but RLS is currently not active because of an SMSVSAM server failure.
  • NOTAPPLIC - The CICS system does not support VSAM RLS because it was started with RLS=NO specified.
Resource recovery management service (RRMS) status RRMSSTAT Indicates the status of the MVS resource recovery management services as reported by this CICS region, for this MVS image
Runaway time interval RUNAWAY The amount of time, in milliseconds, that any task can have control of the processor before it is considered to be in a runaway condition.

Input Values: 0, 250 - 2700000

Terminal scan delay time SCANDELAY The maximum number of milliseconds between a user task making a terminal I/O request and the CICS terminal control task being dispatched to process the request.

Input Values: 0 - 5000

Number of system dumps suppressed SDMPSUPP The number of system dumps requested by CICS or a user that were suppressed by a user exit, the dump table, or a global system dump suppression.
Number of system dumps taken SDMPTOTL The number of system dumps taken by the whole system since the last CICS end-of-day statistics reset. This number does not include suppressed dumps.
Shutdown transaction SDTRAN The name of the transaction to be run at the beginning of a normal or immediate shutdown.
Shutdown status SHUTSTATUS The shutdown status of the CICS system:
  • CONTROLSHUT - Normal shutdown with a warm keypoint.
  • NOTAPPLIC - CICS not in shutdown mode.
  • SHUTDOWN - Immediate shutdown in progress.
Single task trace status SINGLESTATUS The status of the flag that controls user tracing from the issuing task.

Input Values: SINGLEON, SINGLEOFF

Number of I/O requests SIOREQ The number of start I/O (SIO) requests made by this CICS since startup.
Short on storage status above the bar SOSABOVEBAR Indicates whether there is a short on storage condition:
  • NOTSOS - CICS is not short on storage above the bar.
  • SOS - CICS is short on storage above the bar.
Short on storage status above the line SOSABOVELINE Indicates whether there is a short on storage condition:
  • NOTSOS - CICS is not short on storage above the line.
  • SOS - CICS is short on storage above the line.
Short on storage status below the line SOSBELOWLINE Indicates whether there is a short on storage condition:
  • NOTSOS - CICS is not short on storage below the line.
  • SOS - CICS is short on storage below the line.
Short on storage status below the bar SOSSTATUS Indicates whether there is a short on storage condition:
  • NOTSOS - CICS is not short on storage in any of the dynamic storage areas.
  • SOS - CICS is short on storage in at least one of the dynamic storage areas above and below 16MB.
  • SOSABOVE - CICS is short on storage in at least one of the dynamic storage areas above 16MB
  • SOSBELOW - CICS is short on storage in at least one of the dynamic storage areas below 16MB.

Note: This field does not apply to above the bar storage.

Startup type STARTUP The system's startup state (COLDSTART, WARMSTART, EMERGENCY, or LOGTERM).
Date on which CICS started STARTUPDATE The date on which this run of CICS was started. The date is expressed in local time.
Storage protection status STGPROT Indicates whether storage protection is active in this system.
CICS start time STRTTIME The time at which the dispatcher started, which can be considered the approximate time at which this run of CICS started. This is expressed as local time.
Subsystem ID used on SYSEVENT class records SUBSYSTEMID The name used as the subsystem identification in the MVS workload activity reports. The subsystem identification defaults to the first 4 characters of the VTAM generic APPLID.

This is obsolete from CICS TS Version 3 Release 2.

Value set by the SUBTSKS system initialization parameter SUBTASKS The value set by the SUBTSKS system initialization parameter, which can be either 0 or 1.
Auxiliary trace data set switch type SWITCHSTATUS Controls whether automatic data set switching occurs when the current auxiliary trace data set becomes full.

Input Values: SWITCHNEXT, SWITCHALL, NOSWITCH

Performance record at syncpoint SYNCPOINTST Indicates whether performance records are written at a syncpoint.

Values: SYNCPOINT, NOSYNCPOINT

System dump status SYSDUMP Indicates whether the taking of CICS system dumps is globally suppressed.

Input Values: SYSDUMP, NOSYSDUMP

CICS system ID SYSID The system ID of this CICS system.
System trace status SYSTEMSTATUS The status of the system master trace flag.

Input Values: SYSTEMON, SYSTEMOFF

Internal trace table size TABLESIZE The size of the internal trace table in kilobytes.

Input Values: 16 - 1048576

CICS VTAM exit trace status TCEXITSTATUS The status of tracing for CICS-VTAM exits.

Input Values: TCEXITALL, TCEXITSYSTEM, TCEXITNONE, TCEXITALLOFF

TCP/IP status TCPIP The status of CICS internal sockets support (TCP/IP).

Input Values: OPEN, CLOSED, IMMCLOSE

Number of transaction dumps suppressed TDMPSUPP The number of transaction dumps requested by CICS or a user that were suppressed by a user exit or the dump table.
Number of transaction dumps taken TDMPTOTL The number of transaction dumps taken by the whole system since the last CICS end-of-day statistics reset. This number does not include suppressed dumps.
Web domain terminal timeout interval TIMEOUTINT The period of time, in minutes, after which inactive Web 3270 sessions are eligible for garbage collection.

Input Values: 1 - 60

Total number of active user transactions TOTACTVUSRTR The total number of active user transactions in this transaction class.
Total number of queued user transactions TOTDELYUSRTR The total number of queued user transactions in this transaction class.
Total number of tasks TOTLTASKS The number of tasks that have run in the system since the beginning of the CICS run.
Total time queued transactions waited TOTQUETIME The total amount of time that queued transactions spent waiting for this transaction class.
Transaction isolation status TRANISOLATE Indicates whether the task chose to isolate itself from all the user key programs of other transactions defined using the ISOLATE feature.
User trace status USERSTATUS The status of the user master trace flag.

Input Values: USERON, USEROFF

Number of times VTAM ACB dynamically opened VTMACBDOPE The number of times the VTAM access control block (ACB) was opened through the control terminal. If VTAM is started before CICS and stays active for the whole CICS run, this value will be zero.
Number of times RPL maximum value was reached VTMRPLMAX The number of times the maximum RPL posted value was reached.
Maximum number of VTAM RPLs posted VTMRPLPOST The maximum number of receive-any request parameter lists (RPLs) that were posted by VTAM on any one dispatch of terminal control.
Number of times VTAM had short-on-storage status VTMSOSCNT The number of times VTAM experienced a temporary short on storage condition.
CICS-VTAM connection status VTMSTATUS The status of the connection between CICS and VTAM.

Input Values: OPEN, CLOSED, IMMCLOSE, FORCECLOSE

XCF group ID XCFGROUP The 8-character name of the cross-system coupling facility (XCF) group of which this region is a member.

If this region is not a member of an XCF group (because it has not signed on to IRC) this field contains blanks.

Currently at MXT XMGATMXT Whether the CICS region is currently at the specified maximum number of user transactions (MXT).
Time the MAXTASKS limit last reached XMGLAMXT The date and time when the number of active user transactions last equalled the specified maximum number of user transactions (MXT).
Time MAXTASKS last changed XMGLSMXT The date and time when the maximum number of user transactions (MXT) was last set or changed dynamically.
Time last transaction attached XMGLTAT The date and time when the last user transaction was attached.
Extended recovery facility (XRF) status XRFSTATUS For systems that are part of an XRF pair, indicates whether the running CICS is PRIMARY or TAKEOVER.


eyua3us.html | Timestamp icon Last updated: Sunday, 4 June 2017