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

See Also

clear-jobs Command, dcd Command, end Command, job-status Command, jobs File, Options, Overview, phantom-reset Command, phantom-status Command, startsched Command, stopsched Command, z Command