To display the list of Report Forms in the current Report Forms
data set, select option 3 Report Forms from the CICS PA Primary
Option Menu.
Tip: To set or change the current Report Forms data set,
use the
Options menu on the action bar or enter
CDS from
the command line.
From the list of Report Forms, you can select one at a time to
view or modify, or you can create new Report Forms.
You can also add a selection of sample Report Forms by selecting Samples in
the action bar or entering the SAMPLES command. See Sample Report Forms.
The Report Forms are listed with the following user-defined attributes:
- Name
- 1-8 character name in ISPF member name format, used to uniquely
identify the Report Form within the Report Forms data set. By default,
the panel is sorted on the Name field.
- Type
- The type of Report Form, either LIST, LISTX or SUMMARY.
- Description
- Free format text up to 32 characters that describes the contents
and purpose of the Report Form.
Line Actions
- ⁄
- Display the menu of line actions.
- E
- Edit the Report Form.
- S
- Select the Report Form (same as Edit).
- V
- View the Report Form. This looks like the Edit panel but has no
'hold' on the data and has no Save capability. SAVEAS is available.
- D
- Delete the Report Form.
- R
- Rename the Report Form.
- J
- Run the report from the Report Form.
Primary Commands
The following primary commands
are valid for this panel:
- NEW name type
- This command creates a new Report
Form with the specified name. The type is either:
- LIST
- List Report Form
- LISTX or LX
- List Extended Report Form
- SUMMARY
- Summary Report Form
- MODEL
- Model on an existing Report Form
- MODELT
- Model on an existing HDB Template
It displays the New Report Form window populated
with values from your entered command or from the last Report Form
you created, and prompts you for further details to define the new
Report Form.
Also available from File in the action
bar or F6.
See Creating new Report Forms for
information on how to proceed.
- SELECT name
- This command (or S)
selects the specified Report Form for editing. If the Report Form
does not exist, it is created as if the NEW command was used.
- SORT Name|Type|Description|Changed|Id
- This command sorts the list
of Report Forms on one or two columns. The default sort field is Name. The
sort disregards upper and lower case, and is ascending for all but
the Changed column which is descending. The sort order is retained
only until Exit or another SORT command is issued.
- LOCATE string
- This command (or L or LOC)
is used to locate an entry in the list based on the primary sort field.
By default, LOCATE operates on the Name field. The string should
be no longer than the primary sort field and not enclosed in quotes.
The display will scroll to the entry which matches the string, or
the entry preceding it if an exact match is not found.
- CONFIRM ON|OFF
- CONFIRM ON (or CONFIRM)
instructs CICS PA to
prompt for confirmation when you request to Delete a Report Form.
With CONFIRM OFF, Delete requests are actioned immediately.
Deleted Report Forms cannot be reinstated.
This command changes
the setting only for the current invocation of the Report Forms panel.
On exit, it reverts to the default set by Delete Confirmation in CICS PA Settings.
- SAMPLES
- This command displays the
list of Sample Report Forms. You can select one or more Forms from
the list to populate your Report Forms data set.
- FIND string
- This command
(or F) looks for the specified character string within all
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.