Video Systems Reference Manual
Status Display Extension

Document Identifier: A-DS-EL00070-14-0 Rev AX01 26-Oct-1990

Abstract

This document describes the interface to video terminals implementing a distinct on screen status display. It specifies both the application program interface to select and control the status display, and the user interface including general appearance of the status display. The Status Display forms an extension to Level 2 and is required at Level 3 or higher of the Character Cell Display service classes.

Applicability

Mandatory for Engineers designing hardware for terminal products and Software Engineers designing programs using terminal interfaces. Additional requirements are defined in the DEC STD 070-1 Concepts and Conformance Criteria.

Status

FOR REVIEW ONLY

type $ VTX SMC for expiration date.

This document is confidential and proprietary. It is an unpublished work protected under the Federal copyright laws.

Copyright (c) Digital Equipment Corporation. 1990. All rights reserved.

Digital Internal Use Only 

Title
VSRM - STATUS DISPLAY EXTENSION
Document Identifier
A-DS-EL00070-14-0 Rev AX01, 26-Oct-1990
Revision History
Original Draft
VT340 Functional Spec23-Oct-1985
Revision AX0126-Oct-1990
Document Management Group
Terminal Interface Architecture (STI)
Responsible Department
VIPS Terminals Architecture
Responsible Person
Peter Sichel
SMC Writer
Approval

This standard, prepared by the Desktop Systems Group, has been reviewed and recommended for approval by the general review group for its category.

________________________________________
Peter Sichel, Standard Owner
Video, Image, and Printing Systems

________________________________________
Eric Williams, Standards Process Manager

Direct requests for further information to Peter Sichel, DSG1-⁠2/⁠C7, DTN 235-8374, HANNAH::TERMARCH

Use VTX SMC to order copies of this document from Standards and Methods Control. Send distribution questions to JOKUR::SMC or call DTN: 287-3724.

Contents

Chapter 14
Status Display Extension

  1. Introduction14-4
  2. Functional Description14-4
    1. Appearance of the Status Display14-4
      1. Error Line14-5
      2. Indicator Status Line14-5
      3. Implementation Guidelines for Indicators14-6
    2. Operation of Host Writable Status Line14-7
    3. Effect of ANSI controls on the Status
      Display
      14-8
    4. Transmission of the Status Display14-10
    5. Behavior of the Status Display in VT100
      (Level 1) and VT52 Mode
      14-10
  3. Control Functions14-11
  4. Change History14-13
    1. Original draft to REV AX0114-13

14.1 Introduction

The Status Display is a Level 3 feature (Level 2 extension) which provides the ability to display at least one additional line of 80 characters underneath the main display. The Status Display may be configured as Host Writable to form a separately addressed Logical Display, or as an Indicator Line to display local terminal state information.

14.2 Functional Description

Level 3 or higher conforming devices shall allow an additional line of characters to be displayed on the screen as a Status Display. The Status Display shall be one or more lines high and contain the same number of columns as the main Logical Display (usually 80 or 132).

The type of Status Display can be selected by host control function or from Set-Up as one of the following: (1) No Status Line (factory default); (2) Indicator Status Line (not mandatory for workstation or PC terminal emulators); (3) Host Writable Status Line. The type Status Display selected is saved in non-⁠volatile memory (if available), so it becomes the power-up default.

The Indicator Status Line is required on traditional video terminals, but is not mandatory for workstation or PC terminal emulators because local device information is often maintained separately from the terminal in these implementations.

The Indicator Status Line is always selected while in Set-Up. If the terminal needs to display an error or warning message, the Indicator Status Line is temporarily replaced with the Error Line until the next keystroke.

The Host Writable Status Line can be considered a permanent separate logical display, that contains its own ANSI text state and settings. In general, controls which affect some portion of the Main Display do not affect the contents or the ANSI state of the Status Display. Exceptions are noted in this section (DEC STD 70-14). The cursor may not be positioned within the Status Display, unless the DECSASD (Select Active Status Display) command is issued.

