CANCEL PROCESS (Cancel an administrative process)

Use this command to cancel a background process started by an administrative command or by a process, such as storage pool migration.

The following commands generate background processes:
  • AUDIT LIBRARY
  • AUDIT LICENSES
  • AUDIT VOLUME
  • BACKUP DB
  • BACKUP NODE
  • BACKUP STGPOOL
  • CHECKIN LIBVOLUME
  • CHECKOUT LIBVOLUME
  • AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsCONVERT STGPOOL
  • DELETE FILESPACE
  • DELETE VOLUME
  • EXPIRE INVENTORY
  • EXPORT ADMIN
  • EXPORT NODE
  • EXPORT POLICY
  • EXPORT SERVER
  • GENERATE BACKUPSET
  • IMPORT ADMIN
  • IMPORT NODE
  • IMPORT POLICY
  • IMPORT SERVER
  • MIGRATE STGPOOL
  • MOVE DATA
  • MOVE DRMEDIA
  • MOVE MEDIA
  • PREPARE
  • PROTECT STGPOOL
  • RECLAIM STGPOOL
  • REPLICATE NODE
  • RESTORE NODE
  • RESTORE STGPOOL
  • RESTORE VOLUME
  • VARY
The following internal server operations generate background processes:
  • Inventory expiration
  • Migration
  • Reclamation

To cancel a process, you must have the process number, which you can obtain by issuing the QUERY PROCESS command.

Some processes, such as reclamation, generate mount requests to complete processing. If a process has a pending mount request, the process might not respond to a CANCEL PROCESS command until the mount request is answered or canceled by using the REPLY or CANCEL REQUEST command, or by timing out.

Issue the QUERY REQUEST command to list open requests, or query the activity log to determine whether a process has a pending mount request. A mount request indicates that a volume is needed for the current process, but the volume is not available in the library. The volume might not be available if the administrator issues the MOVE MEDIA or CHECKOUT LIBVOLUME command, or manually removes the volume from the library.

After you issue a CANCEL PROCESS command for an export operation, the process cannot be restarted. To stop a server-to-server export operation but allow it to be restarted later, issue the SUSPEND EXPORT command.

Privilege class

To issue this command, you must have system privilege.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-CANcel PRocess--process_number------------------------------><

Parameters

process_number (Required)
Specifies the number of the background process you want to cancel.

Example: Cancel a background process by using its process number

Cancel background process number 3.
cancel process 3

Related commands

Table 1. Commands related to CANCEL PROCESS
Command Description
CANCEL EXPORT Deletes a suspended export operation.
CANCEL REQUEST Cancels pending volume mount requests.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsCONVERT STGPOOL AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsConvert a storage pool to a directory-container storage pool.
AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsPROTECT STGPOOL AIX operating systemsLinux operating systemsOracle Solaris operating systemsWindows operating systemsProtects a directory-container storage pool.
QUERY EXPORT Displays the export operations that are currently running or suspended.
QUERY PROCESS Displays information about background processes.
REPLICATE NODE Replicates data in file spaces that belong to a client node.
REPLY Allows a request to continue processing.
RESTART EXPORT Restarts a suspended export operation.
SUSPEND EXPORT Suspends a running export operation.