Automation Services Application Program Interface › $RMCALL ACTION=PURGE

$RMCALL ACTION=PURGE

This API procedure function call deletes extraneous link records. When a linked region is decommissioned without first unlinking it, extraneous link records are left behind in other regions that were connected to it.

Syntax

This API procedure function call has the following format:

$RMCALL OPT=SERVICE
        SERVICE=ACTION
        ACTION=PURGE
        ACBNAME=acb-name

Operand

This API procedure function call has the following operand:

ACBNAME=acb-name

Specifies the ACB name that identifies the link record.

Return Variable

This API procedure function call returns the following variable:

&SYSMSG

Contains the returned message.

Return Codes

Return codes indicate the success or failure of processing. This API procedure function call returns the following return codes in the &RETCODE variable:

0

Indicates that processing was successful.

8

Indicates that processing failed.

16

Indicates that error occurred in the call syntax.

Example: Delete a Link Record

This example deletes the SOLV1 link record:

&CALL PROC=$RMCALL +
      PARMS=(OPT=SERVICE,+
             SERVICE=ACTION,+
             ACTION=PURGE,+
             ACBNAME=SOLV1)