 |
» |
|
|
|
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, or HEXO 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). 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. If you do not specify NORECNUM and there are words repeated
in the file, FCOPY suppresses the duplicate lines
and displays a message in the form SAME TO XXXX-1, where
XXXX is in octal. This is shown in the example below. If
the entire record contains the same character, FCOPY displays at
least one line of the repeated character
before printing the SAME TO message. However, if all the
characters are blanks in an ASCII file, or zeros
in a binary file, FCOPY displays only the SAME TO message.
Restrictions | |
You cannot combine CLEAR with VERIFY, NEW,
EBCDICOUT, EBCDIKOUT, or BCDICOUT. Notes | |
Some devices are capable of displaying only uppercase Roman
alphabetic characters. When you copy to
such a device, the device controller automatically converts
lowercase characters to uppercase. In such
instances, you may want to combine character and numerical
display functions to display the original character codes in
addition to the character symbols. Example | |
In the following example, the CLEAR and OCTAL functions
have been combined to show the
correspondence between the two forms. This combined function displays the contents of a file where the
effects of terminal control sequences need
to be seen. It can be used to display data on a terminal so
that video enhancements, cursor positioning, and other control
functions are made visible. See also the CHAR function. For example,
FCOPY FROM=DISPL;TO=;OCTAL;CLEAR
HP32212A.03.24 FILE COPIER (C) HEWLETT-PACKARD CO. 1984
DISPL RECORD 0 (%0, #0)
00000: 047157 073440 065563 020164 064145 020164 064555 062440 Now is the time
00010: 063157 071040 060554 066040 063557 067544 020155 062556 for all good men
00020: 020040 020040 020040 020040 020040 020040 020040 020040
00030: SAME: TO 000044-1
DISPL RECORD 1 (%1, #1)
00000: 052157 020143 067555 062440 072157 020164 064145 020141 To come to the
00010: 064544 020157 063040 072150 062440 070141 071164 074456 aid of the party.
00020: 020040 020040 020040 020040 020040 020040 020040 020040
00030: SAME: TO 000044-1
DISPL RECORD 2 (%2, #2)
00000: 015446 062104 052150 064563 020154 064556 062440 064563 This line is
00010: 020165 067144 062562 066151 067145 062056 015446 062100 underlined..
00020: 020040 020040 020040 020040 020040 020040 020040 020040
00030: SAME: TO 000044-1
EOF FOUND IN FROMFILE AFTER RECORD 2
3 RECORDS PROCESSED *** 0 ERRORS
END OF SUBSYSTEM
|
|
