UAUTHINFO

Sends logon requests to a server and returns server messages to the client.

Calling syntax:

"USYSNET".UAUTHINFO (PathDescription, AuthInfo, Status)

Parameters

Parameter Data Type Direction Description
PathDescription String IN The name of a network path that is defined in the [PATHS] section of the assignment file. For example: $TCP. (The $ may be omitted)

Or a full network path using the syntax for an assignment file path setting.

TCP:NETHOST|USER+DOMAIN|PASSWORD|PSV
AuthInfo String OUT Message returned by the server.
Status Numeric OUT Indicates whether an error has occurred, and whether logon is successful.

Return Values

Values Returned in AuthInfo and Status Parameters
AuthInfo Status Description
Empty -1 Error —a connection cannot be established with the server.
Empty 0 Success —the request is authorized by the server.
Contains messages from server 1 Error —a connection is established with the server, but the user name and password combination is not recognized.
Contains messages from server 2 Success —the request is authorized by the server, and the server has returned additional information, such as: " Your password is due to expire. Please change your password. "

Description

This operation submits a logon path to a server and returns user authorization messages from the server.

If you are creating your own USYSNET variant, define the UAUTHINFO operation as follows:

operation UAUTHINFO
params
   string  PathDescription : IN
   string  AuthInfo        : OUT
   numeric Status          : OUT
endparams

<Your code here>
end

Related Topics