1pbs_sched(8B)                         PBS                        pbs_sched(8B)
2
3
4

NAME

6       pbs_sched_cc - pbs C scheduler
7

SYNOPSIS

9       pbs_sched   [-a alarm]   [-d home]   [-L logfile]  [-p file]  [-S port]
10       [-R port] [-c file]
11

DESCRIPTION

13       The pbs_sched program runs in conjunction  with  the  PBS  server.   It
14       queries  the  server  about  the  state  of  PBS  and communicates with
15       pbs_resmon to get information about the status of running jobs,  memory
16       available etc.  It then makes decisions as to what jobs to run.
17
18       pbs_sched must be executed with root permission.
19

OPTIONS

21       -a alarm       This  specifies the time in seconds to wait for a sched‐
22                      ule run to finish.  If a script takes too long  to  fin‐
23                      ish,  an  alarm  signal  is  sent,  and the scheduler is
24                      restarted.  If a core file does not exist in the current
25                      directory,  abort()  is called and a core file is gener‐
26                      ated.  The default for alarm is 180 seconds.
27
28       -d home        This specifies the PBS home  directory,  PBS_HOME.   The
29                      current   working   directory   of   the   scheduler  is
30                      PBS_HOME/sched_priv.   If  this  option  is  not  given,
31                      PBS_HOME  defaults to $PBS_SERVER_HOME as defined during
32                      the PBS build procedure.
33
34       -L logfile     Specifies an absolute path name of the file  to  use  as
35                      the log file.  If not specified, the scheduler will open
36                      a   file   named   for   the   current   date   in   the
37                      PBS_HOME/sched_logs directory (see the -d option).
38
39       -p file        This  specifies the "print" file.  Any output from the C
40                      code which is written to standard out or standard  error
41                      will  be  written  to  this file.  If this option is not
42                      given,      the      file       used       will       be
43                      PBS_HOME/sched_priv/sched_out .  See the -d option.
44
45       -S port        This  specifies  the port to use.  If this option is not
46                      given, the default port for the PBS scheduler is used.
47
48       -R port        This specifies the resource monitor  port  to  use.   If
49                      this  option  is not given, the default port for the PBS
50                      mom is used.  NOTE: this option only makes the mom  port
51                      available  to  the  scheduler  writer.  It doesn't force
52                      them to use it.
53
54       -c file        Specify a configuration file, see description below.  If
55                      this  is  a  relative  file  name it will be relative to
56                      PBS_HOME/sched_priv, see  the  -d  option.   If  the  -c
57                      option  is  not  supplied, pbs_sched will not attempt to
58                      open a configuration file.
59
60       The options that specify file names may be absolute  or  relative.   If
61       they are relative, their root directory will be PBS_HOME/sched_priv.
62

USAGE

64       This  version of the scheduler requires knowledge of the C language and
65       the PBS API.  Source code is provided for a main program for the sched‐
66       uler.   The  site  must supply the heart of the program.  When invoked,
67       the main  program  performs  general  initialization  and  housekeeping
68       chores.   Then  a  locally  supplied function, schedinit() is called to
69       perform site specific initialization.
70
71       In the main loop, a locally supplied function, schedule() is called  to
72       make the scheduling decisions and perform any required actions.  Infor‐
73       mation about jobs and queues is obtained from the  Server  through  the
74       standard PBS API as found in libifl.a.  Information about the execution
75       host(s) is obtained from the Resource Monitor.  Routines to communicate
76       with the Resource Monitor are found in libnet.a.
77
78       If the processing takes more than the allotted time, the scheduler will
79       restart itself.  The default amount of time is three minutes.  This can
80       be changed with the -a option.
81
82       On  receipt of a SIGHUP signal, the scheduler will close and reopen its
83       log file and reread its configuration file (if any).
84

CONFIGURATION FILE

86       A configuration file may be specified with the -c  option.   This  file
87       may be used to specify the hosts (servers) which are allowed to connect
88       to pbs_sched.  The hosts are specified in the configuration file  in  a
89       manor identical to that used in pbs_mom.
90
91       clienthost
92              One or more servers, one per line, may be specified:
93
94              $clienthost    hostname  +.IP restricted Allows connections from
95              non-priviledged ports on the named hosts.  Typically  only  used
96              with Mac OSX:
97
98              $restricted   hostname
99
100              Two  host  names  are always allowed to connection to pbs_sched,
101              "localhost" and the name returned to  pbs_sched  by  the  system
102              call  gethostname().   These  names need not be specified in the
103              configuration file.
104
105       The configuration file must be "secure".  It must be owned by a user id
106       and group id less than 10 and not be world writable.
107

FILES

109       $PBS_SERVER_HOME/sched_priv
110                 the  default  directory  for  configuration  files, typically
111                 (/usr/spool/pbs)/sched_priv.
112

Signal Handling

114       A C based scheduler will handle the following signals:
115
116       SIGHUP The server will close and reopen its log  file  and  reread  the
117              config file if one exists.
118
119       SIGALRM
120              If  the  site supplied scheduling module exceeds the time limit,
121              the Alarm will cause the scheduler to attempt to core  dump  and
122              restart itself.
123
124       SIGINT and SIGTERM
125              Will result in an orderly shutdown of the scheduler.
126
127       All other signals have the default action installed.
128

EXIT STATUS

130       Upon normal termination, an exit status of zero is returned.
131

SEE ALSO

133       pbs_sched_tcl(8B), pbs_server(8B), and pbs_mom(8B).
134       PBS Internal Design Specification
135
136
137
138Local                                                            pbs_sched(8B)
Impressum