At some customer sites, when SAS 9.3 or later is being installed, the SAS Deployment Wizard (setup.rexx) cannot successfully allocate or delete the high-level-qualifier.INSTALL.CNTL data set. This data set is used by the wizard to store the batch jobs used in the installation.

For example, during initial installation, the SAS Deployment Wizard cannot allocate the CNTL data set if your site has defined the TSO DELETE command as authorized. In this situation, the SAS Deployment Wizard fails the "Install Post-Processing" step. Messages similar to the following appear in the file SASHOME directory/InstallMisc/InstallLogs/IT_yyyy-mm-dd-hh.mm.ss.log:

[ 62503] AssembleMVSJobcode : tso stdout: 
IKJ56652I You attempted to run an authorized command or program.  This is not supported under the Dynamic TSO Environment. 

tso stderr: 
del 'high-level-qualifier.INSTALL.CNTL' 
FOMF0139I Authorized commands are not supported 

If you are applying maintenance to an existing installation, you might see a message similar to the following in the file SASHOME directory/InstallMisc/InstallLogs/IT_yyyy-mm-dd-hh.mm.ss.log:

2012-mm-dd hh:mm:ss    Controller - com.sas.tools.installs.it.InstallException: Error removing existing control dataset member MAINT1: IKJ56652I You attempted to run an authorized command or program.  This is not supported under the Dynamic TSO Environment.
del 'high-level-qualifier.INSTALL.CNTL(MAINT1)'
FOMF0139I Authorized commands are not supported

Two Workarounds

There are two ways to circumvent this problem, depending on your situation.

During an initial installation, you may use either option.

When applying maintenance, you must use the first option below, "Enable the Use of Authorized Commands from the Script." SAS recommends that you use the first option, if possible, because if you leave the link in place, then it will be used for subsequent hot-fix installation without any other necessary intervention on your part.

Enable the Use of Authorized Commands from the Script

1. Remove any content that was written to the SASHOME directory.
2. Starting with z/OS release 1.12, the operating system includes the tsocmd utility, which can execute authorized commands. For earlier z/OS releases, download this utility from the IBM z/OS UNIX Tools web page.
3. Once you have the utility available on your system, create a link called tsocmd that points to the utility. Create the link in the SAS home directory (this means that the directory must exist before you invoke setup.rexx). For example, if you have the utility installed at /usr/local/bin/mods/tsocmd, you would execute the following command in OMVS to create the link:
   ln -s /usr/local/bin/mods/tsocmd SAS-home-directory/tsocmd
4. Execute setup.rexx again.

   Note: When you invoke the rexx, you are prompted for your SAS home directory. If you have this link in that directory, you see this message from linemode.rexx:

      The specified SAS Home location contains existing files that may be overwritten
      It is advisable to install into an empty directory.                             
      Would you like to proceed anyway?                                               
                                                                                   
      Enter Yes or No.                                                                
      ==>                                                                             
   

   Respond Yes to this message.

Allocate the high-level-qualifier.INSTALL.CNTL File Before Executing the Script

1. Allocate the following file:

   high-level-qualifier.INSTALL.CNTL—This file has the following DCB characteristics and space:

   LRECL=80
   BLKSIZE=6160
   DSORG=PO
   BLOCKS=1200
   Directory blocks=150

Important Note: To run a SAS 9.3 metadata server under z/OS, allocate a second INSTALL.CNTL library with the high-level qualifier that you will use for your z64 data sets (for example, high-level-qualifier.Z64.INSTALL.CNTL).



2. Execute the following command in OMVS before you invoke setup.rexx, to indicate to the SAS Deployment Wizard that the files are pre-allocated:
   export SASNOALLOC=TRUE
   
   

   Note: The command must be entered exactly as shown, as OMVS is case-sensitive.

3. Remove any content that was written to the SASHOME directory.
4. Execute setup.rexx again.

Operating System and Release Information