tcl.set-batch Verb: Access/TCL

tcl.set-batch

Command tcl.set-batch Verb: Access/TCL
Applicable release versions: AP
Category TCL (746)
Description displays or changes the current sensitivity value for the interactive/batch trigger.

"port.number" is the Pick pib number, which must be an integer number between 0 and the maximum number of ports. (see "maxusers").

"*" in place of a port.number sets/displays the data for all ports on the system.

"trigger" is a sensitivity value which defines how long it takes for a process to become a "batch process". If "trigger" is not specified, the current setting is displayed. The trigger can be one of the following:

0 Force the process to stay in "interactive" mode, giving access to all of the memory.

[1,127] Set the process to become batch after "trigger" disk reads without any keyboard input. After that point, the process will be prevented from using excessive amounts of memory and will be 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 (eg an access statement) on the overall system performance.

[-128,-2] Set the process to become batch after abs("trigger") disk reads, as above. The difference is that, in addition to having the same limits as in the previous case, the process will also be 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. "trigger=-2" is the most stringent setting (disable process every other disk access); "trigger=-128" is the least penalty (disable process every 128 disk reads).

The display includes the total number of reads, and the total number of reads done as a batch process since the last boot or since the last time the counters were cleared.
Syntax set-batch {port.number{,trigger}} {(options}
set-batch {*{,trigger}} {(options}
Options b Displays batch processes only.

i Displays interactive processes only.

p Directs output to system printer, via the Spooler.

q Quiet mode. Suppresses all terminal output when changing values.
Example
set-batch
PIB TRIG STATUS READS TOT.READ TOT.BTCH %BATCH  05 Mar 1992 PAGE 1

29  127 INTER     11      744        0   0.00

In this example, 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" (zero) reads while defined as a "batch" process.

Legend:

"PIB" is the Pick port.number (Process ID).

"TRIG" is the trigger value.

"STATUS" is the current status of the process, either: INTERactive, 
or BATCH.

"READS" is the number of disk reads since the last keyboard input.

"TOT.READ" is the total number of disk reads since the last boot, or 
since the counters were cleared (logon).

"TOT.BTCH" is the number of disk reads done while it was a batch 
process.

"%BATCH" is the percentage of disk reads done while it was a batch 
process, as compared to the total number of disk reads.

set-batch 3,0

Sets the process 3 to forced interactive mode. Whatever the number of disk 
reads the process does, it will remain 'interactive' (highest 
priority).

set-batch 5,100

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 will 
become 'batch', and have a lower priority than interactive processes.

set-batch 10,-50

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 will 
become 'batch', and will be disabled for a short time every 50 disk 
reads.
Purpose
Related pib
tcl.set-batchdly
port.number
tcl.user-coldstart
perf