js.pl - NetBackup job status reporting
js.pl [-v] [-r|-l] [-j <jobfile>] [-ef] [-aA] [-o <order>] [-x] [-t <policy-type>] [-c <policy>] [-C <client>] [-O <OS>] [-M <master>]
In the vein of ps js.pl lists the currently running NetBackup jobs. However, it is also capable of regurgitating the fate of jobs already completed by using the -a and -A options.
Verbose output only adds the job's schedule to the output display.
By default, js.pl only lists active jobs. With the -a option it lists inactive (more commonly known as completed) jobs as well.
By default, js.pl only lists jobs from the past 24 hours of operation. Setting -A lists all jobs in the NetBackup job database.
The most common way to list NetBackup jobs is in descending job-id order, i.e. the most recent jobs first. The -o option allows for two other orderings, namely speed and client. Speed ordering lists jobs from fastest to slowest; client ordering lists jobs by client, leaving the original reverse chronological ordering intact as much as possible.
The standard fixed width column output format can be exchanged for XML data by setting the -x option. XML data can easily be viewed in web browsers and is also manipulatable in Excel.
This option enables the logging of the raw job data transmitted from the NetBackup master being monitored to a file in the user's home directory called ".alljobs.allcolumns". This can then be used with the -r option to replay the session.
Report on a set of data previously logged using the -l option.
Using -r without the -j option will result in a replace of the data contained in the file ~/.alljobs.allcolumns, i.e. the location where the -l dropped off the last recorded session. When reaching farther back in time, copies of these job logs can be maintained and replayed by overriding the file being reported on.
More detailed job error information will be displayed when this option is given. NetBackup's bperror command is used to retrieve this additional data but its output is distilled some to keep the display more compact.
Those jobs with explicit file lists, the list is displayed below the job information. In cases where the jobs list consists of the directive "ALL_LOCAL_DRIVES", the list is expanded to the actual set of mounts/drives assigned to each job. ("NEW_STREAM" directives are filtered out.)
The -j option should be made more intelligent so it can pull a collection of job history files from a directory.
Winkeler, Paul pwinkeler@pbnj-solutions.com
Copyright (C) 2002 Paul Winkeler
To install NBU, copy and paste the appropriate command in to your terminal.
cpanm
cpanm NBU
CPAN shell
perl -MCPAN -e shell install NBU
For more information on module installation, please visit the detailed CPAN module installation guide.