Syntax
$RMDBAPI |
SERVICE=DELETE
[{NAME=resource-name[MANNAME=manager-name]}|
{RSNAME=ft-ruleset-name[RMNAME=ft-rule-name]}]
CLASS=cc
SYSNAME=system-name
VERSION=version
|
Use
Use this call to delete a ResourceView definition from the knowledge base.
Operands
|
Operand |
Description |
|---|---|
|
SERVICE=DELETE |
Indicates that a definition is to be deleted from the knowledge base. |
|
NAME=resource-name |
Specifies the name of the resource definition to be deleted. You cannot delete a resource that owns dependent resources (for example, a CICS started task that owns CICS resources). This operand is not required if you are deleting a system image, a file transfer rule set, or a file transfer rule. |
|
MANNAME=manager-name (FTM) |
Specifies the name of the manager that owns the resource, resource-name (for example, the definition of the file transfer manager that owns the monitor resource whose definition is to be deleted). |
|
RSNAME=ft-ruleset-name (FTM) |
Specifies the name of the file transfer rule set to be deleted or the name of the file transfer rule set from which the specified rule, ft-rule-name, is to be deleted. You cannot delete an active rule set. Note: When you delete a file transfer rule set, you also delete the rules it owns. |
|
RMNAME=ft-rule-name (FTM) |
Specifies the name of the file transfer rule definition to be deleted. This operand is not required if you are deleting a file transfer rule set. |
|
CLASS=cc |
Specifies the two-digit identifier of the ResourceView definition class to which the definition belongs. |
|
SYSNAME=system-name |
Specifies the name of the system image to be deleted or the name of the system image from which the specified resource is to be deleted. Notes:
|
|
VERSION=version |
Specifies the version of the system image. For file transfer rule sets and rules in a CA NetMaster FTM region, the values of VERSION are 0006 and 0005 respectively. |
Returned Variable
|
Variable |
Description |
|---|---|
|
&SYSMSG |
Contains the message returned by $RMDBAPI. |
Return Codes
The following return codes indicate the success or failure of the deletion processing:
|
&RETCODE |
Meaning |
|---|---|
|
0 |
Processing was successful. |
|
8 |
Processing failed. |
|
16 |
Error occurred in call syntax. |
Example
The following example deletes the RES001 printer definition (class 11) from the EASTPRD1 version 1 system image:
&CALL PROC=$RMDBAPI + PARMS=(SERVICE=DELETE,+ NAME=RES001,+ CLASS=11,+ SYSNAME=EASTPRD1,+ VERSION=0001)