Examples

In the following examples, the MAKECREDENTIALS utility is run using CANDE for the host TR-PRESTIJC, username JCP, and password FROG.

U *SYSTEM/NXSERVICES/MAKECREDENTIALS TR-PRESTIJC JCP FROG

R *SYSTEM/NXSERVICES/MAKECREDENTIALS ("TR-PRESTIJC JCP FROG")

The MAKECREDENTIALS utility creates and names the credentials file using the <host> value of the command. In this example, the credentials file would be named, as follows:

NXSERVICES/CREDENTIALS/TR-PRESTIJC

In the following example, the host name is an IP address instead of a NETBIOS name.

U *SYSTEM/NXSERVICES/MAKECREDENTIALS 192.63.228.29 JCP FROG

In this example, the credentials file would be named, as follows:

NXSERVICES/CREDENTIALS/192_63_228_29

To create a default credentials file, use an * (asterisk) as the <host> value. For example,

U *SYSTEM/NXSERVICES/MAKECREDENTIALS
        * <user name> <password> <user domain>

The credentials file would be named, as follows:

NXSERVICES/CREDENTIALS

The following examples demonstrate the differences between credentials files as a result of the CASESENSITIVEPW security option setting.

Note: The CANDE RUN command is used to avoid converting the parameter to uppercase by CANDE.

In the following example, PassWord is used if the CASESENSITIVEPW security option is set. If the CASESENSITIVEPW security option is reset PASSWORD is used.

R *SYSTEM/NXSERVICES/MAKECREDENTIALS ("HOSTA JOE PassWord")

In the following example, because the password is entered within quotation marks ("), PassWord is used regardless of the CASESENSITIVEPW security option setting.

R *SYSTEM/NXSERVICES/MAKECREDENTIALS ("HOSTA JOE ""PassWord""")

The following example shows the same command in a WFL job.

RUN *SYSTEM/NXSERVICES/MAKECREDENTIALS ("HOSTA JOE ""PassWord""")

The following example demonstrates how to retrieve the TASKVALUE.

BEGIN JOB MAKECREDENTIALS;
TASK T;
RUN *SYSTEM/NXSERVICES/MAKECREDENTIALS
        ("HOSTA JOE ""PassWord""") [T];
IF T (TASKVALUE) NEQ 0 THEN
    ABORT ("MAKECREDENTIALS failed with error " & 
           STRING (T (TASKVALUE), *));
END JOB