udpathset

Return a number that uniquely identifies the current logon path

short udpathset(uc, drvnum, pathnum)

struct uctrl *uc;

short drvnum, pathnum;

Parameters

  • uc—address of the current control block.
  • drvnum—connector number (available in uctrl->udrvnum).
  • pathnum—unique logon path identifier. This number must be greater than zero.

Return Values

The unique logon path identifier pathnum.

Description

udpathset supplies Uniface with a number that uniquely identifies the current logon path.

This example allows you to log on to a DBMS.

LogonToDBMS ( struct uctrl *ControlBlock )
{
short PathNumber;
/* Perform the following type of actions:*/
/* - Parse loginstring.*/
/* - Map path to DBMS connection.*/
/* - Create new connection to DBMS when needed.*/
/* - Attach to DBMS on created connection.*/
/* - Set PathNumber to correct value.*/
/* - etc.*/
udpathset ( ControlBlock, ControlBlock->udrvnum, PathNumber );
}