NAME
	  qalter - alter batch job

     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 execution.  The date_time	argument syntax	is:
		  [[[[CC]YY]MM]DD]hhmm[.SS].

		  If the month,	MM, is not specified, it will default
		  to the current month if the specified	day DD,	is in
		  the future.  Otherwise, 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	execution.

	  -c interval
		  Replaces the the interval at which the job will be
		  checkpointed.	 If the	job executes upon a host which
		  does not support 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 executing 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.

		  c=minutes
		     Checkpointing is to be performed at an interval
		     of	minutes, which is the integer number of
		     minutes of	CPU time used by the job.  This	value
		     must be greater than zero.	 If the	number is less
		     than the default checkpoint time, the default
		     time will be used.

		  This attribute can be	altered	once the job has begun
		  execution, but the new value does not	take affect
		  until	the job	is rerun.

	  -e path Replaces the the path	to be used for the standard
		  error	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
		  1003.1.  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 executing 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 execution server	will expand it
		       relative	to the home directory 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 argument 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
		       reservered to the batch administrator.]

		  o    Add the OTHER (or OPERATOR ) type hold if the
		       user has	the appropriate	level of privilege.
		       [Typically reservered 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.

	  -j join Declares which standard streams of the job will be
		  merged together.  The	join argument value may	be the
		  characters "oe" and "eo", or the single character
		  "n".

		  A argument value of oe directs that the standard
		  output and standard error streams of the job will be
		  merged, intermixed, and returned as the standard
		  output.  A argument value of eo directs that the
		  standard output and standard error streams of	the
		  job will be merged, intermixed, and returned as the
		  standard error.

		  A value of n directs that the	two streams will be
		  two separate files.  This attribute can be altered
		  once the job has begun execution, but	it 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.esequence
		       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 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.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	execution.

	  -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 will	send a mail message about the
		  job.	The mail_options argument is a string which
		  consists of the single character "n",	or one 
		  or more of the characters
		  "a", "b", and "e".

		  If the character "n" is specified, no	mail will be
		  sent.

		  For the letters "a", "b", and	"e":

		  a    mail is sent when the job is aborted by the
		       batch system.

		  b    mail is sent when the job begins	execution.

		  e    mail is sent when the job terminates.

	  -M user_list
		  Replaces the list of users to	whom mail is sent by
		  the execution	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 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 executing 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 execution server	will expand it
		       relative	to the home directory 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.  The option argument c is a single
		  character.  PBS recognizes the following characters:
		  y and	n.

		  If the argument is "y", the job is marked rerunable.
		  If the argument is "n", the job is marked as not
		  rerunable.

	  -S path Declares the shell that interprets the job script.

		  The option argument path_list	is in the form:
		      path[@host][,path[@host],...]
		  Only one path	may be specified for any host named.
		  Only one path	may be specified without the
		  corresponding	host name.  The	path selected will be
		  the one with the host	name that matched the name of
		  the execution	host.  If no matching host is found,
		  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 corresponding 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	execution.

	  -W additional_attributes
		  The -W option	allows for the modification of
		  additional job attributes.  The general syntax of
		  the -W is in the form:
		      -W attr_name=value[,attr_name=value...]
		  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[,type:argument[:argument...],...].
		  The argument is either a numeric count or a PBS job
		  id.  If argument is a	count, it must be greater than
		  0.  If it is a job id, the job id must be fully
		  specified in the form:  seq_number.server.name.

		      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 jobs in the set.

		      syncwith:jobid

			  This job is an additional member of a	set of
			  jobs to be executed at the same time.	Jobid
			  is the job identifier	of the first job in
			  the set.

		      after:jobid[:jobid...]
			  This job may be scheduled for	execution at
			  any point after jobs jobid have started
			  execution.

		      afterok:jobid[:jobid...]
			  This job may be scheduled for	execution only
			  after	jobs jobid have	terminated with	no
			  errors.

		      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 existance, state,	or
		      condition	of the job on which the	newly
		      submitted	job is a deferred service, 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 execution system.

		  The g_list argument is of the	form:
		    group[@host][,group[@host],...]
		  Only one group name may be given per specified host.
		  Only one of the group	specifications may be supplied
		  without the corresponding host specification.	 That
		  group	name will used for execution on	any host not
		  named	in the argument	list.

		  stagein=file_list
		  stageout=file_list
		  Alters which files are staged	(copied) in before job
		  start	or staged out after the	job completes
		  execution.  The file_list is in the form:
		  local_file@hostname:remote_file[,...]
		  The name local_file is the name on the system	where
		  the job executes.  It	may be an absolute path	or a
		  path relative	to the home directory of the user.
		  The name remote_file is the destination name on the
		  host specified by hostname.  The name	may be
		  absolute or relative to the user's home directory on
		  the destination 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 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), and 
	  pbs_statjob(3B)