LinuxGuruz
  • Last 5 Forum Topics
    Replies
    Views
    Last post


The Web Only This Site
  • BOOKMARK

  • ADD TO FAVORITES

  • REFERENCES


  • MARC

    Mailing list ARChives
    - Search by -
     Subjects
     Authors
     Bodies





    FOLDOC

    Computing Dictionary




  • Text Link Ads






  • LINUX man pages
  • Linux Man Page Viewer


    The following form allows you to view linux man pages.

    Command:

    pbs_sched_tcl

    
    
    

    SYNOPSIS

           pbs_sched   [-a alarm]   [-b file]   [-d home]  [-i file]  [-L logfile]
           [-p file] [-S port] [-t file] [-v] [-c file]
    
    
    

    DESCRIPTION

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

    OPTIONS

           -a alarm       This  specifies the time in seconds to wait for a sched-
                          ule run to finish.  If a script takes too long  to  fin-
                          ish,  an  alarm  signal  is  sent,  and the scheduler is
                          restarted.  If a core file does not exist in the current
                          directory,  abort()  is called and a core file is gener-
                          ated.  The default for alarm is 180 seconds.
    
           -b file        This specifies the "body" file.  The file given is  read
                          into  memory  once at program start or after the program
                          receives a SIGHUP and executed each time  the  scheduler
                          is awakened by the server.  If this option is not given,
                          the    file     "sched_tcl"     in     the     directory
                          PBS_HOME/sched_priv is read for the body code.
    
           -d home        This  specifies  the  PBS home directory, PBS_HOME.  The
                          current  working   directory   of   the   scheduler   is
                          PBS_HOME/sched_priv.   If  this  option  is  not  given,
                          PBS_HOME defaults to $PBS_SERVER_HOME as defined  during
                          the PBS build procedure.
    
           -i file        This specifies the "initialize" file.  The file given is
                          executed  once  before  the  main  processing  loop   is
                          entered.  If this option is not given, no initialization
                          code is executed.
    
           -L logfile     Specifies an absolute path name of the file  to  use  as
                          the log file.  If not specified, the scheduler will open
                          a   file   named   for   the   current   date   in   the
                          PBS_HOME/sched_logs directory (see the -d option).
    
           -p file        This  specifies  the  "print" file.  Any output from the
                          Tcl code which is written to standard  out  or  standard
                          error  will  be written to this file.  If this option is
                          not     given,     the     file     used     will     be
                          PBS_HOME/sched_priv/sched_out.  See the -d option.
    
           -S port        This  specifies  the port to use.  If this option is not
                          given, the default port for the PBS scheduler is used.
    
                          option is not supplied, pbs_sched will  not  attempt  to
                          open a configuration file.
    
           The  options  that  specify file names may be absolute or relative.  If
           they are relative, their root directory will be PBS_HOME/sched_priv.
    
    
    

    USAGE

           This version of the scheduler requires knowledge of the  Tcl  language.
           A set of functions to communicate with the PBS server and resource mon-
           itor have been added to those normally available with Tcl.   All  these
           calls  will  set the Tcl variable "pbs_errno" to a value to indicate if
           an error occured.  In all cases, the value "0" means no  error.   If  a
           call  to a Resource Monitor function is made, any error value will come
           from the system supplied errno variable.  If the function call communi-
           cates  with  the  PBS  Server, any error value will come from the error
           number returned by the server.
    
           openrm host ?port?
                 Creates a connection to the PBS Resource Monitor  on  host  using
                 port  as  the  port  number or the standard port for the resource
                 monitor if it is not given.  A connection handle is returned.  If
                 the  open is successful, this will be a non-negative integer.  If
                 not, an error occurred.
    
           closerm connection
                 The parameter connection is a handle to a resource monitor  which
                 was  previously returned from openrm.  This connection is closed.
                 Nothing is returned.
    
           downrm connection
                 Sends a command to the connected resource  monitor  to  shutdown.
                 Nothing is returned.
    
           configrm connection filename
                 Sends  a  command  to  the connected resource monitor to read the
                 configuration file given by filename.  If this is  successful,  a
                 "0" is returned, otherwise, "-1" is returned.
    
           addreq connection request
                 A resource request is sent to the connected resource monitor.  If
                 this is  successful,  a  "0"  is  returned,  otherwise,  "-1"  is
                 returned.
    
           getreq connection
                 One resource request response from the connected resource monitor
                 is  returned.   If  an  error  occurred  or  there  are  no  more
                 responses, an empty string is returned.
                 is returned.  If there is nothing to read from any of the connec-
                 tions, a negative number is returned.
    
           fullresp flag
                 Evaluates flag as a boolean value and sets the response mode used
                 by getreq to full if flag evaluates to "true".  The  full  return
                 from a resource monitor includes the original request followed by
                 an equal sign followed by the response.  The default situation is
                 only  to  return  the  response  following  the equal sign.  If a
                 script needs to "see" the entire line, this function may be used.
    
           pbsstatserv
                 The  server  is  sent  a status request for information about the
                 server itself.  If the request succeeds, a list with  three  ele-
                 ments  is  returned,  otherwise an empty string is returned.  The
                 first element is the server's name.  The  second  is  a  list  of
                 attributes.   The  third is the "text" associated with the server
                 (usually blank).
    
           pbsstatjob
                 The server is sent a status request for information about the all
                 jobs resident within the server.  If the request succeeds, a list
                 is returned, otherwise an empty string  is  returned.   The  list
                 contains  an  entry  for  each  job.  Each element is a list with
                 three elements.  The first is the job's jobid.  The second  is  a
                 list  of attributes.  The attribute names which specify resources
                 will have a name of the form "Resource_List:name" where "name" is
                 the  resource  name.  The third is the "text" associated with the
                 job (usually blank).
    
           pbsstatque
                 The server is sent a status request  for  information  about  all
                 queues  resident  within  the server.  If the request succeeds, a
                 list is returned, otherwise an empty  string  is  returned.   The
                 list  contains  an  entry for each queue.  Each element is a list
                 with three elements.  This first is the queue's name.  The second
                 is  a list of attributes similar to pbsstatjob.  The third is the
                 "text" associated with the queue (usually blank).
    
           pbsstatnode
                 The server is sent a status request  for  information  about  all
                 nodes defined within the server.  If the request succeeds, a list
                 is returned, otherwise an empty string  is  returned.   The  list
                 contains  an  entry  for  each node.  Each element is a list with
                 three elements.  This first is the nodes's name.  The second is a
                 list  of  attributes  similar  to  pbsstatjob.   The third is the
                 "text" associated with the node (usually blank).
    
           pbsasyrunjob jobid ?location?
                 Run  the  job  given  by  jobid at the location given by location
                 without waiting for a positive response that the job has actually
                 started.  If location is not given, the default location is used.
                 If this is successful, a "0"  is  returned,  otherwise,  "-1"  is
                 returned.
    
           pbsrerunjob jobid
                 Re-runs  the job given by jobid.  If this is successful, a "0" is
                 returned, otherwise, "-1" is returned.
    
           pbsdeljob jobid
                 Delete the job given by jobid.  If this is successful, a  "0"  is
                 returned, otherwise, "-1" is returned.
    
           pbsholdjob jobid
                 Place a hold on the job given by jobid.  If this is successful, a
                 "0" is returned, otherwise, "-1" is returned.
    
           pbsmovejob jobid ?location?
                 Move the job given by jobid to the location  given  by  location.
                 If  location is not given, the default location is used.  If this
                 is successful, a "0" is returned, otherwise, "-1" is returned.
    
           pbsqenable queue
                 Set the "enabled" attribute for the queue given by queue to true.
                 If  this  is  successful,  a  "0" is returned, otherwise, "-1" is
                 returned.
    
           pbsqdisable queue
                 Set the "enabled" attribute for  the  queue  given  by  queue  to
                 false.  If this is successful, a "0" is returned, otherwise, "-1"
                 is returned.
    
           pbsqstart queue
                 Set the "started" attribute for the queue given by queue to true.
                 If  this  is  successful,  a  "0" is returned, otherwise, "-1" is
                 returned.
    
           pbsqstop queue
                 Set the "started" attribute for  the  queue  given  by  queue  to
                 false.  If this is successful, a "0" is returned, otherwise, "-1"
                 is returned.
                 succeeds,   a   list   with   the  same  number  of  elements  as
                 resource_list is returned.  Each element in this list will  be  a
                 list  with  four  numbers.   The numbers specify available, allo-
                 cated, reserved, and down in that order.
    
           pbsrescreserve resource_id resource_list
                 Make (or extend) a reservation for  the  resources  specified  by
                 resource_list  which  will  be  given  as a list of strings.  The
                 parameter resource_id is a number which provides a unique identi-
                 fier   for  a  reservation  being  tracked  by  the  server.   If
                 resource_id is given as "0", a new reservation  is  created.   In
                 this  case,  a  new  identifier  is generated and returned by the
                 function.  If an old identifier is used, that same number will be
                 returned.   The  Tcl variable "pbs_errno" will be set to indicate
                 the success or failure of the reservation.
    
           pbsrescrelease resource_id
                 The reservation specified by resource_id is released.
    
           The two following commands are not  normally  used  by  the  scheduler.
           They are included here because there could be a need for a scheduler to
           contact a server other than the  one  which  it  normally  communicates
           with.  Also, these commands are used by the Tcl tools.
    
           pbsconnect ?server?
                 Make  a connection to the named server or the default server if a
                 parameter is not given.  Only  one  connection  to  a  server  is
                 allowed at any one time.
    
           pbsdisconnect
                 Disconnect from the currently connected server.
    
           The  above Tcl functions use PBS interface library calls for communica-
           tion with the server and the PBS resource monitor library  to  communi-
           cate with pbs_mom.
    
           datetime ?day? ?time?
                 The  number  of  arguments  used determine the type of date to be
                 calculated.   With  no  arguments,  the  current  POSIX  date  is
                 returned.  This is an integer in seconds.
    
                 With one argument there are two possible formats.  The first is a
                 12 (or more) character string specifying a complete date  in  the
                 following format:
    
                 All  characters  must  be  digits.  The year (YY) is given by the
    
                 With  two  arguments  a  relative  date is calculated.  The first
                 argument specifies a day of the week and must be one of the  fol-
                 lowing  strings:  "Sun",  "Mon",  "Tue",  "Wed", "Thr", "Fri", or
                 "Sat".  The second argument is a relative time  as  given  above.
                 The POSIX date calculated will be the day of the week given which
                 follows the current day, and the time given in the  second  argu-
                 ment.   For  example,  if the current day was Monday, and the two
                 arguments were "Fri" and "04:30:00", the date calculated would be
                 the  POSIX  date  for the Friday following the current Monday, at
                 four-thirty in the morning.  If the day specified and the current
                 day  are  the same, the current day is used, not the day one week
                 later.
    
           strftime format time
                  This function calls the POSIX function strftime().  It  requires
                  two  arguments.   The first is a format string.  The format con-
                  ventions are the same as those  for  the  POSIX  function  strf-
                  time().  The second argument is POSIX calendar time in second as
                  returned by datetime.  It returns a string based on  the  format
                  given.   This  gives  the ability to extract information about a
                  time, or format it for printing.
    
           The Tcl interpreter is started at program initialization  and  after  a
           reset  (the  receipt  of  a  SIGHUP signal).  It is not deleted between
           scheduling runs so variables which are  set  in  one  can  be  accessed
           later.
    
           The  "initialize"  and "terminator" files are run with no supplied con-
           nection to the server.  This means that none  of  the  above  functions
           which  talk  to the server will work unless pbsconnect is called first.
           The "body" file is run with a connection to the server  already  estab-
           lished.
    
    
    

    CONFIGURATION FILE

           A  configuration  file  may be specified with the -c option.  This file
           may be used to specify the hosts (servers) which are allowed to connect
           to  pbs_sched.   The hosts are specified in the configuration file in a
           manor identical to that used in pbs_mom.  There is one  line  per  host
           with the syntax:
           $clienthost   hostname
           where clienthost and hostname are separated by white space.
    
           Two  host  names are always allowed to connection to pbs_sched, "local-
           host" and the name returned to pbs_sched by the  system  call  gethost-
           name().  These names need not be specified in the configuration file.
    
           The configuration file must be "secure".  It must be owned by a user id
           and group id less than 10 and not be world writable.
    
                  the  Alarm  will cause the scheduler to attempt to core dump and
                  restart itself.
    
           SIGINT and SIGTERM
                  Will result in an orderly shutdown of the scheduler.
    
           All other signals have the default action installed.
    
    
    

    EXIT STATUS

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

    SEE ALSO

           pbs_scheduler_cc(8B),   pbs_scheduler_rule(8B),   pbs_server(8B),   and
           pbs_mom(8B).
           PBS Internal Design Specification
    
    
    

    Local pbs_sched(8B)

    
    
  • MORE RESOURCE


  • Linux

    The Distributions





    Linux

    The Software





    Linux

    The News



  • MARKETING






  • Toll Free

webmaster@linuxguruz.com
Copyright © 1999 - 2016 by LinuxGuruz