FCOPY Reference Manual (32212-90008)
64 Chapter5
FCOPY Functions
CLEAR
CLEAR
Displays the contents of a file, record by record, in the form of character symbols for all
codes in the file. The graphic representation of each code depends upon how the displaying
device interprets the code: whether as a command, a displayable character, or a
nondisplayable character. If an output device interprets a code as a command, it displays
nothing unless you have entered a "display functions" mode at a terminal that has such a
mode.
Syntax
;CLEAR [;{HEX
HEXO
OCTAL}] [;NORECNUM] [;TITLE=
title
]
Where:
OCTAL Displays octal codes. Refer to the OCTAL description 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.
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
Use CLEAR to display files that contain codes other than ASCII. Unlike CHAR, CLEAR does
not replace character codes with decimal points.
You can combine the CLEAR 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 (refer to "Notes"
below).