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:

    qalter

    
    
    

    SYNOPSIS

           qalter  [-a  date_time] [-A account_string] [-c interval] [-e path] [-h
           hold_list] [-j join] [-k keep] [-l resource_list] [-m mail_options] [-M
           user_list]  [-N  name]  [-o  path]  [-p  priority] [-r c] [-S path] [-u
           user_list] [-W additional_attributes] job_identifier...
    
    
    

    DESCRIPTION

           The qalter command modifies the attributes of the job or jobs specified
           by job_identifier on the command line.  Only those attributes listed as
           options on the command will be  modified.   If  any  of  the  specified
           attributes  cannot  be  modified for a job for any reason, none of that
           job's attributes will be modified.
    
           The qalter command accomplishes the modifications by sending  a  Modify
           Job batch request to the batch server which owns each job.
    
    
    

    OPTIONS

           -a date_time
                   Replaces  the time at which the job becomes eligible for execu-
                   tion.      The     date_time      argument      syntax      is:
                   [[[[CC]YY]MM]DD]hhmm[.SS].
    
                   If the month, MM, is not specified, it will default to the cur-
                   rent month if the specified day DD, is in the  future.   Other-
                   wise,  the  month  will be set to next month.  Likewise, if the
                   day, DD, is not specified, it will default to today if the time
                   hhmm  is  in  the  future.   Otherwise,  the day will be set to
                   tomorrow.
    
                   This attribute can be altered once the job has begun execution,
                   but it will not take affect until the job is rerun.
    
           -A account_string
                   Replaces the the account string associated with the job.
    
                   This  attribute cannot be altered once the job has begun execu-
                   tion.
    
           -c interval
                   Replaces the the interval at  which  the  job  will  be  check-
                   pointed.   If  the job executes upon a host which does not sup-
                   port checkpoint, this option will be ignored.
    
                   The interval argument is specified as:
    
                   n   No checkpointing is to be performed.
    
                   s   Checkpointing is to be performed only when the server  exe-
                       cuting the job is shutdown.
    
                   c   Checkpointing is to be performed at the default minimum cpu
                       time for the queue from which the job is executing.
    
                   where  hostname is the name of a host to which the file will be
                   returned and path_name is the path name on  that  host  in  the
                   syntax recognized by POSIX 1003.1.  The argument will be inter-
                   preted as follows:
    
                   path_name
                          Where path_name is not an absolute path name,  then  the
                          qalter command will expand the path name relative to the
                          current working directory of the command.   The  command
                          will  supply  the name of the host upon which it is exe-
                          cuting for the hostname component.
    
                   hostname:path_name
                          Where path_name is not an absolute path name,  then  the
                          qalter  command will not expand the path name.  The exe-
                          cution server will expand it relative to the home direc-
                          tory of the user on the system specified by hostname.
    
                   path_name
                          Where  path_name  specifies  an absolute path name, then
                          qalter will supply the name of the host on which  it  is
                          executing for the hostname.
    
                   hostname:path_name
                          Where  path_name  specifies  an  absolute path name, the
                          path will be used as specified.
    
                   This attribute can be altered once the job has begun execution,
                   but it will not take affect until the job is rerun.
    
           -h hold_list
                   Updates the the types of holds on the job.  The hold_list argu-
                   ment is a string of one or more of the following characters:
    
                   u    Add the USER type hold.
    
                   s    Add the SYSTEM type hold if the user has  the  appropriate
                        level  of  privilege.   [Typically  reserved  to the batch
                        administrator.]
    
                   o    Add the OTHER (or OPERATOR ) type hold if the user has the
                        appropriate  level  of  privilege.  [Typically reserved to
                        the batch administrator and batch operator.]
    
                   n    Set to none; that is clear the hold types which  could  be
                        applied with the users level of privilege.
    
                   Repetition  of  characters is permitted, but "n" may not appear
                   in the same option argument with the  other  three  characters.
                   This attribute can be altered once the job has begun execution,
                   but the hold will not take affect until the job is rerun.
    
    
           -k keep Defines which if either of standard output or standard error of
                   the  job  will be retained on the execution host.  If set for a
                   stream, this option overrides the path name for that stream.
    
                   The argument is either the single letter "e", "o", or  "n",  or
                   one  or  more  of  the  letters  "e" and "o" combined in either
                   order.
    
                   n    No streams are to be retained.
    
                   e    The standard error stream is to retained on the  execution
                        host.  The  stream will be placed in the home directory of
                        the user under whose user id the job executed.   The  file
                        name will be the default file name given by: job_name.ese-
                        quence where job_name is the name specified for  the  job,
                        and  sequence  is the sequence number component of the job
                        identifier.
    
                   o    The standard output stream is to be retained on the execu-
                        tion  host.  The  stream will be placed in the home direc-
                        tory of the user under whose user  id  the  job  executed.
                        The  file  name  will  be  the default file name given by:
                        job_name.osequence where job_name is  the  name  specified
                        for the job, and sequence is the sequence number component
                        of the job identifier.
    
                   eo   Both the standard output and standard error  streams  will
                        be retained.
    
                   oe   Both  the  standard output and standard error streams will
                        be retained.
    
                   This attribute cannot be altered once the job has begun  execu-
                   tion.
    
           -l resource_list
                   Modifies  the  list  of resources that are required by the job.
                   The Resource_List argument is in the following syntax:
                   resource_name[=[value]][,resource_name[=[value]],...]
    
                   If a requested modification to  a  resource  would  exceed  the
                   resource  limits for jobs in the current queue, the server will
                   reject the request.
    
                   If the job is running, only certain, resources can be  altered.
                   Which  resources  can  be  altered  in  the run state is system
                   dependent.   A  user  may  only  lower  the  limit  for   those
                   resources.
    
           -m mail_options
                   Replaces the set of conditions under which the execution server
    
           -M user_list
                   Replaces  the  list of users to whom mail is sent by the execu-
                   tion server when it sends mail about the job.
    
                   The user_list argument is of the form:
                       user[@host][,user[@host],...]
    
           -N name Renames the job.  The name specified may be up to and including
                   15  characters  in  length.   It must consist of printable, non
                   white space characters with the first character alphabetic.
    
           -o path Replaces the path to be used for the standard output stream  of
                   the batch job.  The path argument is of the form:
                       [hostname:]path_name
                   where  hostname is the name of a host to which the file will be
                   returned and path_name is the path name on  that  host  in  the
                   syntax  recognized  by POSIX.  The argument will be interpreted
                   as follows:
    
                   path_name
                          Where path_name is not an absolute path name,  then  the
                          qalter command will expand the path name relative to the
                          current working directory of the command.   The  command
                          will  supply  the name of the host upon which it is exe-
                          cuting for the hostname component.
    
                   hostname:path_name
                          Where path_name is not an absolute path name,  then  the
                          qalter  command will not expand the path name.  The exe-
                          cution server will expand it relative to the home direc-
                          tory of the user on the system specified by hostname.
    
                   path_name
                          Where  path_name  specifies  an absolute path name, then
                          the qalter will supply the name of the host on which  it
                          is executing for the hostname.
    
                   hostname:path_name
                          Where  path_name  specifies  an  absolute path name, the
                          path will be used as specified.
    
                   This attribute can be altered once the job has begun execution,
                   but it will not take affect until the job is rerun.
    
           -p priority
                   Replaces  the  priority of the job.  The priority argument must
                   be a integer between -1024 and +1023 inclusive.
    
                   This attribute can be altered once the job has begun execution,
                   but it will not take affect until the job is rerun.
    
           -r c    Declares whether the job is rerunable.  See the qrerun command.
                   then if present the path  specified  without  a  host  will  be
                   selected.
    
                   If  the  -S option is not specified, the option argument is the
                   null string, or no entry from the path_list  is  selected,  the
                   execution will use the login shell of the user on the execution
                   host.
    
                   This attribute can be altered once the job has begun execution,
                   but it will not take affect until the job is rerun.
    
           -u user_list
                   Replaces  the  user  name  under which the job is to run on the
                   execution system.
    
                   The user_list argument is of the form:
                       user[@host][,user[@host],...]
                   Only one user name may be given for per specified  host.   Only
                   one of the user specifications may be supplied without the cor-
                   responding host specification.  That user name will be used for
                   execution on any host not named in the argument list.
    
                   This  attribute cannot be altered once the job has begun execu-
                   tion.
    
           -W additional_attributes
                   The -W option allows for the  modification  of  additional  job
                   attributes.  The general syntax of the -W is in the form:
    
                   Note  if white space occurs anywhere within the option argument
                   string or the equal sign, "=", occurs within an attribute_value
                   string,  then the string must be enclosed with either single or
                   double quote marks.
    
                   PBS currently supports the following attributes within  the  -W
                   option.
    
                   depend=dependency_list
                   Redefines  the  dependencies  between this and other jobs.  The
                   dependency_list   is   in   the   form:   type[:argument[:argu-
                   ment...][,type:argument...].
                   The  argument is either a numeric count or a PBS job id accord-
                   ing to type .  If argument is a count, it must be greater  than
                   0.   If  it is a job id and is not fully specified in the form:
                   seq_number.server.name, it will be expanded  according  to  the
                   default server rules.  If argument is null (the preceding colon
                   need not be specified), the  dependency  of  the  corresponding
                   type is cleared (unset).
    
                       synccount:count
                           This  job  is the first in a set of jobs to be executed
                           at the same time.  Count is the  number  of  additional
    
                       afternotok:jobid[:jobid...]
                           This job may be scheduled for execution only after jobs
                           jobid have terminated with errors.
    
                       afterany:jobid[:jobid...]
                           This job may be  scheduled  for  execution  after  jobs
                           jobid have terminated, with or without errors.
    
                       on:count
                           This  job  may  be  scheduled for execution after count
                           dependencies on other jobs have been  satisfied.   This
                           form  is  used  in  conjunction  with one of the before
                           forms, see below.
    
                       before:jobid[:jobid...]
                           When this job has begun execution, then  jobs  jobid...
                           may begin.
    
                       beforeok:jobid[:jobid...]
                           If  this  job terminates execution without errors, then
                           jobs jobid... may begin.
    
                       beforenotok:jobid[:jobid...]
                           If this job terminates execution with errors, then jobs
                           jobid... may begin.
    
                       beforeany:jobid[:jobid...]
                           When  this  job terminates execution, jobs jobid... may
                           begin.
    
                           If any of the before forms are used, the job referenced
                           by  jobid  must  have  been submitted with a dependency
                           type of on.
    
                           The job specified in any of the before forms must  have
                           the  same  owner as the job being altered..  Otherwise,
                           the dependency will not take effect.
    
                       Error processing of the existence, state, or  condition  of
                       the job on which the newly submitted job is a deferred ser-
                       vice, i.e. the check is performed after the job is  queued.
                       If an error is detected, the new job will be deleted by the
                       server.  Mail will be sent to the job submitter stating the
                       error.
    
                   group_list=g_list
                   Alters the group name under which the job is to run on the exe-
                   cution system.
    
                   The     g_list     argument      is      of      the      form:
                     group[@host][,group[@host],...]
    
                   absolute or relative to the user's home directory on the desti-
                   nation host.
    
    
    

    OPERANDS

           The  qalter  command accepts one or more job_identifier operands of the
           form:
               sequence_number[.server_name][@server]
    
    
    

    STANDARD ERROR

           Any error condition, either in processing the options or the  operands,
           or  any  error received in reply to the batch requests will result in a
           error message being written to standard error.
    
    
    

    EXIT STATUS

           Upon successful processing of all the operands presented to the  qalter
           command, the exit status will be a value of zero.
    
           If  the  qalter command fails to process any operand, the command exits
           with a value greater than zero.
    
    
    

    SEE ALSO

           qsub(1B),  qstat(1B),  pbs_alterjob(3B),  pbs_statjob(3B),   pbs_selec-
           tjob(3B), pbs_resources_*(7B), where * is system type, and the PBS ERS.
    
    
    

    Local qalter(1B)

    
    
  • MORE RESOURCE


  • Linux

    The Distributions





    Linux

    The Software





    Linux

    The News



  • MARKETING






  • Toll Free

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