Previous Topic: General GuidelinesNext Topic: Customizing Literals


Specific Guidelines

The following are guides to specific areas of concern in translating CA Dataquery.

Blank Lines

Generally, CA Dataquery does not allow you to type over blank lines. If you attempt to type over blank lines on protected panels, your keyboard locks.

The following panels allow you to type over blank lines:

Space

On most panels, you have a limited amount of space for customizing statements. As a general rule, keep your translation to less than or equal to the length of the American English version of the statement or description.

Menu Numbers

Do not translate or change the menu item numbers. CA Dataquery does not prohibit you from changing the menu item numbers. However, if you do, CA Dataquery will not be able to identify the function you are indicating.

Error Messages

Some error messages contain blank spaces which CA Dataquery uses to return action specific information. You must leave enough blank spaces for CA Dataquery to return that information. For example, message DQ027 returns the specific CA Datacom/DB return code for the error you encountered. The following messages need seven blank spaces immediately after the last character in the message.

Add seven blanks following the last character to:

DQ041

DQ066

DQ237

DQ467

DQ062

DQ067

DQ242

DQ471

DQ063

DQ068

DQ270

DQ472

DQ064

DQ160

DQ412

DQ479

DQ065

DQ161

DQ414

 

Messages DQ027 and DQ330 require 21 blanks immediately following the last character in the message.

If you do not leave the correct amount of spaces, CA Dataquery overwrites characters in those positions.

Do not change the error message numbers. The error message number includes the characters DQ and the space before the dash ( - ) and the space after the dash.

Blank Messages

CA Dataquery provides you with ten blank error messages. You use these panels to document errors which may result from your tailoring of the system. These messages panels are number DQ990 through DQ999. You must create or change these panels using the EDIT or TRANSLATE function of the Language Maintenance Facility.

If you want to customize error message DQ106, read and apply the following information.

PF Key Legends

The following PF key legend panels do not appear with a main panel during translation. If you are doing a complete translation, translate each of these separately. If you are doing a partial translation, translate the PF keys legends if the corresponding main panel is part of the partial translation. Only the last three characters of the panel name are shown.

PF Key Legends - Main Panels

YED with EB0
YE2 with D10
YE3 with D10

YE7 with D10
YD6 with D60
YE4 with D60

YKA with D60
Y10 with B00, B10, B20, B30, B50, B60

Y20 with B50, B90
YKZ with KG0
YK8 with K10

Procedure

During the deletion procedure, the DIRECTORY OF PANELS is displayed. Use one of the following procedures to locate the panel you want. There are several ways you can locate a panel once you have displayed the DIRECTORY OF PANELS.

The following lists panel locations and their descriptions.

<PF7> and <PF8>

You can use <PF7> to page the DIRECTORY OF PANELS backward and <PF8> to page forward.

+ and -

Page through the directory using the plus and minus sign. For example, entering +20 scrolls forward 20 pages and -20 scrolls backward 20 pages.

TOP and BOTTOM

You can use the TOP and BOTTOM commands. TOP takes you to the first panel of the directory and BOTTOM takes you to the end of the directory.

START WITH

If you know the name of the panel you are searching for, you can use the START WITH field on the DIRECTORY OF PANELS. This field allows you to specify one to three characters with which CA Dataquery can begin searching for a panel name. If you know the panel name, you can specify the last three characters of the name and press Enter. CA Dataquery scrolls that panel name to the top of the display. If you specify one or two characters, CA Dataquery locates the first panel which contains those characters and scrolls it to the top of the directory.

If no panel is located with those characters, CA Dataquery scrolls you to the next greater name on the DIRECTORY OF PANELS.

Operation

Before you can begin customizing panels, you must be signed on to CA Dataquery and display the LANGUAGE MAINTENANCE MENU. For exact instructions about displaying the LANGUAGE MAINTENANCE MENU, see Getting Started Using the Language Maintenance Facility.

Step 1:

On the LANGUAGE MAINTENANCE MENU select Option 1, PANELS. Press Enter.

=> ------------------------------------------------------------------------DQLN0 DATAQUERY: LANGUAGE MAINTENANCE MENU ----------------------------------------------------------------------------- ENTER DESIRED OPTION NUMBER ===> 1 LANGUAGE CODE===> __ (default ALL) 1. PANELS - Translate, edit, delete, and display panels 2. LITERALS - Translate, edit, delete, and display program literals 3. VOCABULARY - Translate, edit, delete, and display vocabulary terms

