The GRDSVC_ENABLE function
is used to enable and disable a grid execution. Grid execution can
be enabled for a specified SAS session or for all SAS grid sessions.
If a grid environment is not configured or is unavailable, the job
is started as a symmetric multi-processor (SMP) process instead.
The GRDSVC_ENABLE function
does not resolve to a specific grid node, and it does not cause grid
execution. The server ID is mapped to a specific grid node. The server
session starts on the grid node when requested by subsequent SAS statements
(for example, when the SIGNON statement or the RSUBMIT statement is
executed).
In order to restrict
the use of specific grid nodes to be used by server sessions, the
name of the SAS Application Server and the workload resource value
are passed as required resources toPlatform Suite for SAS.
Note: An exception to this behavior
is when the SAS Application Server is disabled as a required resource
for the grid server. For details, see the restriction for the SASAPPSERVER=
option.
The grid can be partitioned
according to resource or security requirements. If grid nodes do not
have the required resources, then SAS requests fail. If grid nodes
have the required resources but are busy, SAS requests are queued
until grid resources become available.
For information, see Defining and Specifying Resources.
Some SAS applications
are suited for execution in a grid environment, but not in an SMP
environment. Such applications should contain a macro that checks
the return code from the GRDSVC_ENABLE function to ensure that a grid
node, rather than an SMP process, is used.
Here are the result codes:
GRDSVC_ENABLE Function Result Codes
|
|
|
Reports that one or
all server sessions were disabled from grid execution.
|
|
Reports that a grid
environment is unavailable due to one or more of these conditions:
-
A connection to the SAS Metadata
Server is unavailable.
-
A logical grid server has not been
defined in the SAS Metadata Repository.
-
The current user identity does
not have authorization to use the specified logical grid server.
-
SAS Grid Manager has not been licensed.
Instead, server sessions
execute on the multi-processor (SMP) computers as a SASCMD sign-on.
One of these commands, in order of precedence, is used to start the
server session:
-
the value of the SASCMD system
option
-
|
|
Reports that the specified
session was enabled.
|
|
Reports a syntax error
in the function call. An example is the omission of the server ID.
|
|
Reports a parsing error
in the function call. An example is an invalid option.
|
|
Reports an invalid server
ID in the function call.
|
|
Reports an out-of-memory
condition while the function is executing.
|
|
Reports that the function
cannot connect to the SAS Metadata Server or cannot access the grid
metadata information. This condition frequently occurs when the user
is not explicitly defined in metadata. By default, users without a
definition in metadata are assigned to the PUBLIC group, which is
not granted the ReadMetadata permission.
|