LINE

Description

The LINE command allows you to select whether the line command area displays statement numbers, offsets, or addresses. It affects the source and memory displays for the duration of a test session.

A record of the command is written to the session log.

Input

The following are the parameter descriptions for the LINE command:

STATE

The line command area, which is six characters long, displays the assembler-generated statement numbers. STATE is the default format for the line command area on the Source screen.

STATE is not valid on the Memory screen, and when used, the Memory screen returns to the offset or default format.

24

The line command area displays the hexadecimal address of each instruction. The entire line command area is six characters long to represent 24-bit addressing. If your program actually uses 31-bit addressing, only the low-order three bytes of the address are displayed.

31

The line command area displays the hexadecimal address of each instruction. The entire line command area is eight characters long to represent 31-bit addressing. If an Assembler program is actually using 24-bit addressing, the high-order byte of the address is displayed as 00.

OFFset

The six characters in the line command area display a hexadecimal offset relative to the beginning of the module. If the source module contains multiple CSECTs, the offsets in the line command area may not be contiguous. OFFSET is the default format for the line command area on the Memory screen if the source display is set to Line Statement.

Usage Notes

1. Any time the LINE command is entered on the Source screen and the line command area format changes, the execution status message and the session log/script record of breakpoints also change format.
2. Breakpoint indicators are displayed in column 9 of the Source screen when 24-bit addressing is active and in column 11 when 31-bit addressing is active.

1. The LINE command zeros out the offsets and addresses (24-bit and 31-bit) of the COBOL Data Division lines, PL/I, or C language data lines (DCLs).

Examples

1. The result of entering the LINE OFFSET command is shown in the following figure. The six-character line command area now displays the hexadecimal offset for each statement. The line command area contains a dashed line if a statement does not have a listing offset associated with it.
   LINE OFFSET Format on the Source Screen
    

   ------------------------ CODE DEBUG TSO - SOURCE --------------------------------
   COMMAND ===> line 24                                           SCROLL ===> CSR
   PROGRAM: TRIMAIN    MODULE: TRIMAIN   COMP DATE: 07/28/1995  COMP TIME: 14:54:33
           ** END **
   
   ------   ----------------------------------------- Before TRIMAIN+5F2/AMODE 24 <>
   00050C B  PROCEDURE DIVISION
   00050C     MAIN-PARA.
   00050C        PERFORM INIT-PARA.
   000528        PERFORM ANALYZE-NEXT-REC
   ------            UNTIL OUT-OF-RECS = ’Y’.
   00054C        PERFORM ENDING-PARA.
   000568 A      GOBACK.
   000592     INIT-PARA.
   000592         MOVE ZERO TO N-CNTR (1) N-CNTR (2) N-CNTR (3) N-CNTR (4).
   0005AA         OPEN INPUT INFILR.
   0005E8         MOVE ’N’ TO OUT-OF-RECS.
   M====> B   ANALYZE-NEXT-REC.
   0005F2         READ INFILE INTO WORK-REC
   ------            AT END
   000622            MOVE ’Y’ TO OUT-OF-RECS.

2. If the LINE 24 command is entered on the command line and M is entered in the line command area to display memory from the specified location, the result will be as shown in the following figure. 24-bit addressing is used to display the hexadecimal address of the memory display starting at the specified location. The line command area is still six characters long.
   LINE 24 Format on the Memory Screen 

   ------------------------- CODE DEBUG TSO - MEMORY -----------------------------
   COMMAND ===> line 31                                           SCROLL ===> CSR
   PROGRAM: TRIMAINA  MODULE: TRIMAINA  COMP DATE: 07/20/1995  COMP TIME: 14:41:00
   ------------------------------------------- Before TRIMAINA:10A9AE/AMODE 24 ---
                 0 - 2 -    4 - 6 -    8 - A -    C - E -   =  0-2-4-6-8-A-C-E-
    10A9AE  ===> 00B0C0F0   50DB0004   50BD0008   18DB4510  =  ..{0&...&.......
    10A9BE  ===> C01C8010   AAE00A13   9110C168   4780C0D8  =  {....\....A...{Q
    10A9CE  ===> F810C199   C1F8F810   C19BC1F8   F810C19D  =  8.A.A88.A.A88.A.
    10A9DE  ===> C1F8F810   C19FC1F8   4110C138   4100C1A2  =  A88.A.A8..A...A.
    10A9EE  ===> 1FFFBFF7   103105EF   92F0C1A1   070047F0  =  ...7.....0A~...0
    10A9FE  ===> CO5C0010   1C044110   C06447F0   C0680010  =  {*......{..0{...
    10AA0E  ===> AB4958F0   C05805EF   95F1C1A1   4780C092  =  ...0{....1A~..{.
    10AA1E  ===> 95F2C1A1   4780C09C   95F3C1A1   4780C0A6  =  .2A~..{..3A~..{.
    10AA2E  ===> 95F4C1A1   4790C0B0   47F0C03E   FA10C199  =  .4A~..{..0{...A.
    10AA3E  ===> C1F947F0   C03EFA10   C19BC1F9   47F0C03E  =  A9.0{...A.A9.0{.
    10AA4E  ===> FA10C19D   C1F947F0   C03EFA10   C19FC1F9  =  ..A.A9.0{...A.A9
    10AA5E  ===> 47F0C03E   070047F0   C0C40010   1C4C4110  =  .0{....0{D...<..
    10AA6E  ===> C0CC47F0   C0D00010   AB4158F0   C0C005EF  =  {..0{}.....0{{..
    10AA7E  ===> 07004510   C0E08010   AAE00A14   00DD0004  =  ....{\...\......
    10AA8E  ===> 98ECD00C   07FE0000   00000000   00000000  =  ..}.............
    10AA9E  ===> 00000000   00000000   00000000   00000000  =  ................
    10AAAE  ===> 00000000   00000000   00000000   00000000  =  ................
    10AABE  ===> 00000000   00000000   00000000   00000000  =  ................
    10AACE  ===> 00000000   00000000   00000000   00000000  =  ................

3. When the LINE 31 command is entered on the command line, the line command area is expanded to eight characters. For example:
   0845BCBA