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.
- AUDIT CONTAINER
- AUDIT LIBRARY
- AUDIT LICENSES
- AUDIT VOLUME
- BACKUP DB
- BACKUP NODE
- BACKUP STGPOOL
- CHECKIN LIBVOLUME
- CHECKOUT LIBVOLUME
- CONVERT 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
- 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
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
Command | Description |
---|---|
CANCEL EXPORT | Deletes a suspended export operation. |
CANCEL REQUEST | Cancels pending volume mount requests. |
CONVERT STGPOOL | Convert a storage pool to a directory-container storage pool. |
PROTECT STGPOOL | Protects 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. |