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

Displays the CICS exception alerts.

Syntax:

CALERTS  	< REGion | SYStem | XSYStem | NOXSYStem >
		< Local    | Global    | XSData    | NOXSData >
		< GROUP  name >
		< GROUPType    type     >
		< WARNing  |  NORMal   >
		< THRESH    |  ALL        >
		< ACK          |  NOACK   >
		< NAME           name     >
		< ARG1            arg1      >
		< ARG2            arg2      >
		< SUBGroup     subgroup >
		< SUMMGRP     summgrp  >

New syntax parameters

SUMMGRP - Limits the display to only those entries with corresponding value in the SummGrp field.
GROUPTYPE - Specifies the logical group type. If the group type is not specified, the type CICSPLEX is used.

New data fields

SummGrp - The summarization group ID.

CICSLIST

Displays the CICS regions.

New data fields:

Dispatch - The dispatchability of the address space.
One of the following values:
- RUNNING - The address space has one or more units of work (tasks or SRBs) running on a processor.
- READYnnn - The address space has one or more units of work (tasks or SRBs) that are dispatchable but are waiting to run on a processor. The nnn portion is the dispatch priority order up to a maximum of 255.
- Blank - The address space is not dispatchable.

CICSSET

Alters the CICS resources.

New Subcommand syntax

EXPORT - Exports data definitions.

Syntax:

EXPORT datatype dsname(member)

Parameters and descriptions

datatype - The data definition type with the following valid actions:
- ARTM
- CICSOPTS
- DUMPMGT
- GROUPS
- SCHEDULE
- STATS
- THRESHOLDS
- TRANCANCEL
- TRANOPTS
member - The name of the member to be saved.
dsname - The data set name where you want to save the specified member.
The data set name can be specified as a fully qualified data set name or using one of the following special keywords.

Keywords and descriptions

USER - Use the optional data set name that you defined in the user profile for the library type PARMLIB.
Example: USER(member)
SITE - Use the optional site PARMLIB date set that is defined in the system configuration options parmlib member GSVXSYSV.
Example: SITE(member)
SYSTEM - Use the system PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV.
Example: SYSTEM(member)
SITESYSTEM|* - Use the optional site PARMLIB data set that is defined in the system configuration options parmlib member GSVXSYSV. If the site data set has not been defined, use the system PARMLIB data set name.
Example:
```
SITESYSTEM(member)
                   *(member)
```

CMODS

CICS data collection modules

New data fields:

Owner - The module identifier of the owner user ID.

CSCHEDUL

CICS scheduled events

New Line Command

Metrics - Invoke the CVARS command selecting those metrics that the selected event scheduler function collected.

CSYSDATA

Displays the CICS system interval analysis.

The CA SYSVIEW log stream technology that reads and writes from the log streams now provides a significant performance boost.

This enhancement provides these benefits:

Reduced the CPU used to read and write from a log stream.
Reduced the elapsed time that is required to read many records from a log stream.

The default and maximum value for the LINES parameter has been adjusted.

Parameter

LINES
New Default: 25,000

New Maximum: 1,000,000

Old Default: 5,000

Old Maximum: 100,000

This LINES value is stored in the user profile. You can change the stored default value by issuing the following command from the desired primary command:
```
OPTIONS LINE nnnnn
```

CTASKS

Displays the CICS active tasks.

When you select an active task to display a detailed report of resource usage, a new Real-Time section is added to the report. This section shows the current wait reason.

Example:

Section: Real-Time

Program  WaitType WaitName
TEST0001 TCLASS   XM_HELD

CTCLASS

Displays the CICS transaction classes.

New data fields:

Act% - The percent of maximum transactions that are currently active.

CTDATA

CICS transient data queues

New data fields:

Recovery - The recovery status.
Possible values are:
- Blank (non-intrapartition queues)
- NO
- PHYSICAL
- LOGICAL
- Only valid for intrapartition queues.

CTRANLOG

Displays the CICS transaction log summary.

Syntax:

CTRANLOG	< STREAM	logstream  >
		< TIME		time | *   >
		< DATE		date | *   >
		< LINES		count      >
		< LIMIT		count      >
		< PERIOD	seconds    >

		< JOBName	jobname    >
		< TRAN		tran       >
		< UMBRELLA	umbrella   >
		< UMBTYPE	umbtype    >
		< CLIENT		client     >
		< WEBSERVICE	webservice >
		< ABND		abendcode  >
		< PROGRAM	program    >
		< DEFGROUP	group      >

		< LIFETIME	oper time  >
		< CPUTIME	oper time  >
		< IOREQS	oper count >
		< XCT		oper count >

New syntax parameters

DEFGROUP group - Use this parameter to specify the definition group to be displayed.
FILTER - Display a filter screen to allow the entering of command syntax parameters to filter the data.

The CA SYSVIEW log stream technology that reads and writes from the log streams now provides a significant performance boost.

This enhancement provides these benefits:

Reduced the CPU used to read and write from a log stream.
Reduced the elapsed time that is required to read many records from a log stream.

The default and maximum value for the LINES parameter has been adjusted.

Parameter

LINES
New Default: 25,000

New Maximum: 1,000,000

Old Default: 5,000

Old Maximum: 100,000

This LINES value is stored in the user profile. You can change the stored default value by issuing the following command from the desired primary command:
```
OPTIONS LINE nnnnn
```

New Data Field

DefGroup - The name of the definition group from where the entry was installed.

New data fields to Overview Summary

Program - The initial program name.
Dispatch Time - The time that the transaction was dispatched.
Suspend Time - The time that the transaction was suspended.
Delay Time - The time that the transaction was delayed before the first dispatch.

Section Overview Summary

SMF ID          : CA31          Start Date/Time : 04Dec2012 07:45:20.594
Applid          : A31ICB18      End Date/Time   : 04Dec2012 07:45:20.595
Jobname         : SYSVC640      Life Time       : 0.001334
CICS Release    : TS 3.1 (6.4)  CPU Time        : 0.000480
Transaction ID  : CLS2          Dispatch Time   : 0.000640
Task Number     : 104           Suspend Time    : 0.000688
Program         : DFHLUP        Delay Time      : 0.000016

Tran Class      :               Userid          : CICSUSER
Priority        : 254           Terminal        : -AAB
Abend Code      :               LU-Name         : A31ICCS1
Umbrella Name   :               Client Type     : APPC Session
Umbrella Type   :

New data fields

DefGroup - The name of the definition group from where the entry was installed.

CTRANSUM

CICS transaction intervals

The CA SYSVIEW log stream technology that reads and writes from the log streams now provides a significant performance boost.

This enhancement provides these benefits:

Reduced the CPU used to read and write from a log stream.
Reduced the elapsed time that is required to read many records from a log stream.

The default and maximum value for the LINES parameter has been adjusted.

Parameter

LINES
New Default: 25,000

New Maximum: 1,000,000

Old Default: 5,000

Old Maximum: 100,000

This LINES value is stored in the user profile. You can change the stored default value by issuing the following command from the desired primary command:
```
OPTIONS LINE nnnnn
```

CTSQUEUE

Displays the CICS temporary storage queues.

New Line Command Field

DUmp - Invoke the DUMP command to display the virtual storage that is specified in the TSQUEUE field.

CVARS

Displays the CICS monitor variables.

New data fields:

Schedule - The name of the associated event schedule function responsible for the data collection. If blank, the metric is not collected through an event scheduler function.