Displays the contents of a file, record by record, as
character code numbers in octal form.
| Syntax | 
|  | 
| 
   ;OCTAL [;{CHAR
             CLEAR
             KANA}] [;NORECNUM] [;TITLE=title]
 | 
Where:
- CHAR
- Displays character symbols in
ASCII code. Refer to the CHAR description in this chapter.
 
- CLEAR
- Displays all character
symbols. Refer to the CLEAR description in this chapter.
 
- KANA
- Displays JIS character
symbols. Refer to the KANA description in this chapter.
 
- NORECNUM
- Omits file identification
information, record numbers, and word offset numbers from the display.
 
- title
- Is a character string to be
used as the title of the display. If the tofile is a printer, the title is
printed at the top of each page. Otherwise, the title is written only once, at
the
beginning of the tofile. The title may contain up to 62 characters but may
not
be broken to be continued on the following line.
 
| File Attributes | 
|  | 
The fromfile must have read access and the tofile
must have write access. The tofile is normally a list device
such as $STDLIST, but it can also be another device for
intermediate storage. The record size for an
intermediate storage device should be the same as that of the
list device that ultimately prints the data and must be
greater than or equal to 60 bytes.
| Operation | 
|  | 
You can combine the OCTAL function with the CHAR,
CLEAR, or KANA functions, one at a time, to
display character symbols as well as numerical codes. The
tofile can be a printer, terminal, or an
intermediate disk file. If the tofile is a disk file, it must
be at least 60 bytes in length.
| Examples | 
|  | 
In the examples below, the file TEXT3.PUB.ACCOUNT is an ASCII
file created by using EDIT/3000. The
octal word number at the beginning of each line of data specifies
the sequential number within the record of
the first word of data in the line.
The command below produces the following display on an 80-column line
printer:
| 
   >FROM=TEXT3;TO=*LP;OCTAL
   TEXT3.PUB.ACCOUNT RECORD 0 (%0)
   00000: 052110  044523  020111  051440  046111  047105  020061 027040
   00010: 020124  044105  020070  026504  044507  044524  020116 052515
   00020: 041105  051123  020101  052040  052110  042440  051111 043510
   00030: 052040  040522  042440  052110  042440  020040  020040 020040
   00040: 020040  020040  020040  020040  030060  030060  030460 030006
   TEXT3.PUB.ACCOUNT RECORD 1 (%1)
   00000: 052105  054124  020105  042111  052117  051040  046111 047105
   00010: 020116  052515  041105  051123  027040  020116  047524 042440
   00020: 052110  040524  020124  044105  020122  042503  047522 042040
   00030: 047125  046502  042522  051140  020040  020040  020040 020040
   00040: 020040  020040  020040  020040  030060  030060  031060 030060
   TEXT3.PUB.ACCOUNT RECORD 2 (%2)
   00000: 051525  050120  046111  042504  020102  054440  043103 047520
   00010: 054440  051524  040522  052040  040524  020132  042522 047440
   00020: 053510  044514  042440  052110  042440  052105  054124 020105
   00030: 042111  052117  051040  046111  047105  020040  020040 020040
   00040: 020040  020040  020040  020040  030060  030060  031460 030060
 | 
The following example combines octal and character display.
| 
   >FROM=TEXT3;TO=*LP;OCTAL; CHAR; &
   TITLE="EXAMPLE OF CHAR/OCTAL DISPLAY"
 | 
The command produces the following display. The 8-digit numbers
at the end of each record are text editor line numbers, starting
at 1.
| 
   EXAMPLE OF CHAR/OCTAL DISPLAY 
   TEXT3.PUB.ACCOUNT RECORD 0 (%0)
   00000: 052110 044523 020111 051440 046111 047105 020061 027040 THIS IS LINE 1
   00010: 020124 044105 020070 028504 044507 044524 020116 052515 THE 8-DIGIT NUM
   00020: 041105 051123 020101 052040 052110 042440 051111 043510 BERS AT THE RIGHT
   00030: 052040 040522 042440 052110 042440 020040 020040 020040 ARE THE
   00040: 020040 020040 020040 020040 030060 030060 030460 030060 00001000
   TEXT3.PUB.ACCOUNT RECORD 1 (%1)
   00000: 052105 054124 020105 042111 052117 051040 046111 047105 TEXT EDITOR LINE
   00010: 020116 052515 041105 051123 027040 020116 047524 042440 NUMBERS. NOTE
   00020: 052110 040524 020124 044105 020122 042503 047522 042040 THAT THE RECORD
   00030: 047125 046502 042522 051140 020040 020040 020040 020040 NUMBERS
   00040: 020040 020040 020040 020040 030060 030060 031060 030060 00002000
   TEXT3.PUB.ACCOUNT RECORD 2 (%2)
   00000: 051525 050120 046111 042504 020102 054440 043103 047520 SUPPLIED BY FCOP
   00010: 054440 051524 040522 052040 040524 020132 042522 047440 Y START AT ZERO
   00020: 053510 044514 042440 052110 042440 052105 054124 020105 WHILE THE TEXT 
   00030: 042111 052117 051040 046111 047105 020040 020040 020040 EDITOR LINE
   00040: 020040 020040 020040 020040 030060 030060 031460 030060 00003000
 |