Commands Enhanced (CICS)

Enhancements to Existing Features › Options › Option for CICS › Commands Enhanced (CICS)

Commands Enhanced (CICS)

The following enhancements have been made to existing commands.

CALERTS

CICS exception alerts

New line commands:

RULE - Invokes the CTHRESH or CSTATES command selecting the associated alert definition.

Renamed data fields:

XSystem was renamed to XSSystem.

CATOMS

CICS atom services

New data fields:

PostFeed - The number of times a POST was issued for feed.
GetFeed - The number of times a GET was issued for feed.
GetEntry - The number of times a GET was issued for entry.
PutEntry - The number of times a PUT was issued for entry.
DelEntry - The number of times a DELETE was issued for entry.

Renamed data fields:

XSystem was renamed to XSSystem.

CCHANNEL

CICS channels

Renamed data fields:

XSystem was renamed to XSSystem.

CCONFIG

CICS configuration options

New data fields:

Set - Indicates that the option has been set.

Renamed data fields:

XSystem was renamed to XSSystem.

New line commands:

Select, Help- Invokes online help positioning to the selected configuration option.

CCONN

CICS connections

Renamed data fields:

XSystem was renamed to XSSystem.

CCONTAIN

CICS containers

Renamed data fields:

XSystem was renamed to XSSystem.

CDATAMON

CICS data monitoring statistics

New data fields:

CpuTSFT - The total CPU time that the time series facility task consumed.
TSFT% - The percentage of the CICS CPU time that the time series facility task used.
CpTSFT - The amount of CPU time that the time series facility task consumed on a CP.
EnclTSFT - The amount of CPU time that the time series facility task consumed on an enclave.
eTSFT% - The percent of the total CPU time that the time series facility task used on an enclave.

New line commands:

Select - Invokes the CREVIEW command for display interval statistics.

CDB2CSUB

CICS DB2 Connection State Blocks.

The command has been enabled for cross-system data.

Syntax:

CDB2CSUB < REGion | SYStem | XSYStem | NOXSYStem >
         < Local  | Global | XSData  | NOXSData >
         < GROUP  name >

REGion, Local - Displays only the current target address space. The cross-system data collection is set to off for this execution. The current profile setting of XSDATA is maintained.
SYStem, Global - Displays all CICS address spaces currently being monitored on the current system.
XSYStem, XSData - Displays all CICS address spaces for all systems. This sets cross-system data collection to on for this execution. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - Sets cross-system data collection to off for this execution. The current profile setting of XSDATA is maintained.
GROUP - Specifies that an argument is to follow. The group name that contains the list of CICS regions displays. The list of available groups with the type CICSPLEX can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.

New data fields:

Jobname - The name of the CICS job.
SSID - The DB2 subsystem ID.
ACE - The address of the Agent Control Element (ACE) control block.

New line commands:

Select - Invokes the DBTHACT command to display specific information about the selected thread.
IDB2 - Invokes the IDB2 (CA Insight for DB2) command to display specific information about the selected thread.

CDSAS

CICS dynamic storage areas

New data fields:

Access - The access type of the DSA. Possible values are:
- blank
- CICS
- USER
- READ
- TRUST
- SECURE

CENQUEUE

CICS enqueues

Renamed data fields:

XSystem was renamed to XSSystem.

CENQPOOL

CICS enqueue pools

Renamed data fields:

XSystem was renamed to XSSystem.

CEPBS

CICS exit program blocks

Renamed data fields:

XSystem was renamed to XSSystem.

CFILEREQ

CICS configuration options

Renamed data fields:

XSystem was renamed to XSSystem.

CFILES

CICS file control table entries

Renamed data fields:

XSystem was renamed to XSSystem.

CFILEUSE

CICS files in use

Renamed data fields:

XSystem was renamed to XSSystem.

CGBLEXIT

CICS global user exits

Renamed data fields:

XSystem was renamed to XSSystem.

CICSLIST

CICS regions

New data fields:

Status - The current monitoring status. Possible values are:
- ACTIVE - The CICS monitor is active. Possible Execution Stages: Executing and Shutdown stage 1 or 2.
- CICSINIT - The CICS monitor is not active. Possible Execution Stages: Initialization. The CICS region has previously been monitored.
- CICSTERM - The CICS monitor is not active. Possible Execution Stages: Cancel and Shutdown. The CICS region has previously been monitored.
- INACTIVE - The CICS monitor is not active. Possible Execution Stages: Executing. The CICS region has previously been monitored.
- JOBINACT - The CICS monitor is not active. The CICS region is not active. Possible Execution Stages: Inactive. The CICS region has previously been monitored.
- NONE - The CICS monitor is not active. Possible Execution Stages:
  Initialization
  
  Cancel
  
  Shutdown
