Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-PUBSET-IMPORT-EXPORT

&pagelevel(3)&pagelevel

Show pubset processing status

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
OPERATING

Routing code:

@

Function

The SHOW-PUBSET-IMPORT-EXPORT command informs the systems support staff of the processing status of all pubsets that are currently being imported or exported. If one or more pubsets are named explicitly, the processing status of the volume sets belonging to them may also be output for SM pubsets.

The command supports structured output in S variables (see "Output in S variables").

Format

SHOW-PUBSET-IMPORT-EXPORT                                                                                                           

PUBSET = *ALL / list-poss(256): <cat-id 1..4>(...)


<cat-id 1..4>(...)



|


VOLUME-SET = *NONE / *ALL / <cat-id 1..4>

Operands

PUBSET = *ALL / list-poss(256): <cat-id 1..4>(...)
Specifies the pubsets for which the processing status is to be displayed.

PUBSET = *ALL
The processing status of all pubsets that are currently being imported or exported is displayed (i.e. the status of all import/export jobs that are currently underway).

PUBSET = list-poss(256): <cat-id 1..4>(...)
The ID of the pubset whose processing status is to be displayed. As many as 256 pubsets can be specified in a list.
In the case of SM pubsets, the processing status of the volume sets belonging to them may also be requested. Note that in that case the processing status of the control volume set is not displayed explicitly and is represented by the processing state of the SM pubset.

VOLUME-SET = *NONE / *ALL / list-poss(255): <cat-id 1..4>
This operand is ignored in the case of SF pubsets.
Specifies whether the processing statuses of the volume sets belonging to an SM pubset are to be displayed as well.

VOLUME-SET = *NONE
On information is issued for the volume sets.

VOLUME-SET = *ALL
The processing status is displayed for all volume sets belonging to an SM pubset.

VOLUME-SET = list-poss(255): <cat-id 1..4>
The processing status of the specified volume set is displayed for SM pubsets. As many as 255 volume sets can be specified in a list.

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No error


1

CMD0202

Syntax error


32

CMD0221

Internal error


32

DMS13D0

Internal processing error


64

CMD0216

User is not authorized


64

DMS13D0

MRSCAT not found, wrong MRSCAT type

Output format

The output begins with a heading line followed by value lines. One value line is output for each pubset. If information concerning the volume sets was also requested, the value line of the pubset is followed by an additional value line for each volume set belonging to the pubset. No separate value line is output for the control volume set since it is represented by the value line of the SM pubset.

  1. Heading line:

    ID TYPE PROCESS STATE PROGRESS TSN

  2. Value line for a pubset:

    <catid> <pubset-type> <process-type> <process-state> <progress> <tsn>

  3. Value line for a volume set:

    <catid> VOLSET <process-type> <process-state> <progress> <tsn>

    This information is only issues if VOLUME-SET= *ALL / <cat-id> was specified for an SM pubset. 

Meaning of the output columns

Output column

Meaning and possible values

ID

ID of the pubset or volume set

TYPE

Pubset types: SF-PUBSET, SM-PUBSET, VOLSET

PROCESS

Pubset or volume set processing type:

  • IMPORTING: Pubset/volume set being imported

  • EXPORTING: Pubset/volume set being exported

  • IMPORTED: Pubset/volume set already imported

  • EXPORTED: Pubset/volume set already exported

STATE

Details on the processing status if the pubset/volume set is currently being imported or exported.

PROGRESS

Progress of processing

  • *RUNNING: the current processing status was just reached

  • IN WAIT: nnnn sec: the current processing status was reached nnnn seconds ago

TSN

TSN of the import/export task of the pubset or volume set

Table 142: Output columns of the SHOW-PUBSET-IMPORT-EXPORT command

Output in S variables

The VOLUME-SET operand determines whether additional information about the volume sets associated with an SM pubset are output.

Notation used in command

Abbreviated form used in table

SM-Pubset, VOLUME-SET=*ALL / <cat-id> and number of volume sets (NUM-OF-VOLSETS) is nonzero

1

Output information

Name of the S variable  

T

Contents                

Condition

Number of volume sets

var(*LIST).PUBSET.NUM-OF-VOLSETS

I

<integer 0..255>


Pubset type

var(*LIST).PUBSET.TYPE

S

SF-PUBSET
SM-PUBSET


Pubset processing mode

var(*LIST).PUBSET.PROCESS

S

IMPORTING
IMPORTED
EXPORTING
EXPORTED


Progress of current processing

var(*LIST).PUBSET.PROGRESS

S

<c-string 20..20>
*RUNNING
IN WAIT: nnn SEC


Pubset ID

var(*LIST).PUBSET.PUBSET

S

<cat-id>


Current processing state

var(*LIST).PUBSET.STATE

S

<c-string 20..20>


Current TSN of pubset import/export task

var(*LIST).PUBSET.TSN

S

<c-string 4..4>


Processing mode of volume set

var(*LIST).PUBSET.VOLSET(*LIST).PROCESS

S

IMPORTING
EXPORTING
IMPORTED
EXPORTED

1

Progress of current processing

var(*LIST).PUBSET.VOLSET(*LIST).PROGRESS

S

<c-string 18..18>
*RUNNING
IN WAIT: nnn SEC

1

Current processing state

var(*LIST).PUBSET.VOLSET(*LIST).STATE

S

<c-string 20..20>

1

Volume set ID

var(*LIST).PUBSET.VOLSET(*LIST).VOLSET

S

<cat-id>

1

Current TSN of volume-set import/export task

var(*LIST).PUBSET.VOLSET(*LIST).TSN

S

<c-string 4..4>

1

Powered by Atlassian Confluence and Scroll Viewport.