Detailed NLS Configuration Steps

In this section:

This section describes how to add code pages to the FOCUS configuration, implement default language settings, configure PC3270 for the same code page as FOCUS, and verify the configuration.

Adding New or Alternate Code Pages for FOCUS

How to:

Review your code page configuration requirements. If you did not previously modify your code page configuration but need to do so in FOCUS 7.7, follow the instructions in this section.

If you require customized monocasing or sorting for one or more of your configured code pages, edit the code page definition file for those code pages as described in Advanced NLS Configuration Options.

Procedure: How to Add New or Alternate Code Pages to FOCUS

  1. Copy member CPCODEPG (list of code pages to be configured), any CPnnnnn files that you may want to modify, member CPCPALL (list of languages, language codes, and their associated code pages), and member CPXCPTBL (known code page list) files from install_hlq.ERRNLS.DATA to install_hlq.CONF.CFG.

    All changes will be made in the install_hlq.CONF.CFG library so that the original files remain intact.

    Note: If you reinstall FOCUS over your current production FOCUS libraries, using the same names, the configuration changes will be overwritten. In this case, you should copy these files to another location before reinstalling, and then copy them back after the new installation process is complete.

  2. Browse member CPCPALL in the install_hlq.CONF.CFG library to determine which code pages are available and supported for the language you want to configure.

    The following is a portion of the CPCPALL file that contains the language abbreviation and supported code pages for French:

    * LANG=FRE
    cp297     
    cp863     
    cp137     
    cp1047    
    cp37      
    cp65001   
    BR  
  3. Copy additional or alternate code pages into CPCODEPG from the known code page file, CPXCPTBL.

    Add the information for each additional or alternate code page on a separate line. Note that only the characters CP and the code page number (for example, CP00297) are required to generate the new transcoding tables. The maximum number of code page entries in the file is 16.

    1. Open the known code page file, member CPXCPTBL in the library install_hlq.CONF.CFG.

      The following is a portion of the CPXCPTBL file that contains the code page information for French code page 297 (CP00297):

      CP00281   E SBCS  IBM MF Japanese English   
      CP00284   E SBCS  IBM MF Spain/Latin America
      CP00285   E SBCS  IBM MF United Kingdom     
      CP00297   E SBCS  IBM MF France             

      For a description of all of the fields in CPXCPTBL, see Structure of the Known Code Page File (CPXCPTBL).

    2. Copy the lines for the additional or alternate code pages you need from member CPXCPTBL to member CPCODEPG.

      For example, to add French code page 297 to your configuration, copy the following line from CPXCPTBL to CPCODEPG:

      CP00297   E SBCS  IBM MF France 

      If you started with the default CPCODEPG FILE, the new version will contain the following information:

      CP00037   E SBCS  US IBM MF EBCDIC cod
      CP00437   A SBCS  US PC ASCII code
      CP00137   A SBCS  ANSI Character Set for MS-Windows
      CP01047   E SBCS  IBM MF Open Systems (Latin 1)
      CP65001   A UTF8  Unicode (UTF-8)
      CP00297   E SBCS  IBM MF France

      Note: If the desired code page is not listed in the known code page file (CPXCPTBL), refer to the appropriate IBM Character Data Representation Architecture (CDRA) document and create your own, or contact your local Information Builders representative for information about additional code pages.

  4. Execute the FOCUSC CLIST to start FOCUS.

    The ISETUP installation procedure creates a CLIST named FOCUSC in the install_hlq.CONF.DATA library. This CLIST allocates all of the required libraries for executing FOCUS using the high-level qualifier you chose during the installation process.

    Alternatively, you can submit the FOCUS JCL generated by the installation process, member FOCUS in the install_hlq.CONF.DATA library. In this case, place the TSGU command in SYSIN. For an example, see Use the TSGU Command.

  5. At the FOCUS command prompt, issue the TSGU command to generate the necessary tables.

    For example, to generate the transcoding table (TRANTBL) that adds the new or alternate code pages from the CPCODEPG file, issue the following command.

    TSGU

    The tables are created as members in the install_hlq.CONF.CFG library.

    Next, configure the FOCUS default code page and language as described in Configuring the FOCUS Default Language Settings.

If you modified the monocasing information in any of the code page definition files, issue the following command to generate the monocasing table (CASETBL):

TSGU CASE

If you modified the sorting sequence in any of the code page definition files, issue the following command to generate the sorting table (SORTTBL):

TSGU SORT

To create all three types of tables (transcoding, monocasing, and sort tables), issue the following command:

TSGU GEN

After running the TSGU, check the install_hlq.CONF.CFG library to make sure the required tables were generated.

For complete information about TSGU command syntax, see Generating New Transcoding Tables.

Configuring FOCUS To Use a New Code Page

When you invoke FOCUS, one language and code page combination will be in effect by default. When you configure NLS Services, the default language and code page are controlled by settings in the NLSCFG configuration file, member NLSCFG in the install_hlq.CONF.CFG library.

For example, to change the default language to French and the code page to 297, enter the following settings in NLSCFG:

LANG=FRE
CODE_PAGE=297

If there is no NLSCFG member in the concatenation of data sets allocated to DDNAME ERRORS, the FOCUS default language and code page will be in effect. For information, see FOCUS Default Code Page Configuration.

For complete information about the NLSCFG configuration file, see Use the NLS Configuration File (NLSCFG).

Configuring PC3270 Session Parameters

Before invoking FOCUS, you must configure PC3270 to use the same code page that will be used by FOCUS.

  1. Log off your z/OS session.
  2. On the PC3270 Communication menu, select Configure.
  3. Click Session Parameters.
  4. Select the code page that FOCUS will use from the list of code pages, and click OK.

PC3270 will display a message about the new configuration. Accept the change to the new PC3270 code page, and wait for the screen to refresh before logging in again.

Verifying the FOCUS Language Configuration

Once you have configured FOCUS for a new code page and language, you should verify that they are in effect when FOCUS is invoked.

  1. Log in to z/OS and invoke FOCUS. You can use the FOCUSC CLIST that was created by the installation procedure.
  2. Issue the ? LANG command to check that the language and code page you configured are in effect. For example:
            NATIONAL LANGUAGE INFORMATION
    
    Language                033/FRENCH      (FRE,fr)
    Code Page               297
    Client Code Page        297
    Dollar                  5B($)
    Lowcase alphabet        YES
    Decimal notation        OFF(.)
    Currency symbol         $
    Date/Time format        EDA
    NLS sort                NO(BINARY)
    NLS upcase/lowcase      NO
    NLS Control Characters  OFF
    DBCS Flag               OFF(SBCS)
  3. Display data that contains characters specific to the new code page to make sure that they display correctly.

Information Builders