14.2.1 Appearance of the Status Display

When the Status Display is disabled, the line where it would appear shall blend into the display border. Guidelines: On a non-over-scanned non-windowed display, the area should appear black; On an over-scanned non-windowed display, the area should appear the same as the screen background; On a windowed display, the size of the terminal window may change to include the status line. Visual side effects caused by enabling or disabling the Status Display should be minimized.

When the Indicator Status Line is enabled, it's background is the reverse of the Main Display background as indicated by the setting of Screen Mode (DECSCNM).

When the Host Writable Status Line is enabled, it has the same background as the main display. The reverse video character attribute may be used to cause text on the status line to appear in reverse video with respect to the main display. Screen Mode (DECSCNM) changes the background of both the status line and the main display.

If Column Mode (DECCOLM) is changed, the width of the Status Display changes. This will leave 52 blank spaces on the right hand side of the Indicator Status Line in 132 Column Mode. The spacing between indicators will not be increased in 132 Column Mode, however, the host will be able to place more than 80 characters into the Host Writable Status Line in 132 Column Mode.

14.2.1.1 Error Line

The Error Line appears when it is necessary to indicate the result of some local terminal operation that would not otherwise be evident. An error in Set-Up for example, or a change in session management state. The text of the message replaces the currently displayed Status Line (Indicator or Host Writable) or appears if No Status Line is being displayed. The text of the message continues to be displayed until the user presses a key on the terminal keyboard, which restores the contents of the Status Display. The host may not directly program or affect the Error Line.

14.2.1.2 Indicator Status Line

The Indicator Status Line shall contain a number of indicators reflecting the state of the terminal and options attached to the terminal (e.g. printer). The text of the indicators on the Indicator Status Line will be displayed in the Set-Up language. The indicators shall be placed in fixed positions on the Indicator Status Line, and there shall be at least one space (SP, 2/0) character between indicators for legibility.

Indicators are updated asynchronously, as the state of the feature they are monitoring changes. The interval between the change in the state of a feature and the update of the appropriate indicator shall not exceed 80 milliseconds. Indicator changes are not queued: when an indicator is updated on the Status Display, it shall reflect the state of that feature at the time of the update.

The following indicators are required:

  1. Active Session Indicator if the Session Management Extension is present and the indicator is not otherwise available. Indicates the session to which keyboard input is currently directed.

  2. Active Position Indicator. Displays the current cursor position, row and column. Includes the page number if more than one page is available.

  3. Graphics Input Position Indicator if some graphic input mode is enabled through ReGIS, Tektronix, or the Text Locator extension. Indicates the pixel row and column of the input position.

  4. Edit Mode Indicator if the Local Editing Extension is present. Indicates whether Edit Mode (DECEDM) is enabled.

  5. Insert-Replace Mode Indicator if the Local Editing Extension is present and the terminal is in Edit Mode. Indicates whether new characters typed into the Logical Display will be inserted, or overstrike existing characters.

  6. Printer Status Indicator if the Printer Port Extension is present. Indicates the status of the attached printer if any, and the print mode.

  7. Modem Status Indicator if modem control is supported and enabled. Indicates the status of the DSR signal on the communications port.

14.2.1.3 Implementation Guidelines for Indicators

This subsection gives suggested formats for Indicators on the Indicator Status Line based on existing implementations. The VT340 Indicator Status Line might appear as follows (spacing is approximate):

2 1(24,008) Edit Overstrike Mode Printer: None Modem: DSR

The Active Session Indicator is a single digit at the left most edge of the status line indicating the session to which keyboard input is currently directed. Session 2 in the example above.

The Active Position Indicator gives the current page number within Page Memory followed by the cursor row and column number in parenthesis. Page 1, line 24, column 8 in the example above.

The Graphics Input Position Indicator is only visible when graphics input is enabled. The indicator might appear as "⁠[123,456]" pixel row 123, column 456.

The Edit Mode Indicator is only visible when DECEDM is active. The Indicator might appear as "Edit".

