Including an EBCDIC user table

You can create an EBCDIC user table and then create an EBCDIC user table translated file by using the EBCDIC User Table Translate command.

The templates for the EBCDIC user table files are stored in the 'USERCODE' file in the library where HULFT is installed. EBCDIC user table translated files are stored in the 'UCEXTDF' file in the library where HULFT is installed.

Note

You may not be able to use EBCDIC user tables, depending on the combination of codes from which and to which HULFT carries out conversion. For details, refer to the following:

HULFT10 Code Conversion Manual : Combinations that allow EBCDIC user tables to be used

When you use the user table during single-byte conversion to and from Type Win-UX hosts, it is necessary to include the EBCDIC user table.

Based on some templates, you can register 3 user code tables at the maximum.

For details of code conversion, refer to the following:

HULFT10 Code Conversion Manual : Single byte code conversions by HULFT

Table 3.14 EBCDIC user table template files
EBCDIC Set	Model Member Name
EBCDIC Set	ASCII -> EBCDIC	EBCDIC -> ASCII
Katakana	AS2EBKN	EB2ASKN
Lowercase	AS2EBEL	EB2ASEL
ASCII	AS2EBAC	EB2ASAC
ASPEN	AS2EBAP	EB2ASAP
Japan (Latin) for IBM	AS2EBIBM	EB2ASIBM
Japan (Latin) Extended for IBM	AS2EBEXT	EB2ASEXT
NEC Katakana	AS2EBNEC	EB2ASNEC
Japan (Katakana) Extended for IBM	AS2EBKX	EB2ASKX

Table 3.15 EBCDIC user table translated files
EBCDIC Set	Member Name
User table 1	USR1
User table 2	USR2
User table 3	USR3

EBCDIC User Table Translate command

Program interface

CALL library name/UTLUCEXTD PARM(['LIB=library name'] ['I=infilename'] 
   'R=Codeset name' ['O=outfilename'|'O'] ['G'] ['OUTPUT=filename'] 
   ['EXIT' CL Variable name])

Parameter explanation

LIB=library name

Library name in which HULFT is installed (HULFT by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.

I=infilename

File name of the EBCDIC user table file (Optional)

Specify this parameter in the format of 'Library name/File name(Member name).'

You can omit this parameter only if you specify 'O=' parameter or 'O.'

R=Codeset name

User table to be expanded (Mandatory)

USER1 :: Set up as user table 1
USER2 :: Set up as user table 2
USER3 :: Set up as user table 3

O=outfilename | O

Output the content of the registered user table (Optional)

Specifying 'O=' outputs contents to a file, while specifying 'O' outputs them to standard output.

As the output format is the same as the EBCDIC user table file, you can use the contents output to the file as EBCDIC user table file.

You can omit this parameter only when you specify 'I=' parameter.

G

Control of error messages (Optional)

When omitted, HULFT displays error messages.

OUTPUT=filename

Destination of the error messages (Optional)

Specify this parameter in the format of 'Library name/File name(Member name).'

When omitted, error messages are not output.

The number of log records that a log file can retain is unlimited.

EXIT CL Variable name

Receiving of an error code and CL Variable name (Optional)

The CL Variable name must immediately follow EXIT tag.

When omitted, an error code is not set.

Command interface

UTLUCEXTD IFILE( ) IMBR( ) UC( ) OUT( ) PFILE( ) PMBR( ) 
   LIBRARY( ) MSG( ) FILE( ) MBR( )

Parameter explanation

IFILE

Library name and file name of EBCDIC user table file (Optional)

Specify this parameter in the format of 'Library name/File name.'

Specify these names in alphanumeric characters within 10 bytes starting with an alphabetic character, respectively.

You can default this tag only when you specify either '*STD' or '*FIL' in the parameter OUT.

IMBR

Member name of EBCDIC user table file (*FILE by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.

UC

User table to be expanded (Mandatory)

USER1 :: Set up as user table 1
USER2 :: Set up as user table 2
USER3 :: Set up as user table 3

OUT

Output the content of the registered user table (*NO by default)

*NO :: Do not output
*STD :: Output to standard output
*FIL :: Output to the file specified by 'PFILE'

PFILE

Library name and file name of the output file (Optional)

Specify this parameter in the format of 'Library name/File name.'

Specify these names in alphanumeric characters within 10 bytes starting with an alphabetic character, respectively.

PMBR

Member name of the file to which the table is output (*FILE by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.

LIBRARY

Library name in which HULFT is installed (HULFT by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.

MSG

Control of error messages (*YES by default)

*NO :: Suppress error messages.
*YES :: Show error messages.

FILE

Name of the library and the file to which error messages are output (Optional)

Specify this parameter in the format of 'Library name/File name.'

Specify these names in alphanumeric characters within 10 bytes starting with an alphabetic character, respectively.

When omitted, error messages are not output. The number of log records that a log file can retain is unlimited.

MBR

Member name of the file to which error messages are output (*FILE by default)

Specify this parameter in alphanumeric characters within 10 bytes starting with an alphabetic character.