SHOW-RESOURCE-ALLOCATION

Display resource allocation for job

Component:	BS2000
Functional area:	Device management Job processing
Domain:	DEVICE JOB
Privileges:	STD-PROCESSING TSOS HARDWARE-MAINTENANCE OPERATING SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT
Routing code:	E

Function

With the SHOW-RESOURCE-ALLOCATION command, users can display information on the resources tied up by the jobs running under their own user IDs. The information may be obtained for private volumes, devices for private volumes and files. The quantity of information to be output can be limited to those resources for which an operator action is still pending by means of the INFORMATION operand.

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

Privileged functions

Privileged users (OPERATING privilege) can request information for any job with SHOW-RESOURCE-ALLOCATION.

Format

SHOW-RESOURCE-ALLOCATION                                                                                                              

JOB-IDENTIFICATION = *TSN (...) / *MONJV(...) / <alphanum-name 1..4>
	*TSN(...)
		|	TSN = *OWN-TSN / <alphanum-name 1..4>
	*MONJV(...)
		|	MONJV = <filename 1..54 without-gen-vers>
,OUTPUT-INFORMATION = *JOB-NAME / *USER-IDENTIFICATION
,INFORMATION = *RESOURCES / *ACTIONS

Operands

JOB-IDENTIFICATION =
Type of job identification. A job may be identified by its task sequence number or its monitoring job variable.
Only privileged users (OPERATING privilege) are shown information for jobs running under other user IDs.

JOB-IDENTIFICATION = *TSN(...)
Identifies a job by its task sequence number (TSN).

TSN =
Specifies the TSN of the job.

TSN = *OWN-TSN
Provides information about the user’s own job.

TSN = <alphanum-name 1..4>
Provides information about the job with the specified TSN.

JOB-IDENTIFICATION = *MONJV(...)
Identifies a job by its monitoring job variable.

MONJV = <filename 1..54 without-gen-vers>
Name of the JV monitoring the desired job.

JOB-IDENTIFICATION = <alphanum-name 1..4>
Identifies a job by its task sequence number (TSN).

OUTPUT-INFORMATION = *JOB-NAME / *USER-IDENTIFICATION
Specifies whether the job name or the user ID is to be entered into the NAME/ID output field.

INFORMATION =
Specifies whether information about all resources is to be output.

INFORMATION = *RESOURCES
A record is produced for each resource occupied up by the specified job.

INFORMATION = *ACTIONS
A record is produced for each operator action still pending for a volume involved in the specified job. Operator actions may include:
mounting, activating/deactivating write protection, recovering INOP, premounting, remounting, etc. 

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	NKD0005	Incomplete information
2	0	NKD0011	The caller is not authorized to receive information about the specified TSN
2	0	NKD0018	MONJV was not found
2	0	NKD0019	The job variable found is not an active MONJV
	1	NKD0001	Syntax error in the input, correction of the command parameters recovers the error
	32	NKD0006	Software error in JINBAS parameter
	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
	64	NKD0014	No information available for the TSN
	64	OPS0002	Interrupt (e.g. by K2 key) during S variable generation
4	130	NKD0009	The disk monitor is temporarily not available; the information may be incomplete
8	130	NKD0009	The tape monitor is temporarily not available; the information may be incomplete
	130	NKD0026	JVS is not loaded
	130	OPS0001	SDF-P reporting space problems (possible response: FREE-VARIABLE and repeat command)

Output format

A header line and a values line are displayed. Two display formats are possible, depending on the specification in the INFORMATION operand.

The meaning of the output columns and possible values are described in section "Information services of device management: Meanings of the output values of SHOW commands". 

Output for INFORMATION=*RESOURCES

Header line:

MNEM     TYPE        VSN      VOL-A       TSN      NAME / ID       PHASE

Values:

mn       device      vsn      volume      tsn      see      volume
         allocation           allocation           IDENTIFICATION  phase
         type                 state                operand

In the case of DRV-DUAL allocations, the mnemonic device name of the second DRV disk is displayed instead of the device-allocation type.

In the case of type-related reservation, the storage location assigned to the device is displayed in a second values line.

LOCATION: <location-name>

Output for INFORMATION=*ACTIONS

The information is displayed in the same way as for INFORMATION=*RESOURCES except that values lines are output only for those resources for which an operator action is still pending.

Output in S variables

