J (Job and Task Display)

The J (Job and Task Display) command lists active jobs, tasks, database stacks, and freeze control libraries by job structure.

Syntax

<wild card>

<delim>

Use one of the following characters

/ \ I ~ ! @ # $ % ^ & * '

The first delimiter must be the same as the second delimiter.

<wild-card string>

A string of characters used to search for a task name. The string can include the following special characters.

Character

Description

Equal sign (=)

Matches any sequence of characters

Question mark (?)

Matches any single character

Tilde (~)

Matches any sequence of characters except a slash (/)

The wild-card string is automatically uppercased, except for characters enclosed in quotation marks, and the system stops processing the string when it encounters a space character.

You can include lowercase characters and space characters by prefixing the wild-card string with LIT and enclosing the wild-card string in delimiters.

For example, if you enter the following syntax, the system returns entries that contain the string "PACK":

J NAME =pack=

If you enter the following syntax, the system returns entries that contain the string "pack":

J NAME LIT^=pack=^

Explanation

J

JOBS

Display any active jobs or tasks that have not been suppressed by the SUPPRESS (Suppress Display) command. The J command does not display jobs in the job queue; the SQ (Show Queue) command serves that purpose. The display includes databases and freeze control libraries (but not other types of server libraries).

J ALL

Displays all active jobs or tasks, including any that were suppressed.

J NAME <wild-card string>

Displays the job or all jobs with a name designated by the wild-card string, including any that were suppressed. You can also use all other options with this form of the command.

J MCSNAME = <MCS name>

J MCS = <MCS name>

Display only jobs or tasks originating from the specified MCS. The equal sign (=) is optional.

J QUEUE J Q

Display active jobs or tasks in all queues.

J QUEUE <queue number>

J Q <queue number>

Display only jobs or tasks from the specified queue.

J USER <usercode>

Displays only jobs or tasks running with the specified usercode.

Examples

Example 1

This example shows the response to a simple inquiry:

J
  ---Mix-Pri---------------- JOB ENTRIES -------------------
  * 4591  50       (MACS) JOB BIND/CTLR36
  E 4592  50       ..(MACS) *BINDER (MACS)SYSTEM/MCP/CTLR
    4579  5        (KAY) JOB TEST/PORTFILE
    4581  50 W     ..(KAY) *ALGOL (KAY)OBJECT/TEST/PORTFILE
    4473  80   Job *SYSTEM/CANDE
    4538  50       ..(GEORGE) *OBJECT/ED
    4507  50 S     ..(NORM)OBJECT/PATCH/NED ON ODESY
    4477  80       ..*CANDE/STACK01
    4462  80       ..*SYSTEM/COMS
    4468  50       ....MARC
    4460  80       ..COMS/TANK
    4459  80       ..COMS/INPUT
    4452  50   Job *SYSTEM/PRINT/ROUTER

The heading line appears on the first page of the job and task display and before the job and task entries in automatic display mode (ADM).

At the beginning of each entry line, an E indicates that a syntax error was discovered during compilation. An asterisk (*) indicates that the task is being displayed for the first time.

The job or task number is shown in the Mix field.

The Pri field shows the priority of the job or task; the priority can be followed by a waiting (W) or scheduled (S) flag.

The next column contains the word Job if the task has no parent, Lib if the task is a library process, or DBS if the task is a database stack. Otherwise the column is blank.

The next column contains the job or task name of each entry.

A task initiated by a job or another task is indented by two dots under its parent. The system can display from one to five levels of indentation. If the parent task is suppressed, it is displayed only if the ALL option is used.

The usercode of the originator appears before the job or task name. Some tasks and jobs can have two usercodes shown for the following reasons:

  • One usercode indicates the USERCODE attribute of the task or job.

  • The other usercode is part of the NAME attribute of the task or job. This usercode is one of the following:

  • The usercode that the code file is stored under (an external procedure).

  • The usercode that the parent of the task or job had when the system initiated the task or job (an internal procedure).

Compiler tasks display with the following format:

<task usercode> <compiler name> <code file name>

Tasks other than compiler tasks display with the following format:

<task usercode> <task name>

Example 2

This example shows the command and response for the USER option when no usercode is specified. The command lists the programs running without a usercode.

J USER=""
  ---Mix--Pri----------------JOB ENTRIES USER= ----------------
    3936   50   Job *SYSTEM/PRINT/ROUTER ON DMSIITEST
    3935   50       ...KEYEDIOII/STRUCTURES00
    3937   50       ..*SYSTEM/PRINT/BNAROUTER ON DMSIITEST
    3932   80       ..PRINT/WORKER
    3904   75       ..SYSTEM/STATION/TRANSFER
    3875   80       ..SYSTEM/DSS/ROUTER
    3862   75       ..SYSTEM/NETWORK/SERVICES/MANAGER
    3901   75       ....SYSTEM/LCF
    3850   80   Job *SYSTEM/CANDE ON DMSIITEST
    3900   80       ..*CANDE/STACK01
    3889   80       ..*SYSTEM/COMS ON DMSIITEST
    3893   50       ....MARC
    3892   50       ....MARC
    3887   80       ..COMS/TANK
    3886   80       ..COMS/INPUT
    3938   75       *REMOTESPO