SASGSUB Syntax: Viewing Job Status
The following is the syntax for using SASGSUB to
view the status of a job on a SAS grid. Enter the command on a Windows
or UNIX command line.
Syntax
SASGSUB
-GRIDGETSTATUS job-id |
ALL -GRIDWORK work-directory
-METASERVER server -METAPORT port
-METAPASS password-METAPROFILE profile-name
-METACONNECT connection-name
<-GRIDCONFIG grid-option-file> <-GRIDLIBPATH path><-VERBOSE>
Required Arguments
- -GRIDGETSTATUS job-id |
ALL
-
displays the status
of the job specified by job-id.
If you specify ALL, the status of all jobs for the current user is
displayed.
- -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.
- -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.
- -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.
Examples
Example 1: Viewing the Status of a Single Job
The following is an
example of a SASGSUB statement used to view the status of job 61361
that is running on the grid:
SASGSUB -GRIDGETSTATUS 61361
The output from the
command looks like this:
Status of a Single Job
Current Job Information
Job 61361 (testPgm) is Finished: Submitted: 06Jan2011:10:28:57, Started: 06Jan2011:10:28:57 on Host d12345, Ended: 06Jan2011:10:28:57
Example 2: Viewing the Status of All Jobs
The following is an
example of a SASGSUB statement used to view the status of all jobs
running on the grid:
SASGSUB -GRIDGETSTATUS ALL
The output from the
command looks like this:
Status of All Jobs
Current Job Information
Job 1917 (Pgm_01) is Finished: Submitted: 08May2011:10:28:57, Started: 08May2011:10:28:57 on Host d12345, Ended: 08May2011:10:28:57
Job 1918 (Pgm_02) is Finished: Submitted: 08May2011:10:28:57, Started: 08May2011:10:28:57 on Host d12345, Ended: 08May2011:10:28:57
Job 1919 (Pgm_03) is Finished: Submitted: 08May2011:10:28:57, Started: 08Ma2011:10:28:57 on Host d12345, Ended: 08May2011:10:28:57
Job information in directory U:\jobs\GridSub\GridWork\user1\SASGSUB-2011-05-11_13.17.17.327_testPgm is invalid.
Job 1925 (Pgm_04) is Submitted: Submitted: 08May2011:10:28:57