CA-GSS/ISERV Commands › GSS Extended Functions › PURGE

PURGE

This command eliminates a dormant IMOD task.

Important! Before you purge a dormant IMOD, be sure that the requestor does not reclaim it.

Syntax

PURGE taskid

Parameters

taskid

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 the dormant IMOD tasks are eligible for PURGE.

IMOD taskid Not purged: value

Purge processing returned an unexpected result. The returned value is 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 results of the IMOD.

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