HP 3000 Manuals

KANA [ FCOPY Reference Manual ] MPE/iX 5.0 Documentation


FCOPY Reference Manual

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 

      [ {HEX  }]
;KANA [;{HEXO }] [;NORECNUM] [;TITLE=title]
      [ {OCTAL}]
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, 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, 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.



MPE/iX 5.0 Documentation