SASGSUB Syntax: Retrieving Job Output

The following is the syntax for using SASGSUB to retrieve the output of a job that has completed processing on a SAS grid. Enter the command on a Windows or UNIX command line.

Syntax

SASGSUB
-GRIDGETRESULTS job-id | ALL -GRIDWORK work-directory
-METASERVER server -METAPORT port
-METAPASS password-METAPROFILE profile-name
-METACONNECT connection-name
<-GRIDRESULTSDIR directory>
<-GRIDCONFIG> <-GRIDLIBPATH path><-GRIDFORCECLEAN><-VERBOSE>

Required Arguments

-GRIDGETRESULTS job-id | ALL
Copies the job information from the work directory to the directory specified by -GRIDRESULTSDIR for the specified job-id or for all jobs.
-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.
-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

-GRIDRESULTSDIR directory
specifies the directory to which the job results are moved. The default value is the current directory.
-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.
-GRIDFORCECLEAN
specifies that the job directory on the grid is deleted, regardless of whether the job was successful or not.
-VERBOSE
specifies that extra debugging information is printed. If this argument is not specified, only warning and error messages are printed.

Examples

Example 1: Retrieving the Output of a Job

The following is an example of a SASGSUB statement used to view the output of job 61361 that is running on the grid:
SASGSUB -GRIDGETRESULTS 61361
The output from the command looks like this:
Output of a Single Job
Current Job Information
  Job 61361 (testPgm) is Finished:  Submitted: 06Jan2011:10:53:33, Started: 06Jan2011:10:53:33 on Host d15003, Ended: 06Jan2011:10:53:33
    Moved job information to .\SASGSUB-2011-01-06_21.52.57.130_testPgm

Example 2: Retrieving the Output of All Jobs

The following is an example of a SASGSUB statement used to view the output of all jobs on the grid:
SASGSUB -GRIDGETRESULTS ALL
The output from the command looks like this:
Output of All Jobs
Current Job Information
  Job 1917 (Pgm1) is Finished:  Submitted: 08Dec2008:10:53:33, Started: 08May2011:10:53:33 on Host d15003, Ended: 08May2011:10:53:33
    Moved job information to .\SASGSUB-2011-05-06_21.52.57.130_Pgm1

  Job 1918 (Pgm2) is Finished:  Submitted: 08May2011:10:53:33, Started: 08May2011:10:53:33 on Host d15003, Ended: 08May2011:10:53:33
    Moved job information to .\SASGSUB-2011-05-06_13.13.39.167_Pgm2

  Job 1919 (Pgm3) is Finished:  Submitted: 08May2011:10:53:34, Started: 08May2011:10:53:34 on Host d15003, Ended: 08May2011:10:53:34
    Moved job information to .\SASGSUB-2011-05-06_13.16.06.060_Pgm3

  Job information in directory U:\jobs\GridSub\GridWork\user1\SASGSUB-2011-05-06_13.17.17.327_testPgm is invalid.
    Moved job information to .\SASGSUB-2011-05-06_13.17.17.327_Pgm4

  Job 1925 (Pgm4) is Submitted: Submitted: 08May2011:10:53:34