Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

vm-install-jobs(8) [suse man page]

vm-install-jobs(8)					      System Manager's Manual						vm-install-jobs(8)

NAME

       vm-install-jobs - queries and manages VM creation jobs that were started by vm-install

SYNOPSIS

       vm-install-jobs [options ...]

DESCRIPTION

       VMs  may  be  created  by  vm-install interactively, or as backgrounded jobs.  The vm-install-jobs command manages backgrounded VM creation
       jobs.

OPTIONS

       --cancel job-id
	      Cancels the specified job.  If the VM is still running, it is stopped.  This command may return before the VM is completely  stopped
	      or  the  vm-install  process  has  completely  exited.   The  job is not implicitly deleted, so that the cancelation progress may be
	      observed.

       --delete job-id
	      Deletes the specified job.  The job must be in one of the FINISHED, FAILED, or CANCELED states.  The VM's configuration is  deleted,
	      as are any disks that were created during the job.

       --detach job-id
	      Detaches the created VM from the specified job.  The job must be in the FINISHED state.  The job is deleted, but the VM's configura-
	      tion and its disks are left intact.

       --list Lists all known VM creation jobs, by ID.	One job ID is output per line.

       --status job-id
	      Outputs the status of the specified job.

JOB STATES

       Every job is always in one of the following states:
	       0: SETTINGS
	       1: PREP_INSTALL
	       2: INSTALL
	       3: POST_INSTALL
	       4: RUNTIME_CONF
	       5: RUNTIME
	       6: FINISHED
	       7: FAILED
	       8: CANCELED

       The normal progression is from state 0 to state 6.  States 6, 7, and 8 are terminal states.

JOB STATUS

       Querying the job status will print (to stdout) a number of key/value pairs.  The possible keys and their meanings are:

       exit   The exit code of the VM creation job.  This key is only present once the job is in one of the states FINISHED, FAILED, or  CANCELED.
	      To interpret the meaning of the exit code, see vm-install(8)

       id     The job ID.  Always present.

       inotify
	      A filename to monitor (via inotify(7) ) for state changes.  The recommended inotify mask to use is IN_CLOSE_WRITE.  Always present.

       log    The location of the log file.  Always present.

       pid    The  process  ID	of  the  VM  creation job.  This key is only present if the VM creation process is still running.  The PID is used
	      internally to cancel the job.

       state  The job's current state.	See JOB STATES.  Always present.

       uuid   The VM's UUID.  This key is only present once all of the VM's settings have been gathered.

       vnc    The last known location to view the VM's console via VNC.  Note that the presence of this key does not guarantee that the VM is cur-
	      rently  running.	 When  no  authentication is necessary, the URL will be ip::port.  If authentication is necessary, the URL will be
	      username:password@ip::port.

DIAGNOSTICS

       A zero exit code indicates success; non-zero indicates failure.

       Note that the exit code of this tool indicates the success of the job management command.  It does not represent the success or failure	of
       the job itself.

SEE ALSO

       To interpret the exit code of a job or of this command, see vm-install(8)

       To monitor state changes of jobs, see inotify(7)

       To report problems with this software or its documentation, visit http://bugzilla.novell.com

								    2007-02-01							vm-install-jobs(8)

Check Out this Related Man Page

QSTAT(1)						User Contributed Perl Documentation						  QSTAT(1)

NAME

       qstat - display job/partition information in a familiar pbs format

SYNOPSIS

       qstat [-f] [-a|-i|-r] [-n [-1]] [-G|-M] [-u user_list] [-? | --help] [--man] [job_id...]

       qstat -Q [-f]

       qstat -q

DESCRIPTION

       The qstat command displays information about jobs.

OPTIONS

       -a  Displays all jobs in a single-line format. See the STANDARD OUTPUT section for format details.

       -i  Displays information about idle jobs. This includes jobs which are queued or held.

       -f  Displays the full information for each selected job in a multi-line format. See the STANDARD OUTPUT section for format details.

       -G  Display size information in gigabytes.

       -M  Show size information, disk or memory in mega-words.  A word is considered to be 8 bytes.

       -n  Displays nodes allocated to a job in addition to the basic information.

       -1  In combination with -n, the -1 option puts all of the nodes on the same line as the job id.

       -r  Displays information about running jobs. This includes jobs which are running or suspended.

       -u user_list
	   Display job information for all jobs owned by the specified user(s). The format of user_list is: user_name[,user_name...].

       -? | --help
	   brief help message

       --man
	   full documentation

STANDARD OUTPUT

       Displaying Job Status

       If the -a, -i, -f, -r, -u, -n, -G, and -M options are not specified, the brief single-line display format is used. The following items are
       displayed on a single line, in the specified order, separated by white space:

       the job id
       the job name
       the job owner
       the cpu time used
       the job state
	   C -	Job is completed after having run E -  Job is exiting after having run.  H -  Job is held.  Q -  job is queued, eligible to run or
	   routed.  R -  job is running.  T -  job is being moved to new location.  W -  job is waiting for its execution time (-a option) to be
	   reached.  S -  job is suspended.

       the queue that the job is in

       If the -f option is specified, the multi-line display format is used. The output for each job consists of the header line: Job Id:  job
       identifier followed by one line per job attribute of the form: attribute_name = value

       If any of the options -a, -i, -r, -u, -n, -G or -M are specified, the normal single-line display format is used. The following items are
       displayed on a single line, in the specified order, separated by white space:

       the job id
       the job owner
       the queue the job is in
       the job name
       the session id (if the job is running)
       the number of nodes requested by the job
       the number of cpus or tasks requested by the job
       the amount of memory requested by the job
       either the cpu time, if specified, or wall time requested  by the job, (in hh:mm)
       the job state
       The amount of cpu time or wall time used by the job (in hh:mm)

EXIT STATUS

       On success, qstat will exit with a value of zero. On failure, qstat will exit with a value greater than zero.

perl v5.14.2							    2012-04-10								  QSTAT(1)
Man Page