list-jobs macro

The list-jobs macro produces a report indicating the status of all phantom controlled processes currently in the dm,jobs, file.

Syntax

list-jobs

Description

The report includes the following headings:

user.md User-ID of the user who submitted the phantom job.
ln Line number from which the job was submitted.
pib Line port number on which the job is queued.
status Current state of the job (for example, queue, running, done, and so on). The number adjacent to the status (enclosed in parentheses) is the total number of seconds the job has been running (or the total number of seconds used if done). Possible status information returned:
abort Job aborted.
done Job completed.
error Error occurred.
logoff Phantom was prematurely logged off prior to job completion.
queue Job is in the queue, waiting for an available phantom process.
running Job is still running.
start-dt Date the job was submitted.
stop-dt Date the job finished.
tcl-commands command or list of commands submitted.
Note: The hold file entry number for the job is stored in attribute 5 of the item in the jobs file.

If a job is still running but is waiting for a response to a tape prompt, these prompts may display:

Prompt Possible Responses
Parity Error Accept, Retry, Quit
Block Transfer Incomplete Accept, Retry, Quit
Media Write Protected Continue, Quit
Incorrect reel Continue, Overwrite, Quit
Reel Was Labeled Continue, Overwrite, Quit
Reel Was Unlabeled Continue, Overwrite, Quit
Need To Do Full Save Full save, Quit
Load Next Volume Continue, Quit

Example(s)

list-jobs

PHANTOM   JOBS   STATUS   AT      10:09:07 04 Feb 2003          PAGE 1
user-md   ln.    pib      status..     start-dt..    stop-dt....   tcl-command..
pxp pxp   1      122      done(3)      12/04 10:08   12/04 10:09   pxpjob x25p56
pxp pxp   1      121      done(12)     12/04 10:08   12/04 10:09   pxpjob x25p78
pxp pxp   1      120      done(7)      12/04 10:08   12/04 10:08   pxpjob x25p88