The NGEN28/1/LTEACH file is a flat file, with the characteristics listed in the following table.
| For users of: | Generated applications |
| Contents: | Administration command (colon command) teach information (responses to the :TEA command) |
| Maximum Languages: | 15 |
| Structure: |
|
| Changes reloaded: | Automatically, after the application is next initiated and the first :TEA command is entered |
LTEACH Format
The NGEN28/1/LTEACH file consists of Administration (colon) command teach information in COBOL format, with COBOL line numbers in the first six columns. It contains the following three types of record:
Control record
Command header record
Text record
The format of the first control record is shown in the following table.
| First Control Record Properties | Size |
|---|---|
| Sequence number | 6 digits |
| Primary language | 10 characters |
| Language 2 | 10 characters |
| Language 3 | 10 characters |
| Language 4 | 10 characters |
| Language 5 | 10 characters |
| Language 6 | 10 characters |
| Filler | 6 characters |
The format of the second control record is shown in the following table.
| Second Control Record Properties | Size |
|---|---|
| Sequence number | 6 digits |
| Language 7 | 10 characters |
| Language 8 | 10 characters |
| Language 9 | 10 characters |
| Language 10 | 10 characters |
| Language 11 | 10 characters |
| Language 12 | 10 characters |
| Filler | 6 characters |
The format of the third control record is shown in the following table.
| Third Control Record Properties | Size |
|---|---|
| Sequence number | 6 digits |
| Language 13 | 10 characters |
| Language 14 | 10 characters |
| Language 15 | 10 characters |
| Filler | 36 characters |
The remaining records of the NGEN28/1/LTEACH file are Header records (which define the Administration commands) and Text records (which contain the actual Teach information).
The header record has the format shown in the following table:
| Header Record Properties | Size |
|---|---|
| Sequence number | 6 digits |
| Filler | 1 character |
| Command name | 3 characters |
| Filler | 1 character |
| Privilege level | 1 digit |
| Language number | 2 digits |
| Filler | 58 characters |
Text records for each command immediately follow their header record. There might be from one through nineteen text records (so that the text can be displayed on one screen).
The text record has the format shown in the following table:
| Text Record Properties | Size |
|---|---|
| Sequence number | 6 digits |
| Filler | 10 characters |
| Text message | 56 characters |
Translating the LTEACH File
To translate the contents of the NGEN28/1/LTEACH file, perform the following:
Copy all the Command header records and Text records for an existing language to the end of the file. (Do not copy the Control records.)
Change the initial control records to include the new language.
Change the language number in every Command header record.
Overwrite the existing Text records with your translated version.
CautionThere are limits on extending the length of existing text in some cases. Refer to the relevant file characteristics for more information.
When translating your NGEN28/1/LTEACH file, check the following points:
Ensure that the order and number of header and control records within your translation is identical to that for the primary language.
Remember that language number (rather than name) is used to define the language in the Header records.
Change only the language names in the Control records.
Change only the language number in the Header records.
Change only the text message in the Text records – the number of records of text for each colon command can differ by up to 20 lines for different languages.
If only one language is being used, you do not need to copy a language block. You can simply overwrite the existing control records, language numbers, and text records.