CICSPA control operands

Control operands are used to specify factors that affect the content of reports and extracts.

The following table lists all the control operands showing the format of the command and description of the function.

Table 1. CICSPA control operands
Command Control Function
CICSPA APPLID Application identifier of the CICS® systems from which data is processed. Most reporting occasions will filter on APPLID. However, if reporting on all APPLIDs is required, the command CICSPA NOAPPLID can be used.
CICSPA PRECISION Precision of numeric fields. Specifies 4, 5, or 6 decimal places to report up to microseconds.
CICSPA FORMAT Time and date delimiters to use for the reports and extracts.
CICSPA INput DDnames of the SMF input data set(s). This required operand identifies the source of SMF records for the reports and extracts that follow.
CICSPA LINECount Number of lines per page for the reports.
CICSPA SELECT|SELECT2 Record selection for the reports and extracts. This is a powerful and flexible mechanism for filtering the input data.
CICSPA SMFSTART|SMFSTOP Start/Stop time period to limit the time range of SMF input data processed by CICS PA based on the SMF record time stamp.
Start of changeCICSPA READ2EOFEnd of change Start of changeProcess all records through to EOF. That is, do not stop reading the SMF file as soon as the first record is encountered that is later than SMFSTOP.End of change
CICSPA ZONE Time zone for all reports and extracts, in number of hours west or east of Greenwich Mean Time (GMT).
Control operands are important for specifying how reports and extracts are created. These operands are normally coded before report operands, allowing them to apply to multiple reports. For example,
CICSPA ZONE=-8,TOTAL,SUMEXC
causes both the Performance Totals and Exception Summary reports to print as though the data came from time zone -8 (U.S. Pacific time).
If a control operand is specified more than once, the report operands will use the control operand immediately preceding it. This is useful if you want to create variations of one report. For example,
CICSPA ZONE=10,TOTAL,SUMEXC,ZONE=-8,TOTAL
This example creates two Performance Total reports, with the first printed as though the data came from time zone 10 (for example, Sydney), and the second printed as though from time zone -8. The Exception Summary report is printed as though the data came from time zone 10.
Except for SELECT, values are reset with a new CICSPA command. For example,
CICSPA ZONE=-8,TOTAL
CICSPA TOTAL

This example creates two Performance Totals reports, with the first report printed as though the data came from time zone -8, and the second one printed as though from the default of the local time zone.

When a control operand is used, it affects all reports and extracts until a control operand is respecified or a new CICSPA command is issued. Note, however, that the CICSPA command does not reset the SELECT operand (see Using SELECT statements).


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//controp.htm