Query / Cancel Request {BATCH-20}


This option allows the user to view all his/her own reports.


The option consists of three Panel Boxes:

  

Refer to the Batch Operational Manual for additional information.

  


Fields in the option:


Panel Box 1:  Batch Request Description

May not enter a description if the request is dependent on any other request.

When the description of a master request is cleared, the description of all the dependants will also be cleared.


Field Type
&
Length		 Description
Batch Request number  N5 The request number obtained from Panel Box 1.   
Menu
 A30 The name of the function
Menu option
 A30 The number of the function
User Code
 A30 The login name used by the person on the ITS systems. This name should preferably be unique, but can be the same for a group of people, e.g. temporary staff. Not updateable.
Immediate/Deferred A30
 Has no accumulation period, the batch runs immediately / has an accumulation period where the user chooses the date the batch can run.
Queue
 A30 Lining up the batch
Requested
 DD-MON-YYYY The date that this parameter set was requested. This is a display field only. It is updated by the system with the first, and all subsequent re-uses, of this request.
Date Started
 DD-MON-YYYY The date that this parameter set started. This is a display field only. It is updated by the system with the first, and all subsequent re-uses, of this request.
Date Finished
 DD-MON-YYYY The date that this parameter set was last used. This is a display field only. It is updated by the system with the first, and all subsequent re-uses, of this request.
Cancellation Date
 DD-MON-YYYY The date that this parameter set is cancelled. This is a display field only. It is updated by the system with the first, and all subsequent re-uses, of this request.
Result
 A30 Output of the batch
Program A30 Name of the program. This is a display field only.
Program Extension A3 Program extension e.g. rpt pc sql inc. This is a display field only.




Panel Box 2:  Print / View / Cancel Request

Upon entering the screen, all requests are displayed. The user may query a specific criteria for selection.  

The success / fail indication is as follows:

   - 0 indicates a successful completion
   - 1 indicates an abnormal termination.


Field Type
&
Length		 Description
Print/View A1 This will allow the user to print and/or view the output of a request.    
Depend on
 N5
 Request number on which this request is dependant on 0= not depenant



Panel Box 3 Tab 1 : Batch Request Answers

Batch Request Answers

The user may only query on this block


Field Type
&
Length		 Description
Sequence Number
N3 The sequence of the prompt: it is entered when prompt answers are stored in the database.
Prompt Number N5 The request number will be brought from the previous Panel Box.
Prompt Text A60 Entered by the system in the same way as the Sequence Number above.
Report Variable
 A30
 Variable from batch-2
Prompt Answer
 A30
 Entered by the system in the same way as the Sequence Number above.


Example:

batch 20 image

 

Tab 2 :  Batch Request Objects

The user may only query on this block

Field Type
&
Length		 Description
Request Number N5 The request number will be brought from the Panel Box 1.
Object Sequence N10 The sequence of the object in this batch request.
Output Location A1 The location of this object.  A 'D' indicates that the object is in the DSR: an 'F' indicates it is on the file system.
DSR Sequence Number N10 The Data Storage and Retrieval System sequence number.  This is only used if the Object Location is a 'D'.
File Name A256 The URL of the file on the file system.  This is only used if the Object Location is an 'F'.


Example:

batch 20 image 2

 

Tab 3 : Save Batch Request

Field Type
&
Length		 Description
Request Description A30
 A suitable description may be entered here. It is advisable that a set of parameters be built for requests that are executed often using the same or similar parameter sets.
Date last Used
 DD-MON-YYYY
 The date that this parameter set was last used. This  is a display field only. It is updated by the system with the first , and all subsequent re-uses, of this request.
Program A30
 Name of the program. This is a display field only.
Extension A3
 Program extension e.g rpt pc sql inc. This is a display field only .
User Code
A30
 The login name used by the person on the ITS systems. This name should preferably be unique, but can be the same for a group of people, e.g. temporary staff. Not updateable.

Example:

batch 20 image 3

 



Processing
Rules		  
  No special processing rules.


See Also:



History of Changes

Date System Version By Whom Job Description
24-Aug-2018
 v04.1.0.0
 Tshidiso Dennis Koetle
 T231174
 New Online Manual
01-Dec-2021
 v04.1.0.1
 Precious Matshaya
 T252698
 Grammar correction. Manual stated, "This option allows the user to view the requests of ALL users, not just his/her own." Corrected to "This option allows user to view all his/her own reports."