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-RESOURCE-REQUESTS

&pagelevel(3)&pagelevel

Request information on secure queue and collector task

Component:

BS2000

Functional area:

Device management

Domain:

DEVICE

Privileges:

TSOS
OPERATING

Routing code:

E

Function

The SHOW-RESOURCE-REQUESTS command provides information about the secure queue (device queue) and the collector task.
The output either includes the attributes of all tasks currently waiting for a successive reservation of requested resources or is limited to information on the collector task. In addition, the parameters set by the system operator by means of the RESOURCE-COLLECTION command on the system’s selection of the collector task can also be requested.
The various output fields and their functions are described in section "Information services of device management: Meanings of the output values of SHOW commands".

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

Format

SHOW-RESOURCE-REQUESTS                                                                                                                

OUTPUT-INFORMATION = *JOB-NAME / *USER-IDENTIFICATION

,INFORMATION = *ALL-TASKS / *COLLECTOR-TASK / *COLLECT-PARAMETER

Operands

OUTPUT-INFORMATION =
Controls the contents of the output field NAME/ID.

OUTPUT-INFORMATION = *JOB-NAME
The job name is entered in the NAME/ID field.

OUTPUT-INFORMATION = *USER-IDENTIFICATION
The user ID is entered in the NAME/ID field.

INFORMATION =
Specifies the type of information required.

A header line and a values line are output.

INFORMATION = *ALL-TASKS
Outputs information about all tasks in the secure queue. 

Output format:
TSN      NAME/ID    TSK-TYPE    TSK-PRIO    ADMISSION-TIME  WAIT-TIME
RESOURCES REQUESTED

INFORMATION = *COLLECTOR-TASK
Outputs information about the collector task only.

Output format:
TSN      NAME/ID    TSK-TYPE    TSK-PRIO    ADMISSION-TIME  WAIT-TIME 
RESOURCES REQUESTED                 RESOURCES COLLECTED

INFORMATION = *COLLECT-PARAMETER
Outputs information about the collect parameters which were set with the RESOURCE-COLLECTION commands.

Output format:
RESOURCE-COLLECTION
TIME-WEIGHT

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No error

2

0

NKD0005

Warning: information incomplete


1

NKD0001

Syntax error in input; correct the command parameters to eliminate the error


32

CMD2009

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


64

NKD0002

No information available


64

NKD0006

Internal error during initialization of the command server or:
software error


64

NKD0007

Caller not privileged


64

NKD0040

Secure queue does not exist


64

NKD0041

Collector task does not exist


64

OPS0002

Interrupt (e.g. by K2 key) during S variable generation


130

OPS0001

SDF-P reporting space problems (possible response: FREE-VARIABLE and repeat command)

Output in S variables

The INFORMATION operand identifies the S variables which are to be created. The following specifications are possible for INFORMATION:

Notation used in command

Abbreviated form used in table

INFORMATION = *ALL-TASKS

INF=A-TASK

INFORMATION = *COLLECTOR-TASK

INF=COLL-TASK

INFORMATION = *COLLECT-PARAMETER

INF=COLL-PARA

Output information

Name of the S variable              

T

Contents                   

Condition     

TSN of the collector task

var(*LIST).COLL

S

''
<tsn>

INF=A-TASK/
COLL-TASK

Status of the collector task

var(*LIST).COLL-INFO


''
TASK WAITING FOR FILE LOCKS
TASK WAITING FOR MOUNT OR OPERATOR ACKNOWLEDGMENT
TASK WAITING FOR MAREN LOCK

INF=A-TASK/
COLL-TASK

Depot name of the device pool from which the device reserved for the collector task was taken

var(*LIST).COLL-TYPE(*LIST).LOCATION

S

''
<location>

INF=A-TASK/
COLL-TASK

Number of devices of the specified type reserved for the collector task

var(*LIST).COLL-TYPE(*LIST).NUM

I

<integer>

INF=A-TASK/
COLL-TASK

