SASGSUB Syntax: Batch Options

The following options are used when running SASGSUB in batch mode. Argument values that contain spaces must be contained in quotation marks.

Syntax

-GRIDWORK work-directory
<-GRIDWORKREM shared-file-system-path>
<-GRIDFILESIN grid-file-list >
<-GRIDSTAGECMD command>
<-GRIDSTAGEHOST hostname>
<-GRIDWAIT>
<-GRIDWAITTIMEOUT>timeout-value
<-GRIDWAITRESULTS>
<-GRIDWATCHOUTPUT>

Required Argument

-GRIDWORK work-directory

specifies the path for the shared directory that the job uses to store the program, output, and job information. On Windows, the path can contain spaces, but must be in quotation marks. On UNIX, the path cannot contain spaces. This option is stored in the configuration file that is automatically created by the SAS Deployment Wizard.

Optional Arguments

-GRIDWORKREM shared-file-system-path

when using a shared file system, specifies the pathname of the GRIDWORK directory in the shared file system relative to a grid node. Use this argument when the machine used to submit the job is on a different platform than the grid. The path cannot contain spaces.

When you are using file staging, this artument specifies the location of the GRIDWORK directory as passed to the GRIDSTAGECMD parameter. For example, Windows clients could have GRIDWORK set to \\myServer\myShare\SharedPath with the grid using LSRCP to stage files with GRIDSTAGEFILEHOST set to myServer.mydomain.com. If you set Windows to map C:\myShare on myServer to the Windows share \\myServer\myShare, you would set GRIDWORKREM to C:\myShare\SharedPath.

-GRIDFILESIN grid-file-list

specifies a comma-separated list of files that need to be moved to the grid work directory before the job starts running.

-GRIDSTAGECMD command

specifies the remote copy command used to stage files to the grid. Valid values are LSRCP, RCP, SCP, or SMBCLIENT. This option is used when the grid client machines and the grid machines do not share a common directory structure.

-GRIDSTAGEHOST hostname

specifies the name of the host that stores files that are staged into the grid. This option is used when a machine submits files to the grid and then shuts down.

-GRIDWAIT

specifies that the SAS Grid Manager Client Utility waits until the job has completed running, either successfully or with an error. If the job does not complete, it must be ended manually.

-GRIDWAITTIMEOUT timeout-value

specifies that the SAS Grid Manager Client Utility waits until either the job has completed running (either successfully or with an error) or timeout-value (in seconds) is reached. If you use this option with -GRIDWAIT or -GRIDWAITRESULTS, it enables you to specify how long to wait for results.

-GRIDWAITRESULTS

specifies that the SAS Grid Manager Client Utility waits until the job has completed running (either successfully or with an error). It then returns the results of the processing. If the job does not complete, it must be ended manually.

-GRIDWATCHOUTPUT

specifies that the output of what was submitted by the SASGSUB command is displayed on the user’s machine. If this argument is used with -GRIDSUBMITPGM, the SAS log and output are displayed. If the argument is used with -GRIDRUNCMD, the command’s standard output and standard error are displayed. While the output is being displayed, entering the command prompt does not affect the processing in the grid.