Cross Reference Processor › Filling in Worksheets

Filling in Worksheets

Write in the title first

Start a worksheet for each group of records, as shown in the figure above by writing the descriptive title (that is, file or other group identifier) after the header REPORT=. The descriptive title clearly identifies the group of records, most commonly a particular file that may be known by many different names in the system of programs. Next, enter from one to three of the following variables, line by line, on each worksheet:

1. Program ID
2. Record name
3. Qualification

Each line represents one selection statement

Each line on the worksheet represents one selection statement. The variable(s) specified on each line causes the Cross Reference Processor to select the defined subset of records. For example, supplying a program ID only specifies that all records from the named program are to be included in the report, supplying a record name only specifies that the record associated with that name is to be included. Often, a single record from a file is called by many different names in a system of programs. In this case, many separate names are needed to specify the selection of all copies of the record. Each line contains a different name for the record. Guidelines for specifying various combinations of the three variables are presented below.

Use Program Processor reports to fill in worksheets

The reports produced by the Program Processor can be helpful in filling in the worksheets:

• The File and Record Layouts Report can be used to find file names and record names without having to search through the COBOL source code for all of the programs. This report can also be used to research READ INTO and WRITE FROM statements to locate the resultant copies of records that may reside in the WORKING STORAGE or LINKAGE sections under different names.
• The DATA DIVISION Cross Reference Report can be used to track MOVE statements that move 01-level records from the FILE section to the WORKING STORAGE section or the reverse. This tracking aids in locating copies of records.

Guidelines for specifying selection variables

The record name is the key variable in specifying selection criteria. Most commonly, the record name alone is used to identify a member of the group of records to be reported on. However, it may be advantageous to further qualify record name (because, for example, the name is not unique) or to request the inclusion of records without regard to record name (because, for example, the objective of the report is to look at all records in the LINKAGE section of all programs). All possible combinations of program id, record name, and qualification are valid. Listed below are guidelines for supplying the program id, the record name, and/or a qualification. Note that the qualification can be an FD file name or keywords to indicate the WORKING STORAGE or LINKAGE sections.

Summary table

The following table summarizes the subsets of records selected based on the combination of variables specified.