workbench extension mapping delete command

You can delete extension mapping documents from the metadata repository by using the istool workbench extension mapping delete command.

Purpose

Use this command to delete an extension mapping document or to schedule a deletion. When you delete an extension mapping document from the metadata repository, you do not delete the source and target assets that are in the mappings.

Prerequisites

You must have the Information Governance Catalog Information Asset Administrator role.

IBM® InfoSphere® Information Governance Catalog must be installed on the same server as IBM WebSphere® Application Server.

The version of istool command framework must be the same version as InfoSphere Information Governance Catalog.

Run the command from the client tier, or from the engine tier if InfoSphere Information Governance Catalog was installed there.

The preferred way to run this command is in the istool command-line window. If you run this command in your operating system command-line window or in scripts, you must add istool before the command name.

Command syntax

Optional parameters and optional values in the syntax are enclosed in brackets, [ ].

workbench extension mapping delete 
authentication parameters
-pattern matching_text_pattern
-output log_file_name
[generic parameters]

Parameters

authentication parameters: Required. All asset interchange commands use authentication parameters to connect to a specific installation of InfoSphere Information Server.
generic parameters: The generic parameters are available to all asset interchange commands. Use the generic parameters to request help on command syntax, to specify silent or verbose operation, and to use a script to run commands.
-pattern | -pt matching_text_pattern: Specifies the text pattern to match in the name of the extension mapping document.; Include the file extension in the text pattern. Use the percent sign (%) as a wildcard character. The pattern matching is not case-sensitive. If the extension mapping document name has an embedded space, enclose the name in double quotation marks (").
-output | -o log_file_name: Specifies the name of the log file that contains the output, including errors, of the command that was run. Include the directory path in log_file_name.; If the directory does not exist, the command fails.; The log file is created if it does not exist. If the log file does exists, the output is appended to the file. If the command is automated to run at different times, the log file displays the ongoing output of each command that was run.

Output

A return value of 0 indicates successful completion. Any other value indicates failure. The reason for the failure is displayed in a screen message.

For more information, see the system log file in either of the following directories:

For Microsoft Windows operating system environment: C:\Documents and Settings\username\istool_workspace\.metadata\.log; where username is the name of the operating system account of the user who runs this command.
For UNIX or Linux® operating system environment: user_home/username/istool_workspace/.metadata/.log; where user_home is the root directory of all user accounts, and username is the name of the operating system account of the user who runs this command.

Example

You can delete multiple extension mapping documents by using the wildcard character (%). This sample deletes extension mapping documents that are named Northwest_billing.csv and Northeast_billing.csv from the metadata repository and creates the log file C:\IBM\InformationServer\logs\Northwest_billing_delete_mappings.log:

workbench extension mapping delete 
-pt North%_billing.csv 
-o C:\IBM\InformationServer\logs\Northwest_billing_delete_mappings.log
-dom mysys
-u myid -p mypassword

The output of the istool command might be:

Deleting mapping documents matching 'North%_billing.csv'
Found 2 matching mapping documents
Deleted Northwest_billing.csv
Deleted Northeast_billing.csv
Completed deletion of mapping documents