Displaying the record length

When you are viewing a file in a multi-line display format (TABL, CHAR, HEX, or LHEX), you can select to display the record length of each record.
Note: In SNGL and zoomed display formats, the record length is always displayed.
The display of this information is initially controlled by options in the Editor Options panels (which apply to each new editor session):
Display record length
Turns on the display of record lengths. By default, Z Data Tools displays the record length on the left of the data.
Display record length on the right
Displays the record length on the right of the data (only when the Display record length option is selected or if you issue the RECLEN ON command during an editor session).
Record length width (A,3,4,5,6)
Controls the width of the record length display area.

However, when viewing data in an editor session you can use the RECLEN primary command to temporarily change the record length display options for the current editor session:

RECLEN ON
Turn on the display of record lengths. (Record lengths are displayed on the left of the data, unless the Display record length on the right editor option is selected.)
RECLEN OFF
Turn off the display of record lengths.
RECLEN RIGHT
Turn on the display of record lengths and display record lengths on the right of the data.
RECLEN n
Set the width of the record length display area to n characters, where n can be 3, 4, 5, or 6.
RECLEN A
Set the width of the record length display area according to the value of the record lengths.
Figure 1 shows part of a file displayed in an editor session with no record length information displayed.
Figure 1. Data displayed in an editor session with no record length details shown
  Process   Options   Help
 ───────────────────────────────────────────────────────────────────────────────
 View             PROWSE.JCL(HFMCDATA)                             Top of 40
                                                  Record AT TOP     Format TABL
        REC-TYPE NAME                 EMPLOYEE-NO     AGE   SALARY    MONTH(1)
        #2       #3                            #4      #5       #6          #7
        AN 1:2   AN 3:20                  BI 23:2 BI 25:2  PD 27:4     BI 31:4
        <>       <---+----1----+---->      <---+>  <---+> <---+--> <---+----1>
 ****** ****  Top of data  ****
 000001 01       Garry Northfield            7712      96    75111           6
 000002 01       Graeme Bevan                6612      21    75000          30
 000003 01       Philip Padler               5512      94    68000           7
 000004 01       Will Lever                  4412      28    68000           5
 000005 01       Tiryll Dasher               3312      21    60000          14
 000006 01       Ron Turtle                  5612     100   100000          28
 000007 01       David Nelson                2212     100   100000          44
 000008 01       Jon Bloodston               1112     110   125000          47
 000009 01       Stephen Poot                2312      50    60000           1
 000010 01       Dan Peterah                 4412      55    63000          38
 000011 01       Jean Flowerpat              3412      40    67000          14
 000012 01       Liz Hurring                 3412      40    66000          44
 Command ===>                                                       Scroll CSR 
  F1=Help      F2=Zoom      F3=Exit      F4=CRetriev  F5=RFind     F6=RChange
  F7=Up        F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel
To display the record length information on the left of the data, enter:
RECLEN LEFT
Alternatively, if the Display record length on the right option on the relevant Editor Options panel is not selected, you can enter:
RECLEN ON
Figure 2 shows the same data displayed with the record length displayed on the left of the data.
Figure 2. Record length details displayed in editor session on left of data
  Process   Options   Help
 ───────────────────────────────────────────────────────────────────────────────
 View             PROWSE.JCL(HFMCDATA)                             Top of 40
                                                  Record AT TOP     Format TABL
            REC-TYPE NAME                 EMPLOYEE-NO     AGE   SALARY
            #2       #3                            #4      #5       #6
            AN 1:2   AN 3:20                  BI 23:2 BI 25:2  PD 27:4
            <>       <---+----1----+---->      <---+>  <---+> <---+-->
 ******     ****  Top of data  ****
 000001  80 01       Garry Northfield            7712      96    75111
 000002  80 01       Graeme Bevan                6612      21    75000
 000003  80 01       Philip Padler               5512      94    68000
 000004  80 01       Will Lever                  4412      28    68000
 000005  80 01       Tiryll Dasher               3312      21    60000
 000006  80 01       Ron Turtle                  5612     100   100000
 000007  80 01       David Nelson                2212     100   100000
 000008  80 01       Jon Bloodston               1112     110   125000
 000009  80 01       Stephen Poot                2312      50    60000
 000010  80 01       Dan Peterah                 4412      55    63000
 000011  80 01       Jean Flowerpat              3412      40    67000
 000012  80 01       Liz Hurring                 3412      40    66000
 Command ===>                                                       Scroll CSR 
  F1=Help      F2=Zoom      F3=Exit      F4=CRetriev  F5=RFind     F6=RChange
  F7=Up        F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel
To display the record length information on the right of the data, enter:
RECLEN RIGHT
Alternatively, if the Display record length on the right option on the relevant Editor Options panel is selected, you can enter:
RECLEN ON
Figure 3 shows the same data displayed with the record length displayed on the right of the data.
Figure 3. Record length details displayed in editor session on right of data
  Process   Options   Help
 ───────────────────────────────────────────────────────────────────────────────
 View             PROWSE.JCL(HFMCDATA)                             Top of 40
                                                  Record AT TOP     Format TABL
        REC-TYPE NAME                 EMPLOYEE-NO     AGE   SALARY
        #2       #3                            #4      #5       #6
        AN 1:2   AN 3:20                  BI 23:2 BI 25:2  PD 27:4
        <>       <---+----1----+---->      <---+>  <---+> <---+-->
 ****** ****  Top of data  ****
 000001 01       Garry Northfield            7712      96    75111            80
 000002 01       Graeme Bevan                6612      21    75000            80
 000003 01       Philip Padler               5512      94    68000            80
 000004 01       Will Lever                  4412      28    68000            80
 000005 01       Tiryll Dasher               3312      21    60000            80
 000006 01       Ron Turtle                  5612     100   100000            80
 000007 01       David Nelson                2212     100   100000            80
 000008 01       Jon Bloodston               1112     110   125000            80
 000009 01       Stephen Poot                2312      50    60000            80
 000010 01       Dan Peterah                 4412      55    63000            80
 000011 01       Jean Flowerpat              3412      40    67000            80
 000012 01       Liz Hurring                 3412      40    66000            80
 Command ===>                                                       Scroll CSR 
  F1=Help      F2=Zoom      F3=Exit      F4=CRetriev  F5=RFind     F6=RChange
  F7=Up        F8=Down      F9=Swap     F10=Left     F11=Right    F12=Cancel

To set the width of the field length display area for all editor sessions, set the Record length width option on the relevant Editor Options panel to A, 3, 4, 5, or 6. Setting this option to "A" causes the width of the record length area to be automatically adjusted as required.

To change the width of the field length display area for the current editor session, issue the RECLEN command. For example, to change the width of the field length display area to 4, enter:
RECLEN 4

Related topics