The CICS® System panel is
displayed when:
- 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.
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:
- CICS Transaction
Server generic APPLID or CICS Transaction
Gateway APPLID, which must be specified
- MVS™ (SMF) ID where the CICS system runs
- For CICS Transaction
Server only: the CICS Version
(VRM)
- Suffix of the Monitoring Control Table (MCT)
- Load Library containing the MCT load module
- SDFHLOAD Library containing the CICS utility program DFHMNDUP which CICS PA uses to generate CMF
Dictionary records
- Name of a sequential data set which contains the Dictionary record
for this CICS system
- Files used by the CICS system
- Groups the CICS system
belongs to
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
670
CICS Transaction Server for z/OS Version
4 Release 2
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:
- 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.
- 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.