CICS System (APPLID) definition

The CICS® System panel is displayed when:
Figure 1. System Definitions: CICS System (with Files)
  File  Edit  Dictionary  View  Options  Help
----------------------------------------------------------------------
                              CICS System               Row 1 of 3  More: >
Command ===> ___________________________________________ Scroll ===> ____
 
CICS System definition:
 APPLID . . . . . . . . CICSP1__  MVS Image . . MVS1____
 Description  . . . . . CICS system CICSP1 on MVS MVS1_________________
 CICS Version (VRM) . . 670
 MCT Suffix . . . . . . U1
 MCT Load Library . . . 'CICS.PROD.MCTLOAD'___________________________
 SDFHLOAD Library . . . 'CICS.PROD.SDFHLOAD'__________________________
 Dictionary DSN . . . . 'USER.CICSPA.CICSP1.DICT'_____________________
 
/ Exc             SMF Data Set Name +                UNIT +  SEQ VOLSER +
_  *  'CICSPAOR.CMF1'______________________________ CART____ 1__ 000010 +
_     'CICSPAOR.CMF2'______________________________ 3390____ ___ ______
_  *  'CICSPAOR.CMF3'______________________________ ________ ___ ______
********************************* End of list *****************************
 
 F1=Help        F3=Exit        F4=Prompt      F5=Rfind       F6=Resize
 F7=Backward    F8=Forward    F10=Actions    F11=Right      F12=Cancel
Figure 2. System Definitions: CICS System (with Groups)
  File  Edit  Dictionary  View  Options  Help
----------------------------------------------------------------------
                              CICS System               Row 1 of 2  More: >
Command ===> ___________________________________________ Scroll ===> ____
 
CICS System definition:
 APPLID . . . . . . . . CICSP1__  MVS Image . . MVS1____
 Description  . . . . . CICS system CICSP1 on MVS MVS1_________________
 CICS Version (VRM) . . 670
 MCT Suffix . . . . . . U1
 MCT Load Library . . . 'CICS.PROD.MCTLOAD'___________________________
 SDFHLOAD Library . . . 'CICS.PROD.SDFHLOAD'__________________________
 Dictionary DSN . . . . 'USER.CICSPA.CICSP1.DICT'_____________________
 
/   Group +                 Description
_   CICSPROD   Production CICS_____________________
_   DB2PROD_   Production DB2______________________
********************************* End of list *****************************
 
 F1=Help        F3=Exit        F4=Prompt      F5=Rfind       F6=Resize
 F7=Backward    F8=Forward    F10=Actions    F11=Right      F12=Cancel
This panel is used to define a CICS system (CICS Transaction Server or CICS Transaction Gateway) to CICS PA. The definition includes:

Scroll Right (F11) to switch between Files and Groups. Files is the initial view. However, for each system, CICS PA remembers its last view and returns there next time.

The CICS system details are:
APPLID
The CICS Transaction Server generic APPLID or CICS Transaction Gateway APPLID. An APPLID is up to eight alphanumeric (A-Z,0-9) or special (@,#,$) characters, and must be specified. You can also specify a pattern using the % and * masking characters.
Image
The SMF identifier of the MVS system where the CICS system runs. An Image ID is up to 8 alphanumeric (A-Z,0-9) or special (@,#,$) characters.
Description
Description is free-format text up to 36 characters to describe the system. This is for your reference only, although CICS PA will insert it as a comment in your Report Set JCL.
CICS Version (VRM)
For CICS Transaction Server only; leave this field blank when defining a system for CICS Transaction Gateway. The version, release, and modification level of the CICS system, specified in the same format as the VRM setting in DFHSIT. The supported releases are:
640
CICS Transaction Server for z/OS® Version 3 Release 1
650
CICS Transaction Server for z/OS Version 3 Release 2
660
CICS Transaction Server for z/OS Version 4 Release 1
Start of change670End of change
Start of changeCICS Transaction Server for z/OS Version 4 Release 2End of change
CICS PA uses the version to:
  • Perform release-dependent batch report processing
  • Determine which performance dictionary fields are available, if the MCT is not available.

If VRM is not specified, CICS PA determines it from the version of the SDFHLOAD Library.

MCT Suffix
The suffix of the CICS Monitoring Control Table (MCT), which should be the same as the MCT= parameter in DFHSIT. The suffix is one or two alphanumeric (A-Z,0-9) or special (@,#,$) characters. If not specified, CICS PA uses the system default MCT. If specified, the MCT Load Library must also be specified. The MCT is needed to include user fields in your reporting.
MCT Load Library
The name of the load library containing the MCT load module. If not specified, CICS PA cannot use the MCT to determine the user fields defined in the MCT.
SDFHLOAD Library
The name of the library containing the CICS utility program DFHMNDUP which CICS PA uses to generate a Dictionary record. CICS PA uses the Dictionary record to interpret the CMF performance data records processed from the SMF files. If not specified, CICS PA cannot determine the CICS VRM or report user fields defined in the MCT.
Dictionary DSN
The name of the data set that contains the Dictionary record for this CICS system. It can be either the name of a data set with Variable record format (RECFM=V) or the name of a member of a partitioned data set (PDS).

You only need to specify this if you want to report the user fields defined in the MCT. If you are not reporting user fields, then you can let CICS PA use the default Dictionary record for your release of CICS.

If you want CICS PA to generate the Dictionary record for this CICS system, do the following:
  1. Specify the Dictionary DSN.
  2. Specify the SDFHLOAD Library so that CICS PA can use the DFHMNDUP utility to generate the Dictionary record.
  3. Select Dictionary in the action bar. CICS PA immediately populates the specified data set with the Dictionary record for this CICS system. If the data set is not cataloged, CICS PA will allocate it before writing the record. If the data set is cataloged, CICS PA will overwrite its contents with the new Dictionary record.

At JCL generation time, CICS PA inserts the Dictionary DSN (if cataloged) in the CPADICTR DD statement.

Dictionary records describe the format of CMF performance records and are required for CICS PA reporting. Usually the SMF data set contains a Dictionary record to describe the format of its records. If it is missing, CICS PA uses the record in the CPADICTR data set if present, otherwise it uses the default Dictionary record for the release of the CICS system being processed.

Primary Commands:
The following primary commands are valid for this panel:
FIND string
This command (or F) looks for the specified character string in SMF Data Set and Group columns of displayed data. The string need only be enclosed in quotes if there are embedded spaces. The search is not case sensitive. The display scrolls to the row where the string is found and positions the cursor on the matching data. To find more occurrences, use F5 or the RFIND command repeatedly.

If there is no match but the search did not begin at the top of the list, the screen does not change and the message *Bottom of data reached* is displayed. Use F5 or RFIND to search from the top. If there is no match in the entire list, the screen does not change and a String not found message is displayed.

Also available from Edit in the action bar.

SORT GROUP|DESCription
This command sorts the list of Groups by name (the default) or description. The order is retained on exit.

Also available from Edit in the action bar.

Note: The SORT command is not available for Files since it is important that the data set names are specified in time sequence.
RESET
This command (or RES) removes all outstanding line actions and deletes any blank rows.

Also available from Edit in the action bar.