TASK-INFO

File 113
Op-Sys BS2000
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.