# 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](https://d3codex.com/tcl/clear-jobs-command/)
- [dcd command](https://d3codex.com/tcl/dcd-command/)
- [end command (TCL commands)](https://d3codex.com/tcl/end-command-tcl-commands/)
- [job-status command](https://d3codex.com/tcl/job-status-command/)
- [jobs file](https://d3codex.com/systemfiles/jobs-file/)
- [Options (TCL)](https://d3codex.com/tcl/options-tcl/)
- [Background/Phantom process overview](https://d3codex.com/backgroundphantomprocess/background-phantom-process-overview/)
- [phantom-reset command](https://d3codex.com/tcl/phantom-reset-command/)
- [phantom-status command](https://d3codex.com/tcl/phantom-status-command/)
- [startsched command](https://d3codex.com/backgroundphantomprocess/startsched-command/)
- [stopsched command](https://d3codex.com/tcl/stopsched-command/)
- [z command (Background/Phantom process commands)](https://d3codex.com/backgroundphantomprocess/z-command-background-phantom-process-commands/)

---
Source: https://d3codex.com/tcl/list-jobs-macro/ - part of the D3Codex reference.