Service Functions

Uniface provides a set of service functions that serve the following purposes:

• Exchanging information between Uniface and the connector
• Providing functionality required by Uniface, but not supported by the DBMS
• Facilitating the development of a connector

Many service functions are specific to one corresponding connector request. The description of connector requests includes a list of service functions that can or must be used.

Service Functions

Function	Connector Request	Description
uaddhit	Select, Fetch, Write	Adds an entry to the Uniface hitlist, or updates an existing one.
uaddrec	Select	Adds an entry to the Uniface hitlist.
uaddsql	Sql	Flushes the SQL buffer or the I/O buffer, depending on the mode of the connector request.
ubldprim	Update	Builds the concatenated primary key for a record.
ubldprm	Update, Write	Builds the concatenated primary key for a record.
ucnvext		Converts from meta to external character set
ucnvint		Converts from external to meta character set
udbconv		Converts data from the format with which Uniface supplies it to the connector, to a specified connector-level packing code.
udcurscnt	Logon, Logoff, Open, Close	Returns the number of open database cursors
udfilcnt	Logon, Logoff, Open, Close	Returns the number of open operating system files
udgetasn		Finds the specified assignment and copies it to the assignment value buffer.
udpathset	Logon, Logoff	Returns a number that uniquely identifies the current logon path
ugetblob	Update, Write	Gets segmented data from the Uniface kernel.
ugethit		Gets the concatenated primary key and the physical row address of the current hit corresponding to the specified uctrl structure into the hitlist.
uhitchk	Select, Wildcard delete/nullify	Determines if a record matches the profile specified in the uiflst structure and the uwhrlst structure.
unullify	Wildcard delete/nullify	Updates the fields appearing in the ‘if’ list to NULL in the general I/O buffer.
uputblob	Fetch	Sends segmented data to the Uniface kernel.
uready	Select, Wildcard delete/nullify	Informs the connector whether it needs to continue searching through the preferred index
usumfld	Select	Supplies Uniface with the result of an aggregate computation in the Select mode 4 connector request.
usumhit	Select	Computes the specified aggregate computation or computations when called for all selected records in Select mode 4.