llhold()                                                 llhold()



 NAME
      llhold - holds or releases a job.

 SYNOPSIS
      llhold [-H] [-q] [-v] [-s] [-r] [-u userlist] [-h hostlist]
      [hostname[.cluster_id [.proc_id] ..."

 DESCRIPTION
      The LoadLeveler system administrator or user can use this
      command to place a job in hold or release a job from hold.
      Only the administrator can place a job in system hold or
      remove a job from system hold.  Either the job owner or the
      administrator may place a job in user hold or remove a job
      from user hold.

      -H
      Prints a short usage message.

      -q
      Quiet mode.  Information messages do not display.  Error
      messages always display.

      -v
      Version.  Outputs the name of the command, release number,
      service level and date, and operating system.

      -s
      Places the job in system hold.

      -r
      Releases the job from hold.
      If the job is in both user and system hold, issue the
      "llhold -r" command twice to remove both holds.  The first
      instance removes system hold status and the second instance
      removes user hold status.  Only the administrator can change
      system hold status.

      -u userlist
      Blank delimited list of users.  All jobs submitted by users
      in this list are held or released.  When the -h option is
      also specified, only jobs submitted in userlist and
      monitored on the host machines in hostlist are acted upon.

      -h hostlist
      Blank delimited list of hosts.  All jobs monitored on host
      machines in this list are held or released.

      hostname
      Name of the host to which the job was submitted (delimited
      by a dot).  The default is the local host.

      cluster id



 Page 1                                          (printed 1/21/94)






 llhold()                                                 llhold()



      Cluster id assigned to the job when it was submitted.

      proc id

      (delimited by a dot) is the proc number assigned to the job
      when it was submitted.  The default is to include all
      members of the cluster.

      If you specify neither the -s option nor the -r option, the
      job is placed in user hold.  The administrator can place any
      job in user hold.  The user may only place a job in user
      hold that he or she owns.

      A job can be in both system hold and user hold.

 Examples
      llhold susann.23.0 19.1
      places job 23.0 on host susann and job 19.1 on the local
      host in user hold.

      llhold -r kenneth.23.0 19.1 20.3
      releases jobs kenneth.23.0, 19.1 and 20.3 from a hold state,
      the first located on host kenneth, the latter located on the
      local host.

      llhold -u user1
      places all jobs for user "user1" on the local host in user
      hold.

      llhold -s -u user1
      places all jobs for user "user1" on the local host in system
      hold.  Only the administrator may use the -s option.

      llhold -s -h john
      places all jobs on host john in system hold.

 SEE ALSO
      LoadL_admin LoadL_config llctl LoadL_master llq llcancel
      llsubmit "IBM LoadLeveler: Administration and Installation"
      "IBM LoadLeveler: User's Guide"

 COPYRIGHT INFORMATION
      * (C) COPYRIGHT International Business Machines Corp. 1992
      * All Rights Reserved
      * Licensed Materials - Property of IBM
      *
      * US Government Users Restricted Rights - Use, duplication
      * or disclosure restricted by GSA ADP Schedule Contract with
      * IBM Corp.






 Page 2                                          (printed 1/21/94)