ADM (Automatic Display Mode)

The ADM (Automatic Display Mode) command lets you start or stop automatic display of current system status information on the same ODT at which the ADM command is entered. ADM settings can be changed at any time from the ODT. Automatic display is useful for monitoring the status of scheduled and completed entries, jobs in the mix, libraries, database stacks, peripheral units such as line printers, queue settings, messages from the operating system, and other automatic display information.

Two different modes exist: event-driven automatic display mode (ADM) and time-driven ADM. With event-driven ADM, any new event for which an option has been specified is automatically reflected in the updated display. The default delay time for event-driven ADM is 10 seconds. Time-driven ADM updates its display at specified intervals.

Syntax

──ADM─┬────────────────────────────────────────────────────┬───┤
      ├─ - ────────────────────────────────────────────────┤
      ├─ ST ───────────────────────────────────────────────┤
      ├─ OK ───────────────────────────────────────────────┤
      ├─ GO ───────────────────────────────────────────────┤
      │       ┌─◄────────────────────────────────────────┐ │
      ├─────┬─┴─ (<timed options>) ─┬─ <number> ───────┬─┴─┤
      ├─ + ─┘                       └─ DELAY <number> ─┘   │
      │               ┌─◄──────────── , ────────────┐      │
      ├─────┬─ EVENT ─┴─┬─ C ─────────────────────┬─┴──────┘
      └─ + ─┘           ├─ COMPLETED ─────────────┤
                        ├─ MESSAGES ──┬─┬─────────┤
                        ├─ MSG ───────┘ └─ NW ────┤
                        ├─ PER ── <device type> ──┤
                        ├─ <mix display command> ─┤ 
                        └─ /1\ ─ DELAY <number> ──┘
 

<timed options>

<mix display command>

<mix display option>

Explanation

ADM

Displays the current ADM options under which the ODT is operating. If ADM is canceled, this command sets up ADM with the following default options:

ADM (A7, W3, S2, C5, MSG) DELAY 4.

ADM −

Cancels ADM. Any options set up for the ODT are discarded and the default setting is used for all subsequent initiations of the ADM command.

ADM ST

Stops ADM. ADM instructions are retained but are not executed.

ADM OK

ADM GO

Resume ADM. OK is used after ADM ST, and also to restart ADM after a program has opened a file that the system has assigned to that ODT and is still using it.

ADM (<timed options>)

If the first item following ADM is a left parenthesis, ADM unconditionally displays the described pages after the specified time interval. In the time-driven mode, each group of timed options enclosed in parentheses specifies one page of an ADM display. Each page is automatically updated and displayed after the interval specified by DELAY.

You can specify multiple pages of time-driven ADM by entering more than one group of timed options enclosed in parentheses. The display rotates from one page to the next.

Information for the MSG (Display Messages) option is restricted to a maximum of 42 lines of messages, regardless of the number of lines specified.

A list of the items that can be displayed as timed options follows. The syntax for each option except PS is the same as for its system command counterpart.

Option

Meaning

A

Active entries

ASD

ASD table usage information

C

Completed mix entries

CU

CU AVAIL

System memory usage entry (core usage)

DBS

Active database stacks

JOBS

Job structure

LIBRARIES

Frozen library stacks

LIBS

Synonymous with LIBRARIES

MESSAGES

MESSAGES NW

Most recent messages from the system. If the NW option is specified, only networking messages are displayed. If the NW option is not specified, only non-networking messages are displayed.

Note: The setting of the CONTROLLER option SEPARATEMSGS at the time that the message is received determines whether the messages appear in the MSG or MSG NW list. Refer to the CO (CONTROLLER Options) command.

MIX

Mix entries by job structure (also includes RSVP and DISPLAY messages)

ML

Summary of all queues

MSG

Synonymous with MESSAGES

MX

Synonymous with MIX

O

System overlay utilization

PER

Peripheral entries (must be specified by device)

PS

Print System status (same as PS STATUS)

S

Scheduled entries

U

System utilization

W

Waiting entries

ADM + (<timed options>)

Adds the new ADM instruction to the current ADM specification, which must be a time-driven ADM.

<number>

The number in the timed options syntax diagram specifies the number of lines to allow for each item displayed. Two or more lines must be specified for each category because the heading occupies one line. Lines need not be specified for the last entry on a page; if lines are not specified, that entry fills the rest of the page. For ASD (Actual Segment Descriptor), CU (Core Usage), O (Overlay), PS (Print System status), and U (System Utilization) options, the complete information is displayed regardless of the value specified for the number. If there are insufficient lines available on the page, the excess information is discarded.

DELAY <number>

Specifies the number of seconds of delay before the next ADM page is to be displayed.

ADM EVENT

If the first syntactical item following ADM is the word EVENT, the system automatically updates the appropriate screen display when a change occurs in the status of one of the named displays. For example, if the command ADM EVENT W is entered, the waiting mix list page is displayed whenever the system stops a task requiring operator attention. No matter how frequently events occur, messages are displayed only at intervals of DELAY <number> seconds, or 10-second intervals if no DELAY is specified. EVENT options are as follows.

Option

Meaning

A

Active entries

C

Completed mix entries

DBS

Active database stacks

JOBS

Job structure

LIBRARIES

Frozen library stacks

LIBS

Synonymous with LIBRARIES

MESSAGES

MESSAGES NW

Most recent messages from the system. If the NW option is specified, only networking messages are displayed. If the NW option is not specified, only non-networking messages are displayed.

Note: The setting of the CONTROLLER option SEPARATEMSGS at the time that the message is received determines whether the messages will appear in the MSG or MSG NW list. Refer to the CO (CONTROLLER Options) command.

MSG

Synonymous with MESSAGES

MIX

Mix entries by job structure (also includes RSVP and DISPLAY messages)

MX

Synonymous with MIX

PER

Peripheral entries (must be specified by device)

S

Scheduled entries

W

Waiting entries

ADM + EVENT

Adds the new ADM instruction to the current ADM specification, which must be for event-driven ADM.

<mix display option>

Specifies the entries that are eligible for inclusion in the ADM display. The possible options are as follows.

Option

Description

ALL

Displays all entries, including any that were suppressed

SORT CPU

SORT CPURATE

SORT HOLDRATE

Displays entries according to decreasing CPU time used, decreasing CPU processor rate, or decreasing hold rate.

MCSNAME = <MCS name>

Displays only entries that originated from the specified message control system (MCS)