Most messages that MARC displays are found in the MARC software. The messages provided with MARC are in English, but you can create new messages in another language by using the Message Translation Utility (MSGTRANS).
MSGTRANS can assist you in translating messages and also binds the localized messages to the MARC software, making a new version of MARC available.
To use MSGTRANS to translate messages to another language, you must add the name of the new language to message 0 of the MLSMSGS array in the file
*SYSTEM/MARC/COMMANDER, the file that is the main body of MARC. The name of every language used by MARC, except English, must be included in message 0 of this array.
The following steps briefly explain how to use MSGTRANS to add a new language to the MLSMSGS array, translate messages, and bind the new language to the MARC software. For a detailed discussion of MSGTRANS, see the A Series Message Translation Utility (MSGTRANS) Operations Guide.
Note: Because the MSGTRANS utility creates a new version of the code file SYSTEM/MARC/COMMANDER, it is good practice to save a copy of the current version of this file before you access MSGTRANS.
The steps to use MSGTRANS to add a new language are as follows:
1. Take one of the following actions to access the MSGTRANS utility:
• Choose TOOLS from the MARC home menu and transmit, and then select the MT keyword from the TOOLS menu and transmit.
• In any CANDE session, transmit
RUN $SYSTEM/MSGTRANS ON <family name>
• From the Action field of any MARC screen, enter and transmit RUN SYSTEM/MSGTRANS ON <family name>
Using MARC Internationally
If you use the RUN command, use the syntax ON <family name> to identify the disk family on which the program resides. If the program is on your default family, you can omit this syntax from the statement.
The utility displays the start session screen. Figure 9-1 illustrates this screen.
What object file is to be edited? [ To exit the program, enter ABORT here.
HELP
REFRESH
For help at any time, press the SPCFY key. Information will be displayed about the field or caption where the cursor is located.
To refresh the screen at any time, type the following sequence:
CTRL 0 0 XMT
Unisys Message Translation Utility, Version 39.042.040
Figure 9-1. MSGTRANS Start Session Screen
2. Enter *SYSTEM/MARC/COMMANDER in the What Object File Is To Be Edited?
field of the start session screen and transmit.
MSGTRANS then displays the MSGTRANS home screen, as illustrated in Figure 9-2.
Using MARC Internationally
The messages are being loaded from the object file
EDIT Displays messages so you can view, edit, copy, or delete them.
INCLUDE Compares messages, or adds messages from an external file.
LANGUAGES Displays languages defined for each message array.
PRINT Sends messages to a line printer or a disk file.
RECESS Ends the session and saves all messages to a recovery file.
SAVE Saves messages and, optionally, starts a binding job.
BYE/END Displays the Bye screen where you can end the session.
Enter Command: [
Enter the language name for the messages you want to edit:
To add or change the ccsversion, enter the ccsversion:
To display comparison messages, enter the language name:
Figure 9-2. MSGTRANS Home Screen
3. Enter EDIT in the Enter Command field, and move the cursor to the next field.
4. Enter the name of the language you want to add in the Enter the language name for the messages you want to edit field-for example, FRANCAIS. Move the cursor to the next field.
5. Enter ENGLISH in the To display comparison messages, enter the language name field, and transmit.
MSGTRANS displays the Edit screen, showing the first physical message in the file *SYSTEM/MARC/COMMANDER.
6. Enter FIRST OF MLSMSGS in the Where Next field and transmit.
MSGTRANS refreshes the Edit screen and displays message O.
7. Translate the word OK into the desired language. The translated word must be enclosed in quotation marks. For example~.you could transmit "Bon" to translate the word into French.
8. The next step is to translate any or all MARC messages into the new language - see the A Series Message Translation Utility (MSGTRANS) Operations Guide for details. However, translating the contents of message 0 is the only step that is required to bind a language to MARC.
9. Enter SAVE in the Where Next field.
MSGTRANS displays the MSGTRANS Save screen.
10. Bypass the Select OBJECTor SOURCE field. MSGTRANS prefills this field with the word OBJECT.
Using MARC Internationally
11. Enter a name in the Enter File Title . .. field and transmit. This name is the title you want to give to the saved messages file. For example, you might name a French message file FRANCAISMSGS. Move the cursor to the next field.
12. Bypass the What Languages Are to Be Saved? field.
13. Enter *SYSTEM/MARC/COMMANDER in the To Bind the Saved Messages . ..
field and transmit. MSGTRANS displays the MSGTRANS restart screen.
14. From the Enter Command field, initiate one of the following actions:
• Enter END to exit MSGTRANS.
• Enter HOME to establish another language. Repeat all steps just outlined, beginning with step 2.