Delete option

You can use the delete option with the InfoSphere® Metadata Asset Manager action command. Use the delete option to delete import areas.

Purpose

The Delete option allows you to delete a particular asset type that you want to remove from the metadata repository. The only type that is currently supported is area.

If you have the Common Metadata Administrator role, you can delete import areas created by all users. If you have the Common Metadata Importer role, you can delete only import areas that you created. If an import areas has an import that is shared to the repository, then Common Metadata Importers and Common Metadata Administrators can only delete the import areas if the setting Allow users to delete import areas in which imports were shared to the repository is selected on the Administration tab in InfoSphere Metadata Asset Manager.

Syntax

imam [--help] [--silent] --action delete --type asset_type --name asset_name
[-–username username] [--password password][--authfile authfile_path]  
[--server server_name] [--port port_number]

Parameters

The Delete option uses the following parameters.

Table 1. Delete command parameters
Parameter name (short name)	Description
--action	Required Type `Delete`.
--type (-t)	Required Provides the type of asset that you want to delete. `area` Deletes an import area.
--name (-n)	Required Name of the import area to delete. If the name contains blank spaces, you must put quotation marks around the blank spaces. If the name contains quotation marks, you must enter a backslash character (\) before each of the quotation marks.
-–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.

Delete example

The following command deletes the import area area51.

imam --username isadmin --password isadmin –-action delete –-type area –-name area51