neinit(1M) MISC. REFERENCE MANUAL PAGES neinit(1M)
NAME
neinit - compile a National Language source
file for EXPRESS TN3270-C
SYNOPSIS
neinit [-s InputFile] [-o OutputFile]
DESCRIPTION
Using the neinit utility, EXPRESS TN3270-C can be customized
to work with any single-byte national language. The neinit
utility compiles a National Language source file. The source
file relates EBCDIC codes with mnemonics from the Universal
ASCII character set.
When invoked, neinit uses standard EBCDIC associations for
the alphanumeric and punctuation display characters. How-
ever, if display characters associated with a particular
National Language character set are undefined, neinit
defines these display characters using the National Language
source file. If invalid conditions occur, the neinit utility
generates error messages.
The neinit utility compiles the National Language source
file to produce a National Language output file (NLO.).
Then, EXPRESS TN3270-C must be configured to use the custom
national language via tn3270c(4) configuration files. To
support the new national language, create a keyboard mapping
using kminit(1M) and then customize both the display and
printer using dcinit(1M) and prinit(1M), respectively.
OPTIONS
-s InputFile
specifies the name of the National Language source
file. If -s InputFile is omitted, the environment vari-
able NESRC is used to obtain the National Language
source file. If NESRC is not defined, the default file
name NLI.US is assumed. If the source file is not found
in the current duirectory, $COMMLINK/adm/natlang is
also searched.
-o OutputFile
specifies the name of the compiled National Language
output file. If -o OutputFile is omitted, the environ-
ment variable NEOBJ is used to obtain the file name. If
NEOBJ is not defined, the $COMMLINK/adm/natlang/NLO.US
is assumed. The pathname $COMMLINK/adm/natlang is
appended to the beginning of the file name unless the
name starts with "/" or "./". The compiled National
Language file must be named with the prefix NLO. and be
placed in the $COMMLINK/adm/natlang directory to be
available when using tn3270c(1).
Last change: 4/13/954 1
neinit(1M) MISC. REFERENCE MANUAL PAGES neinit(1M)
BUILDING THE NATIONAL LANGUAGE SOURCE FILE
The standard 3270 character set size defined by IBM is 88
displayable graphics: 74 constant characters and 14 specific
3270 character codes reserved for "National Usage" charac-
ters. The 14 specific character codes in EBCDIC hexadecimal
are as follows: 4a, 4f, 5a, 5b, 5f, 6a, 79, 7b, 7c, 7f, a1,
c0, d0, and e0. Using these codes, IBM created national
usage sets for different countries.
EXPRESS TN3270-C is supplied with files for 19 national
languages, including both a source file (prefix NLI.) and a
compiled output file (prefix NLO.) created by the neinit
utility. Standard IBM national character sets are included
in the EXPRESS TN3270-C supplied files. All supplied
national language files are located in
$COMMLINK/adm/natlang. If you are using a national language
other than one of the 19 supported with the supplied files,
you must define a new National Language (NLI.) source file.
The National Language source file can be written in either
termcap or terminfo syntax.
termcap SYNTAX
In standard termcap description files, capability descrip-
tions are separated by colons. All description lines except
the first must start with white space and a colon. All
description lines except the last must end with a colon,
backslash, and newline. The last description line must end
with a colon. Any line can be designated as a comment by
placing a number sign (#) in the first non-whitespace posi-
tion of the line. The syntax of a termcap-style National
Language source file is as follows:
FileDescription:\
:AEDescription:\
.
.
.
:AEDescription:\
:AEDescription:
FileDescription is a character string, used to identify the
file (for example, English).
AEDescription is an ASCII/EBCDIC association description,
which has the following format:
Mnemonic=EbcdicCode
Mnemonic is one of the Universal ASCII mnemonics listed in
the EXPRESS TN3270-C Administrator's Reference Guide.
Last change: 4/13/954 2
neinit(1M) MISC. REFERENCE MANUAL PAGES neinit(1M)
EbcdicCode is a two-digit EBCDIC hexadecimal code which is
to be paired with the associated ASCII character.
terminfo SYNTAX
In standard terminfo description files, capability descrip-
tions are separated by commas. Whitespace (including new-
lines) between a comma and the start of the next capability
description is ignored. Any line can be designated as a com-
ment by placing a number sign (#) in the first non-
whitespace position of the line. The syntax of a terminfo-
style National Language source file is as follows:
FileDescription,
AEDescription,
.
.
.
AEDescription,
AEDescription
FileDescription and AEDescription have the same meanings as
described above.
FILES
The following National Language files are located in
$COMMLINK/adm/natlang:
NLI.AG1 Austrian/German source file
NLI.AG2 Austrian/German (alternate) source file
NLI.B Belgian source file
NLI.BP Brazilian/Portuguese source file
NLI.C Canadian (French) source file
NLI.DN1 Danish/Norwegian source file
NLI.DN2 Danish/Norwegian (alternate) source file
NLI.F French source file
NLI.FS1 Finnish/Swedish source file
NLI.FS2 Finnish/Swedish (alternate) source file
NLI.I Italian source file
NLI.ITNL International source file
NLI.J Japanese (Roman characters) source file
Last change: 4/13/954 3
neinit(1M) MISC. REFERENCE MANUAL PAGES neinit(1M)
NLI.P Portuguese source file
NLI.S1 Spanish source file
NLI.S2 Spanish (alternate) source file
NLI.SS Spanish Speaking source file
NLI.UK English (U.K.) source file
NLI.US English (U.S.) source file
A compiled version of each source file is also provided with
EXPRESS TN3270-C. The filenames for the compiled versions
start with "NLO" rather than "NLI".
SEE ALSO
tn3270c(1), dcinit(1M), kminit(1M), prinit(1M), tn3270c(4),
EXPRESS TN320-C Administrator's Reference Guide
Last change: 4/13/954 4