FCOPY Reference Manual (32212-90008)

84 Chapter5
FCOPY Functions
KANA
KANA
Displays the contents of a file, record by record, in the form of JIS character symbols. KANA
displays symbols not represented by characters in JIS code as decimal points.
Syntax
;KANA [;{HEX
HEXO
OCTAL}] [;NORECNUM] [;TITLE=
title ]
Where:
OCTAL Displays octal codes. Refer to the OCTAL description in this chapter.
HEX Displays hexadecimal codes. Refer to the HEX description in this chapter.
HEXO Displays the data in hexadecimal and the record number in octal. Refer to
the HEXO description in this chapter.
NORECNUM Omits file identification information, record numbers, and word offset
numbers.
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 ultimately prints the data, and must be equal to or greater than 60
bytes.
Operation
You can combine the KANA 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).
The tofile can be a printer, a 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. 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. However, if all the
characters are blanks in an ASCII file or zeros in a binary file, FCOPY displays only the
SAME TO message.