CICSRGNAggregateRecordType

The number of AIDs in the region

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.

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.

The system ID of this CICS system.

The level of the CICS Transaction Server that this CICS system is running.

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

The length of the good morning message that appears when a user signs on to native CICS.

The text of the good morning message that appears when a user signs on to native CICS.

The 4-character identifier of the CICS good morning transaction.

The status of CICS tracing to the MVS Generalized Tracing Facility (GTF).

Input Values: GTFSTART, GTFSTOP

The number of start I/O (SIO) requests made by this CICS since startup.

The status of interregion communication (IRC) in the system.

Input Values: OPEN, CLOSED, IMMCLOSE

The date and time when the maximum number of user transactions (MXT) was last set or changed dynamically.

The date and time when the number of active user transactions last equalled the specified maximum number of user transactions (MXT).

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

Input Values: 1 - 255

The SMF ID of the MVS system where this CICS is running.

The name of the operating system that the CICS system is running under.

The CICS operating system identification code.

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.

The operating system release that the CICS system is running under.

The user ID which CICS PLTPI is running under.

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.

Maximum amount of above the bar storage that Shared Data Tables can use.

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.

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.

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.

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.

The number of active security request recording tasks.

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

Input Values: OPEN, CLOSED, IMMCLOSE

The status of the connection between CICS and VTAM.

Input Values: OPEN, CLOSED, IMMCLOSE, FORCECLOSE

For systems that are part of an XRF pair, indicates whether the running CICS is PRIMARY or TAKEOVER.

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.

The VTAM application ID of this CICS system.

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

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

Input Values: Any valid program name

The number of program autoinstall attempts.

Indicates whether autoinstalled program definitions should be cataloged.

Input Values: CTLGALL CTLGMODIFY, CTLGNONE

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.

The number of program autoinstall requests that have failed.

The number of times autoinstall program request were rejected.

Indicates whether or not autoinstall is active for programs.

Input Values: AUTOACTIVE, AUTOINACTIVE

The number of autoinstall requests that are currently being processed.

The status of the autoinstall process (ENABLED or DISABLED).

The status of auxiliary tracing in this CICS system.

Input Values: AUXSTART, AUXSTOP, AUXPAUSE

Controls whether automatic data set switching occurs when the current auxiliary trace data set becomes full.

Input Values: SWITCHNEXT, SWITCHALL, NOSWITCH

The total number of times invalid 3270 data was received on a BMS command, where the validation URM chose to abend the task.

Whether BMS 3270 validation is enabled.

The total number of times invalid 3270 data was received on a BMS command, which the validation URM chose to ignore.

The total number of times invalid 3270 data was received on a BMS command, which the validation URM chose to log.

The system's cold start state (COLD, INITIAL, or NOTAPPLIC).

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.

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

Input Values: CONVERSE, NOCONVERSE

The amount of time that currently queued transactions have spent waiting for this transaction class.

Identifies the current auxiliary trace data set (A or B).

Indicates which of the dump data sets is active (A or B).

The actual number of H8 mode open TCBs currently allocated to user tasks.

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.

The total number of T8 mode open TCBs currently allocated to the enabled JVM server runtime environments.

The total number of L8 and L9 mode open TCBs currently allocated to user tasks.

The total number of S8 mode open TCBs currently allocated to user tasks.

The total number of X8 and X9 mode open TCBs currently allocated to user tasks.

Whether the CICS region is currently at the specified maximum number of user transactions (MXT).

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.

The default user ID associated with the CICS system.

The name of the program controlling the distributed routing of transactions in this system.

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.

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.

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: SWITCHALL, SWITCHNEXT, NOSWITCH

Indicates whether the active CICS dump data set is open or closed.

Input Values: OPEN, CLOSED, SWITCH

The name of the program controlling the dynamic routing of transactions in this system.

Input Values: Any valid program name

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

Input Values: EXCEPT, NOEXCEPT

The status of tracing for CICS-VTAM exits.

Input Values: TCEXITALL, TCEXITSYSTEM, TCEXITNONE, TCEXITALLOFF

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

Indicates whether an external security manager (ESM) is active in this system.

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.

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

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

The Generic Resource group name under which this CICS region requests registration to VTAM.

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.

Is the CICS region exempt from IBM z/OS Health Checks.

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.

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

The initialization status of the CICS system:

• INITCOMPLETE - Initialization is complete.
• SECONDINIT - Second stage of CICS initialization.
• THIRDINIT - Third stage of CICS initialization.

The status of internal tracing in this CICS system.

Input Values: INTSTART, INTSTOP

The size of the internal trace table in kilobytes.

Input Values: 16 - 1048576

The number of tasks run since the last CICS statistics reset.

The MVS job name of this CICS system.

The MVS job ID of this CICS system.

