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-OCCUPATION

&pagelevel(3)&pagelevel

Display tasks which are occupying pubsets

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Routing code:

@

Function

The SHOW-PUBSET-OCCUPATION command provides system support with information on the tasks which are occupying pubsets. The command supplies information both for single-feature (SF) pubsets and for system-managed (SM) pubsets.

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

The information on pubset occupancy is also contained in the output of the SHOW-PUBSET-PARAMETERS command.
Restrictions

In the case of SF pubsets in a shared pubset network, only the information displayed on the pubset master is valid. The information displayed on a pubset slave becomes valid if that slave is made the pubset master.

Format

SHOW-PUBSET-OCCUPATION

PUBSET = *ALL / <cat-id 1..4>

,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *ACCESSIBLE / *LOCAL-ACCESSIBLE /

*REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING /

*SINGLE-FEATURE / *SYSTEM-MANAGED / *DEFINED-XCS-CONFIGURATED /

*XCS-CONFIGURATED

,HOST = *LOCAL / *ALL / <alphanum-name 1..8>

Operands

PUBSET = *ALL / <cat-id 1..4>
Specifies the pubsets for which the occupying jobs are to be displayed.

PUBSET = *ALL
The occupying jobs of all pubsets are displayed. The SELECT-PUBSET operand can be used to restrict the selection to pubsets with specific attributes.

PUBSET = <cat-id 1..4>
Identifies the pubset for which the occupying jobs are to be displayed.

SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *ACCESSIBLE / *LOCAL-ACCESSIBLE / 
*REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING / *SINGLE-FEATURE / 
*SYSTEM-MANAGED / *DEFINED-XCS-CONFIGURATED / *XCS-CONFIGURATED
Specifies whether information is required only for specific pubsets. This restriction is useful if *ALL is used in the PUBSET operand to select all pubsets.

SELECT-PUBSET = *ALL
The occupying jobs of all the pubsets specified in the PUBSET operand are displayed.

SELECT-PUBSET = *EXCLUSIVE
The occupying jobs of all pubsets imported exclusively are displayed.

SELECT-PUBSET = *SHARED
The occupying jobs of all pubsets imported as shared are displayed.

SELECT-PUBSET = *ACCESSIBLE
The occupying jobs of all pubsets which can be accessed are displayed.

SELECT-PUBSET = *LOCAL-ACCESSIBLE
The occupying jobs of all locally accessible, i.e. imported, pubsets are displayed.

SELECT-PUBSET = *REMOTE-ACCESSIBLE
The occupying jobs of all pubsets which have not been imported locally but whose file catalog can be accessed over an MSCF connection are displayed.

SELECT-PUBSET = *HSMS-SUPPORTED
The occupying jobs of all pubsets which are supported by the HSMS subsystem are displayed.

SELECT-PUBSET = *SPEEDCAT
The occupying jobs of all SF pubsets whose file catalog can be accessed in the local system via SPEEDCAT are displayed.

SELECT-PUBSET = *PAGING
The occupying jobs of all pubsets with paging areas which are used locally are displayed.

SELECT-PUBSET = *SINGLE-FEATURE
The occupying jobs of all SF pubsets are displayed.

SELECT-PUBSET = *SYSTEM-MANAGED
The occupying jobs of all SM pubsets are displayed.

SELECT-PUBSET = *DEFINED-XCS-CONFIGURATED
The occupying jobs of all pubsets which are defined as XCS pubsets in the MRS catalog are displayed.

SELECT-PUBSET = *XCS-CONFIGURATED
The occupying jobs of all XCS pubsets are displayed.

HOST = *LOCAL / *ALL / <alphanum-name 1..8>
Identifies the host system of the jobs which are to be listed.

HOST = *LOCAL
Only the occupying jobs on the local host are displayed.

HOST = *ALL
If the local host is the pubset master, the occupying jobs on all the hosts in the shared pubset network are displayed. If it is not, only the occupying jobs on the local host are displayed (as for HOST=*LOCAL).

HOST = <alphanum-name 1..8>
The occupying jobs on the specified host are displayed. If the specified BCAM name is not that of the local host, the information is output only if the local host is the pubset master of the shared pubset and the specified BCAM name is that of a pubset sharer.

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No errors


32

CMD0221

Internal system error


32

CMD2009

Error during output in S variables (e.g. subsystem not available)


64

CMD0216

Privilege error


64

DMS1381

Volume set conflict


64

DMS138B

