CA-GSS/ISERV Commands › CA-GSS/ISERVE Operator Commands › PURGE

PURGE

Use the PURGE command to eliminate a dormant IMOD task.

Important! Before you purge a dormant IMOD, be sure that it will not be reclaimed by the requestor.

Syntax

Use this format for the PURGE command:

PURGE taskid

Parameters

The PURGE command takes this parameter:

taskid

The hexadecimal IMOD ID, as shown on the DISPLAY ACTIVE screen.

Example

----------------------- CA‑GSS/ISERVE Control Panel ---------   ROW 1 TO 8 OF 8
==> purge 10ab                                                          => PAGE
Target node: *                ssid: *    Host node: B1MAIN            ssid ISRV
===============================================================================
IMOD 10AB Scheduled for PURGE

Other Responses

IMOD taskid Not Found

The specified IMOD task could not be found. Issue a DISPLAY ACTIVE command and verify the correct ID.

IMOD taskid Not valid for PURGE

The specified IMOD task is not in a dormant state. Only dormant IMOD tasks are eligible for PURGE.

IMOD taskid Not purged: value

An unexpected result was returned by purge processing. The value returned will be useful to CA Technologies Support.

Usage

Some IMODs that are executed at the request of cross-memory users (notably CA Jobtrac Job Management) are assigned a recoverable attribute. This means that if a requestor terminates while an IMOD is being executed on its behalf, the IMOD cannot fully complete until the requestor is restarted and claims the IMOD's results.

An IMOD that has finished processing and is waiting to be reclaimed displays as DORMANT on the DISPLAY ACTIVE screen.