Force pubset export
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Routing code: | R |
Function
The FORCE-PUBSET-EXPORT command forces a pubset to be exported.
The specified pubset is exported without taking into account open files that cannot be restored until the next session. This command should therefore be used only in exceptional cases, since it cannot be guaranteed that the pubset involved can be imported again. This command cannot cancel the wait states for termination of the occupying tasks; it simply limits the wait time involved.
The command is logged with the message DMS0379 on the console.
The command is rejected if it was not preceded by an EXPORT-PUBSET command with the operand TERMINATE-JOBS=*YES.
Format
FORCE-PUBSET-EXPORT |
PUBSET = <cat-id 1..4> ,MONJV = *NONE / <filename 1..54 without-gen-vers> ,JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483639..2147483639> |
Operands
PUBSET = <cat-id 1..4>
Catalog ID of the pubset to be exported.
MONJV = *NONE / <filename 1..54 without-gen-vers>
Specifies whether a monitoring job variable is set.
This operand should only be specified if the JV software product is used.
Note
The job variable must already be cataloged, otherwise it is not set. However, EXPORT processing is continued even if the job variable is not set.
JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483639..2147483639>
Password of the monitoring job variable, if this variable is protected by a write password. The operand has the following special characteristics:
The password entered is not logged.
The input field is automatically blanked out in the guided dialog.
In unguided dialog and foreground procedures, the entry *SECRET or ^, SDF provides a blanked out input field for inputting the password .
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | 0 | DMS0355 | Same export already active |
1 | 0 | DMS0364 | Pubset already unavailable |
1 | CMD0202 | Syntax error | |
32 | DMS035C | Invalid operands | |
32 | DMS0363 | MRSCAT access error | |
64 | DMS035C | IMPORT-PUBSET required | |
64 | DMS0360 | No authorization for command | |
64 | DMS0366 | Export attempt for home pubset | |
64 | DMS036D | Invalid operand sequence | |
64 | DMS036E | FORCE attempt without TERMINATE | |
130 | DMS0351 | Other import/export task active | |
130 | DMS035C | Maximum number of tasks reached | |
130 | DMS0362 | Class 4 memory error |