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

Examples

Example 1: Retrieving the Output of a Job

Example 2: Retrieving the Output of All Jobs

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