$RMDBAPI SERVICE=DELETE

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:

  • When you delete a system image, you also delete the resources it owns.
  • For file transfer rule sets and rules in a CA NetMaster FTM region, the value of SYSNAME is FILTER.

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)


Copyright © 2010 CA. All rights reserved.