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