HP 3000 Manuals

HEX [ FCOPY Reference Manual ] MPE/iX 5.0 Documentation


FCOPY Reference Manual

HEX 

Displays the contents of a file, record by record, as character code
numbers in hexadecimal form.

Syntax 

     [ {CHAR }]
;HEX [;{CLEAR}] [;NORECNUM] [;TITLE=title]
     [ {KANA }]
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.

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 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



MPE/iX 5.0 Documentation