UROUTER_DOYOUHAVE

Check if the Uniface Router has at least one client or server running with the specified attributes.

operation UROUTER_DOYOUHAVE
params
   string Using : IN ; (C1)
   string Host : IN ; (C80)
   string User : IN ; (C40)
   string UST : IN ; (C20)
   numeric unused : IN ; (I4) currently not used
endparams

Parameters

  • Using—code indicating whether information is being requested for clients or servers. One of:
    • S for servers with the specified host name, UST, and/or user name
    • C for clients with the specified host name, UST, and/or user name
    • Blank for either servers or clients
  • Host—host name of the client or server
  • User—user name of the client or server
  • UST—Uniface Server Type (UST) of the client or server

The selection criteria Host, User and/or UST, if present, are combined (logical AND) and applied to running servers and/or clients to determine if at least one match can be found.

Return Values

The value of $status following UROUTER_DOYOUHAVE is set to:

  • 1 if at least one client or server matches the selection criteria
  • 0 if no clients or servers match the selection criteria

Otherwise, see Return Codes.

Use

Allowed in all Uniface component types.

Description

The UROUTER_DOYOUHAVE operation checks if the Uniface Router has at least one client or server running with the specified attributes.

Once it has identified a server or client that fulfils the selection criteria in the administration, it sends an existence check message to the application to verify that it really is available. If it is not, the administration is updated and the search continues for another candidate.

Note:  A successful call to UROUTER_DOYOUHAVE does not guarantee that the server or client are still available when the calling application wants to perform some action on that client or server, it only guarantees that it was available at the time of the UROUTER_DOYOUHAVE operation.