1 02/28/85  tune_work_class, twc
 2 
 3 Syntax as a command:  twc -work_class N -control_args
 4 
 5 
 6 Function:  sets or changes the scheduling parameters for a single work
 7 class.
 8 
 9 
10 Arguments:
11 -work_class N, -wc N
12    specifies the work class for which scheduling parameters are to be
13    set.
14 
15 
16 Control arguments:  are the parameters to be set, and can be chosen
17    from the following (at least one must be specified):
18 -governed STR, -gv STR
19    controls the limitation of CPU resources to the work class.  STR can
20    be "off," in which case there is no limitation for the work class;
21    or STR can be a number between one and 100, which represents a
22    percentage of total system CPU time.  In this case, the work class
23    is limited to the specified percentage of total system CPU time.
24 -int_response N, -ir N
25    is the desired response time, in decimal seconds, after an
26    interaction.
27 -int_quantum N, -iq N
28    is the quantum (time slice), in decimal seconds, given after an
29    interaction.
30 
31 
32 -int_queue STR
33    controls the use of the interactive scheduler queue by users in the
34    work class.  STR can be "on", in which case users in the work class
35    who have interacted recently are given priority over users in all
36    work classes who have not interacted recently.  STR can also be
37    "off", in which case users in the work class who have interacted
38    recently do not receive priority.  The default is "off" for governed
39    work classes and "on" for all other work classes.
40 -response N, -r N
41    is the time, in decimal seconds, between successive quanta.
42 -quantum N, -q N
43    is the quantum, in decimal seconds, given when an interaction has
44    not just occurred.
45 
46 
47 -pin_weight N, -pw N
48    sets the pin weight of the work class to N.  The default is 3 for
49    the Initializer, and 0 for all other work classes.
50 -post_purge STR, -pp STR
51    controls post purging of processes in the work class, where STR can
52    be "on" or "off."  If on, processes are post purged if post purging
53    is enabled for the system; if off, processes are never post purged.
54 -realtime STR, -realt STR
55    places the work class in realtime mode if STR is "on"; removes the
56    work class from realtime mode if STR is "off."
57 -wc_max_eligible N
58    applies eligibility constraints to processes in the work class,
59    where N is an integer.  If N is nonzero, no more than N processes
60    are eligible at one time; if N is zero, only system-wide eligibility
61    constraints are applied.
62 
63 
64 Access required:  This command requires access to hphcs_.
65 
66 
67 Notes:  If the system scheduler is in percent mode and the specified
68 work class is not in realtime mode, then the values of int_response,
69 int_quantum, response, quantum, and wc_max_eligible have no effect on
70 the system's operation.
71 
72 If the system scheduler is in deadline mode or the specified work class
73 is in realtime mode, then the values of governed have no effect on the
74 system's operation.
75 
76 This command is useful for setting scheduler parameters on a temporary
77 basis.  Parameters set by this command are overridden by the values in
78 the master group table (MGT) at shift change time, if a new MGT is
79 installed, or if the operator issues the command line "maxu auto."