554 Chapter 7
Command Definitions S-SO
SETCOUNTER
in force. Once MAX is reached, the next value tried is the BASE value. If you specify a
non-zero value for MAX, it must be greater than the current BASE for the corresponding
counter, but less than the maximum possible value
The BASE keyword causes the specified counter to be immediately yanked to the specified
value. If you supply a value, it must be less than the supplied or current value of MAX
(other than 0), and in any case, less than the maximum possible value. If you do not specify
BASE, it is not changed, nor is current sequencing affected.
For each counter, duplicate values are avoided. For example, if #O10 is in use when due to
be assigned as the next output spoolid, it is skipped and #O11 is tried. This process
continues until an available value is found.
The defaults, established when the system is booted, are MAX=0 and BASE=1. This is for
backward compatibility; if these settings are not changed, the system will operate as it
does today. These boot time settings can be modified by including one or more instances of
this command in SYSSTART.PUB.SYS.
The SHOW option can be used alone to display the current values of BASE and MAX for a
specified counter or for all four counters. If used in addition to either BASE or MAX, the
value(s) displayed are the new setting(s).
This command may be issued from a session, job, program, or in Break. Any display
specified by the SHOW option is breakable, but command operation is not. Any user may
execute this command with only the SHOW option to display current values of BASE,
Next, and MAX for the specified counter (or all counters if none is specified). When
changing either value, this command may be executed only:
• at a console session,
• by a user with SM capability, -OR-
• by any user who has been allowed the use of the SETCOUNTER command with the
ALLOW command.
Examples
To display the current BASE, Next, MAX, and maximum possible values for all four
counters, enter:
:SETCOUNTER ; SHOW
Absolute
COUNTER BASE Next MAX maximum
Input spoolid 1 172 16383 9999999
Output spoolid 1 1872 32767 9999999
Job number 1 172 0 16383
Session number 1 2753 0 16383
To limit input spoolids to the same range as their corresponding jobs, enter:
:SETCOUNTER INSP; MAX=16383
Related Information
Commands None
