set-batch Command

For Windows: Not Supported

The set-batch BASIC program displays or changes the current sensitivity value for the interactive/batch trigger.

Syntax

set-batch {port.number{,trigger}} {(options}

set-batch {*{,trigger}} {(options}

Parameter(s)

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.

  • trigger=-2 is the most stringent setting (disables process every other disk access)

  • trigger=-128 is the minimum penalty (disables process every 128 disk reads).

options

b

Displays batch processes only.

i

Displays interactive processes only.

q

Quiet mode suppresses all terminal output when changing values.

NOTE

When using a negative trigger value, set-batch displays the setting as a number larger than 127. For example, set-batch 0,-100 displays 156 (256-100). The value of 1 is not a legal trigger value.

The display includes:

Example(s)

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

See Also

Performance Monitoring

PIB

Port Number

set-batchdly Command

user-coldstart Macro