| 
|  | » |  | 
 |  | Displays the contents of a file, record by record, as 
character code numbers in hexadecimal form. | Syntax |  |  | 
| 
   ;HEX [;{CHAR
           CLEAR
           KANA} ] [;NORECNUM] [;TITLE=title]
 | 
 Where: CHARDisplays character symbols
in ASCII code.  Refer to the CHAR description in this chapter.
CLEARDisplays all character
symbols. Refer to the CLEAR description in this chapter.
KANADisplays JIS character
symbols. Refer to the KANA description in this chapter.
NORECNUM Omits file identification
information, record numbers, and word offset numbers.titleIs 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 will ultimately print the data, and must be
equal to or greater than 60 bytes.| Operation |  |  | 
You can combine the HEX 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.| Example |  |  | 
In the example below, the file TEXT3.PUB.ACCOUNT is an ASCII
file created by using EDIT/3000. The
hexadecimal 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 example displays the file TEXT3 in both hexadecimal
and character format. Since it does not
specify a language for the CHAR function, FCOPY uses the
default, NATIVE-3000.  (Refer to the CHAR
description in this chapter.) FCOPY prints the title line
described by the title parameter. | 
   >FROM=TEXT3;TO=*LP;HEX;CHAR; &
   TITLE="EXAMPLE OF CHAR/HEX DISPLAY"
   EXAMPLE OF CHAR/HEX DISPLAY
   TEXT3.PUB.ACCOUNT         RECORD       0 (%0)
   0000:  5448  4953  2049  5320  4C49  4E45  2031  2E20  THIS IS LINE 1.
   0008:  2054  4845  2038  2D44  4947  4954  204E  554D  THE 8-DIGIT NUM
   0010:  4245  5253  2041  5420  5448  4520  5249  4748  BERS AT THE RIGH
   0018:  5420  4152  4520  5448  4520  2020  2020  2020  T ARE THE 
   0020:  2020  2020  2020  2020  3030  3030  3130  3030    00001000
 | 
 |