xcall SQL, SQLOP_INIT_CONN, cmdhdr
The SQLOP_INIT_CONN function initializes a connection structure and set of internal resources in preparation for an actual database connection.
Parameters
cmdhdr (ST_SQL_CMDHDR), [in/out]
The fields of interest to this opcode in the cmdhdr structure (defined in SQL.DEF) are listed below.
Field |
Dir |
Notes |
|---|---|---|
handle |
out |
new connection handle (needed for all other calls) |
dbmsconid |
in |
|
opflags |
in |
SQLCONF_TRACE flag activates tracing of ASQL operations in ashlog.log |
cmdarg1,2 |
n/a |
|
rc |
out |
return code (0 = ok, see SQLERR_xxx) |
rcext |
n/s |
|
info1,2 |
n/a |
|
sqlstate |
out |
ANSI standard SQL state code |
reshdl |
n/a |
|
psthdl |
n/a |
|
History
2012 January, ashmysql connector 1.4.132: SQLCONF_TRACE flag added. Note that setting the SQLCONF_TRACE flag in the opflags field is equivalent to defining an environment variable ASQLTRACE=1.
