MODIFY-RESOURCE-COLLECTION

Control secure queue and collector task selection

Component:	BS2000
Functional area:	Device management
Domain:	DEVICE
Privileges:	OPERATING
Routing code:	J

Function

The MODIFY-RESOURCE-COLLECTION command can be used by systems support to control the secure queue and selection of the collector task.

Format

MODIFY-RESOURCE-COLLECTION                                                                                                         

ACTION = *ADD-COLLECTOR / *REMOVE-COLLECTOR / *SET-COLLECTOR

,TSN = <alphanum-name 1..4>

Operands

ACTION =
Determines whether the specified job is taken into account when selecting the collector task.

ACTION = *ADD-COLLECTOR
The specified job is taken into account when selecting the collector task within the system. This state corresponds to the presetting at the time the job enters the secure queue. This command has no effect unless a MODIFY-RESOURCE-COLLECTION command specifying ACTION=*REMOVE-COLLECTOR has been issued for the same job.

ACTION = *REMOVE-COLLECTOR
The specified job is not taken into account when the collector task is selected by the system. If the specified job is the collector, it loses this collector attribute. However, this does not prevent the job in question from reserving resources; it merely cannot collect them one after the other, and instead must wait until all its requests can be met at once.

ACTION = *SET-COLLECTOR
The specified job becomes the collector task. If it is already the collector task, the command has no effect. If another job is the collector, it loses its collector attribute. The setting of the collector task has priority over its selection by the system.

TSN = <alphanum-name 1..4>
Specifies the task sequence number of the job for which the MOD-RES command has been issued. 

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	No error
	64	NKS0023	Command not executed Task not in secure queue
	64	NKS0024	Command not executed with ACTION=*SET-COLL Establishment not confirmed by task
	64	NKS0026	Command not executed with ACTION=*REM-COLL Task currently being established as collector
	64	NKS0027	Command not executed with ACTION=*SET-COLL Collector currently being set up
	64	NKS0028	Command not executed with ACTION=*SET-COLL Task is already collector
	64	NKS0029	Command not executed with ACTION=*SET-COLL Task no longer in secure queue
	64	NKS0041	Control task for secure queue not active with TSN=NKS. Command not executed.
	64	NKS0043	Internal error in NKRORQH module

Notes

• If a job loses its collector attribute, all existing reservations are canceled. The job waits in the secure queue until all reservation requests can be met at once.

• The collector attributes can be modified for each job in the secure queue as often as required. These attributes (collector, noncollector, to be taken into account at selection, not to be taken into account) are, however, only valid as long as the job is contained in the secure queue. When a job leaves (or re-enters) the secure queue the default attributes apply (noncollector, to be taken into account at selection).

• Mount requests are only issued at the operator terminal (console) when all the resources required for the job have been reserved. The mounting of volumes takes place in a subsidiary phase of secure processing. The MODIFY-RESOURCE-COLLECTION command has, therefore, no effect on jobs waiting for a reply to a MOUNT message.

• The MODIFY-RESOURCE-COLLECTION command with the REMOVE or SET operand is rejected if at the time of command input a job is turned into a collector task.