Pathmaker Programming Guide

Coding Custom Services
Creating Services and Servers
067868 Tandem Computers Incorporated 4–25
Table 4-3. Pathmaker Common Service Utility Library (Page 2 of 5)
Function Name Description Parameters Description Return Value
svc_advisory Stores an advisory
message in the reply
advisory fields of the
current service.
short severity
char *text
Severity of the advisory message.
Pointer to the text string to store in
the service’s reply advisory text
field.
Void
lfe_advisory Stores an advisory
message in the reply
advisory message buffer
of the current service
describing the last error
encountered by a logical
file.
LOGICAL_FILE *file Pointer to the logical file that
suffered the error.
Void
sql_advisory Stores an advisory
message in the reply
advisory message buffer
of the current service
describing the last error
encountered by the SQL
run-time system.
Void Void
lfopen Opens an existing logical
file.
LOGICAL_FILE *file
char *logicalname
char *physicalname
short access
short exclusion
Pointer to the open file descriptor
used to access the logical file.
Pointer to the logical name of the
file, or NULL if the file does not use
a logical name.
Pointer to the physical name of the
file, or NULL if the file must be
opened using its logical name.
0 for input/output access; 1 for input
access; 2 for output access; 3 for
extend access.
0 for shared access; 1 for exclusive
access; 3 for protected access.
Pointer to
LOGICAL_FILE or
NULL if operation
fails.
lfclose Closes a previously
opened logical file.
LOGICAL_FILE *file Pointer to the logical file to close. Short
LFE_OK is
returned if the
operation is
successful; an
error code is
returned if it fails.