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

EBCDIKIN/EBCDIKOUT

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

EBCDIKIN translates code from EBCDIK (IBM Standard) to JIS (Japanese Industrial Standard). EBCDIKOUT translates code from JIS to EBCDIK.

Syntax

   ;{EBCDIKIN

     EBCDIKOUT} [={field

                  (field[;field[;...] ]) }[,EXCLUDE] ]

Where:

field

Is a single unsigned integer, or a pair of unsigned integers representing column numbers within the records in the form a; a, b; or a:b. (The first column of a record is column #1.)

In the form a

  • a is the starting column

  • the last column in the record is the ending column

In the form a,b

  • a is the starting column

  • b is the number of columns to be converted

In the form a:b

  • a is the starting column

  • b is the ending column

EXCLUDE

Specifies that the referenced fields are not to be translated.

Operation

These functions support the Katakana language. Use EBCDIKIN and EBCDIKOUT to translate information between EBCDIC and the HP KANA8 character sets. The mapping between these character sets is defined by JIS and by IBM. For more information, refer to the Native Language Support Reference Manual (32414-90001) for MPE V/E or the Native Language Programmer's Guide (32650-90022) for MPE XL. Use these functions when, for example, you copy files to magnetic tapes in order to transfer them from one system to another.

The field and EXCLUDE parameters let you select a portion of the file to be translated. If you do not specify fields or EXCLUDE, the system converts all data within each record in the file to EBCDIK. If you specify fields without specifying EXCLUDE, the system converts only the data within those fields. If you specify fields and EXCLUDE, the system converts all data in each record except for data within the specified fields.

Restrictions

You cannot combine EBCDIKOUT with the CHAR, CLEAR, KANA, OCTAL, HEX, or HEXO functions.

Notes

When you use EBCDIKIN with the SUBSET function, the system makes the conversions first.

Refer to appendix C for a complete list of conversion codes.

The maximum number of fields you can specify is 255.

FCOPY does not translate user labels when translating a file.

Examples

The example below copies all records except columns 3 through 6 from the file CODFILE1 to the file CODFILE2, converting the columns from EBCDIK to JIS code.

   >FROM=CODFILE1;TO=CODFILE2;EBCDIKIN=3:6,EXCLUDE

The following example copies records 1 through 30 of FILEA to FILEB, converting the data from JIS to EBCDIK code.

   >FROM=FILEA;TO=FILEB;EBCDIKOUT=1:30
Feedback to webmaster