DBCHREL returns the software release level and version number strings for the session specified by the input session identifier.
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.
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. |