ins_remove

ins_remove [-d destsys] [-R roottag] [-a appname] [-r restyp][-t tag] [-i id] [-v] [-I] [-N] [-G]

Removes resource instance(s) on system destsys from the configuration database. Associated dependencies and equivalencies will also be removed. If destsys is not specified, the current system is assumed.

Note: All resources that depend upon any of the selected resources directly or indirectly will also be removed before the selected resource is removed.

When a ins_setchkint resource instance is removed, and if a delete action was defined for the resource type of the instance being removed, the delete action is run before the instance is removed.

The command has the following options:

-R	The -R option is for removing entire sub-hierarchies and the resources that depend on them. The roottag string defines a list of instance tag names (separated by the ^A character) for which these resources and the resources below on the hierarchy will be recursively removed, until a resource is encountered for which a resource not being removed depends.
-a	If the -a option is specified, only resources from that application will be removed.
-r	If the -r option is specified, all resources of the specified resource type will be removed.
-t or -i	If the -t option or -i option is specified, the instance with the matching tag or id will be removed along with the resources that depend on them.
-v	If the -v option (verbose) is specified, the function prints a message to standard output including the tag names of all the removed resource instances.
-I	The -I option initializes the resource hierarchy so that ins_remove can work properly. This option should be used by the"highest-level" recursive call to ins_remove, but not necessarily in a lower-level recursive call such as inside a delete script. The -I option should NOT be used by a recursive call to ins_remove from inside a delete script.
-N	The -N option tells ins_remove NOT to reinitialize the resource hierarchy. The assumption when using this option is that a higher level call of ins_remove will perform the -I option. The -N option MUST be used inside a delete script, since a delete script is being called from a parent invocation of ins_remove and the -N option prevents hierarchy cycles from occurring.
-G	The -G option indicates that the predelete and postdelete scripts [see LCD] should not be performed as part of this call to ins_remove. This option is useful if you wish to perform multiple top-level calls to ins_remove and have the predelete and postdelete run manually [using lcdrecover-g delete of LCD] before and after (respectively) the calls to ins_remove. It would also be wise to use the -G option in the delete scripts since the highest-level ins_remove should perform the predelete and postdelete scripts.