HP 3000 Manuals HP 3000 Manuals
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
[ {HEX }]
;CLEAR [;{HEXO }] [;NORECNUM] [;TITLE=title]
[ {OCTAL}]
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