SAS Institute. The Power to Know

Base SAS(R) 9.2 Guide to Information Maps

Previous Page | Next Page

The INFOMAPS Procedure

PROC INFOMAPS Statement


Connects to the specified metadata server.
PROC INFOMAPS
<DOMAIN="authentication-domain">
<MAPPATH="location">
<METAPASS="password">
<METAPORT=port-number>
<METASERVER="address">
<METAUSER="user-ID">;

Options

DOMAIN="authentication-domain"

specifies an authentication domain to associate the user ID and password with. If you do not specify an authentication domain, then the user ID and password are associated with the DefaultAuth authentication domain. For information about authentication, see "Understanding Authentication in the SAS Intelligence Platform" in SAS Intelligence Platform: Security Administration Guide.

An authentication domain is a set of computing resources that use the same authentication process. An individual uses the same user ID and password for all of the resources in a particular authentication domain. The authentication domain is the metadata mechanism for associating logins with the servers on which they can be used. For example, when an application needs to locate credentials that enable a particular user to access a particular server, the application searches the metadata for logins that are associated with the authentication domain in which the target server is registered.

MAPPATH="location"

specifies the location within the SAS folders tree for the information map that you want to create, open, or delete. After the connection is made, the location is stored so that you do not need to specify it again on subsequent statements such as NEW INFOMAP, UPDATE INFOMAP, DELETE INFOMAP, SAVE, or EXPORT. However, if you do specify a location on a subsequent statement in the same PROC INFOMAPS step, then that location overrides the stored location.

Alias: PATH=
METAPASS="password"

specifies the password that corresponds to the user ID that connects to the metadata server.

You can use the METAPASS= system option to specify a default password for connecting to the metadata server for the SAS session. See the METAPASS= system option in the SAS Language Reference: Dictionary.

If your metadata server supports single sign-on, you can omit the METAPASS= and METAUSER= options and connect through a trusted peer connection or through Integrated Windows Authentication. For more information, see the SAS Intelligence Platform: Security Administration Guide.

Alias: PASSWORD= | PW=
Examples:
metapass="My Password"
metapass="MyPassword"
METAPORT=port-number

specifies the TCP port that the metadata server is listening to for connections.

If this option is not specified, the value is obtained from the METAPORT= system option. See the METAPORT= system option in the SAS Language Reference: Dictionary.

Alias: PORT=
Example: metaport=8561
METASERVER="address"

specifies the network IP (Internet Protocol) address of the computer that hosts the metadata server.

If this option is not specified, the value is obtained from the METASERVER= system option. See the METASERVER= system option in the SAS Language Reference: Dictionary.

Alias: SERVER= | HOST=
Example: metaserver="myip.us.mycompany.com"
METAUSER="user-ID"

specifies the user ID to connect to the metadata server. The user ID is not case sensitive.

You can use the METAUSER= system option to specify a default user ID for connecting to the metadata server for the SAS session. See the METAUSER= system option in the SAS Language Reference: Dictionary.

If your metadata server supports single sign-on, you can omit the METAUSER= and METAPASS= options and connect through a trusted peer connection or through Integrated Windows Authentication. For more information, see the SAS Intelligence Platform: Security Administration Guide.

Alias: USER= | USERID= | ID=
Example: metauser="myUserID"
Restriction: In the metadata server, you must have at least one login definition that contains a user ID that corresponds to the user ID that you specify here. For information about login definitions, see the User Manager Help for logins in the SAS Management Console.
Restriction: If your metadata server runs in the Windows environment, then you must fully qualify the user ID by specifying the domain or machine name that you specified when your login object was created in the SAS Metadata Repository. For example: metauser="Windows-domain-name\user-ID" .

Example

proc infomaps
   domain="myDomain"
   metauser="myUserID"
   metapass="myPassword"
   metaserver="myip.us.mycompany.com"
   metaport=8561;

Previous Page | Next Page | Top of Page