The System Definitions panel is displayed when you select option
1 Define Systems, SMF Files and Groups from the System Definitions
Menu. However, if you opted to bypass the menu and go straight to
the Systems view, then selecting option 1 System Definitions on
the Primary Option Menu displays the System Definitions panel immediately.
You can also change to the Systems view from the Files or Groups view
by selecting from View in the action bar or by entering the VIEW
SYSTEMS command.
The System Definitions panel is the primary panel for maintaining
your system definitions. When the list of Systems is displayed:
- To define a new system, enter the NEW command and it is
added at the top of the list. Alternatively, you can enter the line
action I (Insert) on the row above where you want the new entry
to be added.
- To update or view details of a system including its related files
and groups, enter the S line action against the system where
it appears in the list.
- To delete a system that is no longer required, enter the D line
action against the system where it appears in the list.
- You can also use C or R to copy or repeat a system
entry together with its associated files and groups. Note however
that an MVS™ Image must have a
unique name.
- FIND and SORT commands are available to help you
locate entries in the list.
- You can select Filter->Set Filter in the action bar
to reduce the volume of the display to only the systems that match
your specified criteria.
Figure 1. Personal System Definitions File Edit Filter View Mass_Update Options Help
------------------------------------------------------------------------------
Personal System Definitions Row 1 from 9
Command ===> ________________________________________________ Scroll ===> ____
Select a System to edit its definition, SMF Files and Groups.
SMF Files
/ System Type Image Description System
_ CICSP001 CICS MVS1 CICS APPLID CICSP001/MVS1___________ MVS1
_ MVS1 Image MVS System MVS1_____________________ MVS1
_ DB2P DB2 MVS1 DB2 Subsystem DB2P/MVS1_____________ MVS1
_ CICSD001 CICS CICS APPLID CICSD001________________ CICSD001
_ DB2D DB2 MVS1 DB2 Subsystem DB2D/MVS1_____________ DB2D
_ DB2E DB2 DB2 Subsystem DB2E__________________ DB2E
_ DB2F DB2 DB2 Subsystem DB2F__________________
_ CICSP001 Logger MVS1 System Log for CICSPLOG/MVS1________ MVS1
_ CICSP* CICS CICSAPPLIDs CICSP*__________________ CICSP*
********************************* End of list *********************************
This panel lists the Systems that are available for Report Set
processing.
A System is identified by the combination of:
- System ID
- Type of System (CICS®, Image, DB2®, MQ, Logger)
- MVS (SMF) Image ID
Each row shows System, Type, Image, Description, and the SMF Files
System. The fields are display-only except for Description and are
described below.
- System
- The system name is one of the following depending on the type:
- CICS Transaction Server
generic APPLID
- CICS Transaction
Gateway APPLID
- MVS (SMF) Image ID
- DB2 Subsystem ID
- WebSphere® MQ
Subsystem ID
- MVS System Logger ID
Enter the I line action or the NEW command
to define a new System.
Enter the S line action against
a System to specify its details and related SMF Files and Groups.
CICS PA automatically
inserts an Image definition when a System is added or updated with
a new Image. The Image is inserted in the list immediately below the
System that created it.
The purpose of Image definitions is
two-fold:
- To allow you to report against all systems running on an MVS Image without having to explicitly
specify the system names.
- To allow you to specify the SMF data set names once. Simply define
your SMF files for an MVS Image,
and all systems running on that Image (with no files of their own)
will use these files.
If they are uniquely defined, the order of the system
definitions is not relevant to CICS PA. You
can list them on this panel in the order that is convenient for you.
Line action M (Move) or the SORT command is available
for this purpose.
- Type
- The type of system is one of the following:
- CICS System. Either
a CICS Transaction Server system
identified by its generic APPLID, or a CICS Transaction
Gateway system identified by its APPLID. CICS PA matches
this name against the CICS Transaction
Server generic APPLID specified in SMF 110 and SMF 112 records, and
the CICS Transaction Gateway
APPLID specified in SMF 111 records.
- MVS Image. MVS System, identified by its MVS SMF ID (SID parameter in SMFPRMnn)
or any name that uniquely identifies your system. The name need not
match any formal MVS definition.
- DB2 Subsystem. DB2 Subsystem, identified by its
SSID. CICS PA matches
this name against the SSID specified in the DB2 accounting records.
- MQ Subsystem. MQ Subsystem, identified by its
SSID. CICS PA matches
this name against the SSID specified in the MQ accounting records.
- System Logger. MVS System
Logger, identified by the CICS or MVS system it services or any name
that identifies the Logger system. The name need not match any formal MVS definition.
- Image
- Image is the SMF identifier of the MVS System
which collects the SMF data and runs the CICS System, DB2 Subsystem, MQ Subsystem, or System Logger. Image is blank when
the System is an Image because the System name is the Image name.
- 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.
- SMF Files System
- The SMF Files System identifies where you have defined the files
for this system. These are the files that CICS PA will
use for Report Set JCL generation.
CICS PA allows
systems to share files. So if an MVS Image
is running a number of CICS, DB2 or MQ systems,
you need only specify the files once for the Image.
If this
indicator is blank, the system (and its associated Image) have no
files defined or they are all Excluded. If your Report Set requests
this system, the JCL generation process will invoke the “Missing SMF
Files Option”.
Enter the S line action to view or modify
the SMF File specifications (and Groups) for the system.
Line Actions: The valid line actions for the list
of systems are:
- ⁄
- Display the menu of line actions
- S
- Select (edit) the System
- I
- Insert a row
- R
- Repeat this row
- C
- Copy this row
- M
- Move this row
- A
- Move⁄Copy after this row
- B
- Move⁄Copy before this row
- D
- Delete this row
- U
- Include CICS system in
mass update
Note: A line action on this panel applies to the System
definition and all its associated information. For example, copying
a row copies the System details and all its File and Group relationships.
Deleting a row deletes the System and its relationships, but not the
Files and Groups themselves.
Primary Commands: The following primary commands
are available:
- NEW name CICS|IMAGE|DB2|MQ|LOGGER
- This command creates a new System.
If all required parameters are specified, the Definition panel for
the system is displayed. Otherwise, the New System window is displayed
to allow you to specify the name and type of the new System.
Also
available from File in the action bar.
See New System for information on how to proceed.
- SAVE
- This command saves any changes
you have made during this invocation of System Definitions.
Also
available from File in the action bar.
- FIND string
- This command (or F)
looks for the specified character string in all 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 SYSTEM|TYPE|IMAGE|DESCription
- This command sorts the list
of Systems on the specified column. The default is SYSTEM (then TYPE
and IMAGE). The order is retained on exit.
Also available from Edit in
the action bar.
- SELECT pattern
- This command inserts line
action S next to all Systems whose names match the specified
pattern.
- SELECT|S pattern
- This command inserts line
action S next to all Systems whose names match the specified
pattern (such as PROD*, to match all Systems whose name begins with
the letters PROD).
- SELECT|S pattern U
- This command inserts line
action U (include in mass update) next to CICS Systems whose names match the specified
pattern.
- RESET
- This command (or RES)
removes all outstanding line actions.
Also available from Edit in
the action bar.
- VIEW FILES|GROUPS
- This command takes you to the
Files or Groups view. Updates are saved when you change views.
Also
available from View in the action bar.
- MENU
- This command takes you to the
System Definitions Menu. Updates are saved when you go to the menu.
Also
available from View in the action bar.
Note: - The SAVE command is available only at the four possible
“exit points” of System Definitions: the Menu, Systems view, SMF Files
view, and Groups view. All System Definitions updates are saved on
issuing a SAVE command from any of these panels.
- Updates are saved when you change views (VIEW SYSTEMS|FILES|GROUPS command)
or display the menu (MENU command).
- CANCEL (F12) discards all updates.
- EXIT (F3) saves changes as follows:
- If the System Definitions Menu is not being bypassed, the
System Definitions are not saved until Exit from the Menu.
- If the System Definitions Menu is being bypassed, the System
Definitions are saved on Exit from any view (Systems, Files, or Groups).