The CA Endevor Integration for the Natural Environment (EINE) Help screens display blank pop-up windows when PF1 is used or a question mark (?) is entered in a screen field.

Document ID : KB000022572
Last Modified Date : 14/02/2018
Show Technical Document Details

Problem:

The CA Endevor Integration for the Natural Environment (EINE) Help screens display blank pop-up windows when PF1 is used or a question mark (?) is entered in a screen field.

 

Environment:

All supported versions of CA Endevor Integration for the Natural Environment

 

Cause:

Blank pop-up Help windows in CA Endevor Integration for the Natural Environment (EINE) indicates a problem involving the EINE SYSERR error messages.

It is either the SYSERR error messages are missing from the Natural library EINE is executing from or it is related to the setting of the *LANGUAGE Natural System variable. 

 

Resolution:

EINE uses SYSERR error messages for its Help routines and error messaging. If the SYSERR error messages are not loaded to the Natural library that EINE is executing from, it results in the Help pop-up windows being blank.

Use the Natural SYSERR utility to determine if this is the cause.

  1. Log into Natural and invoke SYSERR.

  2. On the SYSERR Main panel enter:

    1. Code di to display messages

    2. Library einelib 

    3. Message number 1 to 9999

    4. Language codes 1

    5. Press Enter

  3. If a list appears then the SYSERR error message are loaded correctly, proceed to  *LANGUAGE Setting.

  4. If the error message 'Specified short texts do not exist.' is displayed, then the EINE SYSERR error messages need to be copied to the appropriate einelib Natural library for your implementation of EINE.

    1. Rerun the EINE installation job LOADNAT in the JCL library using the following CMSYNIN statement with einelib pointing to the appropriate Natural library for your implementation of EINE:
      //CMSYNIN DD * SYSOBJH                                             LOAD * LIB * OBJTYPE * WITH NEWLIBRARY einelib  %   WHERE REPLACE ALL REPORT                            FIN
    2. Repeat the SYSERR steps to verify the EINE error messages are found in the correct einelib Natural library for your implementation of EINE.

  5. Log into Natural, sign in to EINE, and retest the Help display.

    1. If the pop-up Help windows are still blank, proceed to the next section.

 

*LANGUAGE Setting

The EINE SYSERR error messages are distributed in Language 1. If your Natural systems are using a *LANGUAGE number other than Language 1, it will result in blank pop-up Help windows.

 

Check with your Natural administrator for what the *LANGUAGE setting is for your Natural systems.

If using a *LANGUAGE number other than 1, then a copy of the SYSERR Language 1 error messages must be created for the *LANGUAGE being used at your site.

  1. Determine the Language Character Code value.  In the *LANGUAGE section of the Software AG Natural System Variables documentation, there are some tables that equate the *LANGUAGE code to the Language Character Code value. For example, *LANGUAGE code 11 is Portuguese and has a Language Character Code of upper case B, while a *LANGUAGE code of 52 is Malayan and has a Language Character Code of lower case q.   Note - the upper or lower case setting of the Language Character Code value is extremely important when performing the error message copy.

  2. Log into Natural and invoke the SYSMAIN utility.

  3. If the target LANGUAGE is a lower case letter, enter the %l command so SYSMAIN will retain lower case letters.

  4. On the SYSMAIN Main Menu screen enter:

    1. Object Code e for Error Message Texts 

    2. Function Code c for Copy 

    3. Press enter

  5. On the Copy Error Message Texts panel enter:

    1. Code a to copy both the Short and Extended Texts

    2. Change Selection List to N

    3. Copy Error No. From 1 to 9999

    4. Enter Source Library einelib, Lang 1, plus the DBID and FNR numbers for your environment 

    5. and Target Library einelib, Lang x as determined in Step 1 

    6. Press enter and you should receive a confirmation message saying the function completed successfully.

  6. Use SYSERR to verify the error messages were copied to the new Map Name Code value correctly:

    1. Return to the Natural Main Menu screen and invoke SYSERR

    2. Enter Code se for Select messages from a list

    3. Enter Library einelib

    4. Enter Language Codes * and press enter

    5. The Select Messages screen will display the error messages by number and the Languages they are available in. The first language in the display is 1 and there should be a second value for the Language Character Code corresponding to the *LANGUAGE code used at your site.

  7. Log into Natural, sign in to EINE, and retest the Help display.

    1. If the pop-up Help windows are still blank, contact CA Support.

einelib : The default Natural library for EINE is EINELIB; however, it can be changed by your administrator. Check with your administrator for the correct Natural library name.