The Insert-Replace Mode Indicator toggles between "Overstrike Mode" or "Insert Mode". This indicator need only be displayed while Edit Mode is in effect.

The Printer Status Indicator shows the state of an attached printer if any (see Printer Port Extension). The Printer Status Indicator can take the following values:

  • Printer: None
  • Printer: Ready
  • Printer: Not Ready
  • Printer: Auto Print
  • Printer: Controller

The Modem Status Indicator shows the status of the DSR signal when Modem Control is selected on the communications port. This indicator is not displayed if Modem Controls are not selected on the communications port. The Modem Status Indicator can take the following values:

  • Modem: DSR
  • Modem: No DSR

14.2.2 Operation of Host Writable Status Line

If the Status Display is enabled to a Host Writable Status Line, the host is able to treat the Status Display as a separate Logical Display, generally 1 line by 80 or 132 columns.

To write text into the Host Writable Status Line, the host must issue the DECSASD (Select Active Status Display) command. A typical operation by the host would be to send a DECSASD command to switch to the Host Writable Status Line, send a line of text to the line, and then send another DECSASD command to return to the Main Display.

A separate ANSI state is maintained for the Host Writable Status Line. For example, the Status Line could have the USASCII invoked into G0, while the Main Display has the Line Drawing character set invoked into G0. When the DECSASD command is recognized, the terminal must switch and use the correct state information for the Host Writable Status Line or the Main Display. The following information is maintained separately for the Host Writable Status Line and the Main Display:

  • Active Position
  • Current Graphic Rendition (and other character attribute values)
  • Origin Mode
  • the currently designated G0, G1, G2, and G3 sets
  • the currently invoked GL and GR sets
  • the single shift (SS2, SS3) states
  • the Auto-Wrap flag
  • Cursor Save Buffer (DECSC and DECRC)

14.2.3 Effect of ANSI controls on the Status Display

Several ANSI control functions affect both the Main Display and the Status Display. When the Host Writable Status Line is selected, as described above, any data received by the terminal is placed into the Status Display, and most ANSI control functions received will affect only the Status Display. There are some control functions which are executed differently, depending on whether the active position is in the Main or Status Display.

  1. C1 Transmission
    The 7-bit or 8-bit transmission selection affects both the Main and Status Displays.

  2. Character Set Selection
    An independent state is maintained for the invoked and designated character sets, as well as the associated shift states.

    The User-Preference Supplemental Character Set selection affects both the Main and Status Displays.

  3. Cursor Position Controls
    If there is only one row in the Status Display, only the column parameters in cursor positioning control functions (e.g. CUP, etc.), or commands which affect areas dependent on character positions (e.g. ED, DCH, etc.) are significant. Horizontal cursor positioning commands (e.g. CUF, CUB) are recognized, but vertical cursor positioning commands (e.g. CUD, CUU) are ignored. The line number shall be reported as 1, when necessary.

  4. DECANM - ANSI/VT52 Mode
    This sequence is ignored if received in the Status Display. If received in the Main Display, the contents of the Host Writable Status Line are left unchanged. If and when the VT52 Mode Enter ANSI Mode command is issued, the contents of the Host Writable Status Line are left unchanged.

  5. DECCOLM - Colomn mode
    DECCOLM affects both the Main Display and the Status Display simultaneously. The number of columns in the Host Writable Status Line cannot be independently controlled. Receipt of this sequence will clear both the Main Display and the Host Writable Status Line. The Status Display cursor is moved to the home position.

  6. DECRQSS - Request Selection or Setting
    The Status Display Type (DECSSDT) and Active Status Display (DECSASD) may be queried through DECRQSS.

  7. DECSASD - Select Active Status Display
    This control function is the recommended method to exit the Status Display.

  8. DECSCL - Select Conformance Level
    Select Conformance Level performs a Soft Terminal Reset (see DECSTR below).

  9. DECSCLM - Scrolling Mode
    This mode affects both the Main and Status displays.

  10. DECSCNM - Screen Mode
    The Main Display and the Status Line are affected by the setting of this Mode. The screen mode of the Host Writable Status line cannot be independently controlled.

  11. DECSCPP - Set Columns Per Page
    DECSCPP affects both the Main Display and the Status Display simultaneously. The number of columns in the Host Writable Status Line cannot be independently controlled.

  12. DECSSDT - Select Status Display Type
    If the Status Display Type is chosen to be something other than "Host Writable", the Status Display will be exited, and the selected Status Display Type will be imaged (either "Indicator" or "None").

  13. DECSTR
    The Status Display will be exited, but not erased.

  14. DECTCEM - Text Cursor Enable Mode
    Each of the Main and Status Display cursors may be individually enabled or disabled.

  15. Format Effectors (BS, LF, VT, FF, IND, NEL, etc.)
    Affect only the Status Display. If scrolling occurs as a result of a Format Effector, a single line Host Writable Status Line is erased.

  16. IRM - Insert Replace Mode
    Insert/Replace Mode affects both the Main and Status displays.

  17. Keyboard Functions
    All keyboard functions are executed regardless of the selected display (Main or Status).

  18. Printer Functions
    All printer functions are executed regardless of the selected display (Main or Status).

  19. RIS - Reset to Initial State
    The Status Display will be erased and exited.

  20. Tabs
    Tabulation stops affect both the Main and Status displays.

