Types of handles

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 3-10:

  Table 3-10: Context properties

  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 3-11.

  Table 3-11: Connection properties

  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

Routines that affect handles

Table 3-12 lists the routines that allocate, use, and deallocate handles.

Copyright © 2005. Sybase Inc. All rights reserved.

View this book as PDF