The INFORMATION operand identifies the S variables which are to be created. The possible values for INFORMATION are *RESOURCES (in the RES table) and *ACTIONS (ACT).

With regard to INFORMATION=*ACTIONS you should note that the S variables are given values only if there is an operator action outstanding. 

No S variables are generated if the command is rejected with the following message:

NKD0014 NO ALLOCATION EXISTS FOR THE TASK WITH TSN (&00). COMMAND NOT PROCESSED

Output information	Name of the S variable	T	Contents	Condition
Mount operation being performed for the volume by the volume monitoring system	var(*LIST).ACTION	S	'' *CANCEL *DISMOUNT INOP *MOUNT NO-ACTION *NO-DEV *POS *PREMOUNT *RECOVER REMOUNT SNATCHED *SVL-UPDATE *UNLOCK WP-MISSING	INF=RES/ ACT
Location name	var(*LIST).LOCATION	S	'' <location>	INF=RES/ ACT
Job name	var(*LIST).NAME-ID	S	'' <name 1..8>	INF=RES/ ACT
Tape and disk monitoring mode	var(*LIST).PHASE	S	'' *IN-USE *MOUNT *ONLINE *PREMOUNT	INF=RES/ ACT
TSN of the job	var(*LIST).TSN	S	'' <tsn>	INF=RES/ ACT
Volume device type	var(*LIST).TYPE	S	'' <dev-type> <volume-type> EXPLICIT	INF=RES/ ACT
Device unit mnemonic	var(*LIST).UNIT	S	'' <mnemo-name>	INF=RES/ ACT
Volume serial number	var(*LIST).VOL	S	'' <vsn>	INF=RES/ ACT
Private volume attribute	var(*LIST).VOL-ALLOC	S	'' *CANCEL *EXCL *FREE *SHARE	INF=RES/ ACT

Example

Information for multiple reservation

/show-file-attr sup=(*priv,*tape),alloc=*yes ———————————————————————————— (1)

%         :2OSG:$USERXY01.TAPE.FILE.1
%  ------------------------------- ALLOCATION   -------------------------------
%  SUPPORT    = PVT                                  BLK-COUNT =  5
%  EXTENTS     VOLUME     DEVICE-TYPE      EXTENTS     VOLUME     DEVICE-TYPE
%              M5658K       TAPE-C4
%00000003*:2OSG:$USERXY01.TEST.X.1
%  ------------------------------- ALLOCATION   -------------------------------
%  SUPPORT    = PVT         S-ALLOC    = 9           HIGH-US-PA = 0
%  EXTENTS     VOLUME     DEVICE-TYPE      EXTENTS     VOLUME     DEVICE-TYPE
%      1       WORK01       D3435
%  NUM-OF-EXT = 1
%:2OSG: PRDISC:      1 FILE  RES=        3  FRE= 3  REL=        0 PAGES
%:2OSG: TAPE  :      1 FILE

/sec-res tape=((vol=m5658k,type=tape-c4),(vol=m5660k,type=tape-c4)),
         file=((test.x.1),(tape.file.1)),wait=(300) ——————————————————————(2)
/show-res-alloc ——————————————————————————————————————————————————————————(3)

%  MNEM  TYPE     VSN     VOL-A  TSN  NAME/ID    PHASE    ACTION
%  EK   TAPE-C4  M5658K    EXCL  19U2 ULF      PREMOUNT  NO ACTION
%       LOCATION : ROBOTER2
%  EL   TAPE-C4  M5660K    EXCL  15LZ ULF      PREMOUNT  NO ACTION
%       LOCATION : ROBOTER2
%  4342 D3435    WORK01   SHARE  19U2 ULF        IN-USE  NO ACTION

(1)	Information about all files for the user ID on private disks and tapes (or magnetic tape cartridges).
(2)	Reservation of resources: Two magnetic tape cartridges (volume serial numbers M5658K and M5660K, both volume type TAPE-C4) and the files TAPE-FILE.1 and TEST.X.1 are to be reserved.
(3)	The SHOW-RESOURCE-ALLOCATION command gives information about the reservation made: The magnetic tape cartridge M5658K was reserved only once, although it was specified both explicitly (TAPE operand) and implicitly (FILE operand, file TAPE-FILE.1 saved on M5658K, see also item 1). Tape files are always reserved exclusively (see VOL-A output field). The magnetic tape cartridge M5660K was reserved explicitly. The private disk WORK01 was reserved for the file TEST.X.1 (see also item 1).