swm-job(1M)swm-job(1M)NAME
swm job - View, modify, and continue software manager jobs.
SYNOPSIS
option_file] [[job_id]...]
option_file] job_id
attribute] option_file] [[job_id]...]
output_mode] option_file] job_id
DESCRIPTION
The command provides access to jobs that have been created in the past
by using the command. A "job" is a record of an execution of the com‐
mand that modified the software on the system. It contains information
about what command was executed as well as the log of messages produced
by the command.
A job can be in various states, including a "SAVED" state which means
that the job can be continued using either the interactive TUI or com‐
mand line interface.
The keyword following the command indicates what action is to be per‐
formed on the job(s). If no action is specified, then the interactive
job management interface will be invoked. The allowed actions are:
Cancel (kill) a running job.
Continue a saved job.
Delete one or more jobs from the system.
List jobs.
Display the log file of a job to standard output.
Display status of a job.
recognizes the following options:
Displays the usage message.
Displays the available
attributes.
Displays the list of possible
(extended) options.
Launches interactive user interface.
(Mutually exclusive with When used with the job
will be continued in interactive mode. Without
the option, it will continue non-interactively.
When used with all other actions (or when no
action specified), it will cause the job manage‐
ment user interface to be invoked.
Sets preview mode. (Mutually exclusive with -i.)
The verbosity level is decreased by one for each time
is specified. (See also the option).
The verbosity level is increased by one for each time
is specified. (See also the option). When used
with actions, the -v option will provide more
detail about the job(s).
Displays the value of the specified attribute. You may specify
multiple options.
Specifies the output mode as one of the following:
Sets the extended option to a value. See Extended -x Options
definitions below.
Gets the extended options from
option_file. (See the file: for a description
and examples of syntax for this file).
The extended options may be specified on the command line using the
option, in a file specified using the option, or in one of the configu‐
ration files: or If the same option is given in multiple locations, the
following order is prioritized from highest to lowest:
1. Options specified on the command line
2. Options specified within an extended_option_file (-X file)
3. Options specified within the $HOME/.swm.conf file
4. Options specified within the /etc/opt/swm/swm.conf file
Note: If the same option or extended option is given multiple times
with the same location, the last option takes effect. If the option
has a single letter equivalent and both are used on the command line,
the single letter option takes effect. If the single letter option
allows a list of arguments, specifying the single letter option multi‐
ple times will append to the list.
recognizes the following (extended) options:
Usage: Basic
Applicable actions: continue
Protects against inadvertently installing software that requires
a system reboot when SWM is invoked non-interactively (Command
Line). Protects against local system rebooting without user
confirmation when SWM is run interactively. See also the
option.
Software that requires a system reboot can be
installed. All target system(s) will be automatically
rebooted without requiring further confirmation.
If in Command Line mode and software that requires a
system reboot is selected for installation, the install
session will exit with an error message. If in Interac‐
tive mode, software that requires a reboot can be
installed. A confirmation message will be presented
before rebooting the local target system.
Usage: Basic
Applicable actions: continue
Allows user to defer a system reboot. If a reboot is needed,
the user must manually reboot after the software has been
installed.
Defers reboot of system.
Allows SWM to initiate a reboot automatically when -x
auto_reboot=true is set.
Usage: Basic
Applicable actions: cancel continue delete list log status
This is the path to the log file for this command. Each time
SWM is run, this file will grow larger. This can be changed,
for example, to a month-specific location for easier archiving,
off-host backup, and rotation.
Usage: Basic
Applicable actions: cancel continue delete list log status
Specifies the level of message verbosity in the log file (See
also -x verbosity). Legal values are:
Only ERROR messages and the startingending BANNER messages.
Adds WARNING messages.
Adds NOTE messages.
Adds INFO messages (informational messages preceded by the '*'
character).
Adds verbose INFO messages.
Adds very-verbose INFO messages.
Usage: Basic
Applicable actions: cancel continue delete list log status
Specifies the level of stderr verboseness:
Only ERROR messages and the startingending BANNER messages.
Adds WARNING messages.
Adds NOTE messages.
Adds INFO messages (informational messages preceded by the '*'
character).
Adds verbose INFO messages.
Adds very-verbose INFO messages.
Note: The '-v' option is equivalent to increasing ver‐
bosity by 1 (e.g., from 3 to 4) and the '-q' option is
equivalent to decreasing verbosity by 1. The '-v' and
'-q' options can be used more than once.
The job_id as displayed by the various commands is a 6-digit
integer value with leading zeros. For example:
When specifying a job_id to the commands, the value can be
either an integer number (with optional leading zeros), or a
pattern matching expression that can specify one or more jobs.
The expression pattern matching is accomplished using
fnmatch(3C) (See Pattern Matching Notation in regexp(5))
In addition to using a pattern expression for the numeric
job_id, additional attributes can be specified to further qual‐
ify which jobs_ids are matched. This is accomplished by the
syntax:
Where <op> can be one of
For example, to list all jobs newer than 30 days:
When using comparison operators with date/time attributes to
specify absolute date/time, use the time format:
"yyyy[mmdd[hhmm[ss]]]". To specify relative time (in days ago),
use format: "<numeric>d"
Return Values
returns the following values:
Success.
Error.
Warning.
EXAMPLES
To bring up the TUI job management screen:
To list jobs:
To cancel a job named
To continue a suspended job named
To delete a job named
To delete all completed jobs:
To list all jobs with verbose information:
To list all job attributes:
To list just the job_id, major mode, and status of all jobs:
To list all jobs whose status is completed:
To delete all jobs that have an error count greater than 2:
To list jobs through
To list all jobs created after Jan 1, 2005:
To delete all completed jobs that are older than one year:
To show the high level status for two specific jobs:
To get a text version of a particular job's log showing only errors and
warnings:
To get an xml version of a particular job's log:
To get an xml version of a particular job's log on the TUI:
AUTHOR
was developed by HP.
FILES
System-wide SWManager configuration file.
Per-user SWManager configuration file.
Template file that documents each -x option.
Log file.
SEE ALSOswm(1M), swm-oeupdate(1M), swm-install(1M), swm-list(1M), swjob(1M).
swm-job(1M)