Beginning in SAS^® 9.3, a new module is available that validates whether the SAS SVC is installed at the correct level, and whether the SVC-related option settings are correct.

This module is named TKSVCTST with an alias entry of SVCTEST.

You can execute this standalone program directly, or you can execute it as SAS code.

/* As SAS code */

      PROC SVCTEST; RUN;

/* In a batch job using PGM=SVCTEST  */

Note: See the Full Code section for additional examples. 

The required DD names are as follows:

• STEPLIB- the SAS installation load library.
• TKMVSENV- location where TKOPT_SVCNO and TKOPT_SVCR15 are set, which tells SAS how the SVC is installed.
• TKMVSJNL- location where the output results from the call to the SVC are written.

If a non-zero return code occurs, verify that the SAS SVC referenced in the //TKMVSENV file by the following environment variables has been set up correctly:

set TKOPT_SVCNO=
set TKOPT_SVCR15=  

For details about "Installing the SAS 9.4 SVC Routine", see page 34 in the "Configuration Guide for SAS® 9 Foundation for z/OS."

---

Full Code

Sample JCL for using the SVC test routine:

• Set TKOPT_SVCNO and TKOPT_SVCR15 according to how the SAS SVC is installed at your site. If you installed the SVC as a user SVC (not SVC 109), then do not specify the TKOPT_SVCR15 option.
• STEPLIB must refer to the library where TKSVCTST or SVCTEST module resides.

If you installed the SAS SVC as an ESR (Extended SVC Routing SVC):  

//TKSVCTST JOB       
//SVCTST  EXEC PGM=SVCTEST,REGION=129M                           
//STEPLIB  DD DISP=SHR,DSN=your.installation.V930.load.library          
//TKMVSENV DD *                                                  
set TKOPT_SVCNO=109                                              
set TKOPT_SVCR15=4                                               
/*                                                               
//TKMVSJNL DD SYSOUT=*                                           
//                                                              

If you installed the SAS SVC as a user SVC:  

//TKSVCTST JOB       
//SVCTST  EXEC PGM=SVCTEST,REGION=129M                           
//STEPLIB  DD DISP=SHR,DSN=your.installation.V930.load.library          
//TKMVSENV DD *                                                  
set TKOPT_SVCNO=250                                                                                           
/*                                                               
//TKMVSJNL DD SYSOUT=*                                           
//    

---

Output

TKSVCTST: SAS SVC validation program, version 1.0.              
TKMVSENV: Checking relevant variables.                          
          TKMVSENV variable: TKOPT_SVCNO  set to "109".         
          TKMVSENV variable: TKOPT_SVCR15  set to "4".  

Note: Calling the SAS SVC prior to SAS 9.3 results in ABEND U0991.
Note: Calling an uninstalled SVC could return ABEND S16D or SFxx.    
                                                                         
         Attempting to invoke SVC 109 ESR 4                              
                                                                         
     SAS SVC Version: 9.30                                           
     SAS SVC Level: 9                                                
     SAS SVC Date: 20101013                                          
                                                                         
     TKSVCTST: Validation program terminating. 

---

If a non-zero return code occurs, verify that the SAS SVC referenced in the //TKMVSENV file by the following environment variables has been set up correctly:

set TKOPT_SVCNO=
set TKOPT_SVCR15=  

Note: If you use an ESR SVC, do not code the parm "set TKOPT_SVCR15=". This parm causes a non-zero return code.