TERMINAL

Syntax

── TERMINAL ─┬────────────────────────────────────┬────────────────────┤
             │ ┌◄───────────────────────────────┐ │
             └─┴─┬─ WIDTH ─┬─<integer>────────┬─┴─┘
                 ├─ LINE ──┘                  │
                 ├─ PAGE ──<integer>──────────┤
                 ├─ DOWN ──<integer>──────────┤
                 ├─ BUFFER ────┬─┬────────────┤
                 ├─ MAXOUTPUT ─┘ └─<integer>──┤
                 ├─ UNBUFFERED ───────────────┤
                 ├─ SCREEN ───────────────────┤
                 ├─ HARDCOPY ─────────────────┤
                 ├─ WAIT ─────────────────────┤
                 ├─ CONTINUOUS ───────────────┤
                 ├─ WRAPAROUND ─┬─────────────┤
                 │              ├─ TRUE ──────┤
                 │              └─ FALSE ─────┤
                 ├─ TRAILINGBLANKS ─┬─────────┤
                 │                  ├─ TRUE ──┤
                 │                  └─ FALSE ─┤
                 ├─ FORMSCAPABLE ─┬───────────┤
                 │                ├─ TRUE ────┤
                 │                └─ FALSE ───┤
                 └─ " ──<character>── " ──────┘

Explanation

The TERMINAL command specifies attributes of the terminal, which determine the CANDE data-transmission mode. The specifications are significant during the execution of CANDE output commands such as LIST and FIND, and for determining whether a terminal is page-mode capable.

The data communication interface resolves the differences between the actual physical and logical characteristics of the terminals attached to them and the characteristics that CANDE expects. This resolution will be inaccurate if the physical and logical characteristics of actual terminals do not agree with that which CANDE expects. Therefore, the TERMINAL command should be used with discretion.

Proper page mode operation occurs only when the defined values for the terminal attributes match the characteristics of the device and when any intervening software declarations for the device or station (such as those found in the DATACOMMINFO file, terminal emulator, and so on) are also in agreement. Unexpected or undesirable results might occur when the TERMINAL command is used to redefine the logical attributes of the station to values which do not reflect the actual characteristics of the device.

TERMINAL

If you enter the TERMINAL command with no options specified, CANDE displays the current terminal settings. Note that MAXINPUT value is displayed but you cannot modify this fixed value with the TERMINAL command.

The MAXINPUT value indicates the number of characters the terminal can transmit in a single transmission. Refer to Page Mode Operations for more information.

When modifications are made with the TERMINAL command, CANDE displays the terminal settings including any modifications.

WIDTH <integer>

LINE <integer>

The WIDTH option specifies the width of the terminal line in characters. LINE is a synonym for WIDTH.

PAGE <integer>

The PAGE option specifies the number of lines per page or screen.

DOWN <integer>

The DOWN <integer> option specifies the number of lines to shift backwards from the current line. The value of <integer> must be within the range zero (0) to the size of the page on your screen.

BUFFER

BUFFER <integer>

MAXOUTPUT

MAXOUTPUT <integer>

The BUFFER option indicates that the terminal is buffered and, optionally, specifies the number of characters the terminal can receive and display. If <integer> is absent, the previous default specification is used.

MAXOUTPUT is a synonym for BUFFER. Refer to General Information for information about MAXOUTPUT.

UNBUFFERED

The UNBUFFERED option indicates that the terminal is unbuffered. The buffer size is not lost, but it is ignored.

SCREEN

The SCREEN option indicates that the terminal is a screen device.

HARDCOPY

The HARDCOPY option indicates that the terminal produces permanent output, such as a teletype.

WAIT

The WAIT option causes CANDE to wait after sending each page until a signal is sent to display the next page. The signal is a null (empty) line.

CONTINUOUS

The CONTINUOUS option causes CANDE to send continuously until end-of-output.

WRAPAROUND

WAPAROUND TRUE

WRAPAROUND FALSE

The WRAPAROUND option indicates whether or not the terminal performs an automatic line feed and carriage return when a character is displayed in the last character position of a line.

If WRAPAROUND is TRUE, page mode output (padded with spaces if necessary) of the size of a terminal line is sent without the carriage return and linefeed characters.

If WRAPAROUND is FALSE and TRAILINGBLANKS is TRUE, page mode output (padded with spaces if necessary) of the size of a terminal line is sent with the carriage return and linefeed characters.

If WRAPAROUND is FALSE and TRAILINGBLANKS is FALSE, the trailing blanks in each line are truncated and the line is sent with the carriage return and linefeed characters.

WRAPAROUND is set by the network terminal configuration (for example, NDLII), and only in rare cases needs adjustment by using the TERMINAL command.

TRAILINGBLANKS

TRAILINGBLANKS TRUE

TRAILINGBLANKS FALSE

The TRAILINGBLANKS option controls whether or not trailing blanks are sent to the terminal. This option is effective only when WRAPAROUND is set to FALSE.

FORMSCAPABLE

FORMSCAPABLE TRUE

FORMSCAPABLE FALSE

The FORMSCAPABLE option is used to identify the terminal as being capable of handling TD, MT, and ET control codes for cursor placement and forms editing.

If FORMSCAPABLE is set to TRUE, the cursor is positioned after the NEXT +/– or +FIND prompt in page mode and after the +/–prompt in help mode. The initial setting of FORMSCAPABLE is FALSE for all terminals, but once the terminal setting is changed, CANDE retains that terminal setting for that CANDE session.

"<character>"

When an output line exceeds the terminal width, CANDE either truncates the line or wraps it by printing it on several lines. A special character is printed as the last character of a truncated or interrupted line and as the first character of a continuation line. You can specify the character by placing it within quotation marks (") in the TERMINAL specification command. If the quotation marks enclose more than one character, the first character is used.

Examples

The following is a display of the current terminal settings.

TERMINAL
#LINE = 80, PAGE = 24, MAXOUTPUT = 2000, 
        MAXINPUT = 2000, SCREEN, WAIT, 
        WRAPAROUND = FALSE, FORMSCAPABLE = FALSE, 
        TRAILINGBLANKS = FALSE, DOWN = 0, "\"            

The following shows how to modify your terminal line width, the DOWN option, and the wraparound character.

TERM LINE 72 DOWN 5 "/"
#LINE = 72, PAGE = 24, MAXOUTPUT = 2000, 
        MAXINPUT = 2000, SCREEN, WAIT,      
        WRAPAROUND = FALSE, FORMSCAPABLE = FALSE,
        TRAILINGBLANKS = FALSE, DOWN = 5, "/"