HP 3000 Manuals

EBCDIKIN/EBCDIKOUT [ FCOPY Reference Manual ] MPE/iX 5.0 Documentation


FCOPY Reference Manual

EBCDIKIN/EBCDIKOUT 

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

Syntax 

;{EBCDIKIN } [={field                }[,EXCLUDE]]
 {EBCDIKOUT} [ {(field[;field[;...]])}          ]
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 



MPE/iX 5.0 Documentation