Administering CA 2E Translator › Using CA 2E Translator Utilities › Screen and Print Files Menu › Update Literals Dictionary for Panels on List

Update Literals Dictionary for Panels on List

This option scans panel source members and builds a dictionary of literal entries. It may be performed interactively or by submitting a batch job. For applications of more than a few functions, the batch option is recommended. Always use batch for trial runs, to assist diagnostics, as a job log is printed. This should be viewed as it contains comprehensive messages regarding the job's progress.

When scanning a large number of panels, the size of the job log produced may interrupt the job. If this happens, the logging parameters can be amended by changing the contents of the message USR0104 in trnpgmlib/trusrmsg. View this message using WRKMSGD and edit the logging parameters as required.

If performing remote site translation, see the chapter "Remote Site Management" for more information.

This option performs the following steps:

Scan Device Source

Each member on the list is copied into a work file and scanned.

Entries are made into a dictionary for all literals, containing the device file name, row and column, the message identifier, and so on.

Additionally, if the original source is either hand-coded DDS or produced by CA 2E without the MSGID facility, Translator does the following:

- Comments out original literal statements

- Adds a message constant statement for each literal

- Adds a message in the nominated message file for each literal

- Copies the scanned member to new source file

The utility handles literals of up to 132 characters in length. If a longer literal is encountered, a warning message is written to the job log, and a warning entry written into the new DDS. This enforces amendment of the code before a successful compilation is possible.

The member list should be viewed (using option 2) to check for any errors in list processing. Members in error will be flagged with an F (Fail).

If scanning DDS literals, it is also recommended that the resulting source code is viewed using SEU.

Update Target Entries & Flags

This option updates the original and target language entries in the dictionary for all local environments. It also rebuilds the index used in detecting duplicate literals.

New literals are added as target entries. Changed literals are updated and the old version archived for later access. Unchanged literals are unaffected. The update status for entries is reset accordingly.