Previous Topic: Dynamic Menu-Formatting FeatureNext Topic: Connecting the ISPF Libraries to Your System


Formatting Used for Online Reporting

Several dictionaries in the CA Disk parmlib govern the formatting used for online reporting. One of the options is the capability of including SMS constructs and attributes in the ISPF online reports. Users who want to change these dictionaries should have a working knowledge of the ISPF online reporting feature of CA Disk, be familiar with the ISPF section in the User's Guide, covering the online report facility, and have had hands-on experience with the product. You must also define a report definition library to store your user-defined reports.

Note: For more information, see the section ISPF Online Reports in the User Guide.

To run the ISPF reports interactively, we recommend that the TSO region size be at least 3000K. Without the foreground report generation, a region size of 2000K should suffice for the report definition process.

Although the online reporting facility of CA Disk provides a lot of flexibility in defining user reports, it does not allow much tailoring as far as how individual fields are printed (column headings, numeric editing patterns, and so on.). You can tailor these values on an installation-wide basis, however, by modifying the data dictionary in parmlib.

Actually two different dictionaries are used for each report type, a low-level dictionary maps field names to data items in the F1 and F4 DSCBs. These dictionaries are called FMT1FLDS and FMT4FLDS and should not be modified by the user. They only provide a mapping mechanism between the high-level dictionary and the low-level data and have no control over report formatting options. The dictionaries that do control formatting of data fields are called FMT1DICT and FMT4DICT. The FMT1DICT member maps the fields used on the F1-DSCB reports and the FMT4DICT member is used for the volume summary reports (F4 DSCBs).

The ISPF online reports can include SMS constructs and attributes. If you have SMS managed data sets and choose to include these new fields in a report, you must rename the following members within the CA Disk parmlib data set:

Note: If these renames were done while operating under a previous release of CA Disk and there were reports generated from the SMS constructs, you must issue these renames again prior to generating any reports.

Be careful when changing any fields that modify the width required to print a field if report definitions have been generated that use these fields. The column positioning values are calculated at report definition time and a change in the length can cause the output report to be incorrect (overlapped fields, and so on). If this occurs, the problem can be corrected by going through the report modification panels for each report using the affected field(s). No updates need to be made; the field adjustments are automatically made as a by-product of the update process.

Note: For detailed information about each of the fields in the dictionary, see the section ISPF Online Reports in the User Guide.

The ISPF support is shipped to the user on the CA Disk distribution tape or the in the ESD download as four separate files. The following is a list of the file contents:

ISPF Dialog Manager Panel

Contains the panel definitions for all CA Disk dialog manager panels and contains all HELP facility panels relating to the function and menu panels.

ISPF Dialog Manager Skeleton JCL

Contains skeleton JCL used for building JCL that is submitted for processing from CA Disk ISPF applications.

ISPF Dialog Manager Message

Contains error messages to be printed by the dialog manager when the CA Disk application detects an abnormal condition.

ISPF Dialog Manager Load Modules

Contains all CA Disk load modules. The dialog manager to obtain all CA Disk load modules.