Select Report Field

This panel displays a scrollable list of all report fields that can be selected for reporting. In the columns next to the field name are FLD LTH and HDG LTH. These fields show you the number of characters required to display the actual field's data on the report, and also how many characters in width the field's heading requires. The larger of the two values for any given field is the number of bytes that it takes to display the field on the report.

Note: If you select the RACFALL, RACFDIS or RACFGEN fields for your report, you will not be able to run the report online. The selection line for these fields warns you of this fact. You will still be able to run the report in batch. However, if you have modified your TSO session to run APF-authorized (TSO normally does not run this way), you will be able to run your report online.

The remainder of the panels in the report definition phase uses an interactive approach to selecting fields. While each one will vary slightly, the overall processing tries to be consistent. As you select each field from the panel, you will be taken to another panel that prompts for more specific information about a field's selection. From this panel you can type in the requested information and press the <ENTER> key, or you can press <END> to cancel the request. Either response will return you to the field selection screen. You can then select another field, or you can press to proceed to the next level of report definition.

There are two line commands that can be entered from the field selection panel:

An S to select a report field
A D to delete it from the report (if it was previously selected)

To use these commands, you can use the next line (carriage return) key on the keyboard to position the cursor next to the field you want to select (or delete). Then enter the S or D and press the <ENTER> key. Your request will then be processed. If the field you desire is not on the screen, you can use the scroll keys to position the display to the proper page that contains the field name.

From the command line you can enter:

S <fieldname>—to select a field for reporting without having to move the cursor to it,
D <fieldname>—to delete the report field,
L <string>—to locate or position the display to the first field name in the table that begins with the same character string,
SHOW—to show the fields that have been selected to this point, or
CANCEL—to cancel the report definition and return you to the online reports primary option menu.

Note: The fields shown in the previous examples with < > should be entered without the brackets.

Pressing the <END> key at this point signals CA Disk that you have completed the report field selection phase and are ready to proceed to the sort field selection phase. Before showing that panel, let's look at the panel displayed as a result of making a field selection or entering SHOW on the command line.