The time of the last cold start of the region that occurred since the last initial start.

The time of the last emergency start of the region that occurred since the last initial start.

The time of the last initial start of the region.

The last reset time expressed in local time.

The date and time when the last user transaction was attached.

The time the region was last warm started.

The number of LIBRARY search order updates.

The amount of time spent updating the LIBRARY search order.

The number of waits for a program load due to LIBRARY search order updates.

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.

The total number of tasks that have been suspended and forced to wait for loader domain requests to be satisfied.

The number of times the maximum number of suspended tasks was reached.

The number of programs on the not-in-use (NIU) queue.

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.

The total amount of time spent waiting on those transactions that were queued in the transaction class.

The number of logical users currently logged on.

The highest number of logical users logged on at any one time.

The maximum number of autoinstall requests that are allowed to queue at any one time.

Input Values: 0 - 999

The maximum number of H8 mode open TCBs that CICS is allowed to attach and maintain in its pool of H8 mode TCBs.

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.

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.

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.

The maximum number of S8 mode open TCBs that can exist concurrently in the CICS region.

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.

The number of times the MAXTASK limit has been reached.

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.

The status of CICS monitoring in the system.

Input Values: ON, OFF

The time stamp format for performance class records as either Greenwich mean time (GMT) or local time (LOCAL).

The name of the MVS system where this CICS is running.

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.

The number of page-in requests made by this CICS since startup.

The number of page-out requests made by this CICS since startup.

The maximum number of tasks suspended and waiting for loader domain requests to be satisfied at any one time.

The highest number of queued user transactions in the transaction class at any one time.

The highest number of tasks concurrently in the system at any one time.

The highest number of active user transactions in the transaction class at any one time.

Indicates whether the performance class of CICS monitoring data is being collected.

Input Values: PERF, NOPERF

The number of program instances removed from storage by the Dynamic Program Storage Compression (DPSC) facility.

The current number of tasks that are suspended while waiting for loader domain requests to be satisfied.

A factor used internally to relate a task's priority to its wait time.

Input Values: 0 - 65535

The number of uses of any program by this CICS system.

The total number of persistent sessions that were already unbound when CICS tried to restore them.

The total number of times CICS issued an INQUIRE OPTCD=PERSESS.

The total number of VTAM sessions that persisted.

The total number of persistent sessions that were successfully restored.

The number of persistent sessions that were terminated.

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

Specifies if CICS is running with VTAM single node persistent sessions (SNPS), multi node persistent sessions, or no persistent sessions (NOPS).

The number of user transactions queued and waiting for entry into the transaction class.

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.

The number of 1 kilobyte frames of real storage currently in use by this CICS.

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.

The user ID the CICS region is running under.

The CICS release of the displayed CICS system.

Indicates the status of the MVS resource recovery management services as reported by this CICS region, for this MVS image

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

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

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.

The name of the transaction to be run at the beginning of a normal or immediate shutdown.

The status of the flag that controls user tracing from the issuing task.

Input Values: SINGLEON, SINGLEOFF

The date on which this run of CICS was started. The date is expressed in local time.

The system's startup state (COLDSTART, WARMSTART, EMERGENCY, or LOGTERM).

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

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

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.

Indicates whether storage protection is active in this system.

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.

The value set by the SUBTSKS system initialization parameter, which can be either 0 or 1.

Indicates whether performance records are written at a syncpoint.

Values: SYNCPOINT, NOSYNCPOINT

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.

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.

Indicates whether the taking of CICS system dumps is globally suppressed, or suppressed for everything except sysdumpcodes in the dump table.

Input Values: SYSDUMP, NOSYSDUMP, TABLEONLY

The status of the system main trace flag.

Input Values: SYSTEMON, SYSTEMOFF

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.

The period of time, in minutes, after which inactive Web 3270 sessions are eligible for garbage collection.

Input Values: 1 - 60

The total number of active user transactions in this transaction class.

The amount of CPU time, in seconds, used by this CICS since startup.

The total amount of time suspended tasks spent waiting for loader domain requests to be satisfied.

The time taken for all library load requests.

The number of tasks that have run in the system since the beginning of the CICS run.

The total number of queued user transactions in this transaction class.

The total amount of time that queued transactions spent waiting for this transaction class.

The number of transaction dumps requested by CICS or a user that were suppressed by a user exit or the dump table.

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.

Indicates whether the task chose to isolate itself from all the user key programs of other transactions defined using the ISOLATE feature.

The status of the user main trace flag.

Input Values: USERON, USEROFF

The number of user transactions currently active in the transaction class.

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.

The number of times the maximum RPL posted value was reached.

The maximum number of receive-any request parameter lists (RPLs) that were posted by VTAM on any one dispatch of terminal control.

The number of times VTAM experienced a temporary short on storage condition.

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.