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