SASGSUB Syntax: Ending a Job

The following is the complete syntax for ending a job on a SAS grid. Enter the command on a Windows or UNIX command line.

Syntax

Example

Syntax

SASGSUB

-GRIDKILLJOB job-id | ALL -GRIDAPPSERVER sas-application-server
-GRIDLICENSEFILE grid-enabled-license-file

-METASERVER server -METAPORT port
-METAPASS password-METAPROFILE profile-name
-METACONNECT connection-name
<-GRIDCONFIG grid-option-file><-JREOPTIONS java-runtime-options>
<-GRIDSTAGECMDcommand><-GRIDSTAGEFILEHOSThostname>
<-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 to retrieve the license file information from metadata. If specified, the location must point to a valid SID file that contains a SAS Grid Manager license. Do not use this option unless instructed by SAS Technical Support.

-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 pathname 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.

-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.

-GRIDSTAGECMD command: specifies the remote copy command used to stage files to the grid. Valid values are LSRCP, RCP, SCP, or SMBCLIENT. This option is used when the grid client machines and the grid machines do not share a common directory structure.

-GRIDSTAGEFILEHOST hostname: specifies the name of the host that stores files that are staged onto the grid. This option is used when a machine submits files to the grid and then shuts down.

-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.

Example: Ending a Job

The following is an example of a SASGSUB statement used to end the job 61361 that is running on the grid:

SASGSUB -GRIDKILLJOB 61361