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.
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 sets. 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. |
CICSPA READ2EOF | Process 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. |
CICSPA ZONE | Time zone for all reports and extracts, in number of hours west or east of Greenwich Mean Time (GMT). |
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).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.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).