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.
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
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