TASK-INFO

#### Search Results

Search

# TASK-INFO

File | 113
Op-Sys | BS2000 Note Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.
Statement | `FIND`
Task | Display information on the specified task.

## Common Fields for all Operating Systems

Dictionary Field Name | F/L | Mu | DE | Remarks
--- | --- | --- | --- | ---
`ERROR-CODE` | N3 |  |  |
`ERROR-TEXT` | A58 |  |  |
`NODE` | N5 |  | D |
`NODE-NAME` | A16 |  | D |
`SYSTEM-MESSAGE-CODE` | A10 |  |  |
`SYSTEM-CODE` | B2 |  |  |
`JOB-NUMBER` | N7 |  | D | Required if no `JOB-ID` is given.
`JOB-ID` | A8 |  | D | Required if no `JOB-NUMBER` is given.
`JOB-NAME` | A8 |  |  |
`TYPE-NUMBER` | N1 |  |  |
`STATUS` | A9 |  |  |
`PRIORITY` | N3 |  |  |
`USER` | A8 |  |  |
`ACCOUNT-NUMBER` | A8 |  |  |
`CPU-USED` | N7.2 |  |  |
`UNPEND-CODE` | N4 |  |  |
`TASK-QUEUE-NUMBER` | N3 |  |  |
`LAST-COMMAND` | A12 |  |  |
`SIZE` | A6 |  |  |
`LOADED-PROGRAM` | A64 |  |  |
`PRINT-FILE-NAME` | A54 |  |  |
`PRINT-ELEMENT` | A64 |  |  |
`PRINT-ELEMENT-TYPE` | A8 |  |  |
`PRINT-ELEMENT-VERSION` | A24 |  |  |
`NUMBER-OF-PRINTED-LINES` | N6 |  |  |
`PRINT-ERROR-MESSAGE` | A10 |  |  |
`PRINT-FORM` | A8 |  |  |
`COPIES` | N3 |  |  |
`ORIGINATOR-TSN` | N5 |  |  |
`CPU-MAX` | N7.2 |  |  |
`DEVICE` | A8 |  |  |
`ORIGINATOR-JOB-ID` | A8 |  |  |
`NUMBER-OF-PRINTED-PAGES` | N6 |  |  |
`LOGON-DATX` | D |  |  |
`LOGON-TIMX` | T |  |  |
`HOLD` | A3 |  |  |

## Relevant Error Codes

Code | Text | BS2000
--- | --- | ---
724 | Requested job not found. | X
728 | You are not allowed to see this job. | X
799 | Entire System Server internal error. | X
988 | Invalid task type detected. | X

## Field Descriptions

Field Name | Type/Length | Operating System
--- | --- | ---
`ACCOUNT-NUMBER` | (A8) |

Account number of job for Task Types 1 - 3.

Field Name | Type/Length | Operating System
--- | --- | ---
`COPIES` | (N3) |

Number of copies for print jobs.

Field Name | Type/Length | Operating System
--- | --- | ---
`CPU-MAX` | (N7.2) |

CPU time limit for the job, for Task Types 1 - 3.

Field Name | Type/Length | Operating System
--- | --- | ---
`CPU-USED` | (N7.2) |

CPU time already used by the task for Task Types 2 and 3.

Field Name | Type/Length | Operating System
--- | --- | ---
`DEVICE` | (A8) |

Printer device name.

Field Name | Type/Length | Operating System
--- | --- | ---
`HOLD` | (A3) |

For Task Type 2 (see `TYPE-NUMBER`): `YES`, if job is in hold, or `NO`.

Field Name | Type/Length | Operating System
--- | --- | ---
`JOB-ID` | (A8) |

Alphanumeric TSN of job.

Field Name | Type/Length | Operating System
--- | --- | ---
`JOB-NAME` | (A8) |

Name of job.

Field Name | Type/Length | Operating System
--- | --- | ---
`JOB-NUMBER` | (N7) |

TSN of job.

Field Name | Type/Length | Operating System
--- | --- | ---
`LAST-COMMAND` | (A12) |

Last command executed by the task. For Task Types 2 and 3.

Field Name | Type/Length | Operating System
--- | --- | ---
`LOADED-PROGRAM` | (A64) |

For Tasks Types 2 and 3: name of loaded program.

Field Name | Type/Length | Operating System
--- | --- | ---
`LOGON-DATX` | (D) |

For Task Types 2 and 3: date of `LOGON` in Natural format.

Field Name | Type/Length | Operating System
--- | --- | ---
`LOGON-TIMX` | (T) |

For Task Types 2 and 3: time of `LOGON` in Natural format.

Field Name | Type/Length | Operating System
--- | --- | ---
`NUMBER-OF-PRINTED-LINES` | (N6) |

For print jobs.

Field Name | Type/Length | Operating System
--- | --- | ---
`NUMBER-OF-PRINTED-PAGES` | (N6) |

For print jobs.

Field Name | Type/Length | Operating System
--- | --- | ---
`ORIGINATOR-JOB-ID` | (A8) |

For print-jobs: alphanumeric TSN of task which started the job.

Field Name | Type/Length | Operating System
--- | --- | ---
`ORIGINATOR-TSN` | (N5) |

For print-jobs: TSN of task which started the job.

Field Name | Type/Length | Operating System
--- | --- | ---
`PRINT-ELEMENT` | (A64) |

Name of printed element.

Field Name | Type/Length | Operating System
--- | --- | ---
`PRINT-ELEMENT-TYPE` | (A8) |

Type of printed element.

Field Name | Type/Length | Operating System
--- | --- | ---
`PRINT-ELEMENT-VERSION` | (A24) |

Version of printed element.

Field Name | Type/Length | Operating System
--- | --- | ---
`PRINT-ERROR-MESSAGE` | (A10) |

Error message issued during `PRINT`. Only relevant for Task Type 7.

Field Name | Type/Length | Operating System
--- | --- | ---
`PRINT-FILE-NAME` | (A54) |

Name of printed file.

Field Name | Type/Length | Operating System
--- | --- | ---
`PRINT-FORM` | (A8) |

For print jobs: name of form used.

Field Name | Type/Length | Operating System
--- | --- | ---
`PRIORITY` | (N3) |

Task scheduling priority.

Field Name | Type/Length | Operating System
--- | --- | ---
`SIZE` | (A6) |

Size of job.
Task Types 2 and 3: program size.

Task Types 4 - 7: size of `SPOOLOUT` file.

Field Name | Type/Length | Operating System
--- | --- | ---
`STATUS` | (A9) |

Task status (`DIALOG`, `TP`, etc.).

Field Name | Type/Length | Operating System
--- | --- | ---
`TASK-QUEUE-NUMBER` | (N3) |

Number of task scheduler queue for Task Types 2 and 3.

Field Name | Type/Length | Operating System
--- | --- | ---
`TYPE-NUMBER` | (N1) |

Numeric job type identifier used in BS2000 (for example, `2` = batch, `3` = dialog). Possible values: `1` - `7`.

Field Name | Type/Length | Operating System
--- | --- | ---
`UNPEND-CODE` | (N4) |

Pend / Unpend code for Task Types 2 and 3.

Field Name | Type/Length | Operating System
--- | --- | ---
`USER` | (A8) |

BS2000 user ID of task owner.

### On this page

- Common Fields for all Operating Systems
- Relevant Error Codes
- Field Descriptions