rmai - Remove application instances

Purpose

Remove AI (application instance) objects from the TSLM database. In case there are existing references to an object TSLM prevents its deletion in order to maintain a consistent database. The remove operation is transactional which means that either all specified AI objects are removed or no objects if the removal encounters an error.

Parameters

application_instance_name [...]

Specifies the application instance to be removed. Multiple application names must be separated with a blank character between each name.

-app application_name

Specifies the application name for which all application instances should be removed. Specifies a regular expression that describes the name of the application instance that should be removed.

CAUTION: Avoid accidental deletion of an application instance.

-regex pattern

Specifies a regular expression that describes the name of the application instance that should be removed.

Note: Quoting is required to ensure correct shell processing.

-help, -?

Display help page

-match c

Define IEEE 1244 compliant match clause

-order c

Define IEEE 1244 compliant order clause

-number c

Define IEEE 1244 compliant number clause

Results

Beyond the general error code, the following command-specific error codes are returned:

• EMM1610E -- if an application instance could not be deleted because of existing references
• EMM1604E – in case the application instance(s) specified by name, regex or match option could not be found

Limitations

Deletion Semantics: AI objects cannot be deleted until all corresponding SESSION and TASK objects have been deleted.

User notes

Names of application instances must be unique for every application. That means that there might be more application instances with the same name but with different application name attributes. In order to prevent deletion of more than one instance the -app option should be specified.

Related commands

• lsai - List application instances