HPlogo FCOPY Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 5 FCOPY Functions

KANA

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

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, 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.

Feedback to webmaster