Sun Mainframe Transaction Processing Software Configuration Guide

Sun MTP supports the following features for double-byte character sets (DBCS):

• BMS assembler handles PS and SOSI attributes
• Transaction processor builds the 3270 data stream with PS and SOSI attributes
• The Sun MTP local client accepts DBCS characters if the field contains the PS or SOSI attribute
• TN3270 Server processes DBCS 3270 data streams
• Intersystem communications (ISC)
• Support for PU4/PU5 connections

This chapter describes DBCS support and contains the following topics:

• Prerequisites
• Enabling DBCS for a Region
• Using DBCS and ISC
• Conversion Tables
• Usage Considerations

---

Prerequisites

Before you can use DBCS, you must:

• Ensure that your operating environment has National Language Support (NLS).
• Ensure that any third-party products you are using, such as databases and sort programs, are DBCS-aware.
• Become familiar with the DBCS options of your COBOL compiler.

---

Enabling DBCS for a Region

1. Make sure that your Sun MTP license authorizes the use of DBCS.

Refer to the Sun Mainframe Transaction Processing Software Installation Guide for the procedure to create a license file.

2. Start the region with the appropriate options.

You must use the -B option to unikixmain (kixstart) to activate the DBCS features and specify the name of the conversion table to use. For example, to enable DBCS conversion (EBCDIC to ASCII and ASCII to EBCDIC) in Japanese Katakana-Kanji, start the region with the following option:

$ unikixmain -B IBM-930toIBM-932.table other-options

Refer to the Sun Mainframe Transaction Processing Software Reference Guide for a description of all the unikixmain options, and to Conversion Tables.

---

Using DBCS and ISC

If you are using DBCS and are transferring data over ISC, you must follow the procedures in this section to define data conversion templates, unless you are using transaction routing. Transaction routing does not require any special procedures.

1. Open the Table Manager and display the Extended Tables menu.

2. Press PF9 to open the Data Conversion Templates Table (CVT).

  FIGURE 14-1 Data Conversion Templates Table (CVT)

3. Press PF4 to insert your entries. See FIGURE 14-2.

Refer to the Sun Mainframe Transaction Processing Software Reference Guide for information about the CVT.

• If you are converting only double-byte characters, you must specify the value D in the Type field on the CVT Detail screen.
• If you are converting mixed-byte characters, you must specify a value between 50 and 80 in the Type field on the CVT Detail screen.

You must then code the conversion in the $UNIKIX/src/convert/kxcvtxlt.c user exit. This user exit contains commented conversion examples. Refer to the Sun Mainframe Transaction Processing Software Administrator's Guide for information about this user exit.

  FIGURE 14-2 CVT Detail Screen

4. When you are finished typing data in the CVT, press PF2 to save the table.

5. Exit the Table Manager.

6. Shut down and restart the region so your changes take effect.

---

Conversion Tables

Use any of the following conversion tables for DBCS support. The tables are located in the $UNIKIX/lib directory.

---

Usage Considerations

Be aware of the following issues when using DBCS data in your applications:

• DBCS data is supported only in mapping operations, such as SEND MAP and RECEIVE MAP. The raw sends of data streams (using the SEND command) will have to embed double-byte characters within SO and SI bytes.
• If you create your own conversion tables, you must put them in the $UNIKIX/lib directory.

Refer to the COBOL documentation for information about DBCS compiler options and data types.

Sun Mainframe Transaction Processing Software Configuration Guide

816-5328-11

Copyright © 2004, Sun Microsystems, Inc. All rights reserved.