METAAUTORESOURCES System Option

Identifies the metadata resources that are assigned when SAS starts.
Valid in: configuration file, SAS invocation
Category: Communications: Metadata
PROC OPTIONS GROUP= META

Syntax

METAAUTORESOURCES server-object

Syntax Description

server-object
is the name or URI of a LogicalServer, ServerComponent, or ServerContext metadata object in a repository on the SAS Metadata Server. The maximum length is 32,000 characters. If you specify either single or double quotation marks, they are not saved as part of the value.
METAAUTORESOURCES accepts the following name and URI formats:
name
specifies the metadata name of the object. An example is the following:
 -metaautoresources 'SASApp'
This format is supported for a ServerContext object only. For LogicalServer and ServerComponent objects, use one of the following URI formats:
OMSOBJ:identifier.identifier
specifies the metadata identifier of the object. An example is the following:
-metaautoresources "omsobj:A5HMMB7P.AV000005"
OMSOBJ:type/ID
specifies the metadata type name and metadata identifier of the object. An example is the following:
-metaautoresources "omsobj:ServerComponent/A5HMMB7P.AV000005"
OMSOBJ:type?@attribute='value'
specifies the metadata type name, followed by a search string, which is in the form of an attribute='value' pair. An example is the following:
-metaautoresources "OMSOBJ:ServerComponent?@Name='My Server'"

Details

METAAUTORESOURCES identifies metadata resources that are assigned when you invoke SAS. In this release, the option is used to assign libraries. In future releases, additional resources might be supported.
In SAS Management Console, when you define a library, you can assign a server. METAAUTORESOURCES specifies the server object, and assigns the associated libraries at start-up.
In SAS 9.2, libraries that had the Library is pre-assigned check box selected in their library definitions were pre-assigned using the native library engine defined for that library in metadata, unless the library was already pre-assigned by an AUTOEXEC file.
In SAS 9.3, the SAS Management Console Data Library Manager enables you to specify pre-assignment in the library definition. Specifying the PreAssignmentType property affects METAAUTORESOURCES as follows, unless the library was already pre-assigned by an AUTOEXEC file:
  • Libraries marked as pre-assigned by external configuration (for example, the AUTOEXEC file) are ignored by METAAUTORESOURCES.
  • Libraries marked as pre-assigned by the native library engine are assigned using the native library engine defined for that library in metadata.
  • Libraries marked as pre-assigned by the metadata LIBNAME engine are assigned by the metadata LIBNAME engine (MLE). MLE is a proxy library engine that enforces access controls placed on the library and its tables and columns, as defined in metadata.
Library definitions that were created with the SAS 9.2 Data Library Manager, and that had the Library is pre-assigned check box selected, continue to behave as if the native library engine option was specified.
The PreAssignmentType property is not recognized by SAS 9.2 sessions that connect to a SAS 9.3 Metadata Server that was configured with the SAS 9.3 Data Library Manager.
If the SAS Metadata Server is not available, METAAUTORESOURCES is ignored.
METAAUTORESOURCES is set automatically for any SAS Workspace Server or SAS Stored Process Server started by the object spawner. The option can be set manually for any other batch, interactive, or server SAS session using a command-line or configuration file option.
For information about pre-assigning SAS libraries, see the SAS Intelligence Platform: Data Administration Guide.
Operating Environment Information: In a configuration file or at SAS invocation, the syntax for SAS system options is specific to your operating environment. For more information, see the SAS documentation for your operating environment.