Maintaining Report Forms

To display the list of Report Forms, select option 3 Report Forms from the CICS PA Primary Option Menu.
  1. Use the Options menu on the action bar to nominate the Report Forms data set (if one has not yet been nominated, or you wish to change the data set).
Figure 1. Report Forms
   File  Confirm  Samples  Options  Help
 ------------------------------------------------------------------------------
                                  Report Forms                  Row 1 to 3 of 3
 Command ===> ________________________________________________ Scroll ===> PAGE
 
 Report Forms Data Set  . . : xxxx.CICSPA.FORM
 
  /  Name    Type              Description              Changed        ID
  _ LISTX1   LISTX   List Extended Report Form      2005/01/13 09:00 MKR08
  _ LIST1    LIST    List Report Form               2005/01/01 12:27 JCH02
  _ PSUMMY01 SUMMARY Summary Report Form            2005/01/12 08:57 DAM13
 ********************************* End of list *********************************
 

This panel lists all the Report Forms in the current Report Forms data set. The current Report Forms data set is one of the Control Data Sets in your profile settings. To change it, use Options in 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.
In addition, the Report Forms are listed with the following system-generated attributes:
Changed
Date and time when last updated.
ID
The userid that last updated the Report Form.
Line Actions: The following line actions can be entered against any row in the Report Forms list:
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.
Start of changeJEnd of change
Start of changeRun the report from the Report Form.End of change
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.

Also available from File in the action bar.

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.

Also available from Confirm in the action bar.

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.

Also available from Samples in the action bar.

FIND string
This command (or F) looks for the specified character string in all columns of displayed data. The string 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, press RFIND (F5). If there is no match but the search did not begin at the top of the list, the screen does not change and the message *Bottom of data reached* is displayed. Press RFIND (F5) to search from the top. If there is no match in the entire list, the screen does not change and a String not found message is displayed.