%RMVINST

%RMVINST Overview

%RMVINST verifies that the application server is correctly configured for use by SAS IT Resource Management.

CAUTION:

Use this macro only under the direction of Technical Support.

This macro produces a large volume of information, the interpretation of which requires thorough knowledge of SAS IT Resource Management metadata structures.

The output produced by %RMVINST can be useful for debugging issues related to JAR files and JEOPTIONS settings.

The %RMVINST macro reports on the following issues:

Can SAS run Java successfully?
What version of Java is running?
Has the location of the SAS JAR files been set with the JREOPTIONS system option?
Are the SAS JAR files in the correct location?
Is SAS able to access the SAS IT Resource Management JAR files?
What version of the SAS IT Resource Management JAR files is being accessed?

To execute this macro, add it to a SAS IT Resource Management job or program that you submit from SAS.

Output from running the macro in batch is written to log and list files in the current directory or to the SAS log and list in the job output when you use z/OS batch. For more information about this macro and each of these parameters, see the documentation that is provided inside the macro.

%RMVINST Syntax

%RMVINST(
METAPASS=user-password
,METAPORT=metadata-server-port
,METASERVER=name-of-metadata-server
,METAUSER=user-ID
);

%RMVINST Required Arguments

METAPASS=user-password

specifies the password to use in authenticating the user ID to the metadata server. Do not enclose the value for this parameter in quotation marks.

You can use the PWENCODE form of the password. For more information about the PWENCODE procedure, see the Base SAS Procedures Guide.

Tip

If you use the PWENCODE form of the password, be sure to handle embedded braces ({}) carefully. Do not confuse them with square brackets ([]).

METAPORT=metadata-server-port

specifies the password that is associated with the metauser ID. Do not enclose the value for this parameter in quotation marks.

METASERVER=name-of-metadata-server

specifies the name of the metadata server. Do not enclose the value for this parameter in quotation marks.

METAUSER=user-ID

specifies the user ID that accesses the metadata server. Do not enclose the value for this parameter in quotation marks.

Note: All four parameters are required. If you do not supply a value for any parameter, %RMVINST uses the equivalent SAS option, if you have set one.

%RMVINST Example

%RMVINST(
         metapass=my-password,
         metaport=8561,
         metaserver=mybox.subdomain.domain.com,
         metauser=my-username
);