LIST - Performance List report

The LIST operand requests the Performance List report or an extract file (see Performance Data extract).

The command format for the Performance List report is:
CICSPA LIST(
          [OUTPUT(ddname),]
          [ALERTDEF(defname),]
          [SEVERITY(CRITICAL|WARNING|INFO|ELIGIBLE|ALL),] 
          [FIELDS(field1[(options)],...),]
          [LINECount(nnn),]
          [TITLE1('...1st 64 characters of title...'),]
          [TITLE2('...2nd 64 characters of title...'),]
          [SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
          [SELECT2(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...))])
The command format for the List Extract is:
CICSPA LIST(
          [OUTPUT(ddname),]
          [DDNAME(ddname),]
          [DELIMIT('field-delimiter'),]
          [LABELS|NOLABELS,]
          [FLOAT,]
          [ALERTDEF(defname),]
          [SEVERITY(CRITICAL|WARNING|INFO|ELIGIBLE|ALL),]
          [FIELDS(field1[(options)],...),]
          [TITLE1('...1st 64 characters of title...'),]
          [TITLE2('...2nd 64 characters of title...'),]
          [SELECT(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...)),]
          [SELECT2(PERFORMANCE(INCLUDE|EXCLUDE(field1(values1),...),...))])
The options are:
OUTPUT
Controls the report output DDname. See OUTPUT for further information. If not specified, CICS PA assigns a DDname in the format xxxxnnnn where nnnn is the report sequence number 0001-9999 to uniquely identify the output, and xxxx is:
  • LIST for the Performance List report.
  • EXPT for the Recap report for the List Extract.
DDNAME
Specifies the DDname of the extract data set where the extracted data is written. When this operand is specified, instead of producing the report, CICS PA produces the extract file, and a Recap of the extract process is written to the OUTPUT operand report file.

The DDname can be up to 8 alphanumeric characters, with the first non-numeric. The CICS PA dialog assigns DDnames in the format CPAOEXnn where nn is the extract sequence number 01-99. (See the sample JCL in JCL for generating CICS PA reports and extracts (part 1 of 2)).

DELIMIT
Specifies the field delimiter, enclosed in quotes, to be used to separate each data field in the extract data set. The default is a semicolon DELIMIT(';').
LABELS|NOLABELS
LABELS indicates that the first record to be written to the extract data set is to be a field labels record. This is the default.

NOLABELS indicates that CICS PA is not to write a field labels record to the extract data set.

FLOAT
Write numeric fields in the extract in S390 FLOAT format. This only applies to the List Extract when the FIELDS operand is specified.

Specify FLOAT format if you plan to import the extract into a DB2® table. When the DB2 Load Utility is used, it will interpret all numerical fields reliably and consistently in FLOAT format.

If FLOAT is not specified, the numeric fields are written in a mixture of integer, real and exponential using character digits. This is the default and is suitable when importing the extract data into a PC spreadsheet tool.

ALERTDEF
The name of a Performance Alert Definition for alert reporting.
SEVERITY
Determines the minimum severity level to be reported and type of transactions reported.
CRITICAL
Only Critical transactions are reported.
WARNING
Only Critical and Warning transactions are reported.
INFO
All alerts are reported: Critical, Warning and Informational transactions.
ELIGIBLE
Only eligible transactions are processed and reported. Eligible transactions are those that have resource values that match resource values specified in the alert definition. The resulting report will include eligible only transactions with and without alerts.

This option provides the means to filter out transactions that would never generate an alert because their resource values do not match resource values specified in the alert definition.

ALL or blank
All transactions are reported, whether or not they generate an alert and whether or not they are eligible. This is the default.
FIELDS
Specifies which fields are included in the report or extract, their order, and format. See LIST(FIELDS for details.
LINECOUNT
Controls the number of lines per page in the List report. See LINECount for further information.
TITLE1, TITLE2
Controls the report title (left and right half of the subheading line) for the List report or the Extract Recap. See TITLE1 and TITLE2 for further information.
SELECT|SELECT2(PERFORMANCE(INCLUDE|EXCLUDE
Specifies what data to include or exclude from the report or extract based on data field values. See Using SELECT statements for an explanation and examples.

Information Information

Feedback


Timestamp icon Last updated: Saturday, 8 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///users-guide/tlistp.htm