- NOSTART - The CICS monitor is not active. Possible Execution Stages: Executing. The CICS monitor has never been active for this region after IPL.
- SWAPPED - The CICS region is logically swapped out. The CICS monitor is either inactive or has never been active for this region after IPL.

CICSLOGR

CICS data loggers

New data fields:

TranLog - Status of transaction logging to a log stream.
TranSMF - Status of SMF transaction logging.
TranDyn - Status of transaction logging to the dynamic exit GSVX.CICSTRAN.
TSumLog - Status of logging the transaction summary to a log stream.
TSumSMF - Status of logging the SMF transaction summary.
TSumDyn - Status of logging the transaction summary to the dynamic exit GSVX.CICSTSUM.
SysDLog - Status of system data logging to a log stream.
SysDSMF - Status of SMF system data logging.
SysDDyn - Status of system data logging to the dynamic exit GSVX.CICSSYSD.
XLogLog - Status of exception logging to a log stream.
XLogSMF - Status of SMF exception logging.
XLogDyn - Status of exception logging to the dynamic exit GSVX.CICSXLOG.

New line commands:

TRANLOG - Enable transaction logging to the log stream.
NOTRANL - Disable transaction logging to the log stream.
TRANSMF - Enable SMF transaction logging.
NOTRANS - Disable SMF transaction logging.
SYSDLOG - Enable system data logging to the log stream.
NOSYSDL - Disable system data logging to the log stream.
SYSDSMF - Enable SMF system data logging.
NOSYSDS - Disable SMF system data logging.
TSUMLOG - Enable logging the transaction summary to the log stream.
NOTSUML - Disable logging the transaction summary to the log stream.
TSUMSMF - Enable logging the SMF transaction summary.
NOTSUMS - Disable logging the SMF transaction summary.
XLOGLOG - Enable exception logging to the log stream.
NOXLOGL - Disable exception logging to the log stream.
XLOGSMF - Enable SMF exception logging.
NOXLOGS - Disable SMF exception logging

CIPCONN

CICS IP connections

Renamed data fields:

XSystem was renamed as XSSystem.

CJINFO

CICS journal information

Renamed data fields:

XSystem was renamed as XSSystem.

CJMODEL

CICS journal models

Renamed data fields:

XSystem was renamed as XSSystem.

CJVMPROG

CICS JVM programs

Renamed data fields:

XSystem was renamed as XSSystem.

CJVMS

CICS JVMs

Renamed data fields:

XSystem was renamed as XSSystem.

CJVMSERV

CICS JVM servers

Renamed data fields:

XSystem was renamed as XSSystem.

CLIBS

CICS libraries

Renamed data fields:

XSystem was renamed as XSSystem.

CLIFE

CICS lifetime range statistics

The available lifetime ranges have been expanded to include the following ranges:

0.000001 <=0.100000
0.100001 <=  0.250000
0.250001 <=  0.500000
0.500001 <=  1.000000
1.000001 <=  2.000000
2.000001 <=  5.000000
5.000001 <= 10.000000
10.000001 <= 30.000000
30.000001 <= 60.000000
>  60.000000

Syntax:

CLIFE   < TRAN  * | tran | group >< REGion | SYStem | XSYStem | NOXSYStem >

        < Local  | Global | XSData  | NOXSData  >

        < GROUP  name >

New syntax parameters:

TRAN - Specify the transaction ID for displaying the lifetime range.
* - All transactions

tran - Specific transaction ID. Enter c'tran' if you want mixed case.

group - transaction group

Renamed data fields:

XSystem was renamed as XSSystem.

CLOCKMGR

CICS lock manager

Renamed data fields:

XSystem was renamed as XSSystem.

CLIBS

CICS program statistics

New line command:

LMID - Invokes the LISTDIR command with the MODID keyword for the selected data set. The standard CA module identification information for all members in the data set displays.

CMODES

CICS modenames

Renamed data fields:

XSystem was renamed as XSSystem.

CMODS

CICS data collection modules

Renamed data fields:

XSystem was renamed as XSSystem.

CPIPE

CICS pipelines

Renamed data fields:

XSystem was renamed as XSSystem.

CPROFILE

CICS profiles

Renamed data fields:

XSystem was renamed as XSSystem.

CPROGRAM

CICS program statistics

New data fields:

JVM - Runs the program under JVM.
JVMServer - The JVM server resource name.
JVMProf - The JVM profile member name.

Renamed data fields:

XSystem was renamed as XSSystem.

CREVIEW

CICS Transaction Interval Activity

Starting at release r13.7, the transaction interval activity is collected in 1-minute intervals.

Syntax:

