FCOPY Reference Manual (32212-90008)

Chapter 5 61
FCOPY Functions
CHAR
CHAR
Displays the contents of a file, record by record, in the form of character symbols in ASCII
code. CHAR displays character codes not represented by symbols in ASCII code as decimal
points.
Syntax
;CHAR [;{HEX
HEXO
OCTAL} ] [;NORECNUM] [;TITLE=
title ] [;LANG= language ]
Where:
OCTAL Displays octal codes. Refer to the description of OCTAL in this section.
HEX Displays hexadecimal codes. Refer to the HEX description in this section.
HEXO Displays the data in hexadecimal and the record number in octal. Refer to
the HEXO description in this section.
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.
language Is the name or number of the language in which to display character
symbols. FCOPY uses the character definition table associated with the
specified language. The default is NATIVE-3000. For more information,
refer to the Native Language Support Reference Manual (32414-90001) for
MPE V/E or the Native Language Programmer's Guide (32650-90022) for
MPE XL.
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 CHAR function with the OCTAL, HEX,orHEXO functions, one at a time, to
display numerical codes as well as character symbols. You may want to display numerical
codes along with character symbols when, for example, the output device to which you are
copying automatically upshifts lowercase characters, or when you encounter a disk or
magnetic tape file with unknown contents (refer to "Notes" below).