14.2.4 Transmission of the Status Display

The characters in the Status Display can be transmitted to the printer by "Print Composed Main Display". Print Page and Auto Print Mode will never transfer characters on the Status Display.

14.2.5 Behavior of the Status Display in VT100 (Level 1) and VT52 Mode

When VT100, or VT52 mode is entered, the Status Display will remain visible, if it was enabled. The sequences which program or change the type of the Status Display will not be recognized, therefore the type of Status Display may not be changed from the host in these modes. Sequences which globally affect the Status Display will still affect the Status Display, and the Status Display type may be changed from Set-Up.

The Indicator Status Line will remain visible in Set-Up mode.

14.3 Control Functions

Select Active Status Display DECSASD

Levels: 2x, 3, 4

Purpose: Select whether new characters are written to the Main Display or the Status Display.

Format:

CSI  Ps  $    }
9/11     2/4  7/13

Description: Causes the selection of the active status display, either the Main Display, or Status Display (also called the Host Writable or Remote Status Line). The display is specified by the selective parameter, Ps:

PsDisplay
0Main Display (default)
1Host Writable Status Line

Note that the Host Writable Status Line must be selected through DECSSDT for DECSASD to be able to select the Host Writable Status Line.

Select Status Display Type DECSSDT

Levels: 2x, 3, 4

Purpose: To select the type of status line to be displayed: indicator; host-writable; or none.

Format:

CSI  Ps  $    ~
9/11     2/4  7/14

Description: This sequence allows the host to choose the type of Status Line that is displayed. The type of Status Display depends on the value of the selective parameter:

PsStatus Line Type
0No Status Line
1Indicator (Local) Status Line
2Host Writable (Remote) Status Line

Notes:

  • If Ps is omitted, it is assumed to be 0, which will disable the Status Display.

  • When the Status Line Type is changed, it is initialized. Specifically, this means that the Host Writable (Remote) Status Line is cleared, and the Indicator (Local) Status Line is set to the Set-Up indicators, and will show the current status of the terminal.

  • This control has no effect on the Status Line displayed in Set-Up Mode; the Indicator Status Line is always displayed in Set-Up Mode.

  • The type of Status Line can also be changed through a Set-Up field.

  • The Status Display type may not be "locked" as a User-⁠Preference Feature.

14.4 Change History

14.4.1 Original draft to Rev AX01

  1. Added Abstract and Introduction.

  2. Status Display is an extension to Level 2. DECSSDT and DECSASD do not work in Level 1 (VT100 mode).

  3. Listed all sequences which affect status line including DECCOLM and DECSCPP.