CANCEL-PUBSET-IMPORT

Cancel import of pubset

Component:	BS2000
Functional area :	Pubset and MRSCAT management
Domain:	MULTI-CATALOG-AND-PUBSET-MGMT
Privileges:	TSOS OPERATING
Routing code:	R

Function

The CANCEL-PUBSET-IMPORT command causes an active import job to be canceled. In particular in a shared pubset network, this function can be used to cancel an import where the master is being changed so that the pubset becomes accessible again from at least one other system.

When this command is called, the import job loses its current disk accessing rights and it is prevented from building up new disk accessing rights.
However, the import job can only terminate if it encounters an error due to the loss of rights or if it finds the cancel request that is stored in the MRS catalog. If the import job does not terminate, it is not possible to import the pubset in the current session. The data consistency of the pubset is, however, ensured when it is imported on another system.

Format

CANCEL-PUBSET-IMPORT                                                                                                                         

PUBSET = <cat-id 1..4>

Operands

PUBSET = <cat-id 1..4>
Catalog ID of the pubset to be imported.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
	1	CMD0202	Syntax error
	32	DMS13D1	CANCEL-PUBSET-IMPORT was canceled because an error occurred when accessing the volume catalog.
	64	DMS13D1	Error during CANCEL-PUBSET-IMPORT; the insert describes the cause of the error, e.g.: MRSCAT does not exist no pubset import a CANCEL-PUBSET-IMPORT is already being processed the pubset has already been imported the pubset import has already reached its final stage