Global Options

To display the Global Options panel, enter line action S to select Global in the Options category on the Report Set panel.
Figure 1. Global Options
   File  Systems  Options  Help
 ------------------------------------------------------------------------------
                           SAMPLE - Global Options
 Command ===> _________________________________________________________________
 
 System Selection:
  CICS APPLID . . ________  +  Image . . ________  +  Group . . ________ +
  DB2 SSID  . . . ____  +      Image . . ________  +  Group . . ________ +
  MQ SSID   . . . ____  +      Image . . ________  +  Group . . ________ +
  Logger  . . . . ________  +  Image . . ________  +  Group . . ________ +
 
 Report Formatting Options:
  Print Lines per Page . . 60_  (1-255)
  Time Zone  . . . . . . . ___  (Blank for system default or -12 to +12 hours)
  Date Delimiter . . . . . 
  Time Delimiter . . . . . :
  Precision  . . . . . . . 6    (4-6)
 
  F1=Help    F3=Exit    F4=Prompt    F7=Backward  F8=Forward   F10=Actions  
 F12=Cancel

The Global Options define general control information applying to all reports and extracts in the Report Set. They specify the global System Selection (CICS® System, DB2® Subsystem, MQ Subsystem, MVS™ System Logger) and report formatting options (lines per page, time zone, date/time delimiters). You can accept the default formatting options or change them to suit your requirements.

System Selection can be left blank, provided the systems are specified at the report-level, or when the Report Set is submitted.

The Global Options are:
System Selection:
At Report Set run-time, CICS PA needs to determine which systems the reports will analyze. System Selection identifies these systems. The systems must be defined in your System Definitions. You can type in the system names, or select from a list of defined systems using Prompt (F4).

If the required system is not defined to CICS PA, you can link directly to System Definitions to define it by selecting Systems in the action bar or entering the SYSDEFS command.

You can specify System Selection in three places:
  1. Locally for each report within the Report Set. The local selection applies only to this single report.
  2. In the Report Set Global Options. The global selection will only apply to reports that do not specify their own local selection.
  3. At run time. If specified, this selection overrides the Report Set Global Options. In addition, if the Override System Selections option is requested, then the run-time selection also overrides the local report selections.

Each point of selection is optional, but at least one must be specified before CICS PA can proceed with JCL generation. You could choose not to specify any System Selections in your Report Set. Then at run time, you are prompted to specify the systems you want to report against.

You can specify four types of systems:
  1. CICS APPLID: The CICS Generic APPLIDs you want reported. Specify either:
    • A unique APPLID.
    • An APPLID for a particular MVS Image. This identifies a particular CICS system when there are multiple CICS systems with the same APPLID.
    • An MVS Image. CICS PA will report on all APPLIDs running on this Image using the SMF files defined for the Image.
    • An APPLID and Image combination plus a Group. This is useful for uniquely identifying CICS systems when there are duplicate IDs defined in System Definitions.
    • A Group alone. CICS PA will report on all APPLID and Image combinations in the Group to produce a single consolidated report. For example, for transaction grouping, or for systems that connect via IRC/MRO, ISC/APPC, or IPIC.

    CICS PA generates the APPLID(applid1,applid2,applid3,...) and INput(SMFIN001,SMFIN002,SMFIN003,...) operands, and corresponding //SMFINnnn DD statements.

  2. DB2 SSID: The DB2 Subsystem IDs. This is only used by the DB2 Report and Record Selection Extract. If the CICS APPLID Group contains the DB2 SSIDs, then it can be omitted.

    CICS PA generates the SSID(ssid1,ssid2,ssid3,...) operands for the DB2 or RECSEL commands and the DD statements for the associated files.

  3. MQ SSID: The MQ Subsystem IDs. This is only used by the WebSphere® MQ Report and Record Selection Extract. If the CICS APPLID Group contains the MQ SSIDs, then it can be omitted.

    CICS PA generates the operand SSID(ssid1,ssid2,ssid3,...) operands for the MQ or RECSEL commands and the DD statements for the associated files.

  4. Logger: The MVS System Logger. This is only used by the System Logger Report, System Logger Extract, and Record Selection Extract. If the CICS APPLID Group contains the System Loggers, then it can be omitted.

    CICS PA generates the DD statements for the associated files.

Print Lines per Page
The maximum number of lines, including headings, to print on each page of the report. Valid values are from 1 to 255. The default is 60.

The global value applies to all reports. (It is not applicable to extracts.) If a value is specified on the report panel, the report value takes precedence over the global for that report only.

CICS PA JCL generation translates this field to:
LINECount(nnn)
Time Zone
This provides a way to override your local CPU time zone setting and convert CMF, DB2, MQ, and System Logger clock fields to a different time zone. It is only useful if the data you are reporting was generated by a system running with a different time zone.

CMF, DB2, MQ, and Logger records have clock fields in STCK format based on Greenwich Mean Time (GMT). Every CMF record includes time zone conversion factors SMFMNLSO (Leap Second Offset) and SMFMNDTO (Date/Time Offset). CICS PA uses these to convert the time stamps to reflect the local time of the SMF data.

DB2, MQ, and System Logger records, however, do not have time zone conversion factors. CICS PA uses the reporting system's time zone obtained from the conversion factors CVTLSO (Leap Second Offset) and CVTLDTO (Date/Time Offset) in the CVT. When you run the DB2, MQ, or Logger report on a system with a different time zone setting to that of the SMF data, then you must specify the time zone option to match that of the SMF data. The time zone specification is used to convert the CMF, DB2, MQ, and Logger time stamps to reflect the local time of the SMF data.

Specify the time zone as an integer from -12 to +12 to represent the number of hours that local time is west or east of GMT. For example, specify -5 for New York, 10 for Sydney. CICS PA will then convert GMT STCK values to the required local time for all record types.

The default is blank (not specified).

CICS PA JCL generation translates this field to:
ZONE(time-zone)
Date Delimiter
The separator character for the dates in reports and extracts. Any character or a space can be specified. The default is a slash ().
CICS PA JCL generation translates this option to:
FORMAT(time-delimiter,date-delimiter)
Time Delimiter
The separator character for the time-of-day in reports and extracts. Any character or a space can be specified. The default is a colon (:).
CICS PA JCL generation translates this option to:
FORMAT(time-delimiter,date-delimiter)
Precision
The precision of numeric fields, and of time stamp fields that specify the TIMEP format. Numeric fields can be formatted to either 4, 5, or 6 decimal places. The default is 4.
  • 4 decimal places is 0.0001 precision
  • 5 decimal places is 0.00001 precision
  • 6 decimal places is 0.000001 (microsecond) precision

For details on the TIMEP format, see Suboperands for Time Stamp fields.

This option generates the PRECISION(n) global operand.


Information Information

Feedback


Timestamp icon Last updated: Saturday, 8 February 2014


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