Define column headings

The COLHEAD process statement defines column headings and specifies the location and format of the corresponding data to be displayed. For an example of a listing with column headings, see Figure 2.

Note: COLHEAD is not available for side-by-side listings. (See “NARROW” process option).

Compare Type: LINE


>>-COLHEAD--'--heading1--'--,--+----------------+--,------------>
                               '-'--heading2--'-'      

                                                    (1)   
>--start_print_column--:--end_print_column--,--N-- ------------->

                                         (2)  .-C-.   
>--start_column--:--last_start_column-- ------+---+------------->
                                              +-B-+   
                                              +-D-+   
                                              +-P-+   
                                              '-Z-'   

>--+---------------------------------------------------------------+-><
   |         (1)                                        (2)  .-C-. |   
   '-,--O-- ------start_column--:--last_start_column-- ------+---+-'   
                                                             +-B-+     
                                                             +-D-+     
                                                             +-P-+     
                                                             '-Z-'

Notes:

N and O must be followed by a space.
C, B, D, P, or Z must be preceded by a space.

heading1

The heading to appear on the first line for the print column.

heading2

The heading to appear on the second line for the print column.

start_print_column

The starting print column for the heading specified.

end_print_column

The ending print column for the heading specified. (Must be separated from the start_print_column by a colon.)

Note: If the print-column range is shorter than the heading specified, the heading is truncated.

N

Indicates the operands following relate to the new file.

start_column

The starting position in the new file of the data to be displayed.

last_start_column

The ending position in the new file of the data to be displayed. (Must be separated from the start_column by a colon.)

Data Format Indicator

The format of the data in the new file to be displayed:

C: Character
B: Binary
D: Unsigned packed decimal
P: Packed decimal
Z: Zoned decimal

O

Indicates the operands following relate to the old file.

start_column

The starting position in the old file of the data to be displayed.

last_start_column

The ending position in the old file of the data to be displayed. (Must be separated from the start_column by a colon.)

Data Format Indicator

The format of the data in the old file to be displayed (as for the new file).

Example: Description
COLHEAD 'START','DATE',1:7,N 1:6 P,O 11:16: Defines a print column with a heading of "START" in the first line and "DATE" in the second heading line, headings to start in print column 1. The data to be displayed from the new file is in positions 1 through 6 and is in packed format. The data to be displayed from the old file is in positions 11 through 16 and is in (the default) character format.