Maintaining Personal System Definitions

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:
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:
  1. To allow you to report against all systems running on an MVS Image without having to explicitly specify the system names.
  2. 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:
  1. 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.
  2. 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.
  3. DB2 Subsystem. DB2 Subsystem, identified by its SSID. CICS PA matches this name against the SSID specified in the DB2 accounting records.
  4. MQ Subsystem. WebSphere MQ Subsystem, identified by its SSID. CICS PA matches this name against the SSID specified in the MQ accounting records.
  5. 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
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.

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 Start of change No CHARS xxx found End of change 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:
  1. 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.
  2. Updates are saved when you change views (VIEW SYSTEMS|FILES|GROUPS command) or display the menu (MENU command).
  3. CANCEL (F12) discards all updates.
  4. 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).

Information Information

Feedback


Timestamp icon Last updated: Saturday, 8 February 2014


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic///users-guide/smaint.htm