FCOPY Reference Manual (32212-90008)

Chapter 5 65
FCOPY Functions
CLEAR
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