FCOPY Reference Manual (32212-90008)

62 Chapter5
FCOPY Functions
CHAR
The tofile can be a printer, terminal, or an intermediate disk file. If the tofile is a disk file,
its records must be at least 60 bytes in length.
If you do not specify NORECNUM and words are 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. If the entire record consists of the same character, FCOPY displays at least one line
of the repeated character before printing the SAME TO message, as shown in the following
example. 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 CHAR with VERIFY, NEW, EBCDICOUT, EBCDIKOUT, or BCDICOUT.
Notes
The FCOPY display functions that show both numeric codes and character symbols are
particularly useful because they let you examine the contents of a file either at a terminal
or in a printer listing.
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 CHAR and OCTAL functions have been combined to show the
correspondence between the two forms.
This combined command displays the contents of a file. CHAR suppresses terminal
recognition of such things as control sequences imbedded in the file to which the terminal
would otherwise be sensitive. Escape codes and other nongraphic control characters are
shown as dots, allowing you to see the exact position within the file of all the displayable
characters. Refer to the CLEAR function for relevant information.
For example,
FCOPY FROM=DISPL;TO=;OCTAL;CHAR
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