DBFCON is the Connect function of DBCHCL.
- Log on to the specified database computer.
- Arrange to have the specified set of services used for all requests on that session.
- Allocate internal control structures that CLI uses to store session context.
CLIv2 allows users to append user-specific information to the LogonSource column of the DBC.EventLog table for each connected session. CLIv2 accesses this information through the LSINFO environment variable. The method for setting an environment variable does vary among platform implementations; consult the appropriate documentation for your specific platform environment.
Be aware that the LogonSource column is a string defined as VARCHAR(128). Therefore, the maximum allowable length of the LogonSource column is 127 bytes (with the last byte a null terminator). If the LogonSource column exceeds 127 bytes, it will be truncated and LSINFO will not be appended. If the sum of the lengths of the Logon Source column and LSINFO (plus a blank separator character) exceeds 127 bytes, LSINFO will not be appended.
What It Does
- Obtains and initializes context block
- Validates DBCAREA arguments, as necessary
If the application has requested option updates, perform option set/validation logic
- Obtains/initializes buffers, the length of which is either the user requested size or the default size
- Sets actual length of request/fetch buffers
- If the application program has requested the User Exit option, sends a special logon string to the CLI User Exit Function
- Sends the logon (connect) request and connect request parcels in the request buffer to the MTDP and awaits completion
- If the Run String Buffer Length field indicates the buffer is a run string and not a connect structure, builds a connect structure for the session
- If successful, sets the actual session number output argument and the return code and returns control to caller
- If the Connect fails, returns an error; run string, if omitted, defaults to Teradata SQL
Sending a Connect Request
- Call DBCHCL for DBFCON
- Check that return code is zero
Successful Connect Operation
- Call DBCHCL for DBFCON
- Check that return code is zero
- Call DBCHCL for DBFFET
- Check that return code is zero
- Check that parcel is not Error or Failure parcel
- Call DBCHCL for DBFERQ
- Check that return code is zero
Interface
The DBFCON interface is as follows:
| Function: | DBFCON - Connect |
| Purpose: | Logon and Run. (Analogous to SQL ‘CONNECT‘) |
| Parms: | struct DBCAREA *dbcptr pointer to a DBCAREA |