1pbs_sched(8B) PBS pbs_sched(8B)
2
6 pbs_sched_cc - pbs C scheduler
7
9 pbs_sched [-a alarm] [-d home] [-L logfile] [-p file] [-S port]
10 [-R port] [-c file]
11
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 pbs_sched must be executed with root permission.
19
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 -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 -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 -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 -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 -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 -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 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
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 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 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 On receipt of a SIGHUP signal, the scheduler will close and reopen its
83 log file and reread its configuration file (if any).
84
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 clienthost
92 One or more servers, one per line, may be specified:
93 $clienthost hostname +.IP restricted Allows connections from
95 non-priviledged ports on the named hosts. Typically only used
96 with Mac OSX:
97 $restricted hostname
99 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 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
109 $PBS_SERVER_HOME/sched_priv
110 the default directory for configuration files, typically
111 (/usr/spool/pbs)/sched_priv.
112
114 A C based scheduler will handle the following signals:
115 SIGHUP The server will close and reopen its log file and reread the
117 config file if one exists.
118 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 SIGINT and SIGTERM
125 Will result in an orderly shutdown of the scheduler.
126 All other signals have the default action installed.
128
130 Upon normal termination, an exit status of zero is returned.
131
133 pbs_sched_tcl(8B), pbs_server(8B), and pbs_mom(8B).
134 PBS Internal Design Specification
135Local pbs_sched(8B)