Server Logging On

The following function turns on server query logging and/or alters the log format being used.

dvkerr_t lkt_svrlogon( lpar_t hostc, lpar_t format );

In order for this command to have any effect, the server must have been started with the −l command line option to specify the name of the query log file. For further details, see the TIBCO® Patterns Installation guide.

The format lpar, if not LPAR_NULL, specifies the new log format to use. The format string is copied literally to the log file after the following conversions:

%c	(where c is any character) is substituted as in the ANSI C library function strftime.
$c
$d	database(s) accessed by command
$g	GIP prefilter state
$i	IP address of connection
$n	number of matching records returned
$P	predicate
$q	query
$s	numeric status code returned by server
$S	string representation of status returned by server
$t	CPU time needed by command
$$	literal $

The default format is:

$c %d/%b/%Y-%H:%M:%S $i $s $t $d $q $n $p $g\n

Input

host (required)

For more information, see Communicating with TIBCO Patterns Servers.

format (optional)

is the log file format (SVR_LPAR_BLK_LOGFORMAT).

Error codes and items returned by lkt_svrlogon

IPCERR	(none)
IPCTIMEOUT	(none)
IPCEOF	(none)
HANDSHAKE	(none)
LOGFILE	(none)
PARAMVAL	Parameter that should have been a SVR_LPAR_BLK_LOGFORMAT.