ViewRegistry Report

1. Introduction
2. Preparing to run the ViewRegistry Report
3. Generating the ViewRegistry Report
4. Report options
5. Sample output
6. Troubleshooting problems with the ViewRegistry Report
7. Using PROC PRODUCT_STATUS to determine SAS software installation information
8. More information about product release and maintenance numbers

1. Introduction

   The installation of SAS^® products is logged in the SAS Deployment Registry. ViewRegistry (sas.tools.viewregistry.jar) is a reporting utility that processes the deployment registry to generate the DeploymentRegistry.html report. This report identifies all SAS^® 9.2 and later software that is installed in the current SASHOME location. Installed hot fixes are also logged in the SAS Deployment Registry and reported in DeploymentRegistry.html.

   Beginning with SAS® 9.4 M3 the default output will report only the current release of product components which are installed in the current SASHOME. Duplicate product component entries will appear only for products that support side-by-side deployment, for example SAS® Enterprise Guide and SAS® Add-in for Microsoft Office. The -all option can be used to report on all product components that have been installed in SASHOME; see the Report Options section below.

2. Preparing to Run the ViewRegistry Report

   This utility is installed by default with SAS 9.2 TS2M2 and later in SASHOME/deploymntreg.

   If you are running a SAS 9.2 release earlier than TS2M2, you can download sas.tools.viewregistry.jar. The file must be saved to the SASHOME/deploymntreg directory, and it must be saved with a .jar extension.

   Requirements:

   • You must be running Java 5 Update 12 or later.
   • You must have Administrator privileges.

3. Generating the ViewRegistry Report

   sas.tools.viewregistry.jar must be executed from the SASHOME/deploymntreg directory.

   Two output files are produced by the reporting utility, DeploymentRegistry.html and DeploymentRegistry.txt. The HTML and TXT output files are written in the SASHOME/deploymntreg directory.

   
   Windows:

   Double-click on sas.tools.viewregistry.jar to run the file.

   Alternatively, the JAR file can be executed from a command prompt:

   (For SAS 9.2): C:\Program Files\SAS\deploymntreg> java -jar sas.tools.viewregistry.jar

   (For SAS 9.3 or 9.4 installed with no other SAS release): C:\Program Files\SASHome\deploymntreg> java -jar sas.tools.viewregistry.jar

   (For SAS 9.4, with SAS 9.3 installed as well): C:\Program Files\SASHome2\deploymntreg> java -jar sas.tools.viewregistry.jar

   
   UNIX:

   Execute the JAR file,

          SASHOME/deploymntreg> java -jar sas.tools.viewregistry.jar

   where SASHOME is the directory where SAS is installed. In the examples below, SASHOME is /apps/sas92m3.

   Host-specific examples:

   HPUX (64-bit), HPUX IPF:
   /apps/sas92m3/deploymntreg> ../jre1.5.0.08/bin/java -jar sas.tools.viewregistry.jar

   Linux, Linux for x64:
   /apps/sas92m3/deploymntreg> ../jre1.5.0_14/bin/java -jar sas.tools.viewregistry.jar

   AIX (64-bit):
   /apps/sas92m3/deploymntreg> ../jre1.5_SR5/jre/bin/java -jar sas.tools.viewregistry.jar

   Solaris (64-bit), Solaris for x64:
   /apps/sas92m3/deploymntreg> ../jre1.5.0_12/bin/java -jar sas.tools.viewregistry.jar

   Note: In order to run the reporting utility on UNIX systems, you must have Write permission to the SASHOME location because the resulting reports are written to this location. See Report options for information about using the -path option.

   
   VMI:

   Execute the JAR file.

   java -jar sas.tools.viewregistry.jar

   Note: In order to run the reporting utility on VMI, you must first set the following logicals and process attribute:

   $ set process/parse=extended
   $ DEFINE DECC$ARGV_PARSE_STYLE ENABLE
   $ DEFINE DECC$EFS_CHARSET ENABLE
   $ DEFINE DECC$EFS_CASE_PRESERVE ENABLE
   $ define JAVA$FILE_OPEN_MODE 3
   $ define java$filename_controls 0
   

   
   z/OS:

   Execute the JAR file from UNIX System Services (USS) by issuing the following commands in omvs:

   cd SASHOME directory/deploymntreg 
   java -jar sas.tools.viewregistry.jar 

   where SASHOME directory is the directory where SAS is installed. If you do not know where your SASHOME directory is, it is the directory specified in the "set SASHOME=" statement in your TKMVSENV data set. If you do not have java defined in your PATH environment variable, you may need to put the entire java path in the second command, for example:

   /usr/lpp/java/J6.0/bin/java -jar sas.tools.viewregistry.jar 

   if java was installed at /usr/lpp/java/J6.0

4. Report Options

   -hotfix

   reports only the product components to which hot fixes have been applied, including the hot fix IDs. No parameter is accepted.
   Do NOT use the -hotfix option if the DeploymentRegistry.txt that is generated will be used by the SAS Hot Fix Analysis, Download and Deployment Tool (SASHFADD).

   Example:

   java -jar sas.tools.viewregistry.jar -hotfix

   
   -out <parameter>

   specifies an alternative output directory for DeploymentRegistry.html and DeploymentRegistry.txt. This option should be used if you do not have Write access to SASHOME, which is the default output location.

   Example:

   java -jar sas.tools.viewregistry.jar -out /u/myuserid/output

   
   -all

   valid beginning with SAS® 9.4 M3; reports all product components that have been installed, which may include multiple releases of a product component that has been upgraded. No parameter is accepted.

   Example:

   java -jar sas.tools.viewregistry.jar -all

   
   

5. Sample Output

   
   

   
   * Note: This report output has been modified for the demonstration purposes.

6. Troubleshooting Problems with the ViewRegistry Report

   • How to troubleshoot problems when running the sas.tools.viewregistry.jar tool to see what products you have installed

     See SAS Note 38551 for more details.

7. Using PROC PRODUCT_STATUS to Determine SAS Software Installation Information

   Another way to determine maintenance levels is to submit this code and inspect the log window:

         proc product_status;
         run;

   This code generates information for SAS^® Foundation products only; it does not generate information for web applications, other Java based products, or hot fixes. This code is available on all operating systems.

   Note:
   proc product_status; output might not reflect the same content as the SAS Deployment Registry report for z/OS.

   
   

   Sample Output:

   

8. More Information about Product Release and Maintenance Numbers

   To learn more about maintenance product release numbers, see

   • Understanding Product Release Numbers in Planning for Maintenance Releases and Product Upgrades for SAS^® 9.2
   • Determining the Product Release Numbers for Products at Your Site in SAS^® 9.3 Guide to Software Updates
   • SAS^® 9.2 Provides New Product-Specific Release Numbers.