Maintaining Personal System Definitions
The Personal System Definitions panel is the primary panel for maintaining your system definitions.
- From the Personal System Definitions Menu, select option 1 Define Systems, SMF Files and Groups.
- Select Systems in the action bar of any reporting panel, and then select Specify Personal System Definitions. (See Figure 1).
- Define a new system by entering the NEW command or using the line action I.
- Copy or repeat a system together with its associated files and groups. Note however that an MVS™ Image must have a unique name.
- Use the line action S to update or view details of a system including its related files and groups.
- Delete a system that is no longer required.
- Use the FIND and SORT commands to locate entries in the list
- Use Filter->Set Filter in the action bar to display only systems that match your specified criteria
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 following types of system are supported:
- 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. WebSphere 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
- ⁄
- 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
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.
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 or a subset
of columns in 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 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.
- 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).