Request Management
This function is used to list and track the requests sent to the batch server, either by means of the request submission or by placing the request files in a dedicated directory.
Prerequisite
Refer to documentation Implementation
Screen management
Entry screen
Presentation
The request management function is used to display, in a single screen, the list of requests submitted to the server (released or not released) and their statuses.
According to the request status, the line appears in black (request finished without error), in red (request interrupted or terminated with errors), in green (request being executed) or in blue (request pending execution).
Close
Fields
The following fields are present on this tab :
Table Queries
| This single number identifies the request. It is assigned starting from an initial number defined in the parameters of the batch server. |
| It defines the folder in which the task execution has been requested. |
| Code identifying the launched task |
| It defines the code of the user who launched the task. |
| It defines the planned start date and time for the task |
|
|
| It defines the launch priority (at system level) of the process launched to execute the task. |
| If this field is set to Yes, the task can only be executed in the single user mode for the folder. |
| This status flag of the requests in process can take the values defined by the local menu 21 : Standby : the request has not yet been started
|
| It defines the end date and time for the execution of the task. This information is entered only if the task has already been launched and it is completed. |
|
|
| This field, that is defined by the local menu 20, specifies whether the task launched is an adonix process or a script (shellscript or command file) executed on the process server. |
| It defines the code of the process or the script, when the launched task does not correspond to a basic software function. |
| Each request is executed by an adonix process given on the application server. This field identifies the process number (usually called process id, or pid). |
| When this field is not null, it defines a timeout duration, that is to say, a time limit above which the task is automatically stopped if it is still running. |
| It defines the service number used for connection to adonix. When it is not specified, the current service number is used. |
| When the task belongs to a launched group of tasks, the grid mentions a number common to all the tasks of the group, and a sequence number in the group (these fields are empty if the request does not belong to a group). |
|
|
| When the batch task is launched at a specified frequency every N minutes, this column defines the value of N. |
| When a task has been subscribed to be executed with a frequency, a single line appears to notify its execution, but each time that it is relaunched, 1 is added to this column. Thus, it is possible to know how many times it has been executed. |
| When the task has been launched via a job file (see the corresponding technical appendix), the name of the file that has been submitted (without the extension) can be found here. |
Server
| This flag, whose values are defined by the local menu 8, is used to know the status of the batch server, and it can take the following values :
|
| It identifies the process number of the batch server itself (usually called process id or pid). |
| Ir displays the number of the current page, along with the total number of pages. |
Close
Functions accessed by right click on the grid
Parameter Entry
it is used to modify the request parameters (whether pending launch or already finished).
Interruption
it is used to request that the batch server interrupts the execution of a task.
Modification
it is used to modify the date and time of launch and the execution priority for a request that has not already been launched.
Log
it is used to display the trace file of the execution of a request already executed (it is found in the TRA directory of the SERVX3 directory, itself located in the Runtime directory, and its name is RQT followed by the request number).
Release
it is used to create a new task, with the same launch parameters as the previous task. By default, the execution is requested for the same day, in 5 minutes (which leaves enough time to modify the date/time of launch thanks to the Modification action). The task to be re-launched must have been launched in the current folder. It could have been launched by another user, but its re-launch will be performed on the current user's account, after verifying the user's access rights.
Relaunch group
Restart recur. task
Fermer
Specific Buttons
The following fields are present on the window opened through this button : Block number 1
Block number 2
Close it allows the submission of a new request. |
it is used to refresh the request list and their corresponding statuses. This function is also available via the shortcut key |
it triggers the purging of the table lines. The requests completed on a given date (entered in a window which opens then) are deleted from the task list. |
Error messages
In addition to the generic error messages, the following messages can appear during the entry :
The request is no longer waiting to be executed
Cancellation impossible.
This message is displayed when an attempt is made to delete a request where the execution has already taken place.
No request in progress
The request to execute or executed request table is empty (this may occur after a purge, or if the batch server has not been started).
Full grid
There are more lines than the request manager can display in the table : only the first lines are visible.
This task should be activated from the XXXX folder.
An attempt has been made to launch a task in a folder other than the current folder.
At the bottom of the screen, the server status appears (Abled/Disabled), as well as the number of the corresponding process, if it is abled. The fact that the server is not abled does not stop the submission of requests (however, they are not executed immediately even if the trigger time has arrived).