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 before 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 its System
ID, System type, and MVS (SMF)
Image ID. Each row shows System, Type, Image, Description, and the
SMF Files System. The fields are display-only except for Description.
- 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
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 after 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:
- 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
- ⁄
- 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
- 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.
See New System for information on how to proceed.
- SAVE
- This command saves any changes
you have made during this invocation of System Definitions.
- 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.
- 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.
- VIEW FILES|GROUPS
- This command takes you to the
Files or Groups view. Updates are saved when you change views.
- MENU
- This command takes you to the
System Definitions Menu. Updates are saved when you go to the menu.
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).