CREVIEW < INTerval minutes >
< REGion | SYStem | XSYStem | NOXSYStem >
< Local  | Global | XSData  | NOXSData  >
< GROUP  name >

New syntax parameters:

INTERVAL - Specify the summarization interval for data rows. The interval data is available in 1-minute increments for the past 24 hours.

New data fields:

RMITime - The average resource manager time.
GSVICPU - Global user exit CPU time.
GSVITime - Global user exit monitor.
CICSCPU - The amount of consumed CPU time by the CICS address space after starting the data collector.
ReqsGLUE - The total number of CICS Global User Exit requests that have been processed.
CpuGLUE - The total consumed CPU time by the data collector while processing the CICS Global User Exit requests.
GLUE% - The percentage of used CICS CPU time by the GLUE data collection process.
CpuSDC - The total consumed CPU time by the System data collector.
SDCS% - The percentage of used CICS CPU time by the System data collection process.
ReqsXDIS - The total number of External Data Interface requests that have been processed.
CpuXDIS - The total consumed CPU time by the External Data Interface task.
XDIS% - The percentage of used CICS CPU time by the External Data Interface task.
CpuSCHT - The total consumed CPU time by the scheduler.
SCHT% - The percentage of used CICS CPU time by the scheduler process.
CpuTPPT - The total consumed CPU time by the transaction postprocessor task.
TPPT% - The percentage of used CICS CPU time by the transaction postprocessor task.
CpuLOGT - The total consumed CPU time by the message logger task.
LOGT% - The percentage of used CICS CPU time by the message logger task.
CpuTSFT - The total consumed CPU time by the time series facility task.
TSFT% - The percentage of used CICS CPU time by the time series facility task.

Renamed data fields:

Renamed Hour to Interval.
Renamed XSystem to XSSystem.

New line commands:

Select - Redisplays the transaction information specifying an interval of one-minute and positioning to the selected interval. Minute interval data is available in release 13.7 and higher.

CSCHEDUL

CICS scheduled events

New event functions:

STATE-IPCONN - CICS IP connections
STATE-PIPELINES - CICS pipelines
TSF-SYSTEM - Time Series Facility - System Data
TSF-TRANS - Time Series Facility - Transactions

New data fields:

Deg - Specifies if the variable metric is associated with degradation analysis.
TSF - Specifies if the variable metric is eligible for Time Series Facility processing.

CSIT

CICS system initialization table

Renamed data fields:

XSystem was renamed as XSSystem.

CSITINIT

CICS initialization parameters

Renamed data fields:

Renamed XSystem to XSSystem.

CSOCKETS

CICS sockets

Renamed data fields:

Renamed XSystem to XSSystem.

CSOCKUSE

CICS socket users

Renamed data fields:

Renamed XSystem to XSSystem.

CSTATES

CICS state definitions

Syntax:

CSTATES  < ADDLINE | NOADDLINE >

ADDLINE - Display the "?Add" line.
NOADDLINE - Do not display the "?Add" line.

CSUBPOOL

CICS dynamic storage subpools

CSUBPOOL < REGion | SYStem | XSYStem | NOXSYStem >
         < Local  | Global | XSData  | NOXSData >
          < GROUP  name >

New data fields:

Access - The access type of the subpool.
AllocHWM - The high water mark of storage that is allocated to the subpool.
FixedLen - The length of each element in the subpool. Valid only for the fixed type subpools.
InitFree - The total storage that is allocated when the domain subpool is preallocated.
MaxFree - The largest free storage element. Valid only for the grande (64-bit) DSA subpools.
Pct% - The percentage of storage used in the owning DSA.
Type - Element type.

CSYSDMON

CICS system data monitor

Renamed data fields:

Renamed XSystem to XSSystem.

CTASKENT

CICS kernel task table entries

Renamed data fields:

Renamed XSystem to XSSystem.

CTASKS

CICS active tasks

Changed line commands:

Select - Invokes the SMFRPT command to display a real-time report of detailed transaction information for the selected task.

Renamed data fields:

Renamed XSystem to XSSystem.

CTCLASS

CICS transaction classes

Renamed data fields:

Renamed XSystem to XSSystem.

CTDATA

CICS transient data queues

Renamed data fields:

Renamed XSystem to XSSystem.

CTERMS

CICS terminal statistics

Renamed data fields:

Renamed XSystem to XSSystem.

CTHRESH

CICS threshold definitions

Syntax:

CTHRESH  < ADDLINE | NOADDLINE >

ADDLINE - Display the "?Add" line.
NOADDLINE - Do not display the "?Add" line.

CTRANLOG

CICS transaction log summary

New line commands:

