List of functions

Table 3-1 describes the Gateway-Library functions.

Table 3-1: List of Gateway-Library functions

Function

Description

TDACCEPT

Accepts an incoming request from a remote client.

TDCONVRT

Converts a mainframe datatype to a datatype that can be used by an Open Client DB-Library or Client-Library application.

TDCURPRO

Gets or sets information about a cursor.

TDESCRIB

Describes a row column and binds its associated host program variable.

TDFREE

Frees up the TDPROC structure for the connection.

TDGETREQ

Accepts the next RPC or language, cursor, or dynamic request in a long-running transaction and returns the transaction ID of the associated mainframe transaction.

TDGETSOI

Determines what Shift Out/Shift In (SO/SI) processing options are set for a column or parameter. (Used with double-byte character sets.)

TDGETUSR

Retrieves client login and mainframe customization information.

TDINFACT

Retrieves information about global accounting.

TDINFBCD

Retrieves the length and the number of decimal places for a specified packed decimal column or parameter.

TDINFLOG

Returns information about the trace settings currently in effect for the trace log.

TDINFPGM

Returns information about the currently running transaction.

TDINFPRM

Retrieves information about the specified parameter.

TDINFRPC

Returns information about the client RPC that requested the current transaction.

TDINFSPT

Indicates whether tracing is on or off for a specified transaction, and returns the transaction ID.

TDINFUDT

Returns information about the user-defined datatype associated with a column.

TDINIT

Initializes the Gateway-Library environment.

TDLOCPRM

Returns the ID number of a parameter based on its parameter name.

TDLSTSPT

Lists all transactions for which tracing is enabled.

TDNUMPRM

Returns the total number of parameters that came with the current remote procedure call, or cursor or dynamic request.

TDRCVPRM

Receives a parameter from a remote client.

TDRCVSQL

Receives a SQL statement string from a remote client.

TDRESULT

Describes the communication received from the client.

TDSETACT

Turns system-wide accounting for Gateway-Library on or off. Also used to rename the accounting log under CICS.

TDSETBCD

Specifies the length and number of decimal places for a given column.

TDSETLEN

Sets the column length for a variable-length field before sending it to a client.

TDSETLOG

Turns system-wide tracing options for the Gateway-Library functions on or off. Also used to rename the trace log under CICS.

TDSETPRM

Specifies the length and address of a return parameter.

TDSETPT

Specifies the type of IMS TM transaction being used.

TDSETSOI

Sets the Shift Out/Shift In (SO/SI) processing options for a column or parameter. (Used with double-byte character sets.

TDSETSPT

Turns tracing on or off for a specified transaction.

TDSETUDT

Specifies the TDS datatype for a given column.

TDSNDDON

Sends return parameter information back to the client. Tells the client that all results have been sent, and retains or terminates the connection between the client and server.

TDSNDMSG

Sends an error or informational message to a client.

TDSNDROW

Sends a row of data back to the requesting client.

TDSQLLEN

Gets the length of a SQL statement string received from a remote client.

TDSTATUS

Retrieves status information about the client/server connection.

TDYNAMIC

Read or respond to a client dynamic SQL command.

TDWRTLOG

Writes a user-created message or a system entry to the trace log.