The set-batch BASIC program displays or changes the current sensitivity value for the interactive/batch trigger.
For Windows: Not Supported
set-batch {port.number{,trigger}} {(options}
set-batch {*{,trigger}} {(options}
| port.number | Integer number between 0 and the maximum number of ports. | |
| * | Sets and displays the data for all ports on the system in place of a port number. | |
| trigger | A sensitivity value which defines how long it takes for a process to become a batch process. If the trigger value is not specified, the current setting displays. The trigger value can be either one of these: | |
| 0 | Forces the process to stay in interactive mode, giving access to all of the memory. | |
| [1,127] | Sets the process to become batch after the trigger disk reads without any keyboard input. After that point, the process is prevented from using excessive amounts of memory and is disabled for a short period, set by set-batchdly, if it attempts to do a disk read when an interactive process is accessing the disk. This tends to limit the impact of batch jobs reading a lot of data (for example, an AQL statement) on the overall system performance. | |
| [-128,-2] | Sets the process to become batch after the ABS (trigger) disk
reads, as above. The difference is that, in addition to having the
same limits as in the previous case, the process is disabled for a
short period every ABS (trigger) disk reads, even if there is no concurrent
disk access by an interactive process. This setting is useful for
processes which modify a large amount of data. Note: The performance
penalty on these processes can be severe, depending on the setting.
This option should be used only on background tasks.
|
|
| options | b | Displays batch processes only. |
| i | Displays interactive processes only. | |
| q | Quiet mode suppresses all terminal output when changing values. | |
The display includes:
Total number of reads
Total number of reads completed as a batch process since the last boot, or since the last time the counters were cleared
set-batch pib trig status reads tot.read tot.btch %batch 05 mar 2002 page 1 29 27 inter 11 744 0 0.00
In the example above, port 29 is interactive, has a batch trigger of 127, has read 11 times since the last keyboard input, has read 744 times since the last boot time (or since the counters were cleared), and has done 0 reads while defined as a batch process.
The report includes the following headings:
| pib | D3 port number (PID) |
| trig | Trigger value |
| status | Current status of the process, is either interactive or batch. |
| reads | Number of disk reads since the last keyboard input. |
| tot.read | Total number of disk reads since the last boot, or since the counters were cleared (logon). |
| tot.btch | Number of disk reads done while it was a batch process. |
| %batch | Percentage of disk reads done while it was a batch process, as compared to the total number of disk reads. |
Sets the process 3 to forced interactive mode. Whatever the number of disk reads the process does, it remains interactive (highest priority).
set-batch 3,0
Sets the batch trigger counter of process 5 to 100. After 100 disk reads without any keyboard input (for a select, for instance), the process becomes batch, and is a lower priority than the interactive processes.
set-batch 5,100
Sets the batch trigger counter of process 10 to -50. After 50 disk reads without any keyboard input (for a select, for instance), the process becomes batch, and is disabled for a short time every 50 disk reads.
set-batch 10,-50