SP - Displays the detail screen for a record, prints the detail report to a SYSOUT data set, and then returns to the CTRANLOG screen. This line command opens an unopened SYSOUT print data set. All subsequent SP line commands print to the same SYSOUT data set until a PRINT CLOSE command is issued or until the session terminates.

CTRANOPT

CICS transaction options.

New data field:

TSF - Specifies whether to send statistics for the transaction to the CA Chorus Time Series Facility.

Renamed data fields:

Renamed WilyAPM to CEAPM.

CTRANS

CICS transaction summary.

Displays an additional data row that contains a statistical summary for all "*" transactions.

New data field:

Attaches - The number of transactions attached.

New line command:

DEG - Invokes the CWAITS command to show degradation analysis for the selected transaction.
LIFE - Invokes the CLIFE command to show the lifetime analysis for the selected transaction.

Renamed data fields:

Renamed XSystem to XSSystem.

CTRANSUM

CICS transaction intervals

The CICS transaction summary record has been expanded to contain all degradation analysis metrics.

CTSMODEL

CICS temporary storage models

Renamed data fields:

Renamed XSystem to XSSystem.

CTSPOOLS

CICS temporary storage pools

Renamed data fields:

Renamed XSystem to XSSystem.

CTSQUEUE

CICS temporary storage queues

Renamed data fields:

Renamed XSystem to XSSystem.

CUOW

CICS units of work

Renamed data fields:

Renamed XSystem to XSSystem.

CURIMAPS

CICS URI maps

Renamed data fields:

Renamed XSystem to XSSystem.

CUSERS

CICS external security user info

Renamed data fields:

Renamed XSystem to XSSystem.

CVARS

CICS monitor variables

New data fields:

Deg - Specifies if the variable metric is associated with degradation analysis.
TSF - Specifies if the variable metric is eligible for Time Series Facility processing.
TS51 - Indicates that the metric is valid for CICS TS 5.1.
TS42 - Indicates that the metric is valid for CICS TS 4.2.
TS41 - Indicates that the metric is valid for CICS TS 4.1.
TS32 - Indicates that the metric is valid for CICS TS 3.2.
TS31 - Indicates that the metric is valid for CICS TS 3.1.

CWAITS

CICS degradation analysis

The command has been enabled for cross system data.

Syntax:

CWAITS  < TRAN  * | tran | group >
CWAITS  < REGion | SYStem | XSYStem | NOXSYStem >
        < Local  | Global | XSData  | NOXSData >
        < GROUP  name >
        < TOTal       >
        < SYSInterval >
        < INTerval    >
        < Biz   >
        < NOBiz >

New syntax parameters:

TRAN - Specifies the transaction ID to display the degradation analysis.
- * - All transactions.
- tran - Specific transaction ID. Enter c'tran' if you want mixed case.
- group - transaction group.
REGion, Local - Displays only the current target address space. This execution of the cross-system data collection is set to off. The current profile setting of XSDATA is maintained.
SYStem, Global - Displays all CICS address spaces currently being monitored on the current system.
XSYStem, XSData - Displays all CICS address spaces for all systems. This execution of the cross-system data collection is set to on. The current profile setting of XSDATA is maintained.
NOXSYStem, NOXSData - This execution of the cross-system data collection is set to off. The current profile setting of XSDATA is maintained.
GROUP - Specifies that an argument is to follow providing the group name that contains the list of CICS regions to display. The list of available groups with the type CICSPLEX can be found on the GROUPS command. A group name of "*" can be entered to indicate that no group processing is required.
TOTal - Request analysis of data after the last start of the data collection.
SYSInterval - Request analysis of data for the current system interval.
INTerval - Request analysis of data for the current 60-second interval.

New/changed information fields:

Tran - Specified transaction ID or group.
Transactions - The number of transactions that have been monitored for the specified interval. The count includes those excluded transactions from statistical averaging due to excessive life time values.
TranRate - Transaction rate per second for the specified interval.
Interval - The amount of time that has elapsed in the specified interval.
Exclude - The number of transactions that have been excluded from statistical averaging due to excessive life time values.
MaxLife - The maximum life time value of a transaction that is included in statistical averaging.
JobCPU - CPU usage for the address space, expressed as a percentage. Average value for the last 30-second interval.
Paging - Paging rate per second. Paging rate per second for the address space. Average value for the last 30-second interval.
IORate - I/O rate per second. I/O rate per second for the address space. Average value for the last 30-second interval.

New data fields:

Deg - Specifies if the variable metric is associated with degradation analysis.
TSF - Specifies if the variable metric is eligible for Time Series Facility processing.

CWEBSERV

CICS web services

Renamed data fields:

Renamed XSystem to XSSystem.

CXDISTAT

External data interface stats

Renamed data fields:

Renamed XSystem to XSSystem.