METACONNECT= System Option

Identifies one named profile from the metadata user connection profiles for connecting to the metadata server.
Valid in: configuration file, SAS invocation, OPTIONS statement, SAS System Options window
Category: Communications: Metadata
PROC OPTIONS GROUP= META
Default: NULL

Syntax

METACONNECT="named-connection"

Syntax Description

"named-connection"
is a named connection that is contained in the metadata user profiles. The maximum length is 256 characters. Quotation marks are required.

Details

This system option is one of a category of system options that define a connection to the metadata server. Instead of specifying individual connection options for the metadata server, you can use the METACONNECT= and METAPROFILE options.
METAPROFILE must be specified at SAS invocation or in a configuration file. It specifies the pathname of an XML document that contains connection profiles. METACONNECT= can be submitted at any time. It specifies one named connection profile in the XML document. A connection profile contains metadata server connection properties, such as the name of the host computer on which the metadata server is invoked, the TCP port, and the user ID and password of the requesting user.
You can create connection profiles with the Metadata Server Connections dialog box. Open the dialog box by executing the SAS windowing environment command METACON. The dialog box enables you to save (export) one or more connection profiles to a permanent XML document. To learn more about the METACON command, see the online Help in the SAS windowing environment.
The connection profiles are similar to the ones that are used by SAS Management Console. However, SAS Management Console stores its connection profiles in a different way.
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.

Example: Use in a Configuration File

Here is an example from a configuration file, followed by an explanation:
-METAPROFILE "C:\userprofile.xml"
-METACONNECT "B"

Explanation

  1. The METAPROFILE system option specifies the file C:\userprofile.xml. The file contains three named connection profiles: A, B, and C. Each named connection profile contains properties for connecting to the metadata server.
  2. The METACONNECT system option specifies the named connection profile B.
  3. The metadata server connection properties that are specified in the named connection profile B are loaded from the metadata user B and are used as the properties for connecting to the metadata server.
For information about the metadata server, see SAS Intelligence Platform: System Administration Guide.