Use the PWENCODE procedure to encode the password. The encoded password is written to the SAS log:

1    proc pwencode in='pass1234';
2    run;
{sas001}eNCrypTeDpW=

Note that mixed case and brackets{} in the encoded password generated by PROC PWENCODE are not accepted in the startup JCL for a SAS/SHARE server. Use one of the following methods:

METHOD 1: Using the STRTSRV macro after SYSIN

1. Start SAS/SHARE server.

   //jobcard  JOB (,Jxxxx),'programmer-name',TIME=(2,0),REGION=64M
   /*JOBPARM FETCH
   //*
   //STEP1  EXEC SASPROC,OPTIONS='COMAMID=XMS'
   //SYSIN DD *
   %SHRMACS(SERVER);
   %STRTSRV(TEST,,,"{sas001}eNCrypTeDpW=");
   RUN;

2. Once the server is up, use PROC OPERATE commands with sapw= from the client.

proc operate server=TEST sapw="{sas001}eNCrypTeDpW="; display library _all_ ; run;

METHOD 2: Passing the encoded password in a batch job

1. Start SAS/SHARE server.

   //jobcard  JOB (,Jxxxx),'programmer-name',TIME=(2,0),REGION=64M
   /*JOBPARM FETCH
   //*
   //* proc pwencode in='password'; run;
   //*
   //STEP1  EXEC SASPROC,OPTIONS='COMAMID=XMS'
   //SYSIN DD *
   PROC SERVER SERVER=TEST OAPW="{sas001}eNCrypTeDpW=" ;
   RUN;

2. Once server is up, use PROC OPERATE commands with sapw= from the client.

proc operate server=TEST sapw="{sas001}eNCrypTeDpW="; display library _all_ ; run;

METHOD 3: Using the macro method from the online documentation.

Consult SAS OnlineDoc^® 9.1.3 under the section “z/OS: Creating the Server Environment.”

Although it is recommended that you use the %STRTSRV macro from the SAS macro autocall library (see SAS/SHARE Macros for Server Access), you can also create and use the SERVER macro, which executes faster than %STRTSRV.

Before you can use the SERVER macro, you must create a member named SERVER in the SAS macro autocall library and add the following statements (from %MACRO to %MEND). The following sample will execute this activity in a batch job:

   //jobcard....
   //STEP1  EXEC SASPROC,OPTIONS='COMAMID=XMS'
   //SYSIN DD *
   
   %MACRO SERVER(id,servopt,uapw,oapw);
   %********************************************;
   %* This macro invokes PROC SERVER to create *;
   %* a server with the specified ID.          *;
   %********************************************;
   PROC SERVER ID=&id &servopt
      %if (&uapw NE) %then
         %do;
            UAPW=&uapw
         %end;
      %if (&oapw NE) %then
         %do;
            OAPW=&oapw
         %end;
   ;
   run;
   endsas;
   %MEND;

   %SERVER(TEST,,,"{sas001}eNCrypTeDpW=");
   run;

Note: Share passwords are not case sensitive by design. The PWENCODE facility is case sensitive, but it is an independent layer of code that serves to encrypt and decrypt passwords. When Share code receives such an encrypted password, it calls the facility for decryption and changes the plain text password to uppercase. Users will have to rely on passwords not being case sensitive.

Operating System and Release Information