Filter
Top Products
Chapter 7 553
Command Definitions S-SO
SETCOUNTER
SETCOUNTER
Sets the next value of a specified resource counter, and optionally enables automatic
rollback when a specified limit is reached. Duplicate values are avoided.
Syntax
SETCOUNTER[ COUNTER=] [ INSP | OUTSP | JOBNUM | SESSNUM ]
[ ;BASE = num] [ ;MAX = num ]
[ ;SHOW]
Parameters
INSP Specifies the input spoolid counter.
OUTSP Specifies the output spoolid counter.
JOBNUM Specifies the job number counter.
SESSNUM Specifies the session number counter.
The target counter (INSP, OUTSP, etc.) is only optional if the SHOW option is
used by itself to display BASE and MAX values for all counters without
changing any of them. For any other form of the command, the target
counter is a required parameter.
num A positive integer. For MAX, num may also equal zero. A non-zero num for
MAX must be less than or equal to the maximum possible value for that
counter. Those values are:
INSP 9999999
OUTSP 9999999
JOBNUM 16383
SESSNUM 16383
For BASE, num must be less than MAX, except when MAX is equal to zero.
Operation Notes
The SETCOUNTER command allows you to specify limits other than 1 and the maximum
possible value of one of four counters (but within that range) You may set limits for one
counter with each use of the command and, therefore, you must invoke the command four
times to change the limits of all four coutners.
You may also use SETCOUNTER to display the current values of the counters. Only one
invocation of the command is necessary to see all current values.
To set a maximum operating value for the specified counter and enable its operation, enter
a positive value for the MAX keyword. Specify MAX=0 to disable the operation, that is, the
counter's limit is then its maximum possible value. Omitting MAX leaves its previous value