Step 2:

CA Dataquery displays a directory of all panels. From this directory you can select the panel you wish to customize. See the section in this chapter on locating panels for more information. After you have located the panel you wish to customize, move the cursor down beside the panel name and press <PF6> TRANSLATE. <PF6> TRANSLATE creates a copy of the panel.

DIRECTORY OF PANELS (DQL10)

=> PLACE THE CURSOR ON THE DESIRED NAME AND PRESS THE APPROPRIATE PFKEY ------------------------------------------------------------------------DQL10 DATAQUERY: DIRECTORY OF PANELS START WITH: ___ ----------------------------------------------------------------------------- PANEL NAME |LANGUAGE| DESCRIPTION | PFKEY LEGEND | COLUMNS ----------------------------------------------------------------------------- 039 | AE | MSG: DQ039E | YZ1 | 80 041 | AE | MSG: DQ041E | YZ1 | 80 046 | AE | MSG: DQ046E | YZ1 | 80 049 | AE | MSG: DQ049E | YZ1 | 80 050 | AE | MSG: DQ051E | YZ1 | 80 051 | AE | MSG: DQ051E | YZ1 | 80 052 | AE | MSG: DQ052E | YZ1 | 80 058 | AE | MSG: DQ058E | YZ1 | 80 059 | AE | MSG: DQ059E | YZ1 | 80 060 | AE | MSG: DQ060E | YZ1 | 80 062 | AE | MSG: DQ062I | YZ1 | 80 063 | AE | MSG: DQ063I | YZ1 | 80 064 | AE | MSG: DQ064I | YZ1 | 80 065 | AE | MSG: DQ065I | YZ1 | 80 ----------------------------------------------------------------------------- <PF1> HELP <PF2> RETURN <PF3> DISPLAY PANEL <PF4> EDIT PANEL <PF5> DELETE PANEL <PF6> TRANSLATE <PF7> BACKWARD <PF8> FORWARD

Step 3:

CA Dataquery displays the PANEL EDIT/TRANSLATE panel. Fill in the TRANSLATE TO LANGUAGE CODE field with your language code. You can customize the description by typing over the existing description in the NEW DESCRIPTION field. After completing the panel, press Enter.

PANEL EDIT/TRANSLATE (DQL20)

=> ------------------------------------------------------------------------DQL20 DATAQUERY: PANEL EDIT/TRANSLATE ----------------------------------------------------------------------------- PANEL: DQ039 LANGUAGE CODE: AE ----------------------------------------------------------------------------- TRANSLATE TO LANGUAGE CODE==> ac ----------------------------------------------------------------------------- DESCRIPTION: MSG: DQ039E NEW DESCRIPTION ===> MSG: DQ039E ____________ The selected panel will be displayed in an updatable format. Key the translation or changes in the appropriate literal areas. When you have completed the changes for the entire panel, use the Enter key to finish the function. Use the CLEAR key to cancel the function. ----------------------------------------------------------------------------- <PF1> HELP <PF2> RETURN

Step 4:

The panel now appears in an unprotected format. On color monitors the unprotected information appears in red. On monitors which are not color, the unprotected information is highlighted. You can customize the panel including any PF keys. Enter your customization by typing over the existing information.

=> ------------------------------------------------------------------------DQ039 DATAQUERY: HELP PANEL FOR ERROR MESSAGE ----------------------------------------------------------------------------- DQ039E - Printer requested not available. Call operations at ext. 3456. CAUSE: You requested that the output report from your query be sent to a printer that is not in service. ACTION: Either wait until the printer is back in service or direct your output to another printer. Please report any problems to Karen at extension 3456. ----------------------------------------------------------------------------- <PF1> HELP <PF2> RETURN

This example took the original error message and added the company specific information.

Step 5:

Press Enter to save your customization. CA Dataquery then returns you to the panels directory. To exit without saving your customization, press CLEAR or <PF2>.

Editing Panels

After a panel has been customized using the TRANSLATE function, you can use the EDIT function to make corrections or changes. When you use the edit function, CA Dataquery does not create a new copy of the panel. CA Dataquery allows you to change the description but not the language code. CA Dataquery then displays the panel in unprotected format.

You cannot edit an American English panel. The EDIT function of the Language Maintenance Facility is described in Editing Panels.

Deleting Panels

If after you have created a customized panel and you no longer want or need that panel, you can delete the panel. CA Dataquery does not allow you to delete an American English panel.

For more information about deleting panels, see Deleting Panels.