SASGSUB Syntax: Ending a Job

The following is the complete syntax for ending a job on a SAS grid. The SASGSUB options can be specified in a configuration file so that they do not have to be entered manually. By default, the configuration file is named sasgsub.cfg and is stored in the current directory. The SAS Deployment Wizard automatically creates a configuration file that includes most of the required options. Enter the command on a Windows or UNIX command line.

Syntax

SASGSUB

-GRIDKILLJOB job-id | ALL-GRIDAPPSERVER sas-application-server
-GRIDLICENSEFILE grid-enabled-license-file
-GRIDSUBMITPGM sas-program-file
-GRIDWORK work-directory -JREOPTIONS java-runtime-options
-METASERVER server -METAPORT port
-METAPASS password-METAPROFILE profile-name
-METACONNECT connection-name
<-GRIDCONFIG grid-option-file>
<-GRIDUSER grid-logon-username> <-GRIDPASSWORD grid-logon-password>
<-GRIDPLUGINPATH grid-jar-file-path>
<-LOGCONFIGLOC logging-option-file> <-GRIDLIBPATH path><-VERBOSE>

Required Arguments

-GRIDKILLJOB job-id | ALL: terminates the job specified by job-id. If you specify ALL, all jobs are terminated.

-GRIDAPPSERVER sas-application-server: specifies the name of the SAS Application Server that contains the grid's logical grid server definition. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-GRIDLICENSEFILE grid-enabled-license-file: specifies the path and filename of a SAS license file that contains the SAS Grid Manager license. The default value is "license.sasgsub" and the default location is the GRIDWORK directory. You must copy the license file for the grid control server to the GRIDWORK directory and rename the file license.sasgsub in order to match the default values for this option. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-GRIDWORK work-directory: specifies the path for the shared directory that the job uses to store the program, output, and job information. The path cannot contain spaces. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-JREOPTIONS java-runtime-options: specifies any Java run-time options that are passed to the Java Virtual Machine. This argument is required if the grid provider plug-in uses Java.

-METASERVERserver: specifies the name or IP address of the SAS Metadata Server. You must specify either -METASERVER, -METAPORT, -METAUSER, and -METAPASS, or -METAPROFILE and -METACONNECT. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-METAPORT port: specifies the port to use to connect to the SAS Metadata Server specified by the -METASERVER argument. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-METAUSER user-ID: specifies the user ID to use to connect to the SAS Metadata Server specified by the -METASERVER argument. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-METAPASS password | PROMPT: specifies the password of the user specified in the -METAUSER argument. If the value of the argument is set to PROMPT, the user is prompted for a password. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-METAPROFILE profile_pathname: specifies the path name of the connection profile for the SAS Metadata Server. You must specify either -METASERVER, -METAPORT, -METAUSER, and -METAPASS, or -METAPROFILE and -METACONNECT. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

-METACONNECT connection-name: specifies the name of the connection to use when connecting to the SAS Metadata Server. The connection must be defined in the metadata profile specified in the -METAPROFILE argument. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

Optional Arguments

-GRIDCONFIG grid-option-file: specifies the path and filename of a file containing other SASGSUB options. The default value is sasgsub.cfg.

-GRIDUSER grid-logon-username: specifies the user name to be used to log on to the grid.

-GRIDPASSWORD grid-logon-password: specifies the password to log on to the grid.

-GRIDPLUGINPATH grid-jar-file-path1...grid-jar-file-pathN: specifies a list of paths to search for additional grid provider JAR files. Paths are separated by semicolons and cannot contain spaces. This option is not required if the grid uses Platform Suite for SAS.

-LOGCONFIGLOC logging-options: specifies any options for the SAS logging facility. See SASGSUB Syntax: Submitting a Job for a list of keys for the App.Grid logger.

-GRIDLIBPATH path: the path to the shared libraries used by the utility. This value is set in the configuration file and should not be altered. The path cannot contain spaces.

-VERBOSE: specifies that extra debugging information is printed. If this argument is not specified, only warning and error messages are printed.