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