17.10 - DBCHREL - Call-Level Interface Version 2

Teradata® Call-Level Interface Version 2 Reference for Workstation-Attached Systems

Product
Call-Level Interface Version 2
Release Number
17.10
Release Date
October 2021
Content Type
Programming Reference
Publication ID
B035-2418-061K
Language
English (United States)

DBCHREL returns the software release level and version number strings for the session specified by the input session identifier.

For increased reliability, use the QEPIDBR field of the DBCHQE routine instead of DBCHREL. See The qepItem Field for more information.

The release level string is returned as a 6 byte string of the format XX.YY, where XX is the major release number and YY is the minor release number. For example, 3.1 would be returned for 3.1 level software.

The version string is a 15 byte string of the form XXXX.YYYY.ZZZZ, where XXXX is the major version number, YYYY is the minor version number, and ZZZZ is the update version number. For example, 0051.0000.0130 would be returned for version 51.0.130.

Release level and version number are session-specific because it is possible to log sessions onto different database computers from the same application program.

Returns 0 if succeeds, else returns error.

DBCHREL will return NOSESSION (304) if the session is not found.

Parameters

Int32 DBCHREL (ReturnCode, ContextArea, sessid, relstr, verstr)
Int32 *ReturnCode;
char *ContextArea;
Int32 sessid;
char *relstr;
char *verstr;

where the following is true:

The parameter... Is the...
ReturnCode address of an area allocated by the application program for storage of a four-byte signed integer.

After control returns from DBCHREL, the integer contains a code whose value represents success or failure to obtain the information. A return code of zero indicates success; a non-zero return code indicates failure, and the value specifies the reason for the failure.

ContextArea address of a one-byte area not used by CLI or the application program.

It is provided to maintain compatibility with calls on mainframe clients.

sessid (session) four-byte signed integer returned in the Output Session Id field of DBCAREA from a previous call to DBCHCL for the DBFCON.

The integer contains the session id of the session for which the release information is to be obtained.

relstr (release) address of an area allocated by the application program for storage of a 6-byte character string.

Upon return from DBCHREL, the string will contain the printable release level of the software that is running on the database computer which is handling the specified session.

verstr (version) address of an area allocated by the application for storage of a 15-byte character string.

Upon return from DBCHREL, the string will contain the printable version number of the software that is running on the database computer which is handling the specified session.