UCHANGEPWD

Changes the password for a given network path.

Calling syntax:

"USYSNET".UCHANGEPWD (PathDescription, NewPassword, 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

Note:  The path should use the current password, not the new password contained in NewPassword.
NewPassword String IN New network password.
AuthInfo String OUT Message returned by the server.
Status Numeric OUT Indicates whether an error has occurred.

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

UCHANGEPWD submits a new password and an existing path to a server, and requests the server to change the password for the given path.

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

operation UCHANGEPWD
params
   string  PathDescription : IN
   string  NewPassword     : IN
   string  AuthInfo        : OUT
   numeric Status          : OUT
endparams

<Your code here>
end

Related Topics