CICS System (APPLID) definition
- You enter the S line action against a CICS System listed on the System Definitions panel.
- You enter the NEW command with a type of CICS.
File Edit Dictionary View Options Help
----------------------------------------------------------------------
CICS System Row 1 of 3 More: >
Command ===> ___________________________________________ Scroll ===> ____
CICS System definition:
APPLID . . . . . . . . CICSP1__ MVS Image . . MVS1____ VRM . :
Description . . . . . CICS system CICSP1 on MVS MVS1_________________
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
…
/ Group + Description
_ CICSPROD Production CICS_____________________
_ DB2PROD_ Production DB2______________________
********************************* End of list *****************************
…
For each system, CICS PA remembers its last view and returns there next time.
This panel is used to define a CICS system (CICS TS or CICS TG) to CICS PA. 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.
The use of masking characters allows the definition of a generic Dictionary record for use by multiple APPLIDs that match the masked APPLID. All matching APPLIDs plus Image must use the same MCT specified when creating the Dictionary record.
- 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.
The use of masking characters allows the definition of a generic Dictionary record for use by multiple Images that match the masked Image. All matching APPLIDs plus Image must use the same MCT specified when creating the Dictionary record.
- VRM
- The VRM value is displayed if it can be determined from the MCT load library or the SDFHLOAD library, otherwise it is blank.
- 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.
- 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 steps::- Specify the Dictionary DSN.
- Specify the SDFHLOAD Library so that CICS PA can use the DFHMNDUP utility to generate the dictionary record.
- 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.
Important:- The APPLID/Image ID combination in the created dictionary record must match the CMF records, otherwise the dictionary record will not be used.
- If Image ID is not specified in the System Definition, the system on which the dictionary record is created (that is, the image on which the CICS PA dialog is executing) will be written in the generated dictionary record. This Image ID will be used to match with the CMF records.
Primary Commands
- FIND string
- This command (or
F) looks for the specified character string in the SMF Data Set Name and Group columns of the
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 start 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 the message No CHARS xxx found 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.