SNA Connection under OS/2 (SAP Library

SNA Connection under OS/2

On an OS/2 workstation with an SNA host, the side info table is located in the \ SAP_WS path.

If you are storing it in another directory, you must use the SIDE_INFO environment variable.

Note

Release 1.0xx of the OS/2 CUA Interface (R/2 Workstation Software):

The table is called SAPCPIC.TBL. It is localized with the environment variable SAPTBL.

You will find a description of the parameters under "Table SAPCPIC.TBL" below.

The side info table describes all the possible CPI-C connections to partner systems.

The entries are read and used for connection setup according to the parameter specified in the calling program from CMINIT (dest).

Table SIDEINFO

The structure and parameters of the table SIDEINFO are described at the beginning.

Example

DEST=K50
LU=K50T00
TP=X1SA
PROTOCOL=C
GWHOST=is0001
GWSERV=sapgw00
MODE_NAME=LU62TST1
LOCAL_LU=LULOC01
CPIC_TRACE=2
TIMEOUT=10

Table SAPCPIC.TBL

In Release 1.x of the R/2 Workstation Software, the table is called SAPCPIC.TBL. It is localized with the environment variable SAPTBL.

Example ***************************************************************
*DEST LU_ALIAS PLU_ALIAS REMOTE_TP LOCAL_TP MODE DATA

***************************************************************
E50 LTRCA63 E50TR1 X1SA CICSE50 LU62TST1 EBCDIC
E50 LTRCA64 E50TR2 X1SA CICSE50 LU62TST1 EBCDIC
K43 LTRCA65 K43TR X1SA CICSE50 LU62TST1 EBCDIC
K43 LTRCA66 K43TR1 X1SA CICSE50 LU62TST1 EBCDIC
*****************************************************************

The parameters have the following meaning:

DEST

Symbolic destination (max. 8 characters)

LU_ALIAS

Name of the local LU_ALIAS to be used for a particular connection (max. 8 characters)

PLU_ALIAS

Name of the Partner LU ALIAS to be used for a particular connection (max. 8 characters)

REMOTE_TP

Name of the program to be initiated on the remote host (max. 8 characters)

If the partner program is on an OS/2 system, the entry in this table must match the name of the partner program.

LOCAL_TP

Name of the local program which accesses the SAP CPI-C interface.

MODE

Name of the SNA session to be used for a particular connection.

DATA

Character set, in which data is transferred.
This information is only used for trace and error log evaluations.
Legal values: EBCDIC or ASCII

Comments:

LU_ALIAS, PLU_ALIAS, REMOTE_TP and MODE must be configured with the IBM Communications Manager (See OS/2: Communications Manager).

You can make several entries in the table for a particular symbolic destination. Entries with a common symbolic target address correspond to alternative SNA connections to a particular partner.

If a particular connection is in use (for example because all the permissible Sessions between local Logical Unit (LU) and Partner Logical Unit (PLU) are in use), an alternative connection is sought in the table SAPCPIC.TBL.

If all possible SNA sessions are in use, the Call CMALLC returns the error PRODUCT_SPECIFIC_ERROR. You will also find the following error message in the accompanying error log: SAP_NO_FREE_SESSION_AVAILABLE.

Environment Variables Under OS/2

You can use the following environment variables:

SIDE_INFO (SAPTBL)

Environment variable with the fully qualified name of the side info table.(e.g. E:\SAP_WS\SIDEINFO )

In Release 1.0xx of the CUA Interface the environment variable is SAPTBL.

If this variable is not defined, the table must be located in the \CMLIB directory of the IBM Communications Manager.

CPIC_TRACE (CPIC_TRC)

Variable with trace switch
In Release 1.0xx of the CUA Interface the environment variable is CPIC_TRC .

Legal values are 1, 2 or 3:
1: Error trace
2: Complete process trace, short data trace
3: Complete process trace, complete data trace. When the trace function is switched on, a log file named CPxxxxx.TRC is created in the current directory (xxxxx=process number). You can use this log file for error analysis.

COMTBLG:

Only for DCA software:
Variable for conversion table
This variable gives the fully qualified name of the table, which is used by the DCA software for character conversion according to SNA Character Set G.
Example: D:\DCA\SAMPLES\CSVTBLG.DAT

CONVERT

Variable for conversion table.
If you do not want to use standard tables, this variable lets you define your own conversion table for ASCII-EBCDIC conversion.

The CMCNVI and CMCNVO functions work with pre-defined standard tables.

SAP_KEEP_SESSION

This variable defines whether, after closing a LU6.2 connection, the session is retained or closed as well (side info parameter KEEP_SESSION).
For an R/2 host with an IMS system, the existing session cannot be closed.

Legal values:
0: Session is closed down
1: Session is retained in spite of instruction to the contrary