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 an 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.


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.
-l 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.


Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Post your comment on this topic.

Post Comment