The following handles are used with Client-Library:
Context handle. A context handle defines a particular application, context, or operating environment. The context handle is defined in the program call CSBCTXALLOC.
An application can have only one context.
A context handle corresponds to the IHANDLE structure in the Open ServerConnect Gateway-Library.
The context handle can have the following properties listed in Table 2-10:
Property |
Set by |
|---|---|
CS-EXTRA-INF |
CSBCONFIG |
CS-LOGIN-TIMEOUT |
CTBCONFIG |
CS-MAX-CONNECT |
CTBCONFIG |
CS-NETIO |
CTBCONFIG |
CS-NOINTERRUPT |
CTBCONFIG |
CS-TEXTLIMIT |
CTBCONFIG |
CS-TIMEOUT |
CTBCONFIG |
CS-VERSION |
CSBCONFIG |
Connection handle. This is the handle for an individual client/server connection. The connection handle is defined in the program call CTBCONALLOC. If parallel sessions are used, there must be one connection handle for each session. An application can have up to 25 connections.
Open ClientConnect uses a Connection Router program to define connections. Each connection handle corresponds to a connection defined with the Connection Router. For details about the Connection Router, see the Mainframe Connect Client Option Installation and Administration Guide.
A connection handle can have the following properties listed in Table 2-11.
Property |
Set by |
|---|---|
CS-APPNAME |
CTBCONPROPS |
CS-CHARSETCNV |
CTBCONPROPS |
CS-COMMBLOCK |
CTBCONPROPS |
CS-EXTRA-INF |
CTBCONPROPS |
CS-HOSTNAME |
CTBCONPROPS |
CS-LOC-PROP |
CTBCONPROPS |
CS-LOGIN-STATUS |
CTBCONPROPS |
CS-NET-DRIVER |
CTBCONPROPS |
CS-NETIO |
CTBCONPROPS |
CS-NOINTERRUPT |
CTBCONPROPS |
CS-PACKETSIZE |
CTBCONPROPS |
CS-PASSWORD |
CTBCONPROPS |
CS-TDS-VERSION |
CTBCONPROPS |
CS-TEXTLIMIT |
CTBCONPROPS |
CS-TRANSACTION-NAME |
CTBCONPROPS |
CS-USERNAME |
CTBCONPROPS |
Command handle. A command handle defines a command space, which is used to send commands to a server over a connection and process the results. A command handle is defined in the program’s CTBCMDALLOC call. Each command handle is associated with a particular connection. There can be any number of command handles associated with a connection.
A command handle and its associated connection handle correspond to the TDPROC handle in Open ServerConnect’s Gateway-Library.
A command handle can have the following property:
CS-USERDATA
Table 2-12 lists the routines that allocate, use, and deallocate handles.
Structure |
Allocated and used by |
|---|---|
CONTEXT |
CSBCTXALLOC, CTBCONFIG, CSBCONFIG, CSBCTXDROP |
CONNECTION |
CTBCONALLOC, CTBCONPROPS, CTBCONDROP |
COMMAND |
CTBCMDALLOC, CTBCMDPROPS, CTBCMDDROP |
