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:
|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.
|If the -a option is specified, only resources from that application will be removed.
|If the -r option is specified, all resources of the specified resource type will be removed.
| -t or
|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.
|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.
|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.
|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.
|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.