Open / Close Queues {BATCH-3}


This option can be used to open and close individual queues. Upon commit, a program will start the queue processors for the specified queue. When a queue is closed, the queue processing programs will terminate, after finishing the requestswith which they were busy. 

A UNIX shell script (g31uni) can be executed to open all queues, e.g. sh g31uni. This would typically be scheduled to execute once the normal daily backup process has terminated successfully. The user, however, has full control as to when the process is to be started.   In order to change the status of a queue, the queue must be queried, the status changed and <COMMIT>ted.


This option consists of two Blocks. 

Fields in the option:

Block 1:  Block Description

Field Type
&
Length		 Description
Queue Code A2 The user can only query the queue code to be opened or closed.
Queue Description A40 When the query is executed the description will be displayed.
Open/Close The user must click on the button and commit to open or close the queue.  If the button says 'Open the Queue', it means that it is closed.  If the button says 'Close the Queue', it means that it is open.
Number of Queue Processes Allowed N5 This is the value, as entered in {BATCH-1}, for the specific queue.
Maximum No. of Immediate Batch Jobs Allowed in the System N2 This is the value, as entered in {BATCH-1}, for the system.
The No. of Seconds the Queue Must Wait Before Checking for More Jobs N5 This is the value, as entered in {BATCH-1}, for the specific queue.
Must the Queue Terminate and Close if No More Jobs This is the value, as entered in {BATCH-1}, for the specific queue.



Example:

Example of batch-3b1



Block 2:  Active Queue Processes

Field Type
&
Length		 Description
 Every time a queue processor is started, a record is written to this table. This Block can be used to query which queue processors are currently active. When a queue processor terminates, the record is deleted automatically. It could, however, be necessary to delete records here if the computer went down while queue processors were running. The records can then be deleted and re-started by entering this option and exiting, or using g31uni.

Example:

Example of batch-3b2




Processing
Rules		  
  No special processing rules.


See Also:



History of Changes

Date System Version By Whom Job Description
15-Dec-2006 v01.0.0.0 Amanda Nell t134787 New manual format.
10-Mar-2008 v01.0.0.0 Vaughn Dumas t134787 System owner proof read.
12-Sep-2008 v01.0.0.0 Charlene van der Schyff t152060 Edit language obtained from proof read language Juliet Gillies.