Pubset does not exist or not with specified attribute


64

DMS138E

Volume set does not exist


64

DMS1396

Invalid host name


128

DMS1386

Not enough class 4/5 memory

Output format

The output starts with a header line consisting of the command name. The output information per pubset breaks down into two groups of output blocks:

  1. output block for pubset-global summary information

  2. output blocks for pubset-global detailed information

Pubset-global summary information

The output block for pubset-global summary information consists of a row of values which at the same time acts as a header line introducing the information output for a pubset. The summary information has the following layout:

PUBSET <catid>: <type>, CTL-SET = (<ctlid>, <type>), <status>, <hsms> 

Key to the output values

<catid>

Pubset ID

<type>

Pubset type; possible values: SINGLE-FEATURE or SYSTEM-MANAGED

<ctlid>

Control volume set ID (for SM pubsets)

<type>

Device type of control volume set’s system disk (for SM pubsets)

<status>

Pubset accessibility; possible values:

  • ACC: Pubset is locally accessible.

  • INACC: Pubset is not locally accessible.

<hsms>

HSMS subsystem support (for SM pubsets); possible values:

  • HSMS-SUP: Pubset is supported by HSMS.

  • NO-HSMS-SUP: Pubset is not supported by HSMS.

Pubset-global detailed information

The occupying jobs are displayed for the pubsets.

The output block is introduced by the following header line:

--- REFERENCE              ---------------------------------------

The following row of values shows the number of jobs occupying the pubset:

NUMBER OF OCCUPYING TASKS        | <number>

If there is at least one job occupying the pubset, detailed information about the occupying jobs is shown next. The output is arranged according to the host on which the occupying jobs reside. The information about the occupying jobs of each host is preceded by one of the following header lines:

  • Header line for occupying jobs on the local host:

    OCCUPATIONS BY LOCAL TASKS

  • Header line for occupying jobs on unknown hosts:

    OCCUPATIONS FROM HOST: (UNKNOWN)

  • Header line for occupying jobs on a remote host:

    OCCUPATIONS FROM HOST: <bcam name>

The header line is followed by one or more lines indicating all the occupying jobs on the given host, showing the task sequence number (TSN) and the user ID (if there is one):

<tsn> <userid>    <tsn> <userid>    <tsn> <userid>    <tsn> <userid> 

Output in S variables

Output information

Name of the S variable          

T

Contents                  

Condition

Device type of the system disk of the control volume set;
*NO for SF pubsets

var(*LIST).CONTR-DEV-TYPE

S

*NO
<c-string 1..8>


ID of the control volume set;
*NO for SF pubsets

var(*LIST).CONTR-VOLSET

S

*NO
FALSE=none


HSMS support for the pubset
*NO=pubset is not supported
*STD=for single-feature pubsets
*YES=pubset is supported

var(*LIST).HSMS-SUP

S

*NO
*STD
*YES


Number of occupying tasks

var(*LIST).OCCUP.NUM-OF-TASK

I

<integer>


Host name (only if OCCUP.NUM-OF-TASK > 0)

var(*LIST).OCCUP.HOST(*LIST).NAME

S

*LOC
*UNKNOWN
<alphan.-name 1..8>


TSN of an occupying task (only if OCCUP.NUM-OF-TASK > 0)

var(*LIST).OCCUP.HOST(*LIST).TASK(*LIST).TSN

S

<tsn>


User ID of an occupying task (only if OCCUP.NUM-OF-TASK > 0)

var(*LIST).OCCUP.HOST(*LIST).TASK(*LIST).USER-ID

S

*NONE
<user-id>


Pubset ID

var(*LIST).PUBSET-ID

S

FALSE=none


Pubset type

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE


Availability of the pubset
*ACCESSIBLE=locally accessible
*INACCESSIBLE=not locally accessible

var(*LIST).STA

S

*ACCESSIBLE
*INACCESSIBLE


Example

/show-pubset-occupation pubset=x

%----------------------------------------------------------------------------
%COMMAND: SHOW-PUBSET-OCCUPATION
%- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PUBSET X   : SINGLE-FEATURE, ACC
---- REFERENCE            -------------------------------------------------
 NUMBER OF OCCUPYING TASKS            | 1
---- DETAILS OF OCCUPATION  -------------------------------------------------
 OCCUPATIONS BY LOCAL TASKS
  RP02
-----------------------------------------------------------------------------
Powered by Atlassian Confluence and Scroll Viewport.