The OPERATE Procedure

PROC OPERATE Statement

PROC OPERATE <options>;

SERVER=server-ID | _ _port-number

identifies the default server session to be managed. If this option is not specified, you must identify the server in the SET SERVER command or in those PROC OPERATE commands that allow you to identify the server to be managed. For details, see Specifying a Server.

If you are using the TCP/IP access method, you can specify the server's port number that corresponds to the server ID in the TCP/IP SERVICES file. Precede the port number with two consecutive underscores. (For details about the SERVICES file, see the topic on the SERVICES file in Communications Access Methods for SAS/CONNECT and SAS/SHARE.)

Note: Do not space after the first underscore or the second underscore. [cautionend]

Example:

_ _1025

Aliases:

ID, SERVERID

PRINTFILE=LOG | PRINT

directs the output from the OPERATE procedure. PRINTFILE=LOG directs the output to the SAS log. PRINTFILE=PRINT directs the output to the procedure output file or Output window.

Alias:

Default:

LOG

SAPW=password | "encoded-password"

specifies a server-access password. This password is required to access a SAS/SHARE server that is executing with the OAPW= option in PROC SERVER in effect.

password

must be a valid SAS name that is 1 to 8 characters in length. The value for this option is replaced by Xs in the log. To protect this password, you should use the security software at your site to limit access to the SAS program statements that create the server.

"encoded-password"

is an encoded version of a password. Using encoded passwords promotes security and enables you to store SAS programs that do not contain clear-text passwords.

To obtain an encoded password, specify the clear-text password as input to the PROC PWENCODE statement.

Here is an example of code for obtaining an encoded password:

 proc PWENCODE in="srvmach";
run;
{sas001}c2Vydm1hY2g=

The clear-text password srvmach is specified in the PROC PWENCODE statement. The output is generated in the form {key}encoded-password . sas001 is the key, which is used to decode the encoded password to its clear-text form when the password is needed.

Note: The encoded password is case-sensitive. Use the entire generated output string, including the key. [cautionend]

Use the output from the PROC PWENCODE statement as the value for encoded-password in the appropriate statement.

USER=user-ID| _PROMPT_

specifies the user ID of the accessing client on the server. The operating environment on which the client runs can also affect user ID conventions. For details about user ID conventions that are imposed by the operating environment, see Communications Access Methods for SAS/CONNECT and SAS/SHARE.

Here are the valid values for this option:

user-ID: For details about a valid user ID, see User ID and Password Naming Conventions.
_PROMPT_: specifies that SAS prompt the user for a valid user ID. Using _PROMPT_ is a way to enforce security.

Aliases:

USERNAME, USERID, UID

PASSWORD=password | "encoded-password" | _PROMPT_

specifies the password of the accessing client on the server. The operating environment on which the client runs can also affect password naming conventions. For details about password naming conventions that are imposed by the operating environment, see Communications Access Methods for SAS/CONNECT and SAS/SHARE.

password

"encoded-password"

is an encoded version of a password. Using encoded passwords promotes security and enables you to store SAS programs that do not contain clear-text passwords.

To obtain an encoded password, specify the clear-text password as input to the PROC PWENCODE statement.

Here is an example of code for obtaining an encoded password:

 proc PWENCODE in="srvmach";
run;
{sas001}c2Vydm1hY2g=

Note: The encoded password is case-sensitive. Use the entire generated output string, including the key. [cautionend]

Use the output from the PROC PWENCODE statement as the value for encoded-password in the appropriate statement.

Aliases:

PASSWD, PASS, PWD, PW

SETSASRC=(YES | NO)

causes the return code of PROC OPERATE to be surfaced to the operating environment when SAS execution terminates. For example, when submitting PROC OPERATE commands under batch mode under z/OS, SETSASRC=YES specifies that a non-zero return code from PROC OPERATE cause a condition code to be set in the JES message log for the batch job that invoked PROC OPERATE.

If SETSASRC=NO, the condition code for the batch job will be 0 regardless of whether the PROC OPERATE commands executed successfully.

Default:

NO (disabled)

Top of Page