Device type reserved for the collector task

var(*LIST).COLL-TYPE(*LIST).TYPE

S

''
<dev-type>

INF=A-TASK/
COLL-TASK

Device mnemonic of the device reserved for the collector task

var(*LIST).COLL-UNIT(*LIST)

S

''
<mnemo-name>

INF=A-TASK/
COLL-TASK

Depot name of the volume recording the collector task data

var(*LIST).COLL-VOL(*LIST).LOCATION

S

''
<location>

INF=A-TASK/
COLL-TASK 

Volume reserved for the collector task

var(*LIST).COLL-VOL(*LIST).RESERVED

S

''
EXCL
OFFL 

INF=A-TASK/
COLL-TASK

Device type on which the volume recording the collector task data is set up

var(*LIST).COLL-VOL(*LIST).TYPE

S

''
<volume-type>

INF=A-TASK/
COLL-TASK

VSN of the volume selected using the device reservation mechanism to store the collector task data

var(*LIST).COLL-VOL(*LIST).VOL

S

''
<vsn>

INF=A-TASK/
COLL-TASK

Time when the task was admitted to the device queue

var(*LIST).REQ(*LIST).ADMIS-TIME

S

<admission-time>

INF=A-TASK/
COLL-TASK

Job name of the task waiting

var(*LIST).REQ(*LIST).NAME

S

''
<name>

INF=A-TASK/
COLL-TASK

Priority of the task on the device queue

var(*LIST).REQ(*LIST).TASK-PRIO

S

<task-priority>

INF=A-TASK/
COLL-TASK

Type of queued task

var(*LIST).REQ(*LIST).TASK-TYPE

S

''
BAT
DIA
RFA

INF=A-TASK/
COLL-TASK

TSN of the queued task

var(*LIST).REQ(*LIST).TSN

S

''
<tsn>

INF=A-TASK/
COLL-TASK

Depot name of the device pool from which the device reserved for the queued task was taken

var(*LIST).REQ(*LIST).TYPE(*LIST).LOCATION

S

''
<location>

INF=A-TASK/
COLL-TASK

Number of devices of the specified type reserved for the queued task

var(*LIST).REQ(*LIST).TYPE(*LIST).NUM

I

<integer>

INF=A-TASK/
COLL-TASK

Device type reserved for the queued task

var(*LIST).REQ(*LIST).TYPE(*LIST).TYPE

S

''
<dev-type>

INF=A-TASK/
COLL-TASK

Device mnemonic of the device reserved for the queued task

var(*LIST).REQ(*LIST).UNIT(*LIST)

S

''
<mnemo-name>

INF=A-TASK/
COLL-TASK

Depot name of the volume recording the data of the queued task

var(*LIST).REQ(*LIST).VOL(*LIST).LOCATION

S

''
<location>

INF=A-TASK/
COLL-TASK

Volume to be reserved for the task

var(*LIST).REQ(*LIST).VOL(*LIST).RESERVED

S

''
EXCL
OFFL

INF=A-TASK/
COLL-TASK 

Device type on which the volume recording the data of the queued task is set up

var(*LIST).REQ(*LIST).VOL(*LIST).TYPE

S

''
<device-type>

INF=A-TASK/
COLL-TASK

VSN of the volume selected using the device reservation mechanism to store the task data

var(*LIST).REQ(*LIST).VOL(*LIST).VOL

S

''
<vsn>

INF=A-TASK/
COLL-TASK

Length of time the task has been waiting on the queue

var(*LIST).REQ(*LIST).WAIT-TIME

S

<wait-time>

INF=A-TASK/
COLL-TASK

Collector task selection

var(*LIST).RES-COLL

S

*NO
*YES

INF=
COLL-PARA

Maximum time the task is to wait for the reservation request to be carried out

var(*LIST).TIME-WEIGHT

S

*NONE
<sec>

INF=
COLL-PARA

Powered by Atlassian Confluence and Scroll Viewport.