Performance report forms
File Systems Options Help
----------------------------------------------------------------------------
New
Performance
Report Form
Command ===>
Specify new Report Form options.
Name . . . LIST2___ Version (VRM) . . . ___ +
System Selection: Field Categories:
APPLID . . . . CICST1__ + _ Select to specify Field Categories
MVS Image . . . ________
Form Type or Model:
_ 1. List 4. Model (Report Form)
2. List Extended (Sorted) 5. Model (HDB Template)
3. Summary
Model . . . . . . . . . . LIST1___ +
Report Forms Data Set . . 'xxxx.CICSPA.FORM'____________________________ +
Repository . . . . . . . 'CICSPA.XYX.REPOSTRY'_________________________ +
- Name
- The name of the new report form. A 1-8 character name in ISPF member name format. The name must be unique within the report forms data set.
- APPLID, Image, Version (VRM)
- Specify the CICS System
or CICS Version (VRM) that
this report form applies to.
- If you specify the CICS System
(APPLID, or APPLID and MVS™ Image), CICS PA can
extract the associated (active) Dictionary entries for that CICS system, including any user
fields. If not specified, CICS PA will
assume the default Form, and user fields will not be available.
The CICS system must be defined in System Definitions, either Personal or Shared depending on your current setting. To select one from a list, use Prompt (F4). To link directly to System Definitions or switch between Personal and Shared Systems, use Systems in the action bar.
- Alternatively, if you specify the VRM, CICS PA uses
it to populate the Form with fields applicable to that release of CICS. 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
- 680
- CICS Transaction Server for z/OS Version 5 Release 1
- 690
- CICS Transaction Server for z/OS Version 5 Release 2
700
CICS Transaction Server for z/OS Version 5 Release 3
If a CICS system (APPLID/Image) is specified and a VRM can be derived from the MCT load library or SDFHLOAD library, then that VRM is used. If a VRM cannot be derived from the system definition then the VRM value specified in this panel is used.
If you do not specify either a CICS System or a VRM, then CICS PA populates the form with fields applicable to the latest supported release of CICS.
- If you specify the CICS System
(APPLID, or APPLID and MVS™ Image), CICS PA can
extract the associated (active) Dictionary entries for that CICS system, including any user
fields. If not specified, CICS PA will
assume the default Form, and user fields will not be available.
- Field Categories
- Enter / (or press F11) to display the selection list of
field categories that you can use to initially populate your new report
form. For example, you can initialize your form with Task and Terminal
Control fields by selecting DFHTASK and DFHTERM from the list. The
default is all categories except CROSSYS, DBCTL, and OMCICS.
Within the selected categories, the fields added to your report form depend on the specified CICS APPLID or VRM. If APPLID is specified, CICS PA obtains the fields from the CMF Dictionary for that APPLID. Otherwise the VRM is used. If APPLID and VRM are not specified, the default is 700.
See Figure 1 for an example of the Field Categories selection list.
- Form Type or Model
- Select the type of report form or model which dictates how the
new form is to be initialized (such as the fields, order, sort sequence).
Type is important because a form can only be used by reports and extracts
of compatible type:
- 1. List
- LIST report forms can be used for the Performance List report and similar list-style reports and extracts: For the names of compatible reports and extracts, see LIST Report Form.
- 2. List Extended (Sorted)
- LISTX report forms are similar to LIST report forms but also
enable you to specify multiple sort fields
and a processing limit. For the names of compatible reports and extracts, see LISTX Report Form.
- 3. Summary
- SUMMARY report forms can be used for the Performance Summary report and other summary reports and extracts. For the names of compatible reports and extracts, see SUMMARY Report Form.
- 4. Model (Report Form)
- If the new report form is to be modelled on an existing one, specify the name of the model report form and data set where it is stored. Prompt (F4) is available for both the report form data set name and the report form member name.
- 5. Model (HDB Template)
- If the new report form is to be modelled on an existing HDB Template,
specify the name of the model HDB Template and Repository where it
is stored. Prompt (F4) is available for both
the Repository data set name and the HDB Template name.
For HDB reporting and extract to CSV, it is useful to model a report form on an HDB template. This ensures that the fields requested in the form match the fields collected in the HDB.
When you have specified all required details, press Enter to create the report form.