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