swjob.1m (2010 09)

s
swjob(1M) swjob(1M)
• Logfile Listing
Default Listing
If
swjob is invoked with no options or operands, it lists all jobs that are on the local host. This listing
contains one line for each job. The line includes the job tag attribute and all other attributes selected via
the one_liner option.
Listing jobs on a remote controller is not supported. If a jobid is given, information for only that job is
displayed.
Status Listing
If a
-R or @ target_speci fication is given, the targets for that job and their status are displayed. By
default the status information includes Type, State, Progress and Results.
Logfile Listing
One of the attributes "log" encompasses a variety of logfile types. The type of logfile returned when the
-a log attribute is given depends on the operands given. The types of logfiles:
No target_selections Show the controller logfile (default).
@ target Show the agent logfile.
RETURN VALUES
The
swjob command returns:
0 The job information was successfully listed or the job was successfully removed.
1 The list /remove operation failed for all jobids .
2 The list /remove operation failed for some jobids .
DIAGNOSTICS
The
swjob command writes to stdout, stderr, and to the agent logfile.
Standard Output
All listings are printed to stdout.
Standard Error
The
swjob command writes messages for all WARNING and ERROR conditions to stderr.
Logging
The
swjob command does not log summary events. It logs events about each read task to the
swagent
logfile associated with each target_selection.
swagentd Disabled
If the
swagentd daemon has been disabled on the host, it can be enabled by the host’s system adminis-
trator by setting the SW_ENABLE_SWAGENTD
entry in /etc/rc.config.d/swconfig to
1 and exe-
cuting
/usr/sbin/swagentd -r.
EXAMPLES
To list all of the jobs that exist on the local host:
swjob
To show the scheduled date for job hostA-0001:
swjob -a schedule hostA-0001
For job hostA-0001 list the targets and their status:
swjob -R hostA-0001
or
swjob hostA-0001 @ *::*
For job hostA-0001 list the controller log:
swjob -a log hostA-0001
For job hostA-0001 list the targetA agent log:
swjob -a log targetA-0001 @ targetA
6 Hewlett-Packard Company − 6 − HP-UX 11i Version 3: September 2010