DELETE control statement

The DELETE control statement deletes data from an RTCS registry. The data to be deleted is identified by a SELECT control statement.

The DELETE control statement has the following forms:

Related topic

Control-statements

DELETE NODE

The DELETE NODE control statement deletes a specific subnode from the node identified by a previous SELECT TREE=/ path / control statement.

DELETE NODE=/subnode/ [OKIFNOTEMPTY]

If OKIFNOTEMPTY is not specified and the specified subnode is empty (does not contain any values or subnodes), the subnode is deleted. Otherwise, an error message is issued and RMU processing is terminated.

If OKIFNOTEMPTY is specified, the specified subnode (and any contained values or subnodes) is deleted even if there are values or subnodes defined there.

Important

Another way to delete a subnode and everything defined in it (values and subnodes) is to use the DELETE TREE FORCE control statement.

The following figure illustrates the JCL for RMU DELETE NODE processing.

RMU DELETE NODE processing JCL

//jobname  JOB (acct,room ),programmer,NOTIFY=&SYSUID
//<stepName> EXEC PGM=OSZEXEC8,REGION=0M,
//            PARM='P=OSZRGMNT'
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
SET REGISTRY.DSNAME = prefix.BMC.product.REGISTRY
SELECT TREE = //config/
DELETE NODE = /sysb/ OKIFNOTEMPTY         
//*

DELETE VALUE

The DELETE VALUE control statement deletes the specified value from the node identified by a previous SELECT TREE=/ path / control statement.

DELETE VALUE=/valueName/

The following figure illustrates the JCL for RMU DELETE VALUE processing.

RMU DELETE VALUE processing JCL

//jobname  JOB (acct,room ),programmer,NOTIFY=&SYSUID
//<stepName> EXEC PGM=OSZEXEC8,REGION=0M,
//            PARM='P=OSZRGMNT'
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
SET REGISTRY.DSNAME = prefix.BMC.product.REGISTRY
SELECT TREE = //active/data/              
DELETE VALUE = /SystemName/  
SELECT TREE  = //installed/BBM/VERSIONS.SYSA.SYSTEMA.BBCS//,  
               /PLEXMGR.CALPERIOD.CALDEF.CALPER/     
DELETE VALUE = /V_TYPE/    
//*

DELETE TREE FORCE

The DELETE TREE FORCE control statement deletes the node identified by a previous SELECT TREE=/ path / control statement, including all values defined at that node, and all subnodes and values defined within it.

The entire registry subtree identified by SELECT TREE is deleted.

Important

Typically, deleting an entire subtree in a registry is performed only as part of a repair and recovery operation at the request of BMC Customer Support. DELETE TREE FORCE might also be used to erase the entire contents of an RTCS registry in preparation for a RESTORE operation.

The following figure illustrates the JCL for RMU DELETE TREE FORCE processing.

RMU DELETE TREE FORCE processing JCL

//jobname  JOB (acct,room ),programmer,NOTIFY=&SYSUID
//<stepName> EXEC PGM=OSZEXEC8,REGION=0M,
//            PARM='P=OSZRGMNT'
//SYSPRINT DD SYSOUT=*
//SYSIN DD *
SET REGISTRY.DSNAME = prefix.BMC.product.REGISTRY
SELECT TREE = //config/sysb/
DELETE TREE FORCE          
//*




 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*