IMPORTQUOTA(8)                                     IMPORTQUOTA(8)

NAME

       importquota - change running parameters for customs

SYNOPSIS

       importquota [-check check-interval] [-localjobs available]
       [-idle min-idle]  [-idlecrit  criteria]  [-load  min-load-
       average]  [-swap  min-pct]  [-proc  min-procs]  [-cpu max-
       cputime]  [-memory  max-memory-use]   [-nice   nice-level]
       [-npri  priority]  [-evict  eviction-delay] [-access user-
       access-level] [-jobs max-jobs]  [-default  ]  [-q[uiet]  ]
       [-h[elp] ]

DESCRIPTION

       Importquota is used to modify the criteria customs(8) uses
       to determine the local machine's availability as a compute
       server for other machines, as well as the base interval at
       which the machine's availability is determined.

       The criteria and their flags are:

       -jobs max-jobs
              There may be at most max-jobs running on behalf  of
              other systems.

       -swap min-pct
              At  least  min-pct  percent  of  the machine's swap
              space must be free.

       -proc min-procs
              At least min-procs free slots for  additional  pro­
              cesses must be available.

       -load max-load
              The one-minute load average for the machine may not
              exceed max-load.

       -idle min-idle
              Logins on the machine must have been  idle  for  at
              least  min-idle  seconds (the argument may be given
              as min:sec for convenience).

       -idlecrit criteria
              Selects the criteria  (terminal  devices)  used  to
              determine  idle  times.   The  argument is a sum of
              small integers denoting a combination of  criteria,
              explained further in customs(8).

       -localjobs allowed
              If allowed is non-zero even local clients can start
              jobs through the customs daemon.

       Additionally, the following  flags  control  accessibility
       and resource limits for imported jobs.




PMake 2.1 (ICSI)   $Date: 1996/08/18 15:51:58 $                 1





IMPORTQUOTA(8)                                     IMPORTQUOTA(8)


       -cpu max-cputime
              Sets  the maximum amount of CPU time allowed for an
              imported job (given as min:sec).

       -memory max-memory-use
              Sets the maximum amount of real memory  allowed  to
              the imported job (specified in Kbytes).

       -nice nice-level
              Sets  a  minimum  nice  value greater that 0 (i.e.,
              lower priority) for imported jobs to execute at.

       -npri priority
              Sets a non-degrading priority  for  imported  jobs.
              (This feature is specific to SGI systems.)

       -evict eviction-delay
              Sets a time after which imported processes are ter­
              minated if a machine ceases to be idle.

       -access user-access-level
              Changes the level of user access checking performed
              by  the  local customs daemon, as explained in cus­
              toms(8).

       There are limits to these various  parameters,  to  insure
       that the machine will be available some of the time. If an
       invalid parameter is given, none of the  other  parameters
       will  be  set.  You  will  be told the valid range for the
       offending parameter(s). The one exception to these  ranges
       is  a value of 0 (e.g. "-swap 0"). If any parameter is set
       to 0, that parameter is ignored as an availability  crite­
       rion or access restriction until it is reset to a non-zero
       value.

       Importquota will print out the current criteria when it is
       done,  even if no parameters are altered. Thus just typing
       "importquota" will give you the current criteria for  your
       machine.   Certain criteria may no be available on certain
       platforms, in which case they will be ignored and  not  be
       printed.

       Customs may also be told to check the machine's availabil­
       ity at a different interval by means of the  -check  flag.
       The interval serves two purposes:

       -      It  serves to track the state of the machine -- the
              longer the interval, the  less  responsive  customs
              will be to changes in the machine state.

       -      It  gives  a  definite time within which the master
              agent will hear from the machine if that machine is
              still  up.  If  no  message  is received within the
              given interval (which may  be  different  for  each



PMake 2.1 (ICSI)   $Date: 1996/08/18 15:51:58 $                 2





IMPORTQUOTA(8)                                     IMPORTQUOTA(8)


              machine), the master considers the machine down and
              will not attempt to allocate it until another  mes­
              sage is received from it.

       The default check interval is 10 seconds, but 30 is proba­
       bly more reasonable, as machines also return their  avail­
       ability  each time they are allocated by the master agent,
       allowing a faster reaction to machine-state  changes  than
       might  be  implied  by  the  check interval.  The shortest
       allowed check interval is 5 seconds.

       The -default flag can be used to set -check and all avail­
       ability parameters to their default values.

       -q or -quiet suppresses the printing of the current avail­
       ability criteria on the standard output.

       -h or -help prints a summary of options and changes  noth­
       ing.

SEE ALSO

       customs(8),   cctrl(8),   reginfo(1),  pmake(1),  logd(8),
       export(1)

AUTHOR

       Adam de Boor, adam@bsw.uu.net (...!uunet!bsw!adam).
       Bugfixes and enhancements by Andreas Stolcke (stol­
       cke@icsi.berkeley.edu).





























PMake 2.1 (ICSI)   $Date: 1996/08/18 15:51:58 $                 3