Designating a metadata interchange server option

You can use the create_mis option with the InfoSphere® Metadata Asset Manager action command. Use the create_mis option to designate a computer as a metadata interchange server.

Purpose

Metadata interchange servers are computers that are used by InfoSphere Metadata Asset Manager to run imports with bridges and connectors. Most metadata interchange servers are designated automatically during installation of InfoSphere Information Server, but for some client installations you can designate the metadata interchange server on the command line after installation. You designate a computer where one or both of the following components are installed:

Metadata interchange agent and bridges, installed on the client tier.
Connectors, installed on the engine tier with InfoSphere DataStage® and QualityStage® or InfoSphere Information Analyzer

You must have the Common Metadata Administrator role to designate a metadata interchange server.

After you designate a metadata interchange server, you must enable it on the Administration tab of InfoSphere Metadata Asset Manager before you can use the bridges or connectors to import metadata.

Syntax

imam [--help] [--silent] --action create_mis 
--mis_name metadata_interchange_server_name
 --mis_description metadata_interchange_server_description
 --mis_host metadata_interchange_server_host
 --mis_port metadata_interchange_server_port 
[-–username username] [--password password] [--authfile authfile_path]
[--server server_name] [--port port_number]

Parameters

The create_mis option uses the following parameters.

Table 1. Create_mis command parameters
Parameter name (short name)	Description
-–action	Required Type `create_mis`.
--mis_name (-mn)	Required The name of the metadata interchange server to be designated.
--mis_description (-md)	Required The description of the metadata interchange server.
--mis_host (-mh)	Required The host computer of the metadata interchange server.
--mis_port (-mp)	Required The port of the host computer.
-–authfile (-af)	Optional Path to a file that contains the encrypted or non-encrypted credentials for logging on to InfoSphere Information Server. If you use the --authfile parameter, you do not need to specify --username or --password on the command line. If you specify both the --authfile option and the explicit user name and password options, the explicit options take precedence over what is specified in the file. For more information see Encrypt command.
--username (-u)	Optional User name that is required for logging into InfoSphere Information Server. The user must have the role of Common Metadata Administrator or Common Metadata Importer. You can use the --authfile parameter instead of specifying the --username and --password parameters. You can enter a username without entering a password. If you do this you will get prompted for a password.
--password (-w)	Optional Password for the specified user name to log into InfoSphere Information Server. You can use the --authfile parameter instead of specifying the --username and --password parameters.
--server (-s)	Optional Name of the services tier computer. If you specify a server, then you must specify a port.
--port (-p)	Optional Port number to use on the services tier computer. If your InfoSphere Information Server suite installation is configured for HTTP, then the default port used is 9080. If you do not specify a port, and your InfoSphere Information Server suite installation is configured for HTTPS, then the default port used is 9443. If you want to use the HTTPS configuration, then you must change the `registered-servers.xml` file. If you specify a port, then you must specify a server.
--silent (-sil)	Optional. Suppresses prompts for credentials and SSL certificates. Use this option when you run scheduled or unattended sessions. When a prompt is suppressed, the action fails. To ensure that actions succeed, specify credentials on the command line and run the UpdateSignerCerts tool if necessary, as described in the topic: Running UpdateSignerCerts after enabling SSL or changing SSL settings.
--help (-h)	Optional Prints the list of actions and parameters. The help command is automatically issued when you issue a command that contains a syntax error, such as a typographical error, an improperly cased option or argument, or when the command is missing a mandatory parameter.

Create_mis example

The following command designates the metadata interchange server named is-computer2 on port 19443 of the computer is-xmeta-sys4.

imam --username isadmin --password isadmin –-action create_mis --mis_name 
is-computer2 -md server1 --mis_host is-xmeta-sys4 -mp 19443