![[Compaq]](../images/compaq.gif)
![[Go to the documentation home page]](../images/buttons/bn_site_home.gif)
![[How to order documentation]](../images/buttons/bn_order_docs.gif)
![[Help on this site]](../images/buttons/bn_site_help.gif)
![[How to contact us]](../images/buttons/bn_comments.gif)
![[OpenVMS documentation]](../images/ovmsdoc_sec_head.gif)
| Document revision date: 30 March 2001 | |
|
|
|
|
|
|
| Previous | Contents | Index |
Numeric capabilities take a numeric argument; for example, the number of columns on the terminal screen.
The format for a numeric capability field is as follows:
|
NUMERIC {numeric-capability = value} [,...] |
Following are the meanings of the elements:
| OpenVMS Name | Used by SMG | Description |
|---|---|---|
| COLUMNS | Y | Specifies the number of columns in a line. |
| CR_FILL | N | Specifies the number of fill characters needed after a carriage return. |
| LF_FILL | N | Specifies the number of fill characters needed after a line feed. |
| FRAME | N | Controls the number of data bits expected by the terminal driver for every character that is input or output (value must be between 5 and 8, inclusive). |
| NUMBER_FN_KEYS | N | Specifies the number of function keys available. |
| PRIVATE_NUM_1 to 10 | N | If set, these fields denote user-defined capabilities 1 through 10. |
| ROWS | N | Specifies the number of rows on the screen. |
| WIDE_SCREEN_COLUMNS | Y | Specifies the number of columns available in wide mode. |
For example, the following TERMTABLE entry describes two characteristics of a VT300-series terminal:
NAME = "VT300_series"
NUMERIC
rows = 24, columns = 80
|
String capability fields provide several features. They let you do the following:
Table 5-3 lists string capabilities.
| OpenVMS Name | Used by SMG | Description |
|---|---|---|
| BEGIN_ALTERNATE_CHAR | N | Begins alternate character set. |
| BEGIN_AUTOPRINT_MODE | N | Begins autoprint mode. |
| BEGIN_AUTOREPEAT_MODE | N | Begins autorepeat mode. |
| BEGIN_AUTOWRAP_MODE | N | Begins autowrap mode. |
| BEGIN_BLINK | Y | Begins blinking characters. |
| BEGIN_BOLD | Y | Begins bolded characters. |
| BEGIN_DELETE_MODE | N | Begins delete mode. |
| BEGIN_INSERT_MODE | N | Begins insert mode. |
| BEGIN_LINE_DRAWING_CHAR | Y | Begins using line-drawing character set. |
| BEGIN_NORMAL_RENDITION | Y | Begins using normal video attributes. |
| BEGIN_REVERSE | Y | Begins reverse video characters. |
| BEGIN_UNDERSCORE | Y | Begins underscored characters. |
| BOTTOM_T_CHAR | Y | Displays line-drawing character bottom t. |
| CLEAR_TAB | N | Clears tab at current column. |
| CR_GRAPHIC | Y | Defines character to indicate a carriage return when control characters are being represented rather than executed. |
| CROSS_CHAR | Y | Defines character to represent the intersection of perpendicular lines. |
| CURSOR_DOWN | N | Moves cursor n lines down (does not cause scrolling). |
| CURSOR_LEFT | N | Moves cursor n positions to the left. |
| CURSOR_NEXT_LINE | N | Accepts an argument n and moves the cursor to the first position in the nth following line. |
| CURSOR_POSITION_REPORT | N | Reports the active position using two arguments. |
| CURSOR_PRECEDING_LINE | N | Accepts an argument n and moves the cursor to the first position in the nth preceding line. |
| CURSOR_RIGHT | N | Accepts an argument n and moves the cursor n positions to the right. |
| CURSOR_UP | N | Accepts an argument n and and moves cursor up n lines (does not cause scrolling). |
| DARK_SCREEN | Y | Makes screen background color dark (normal video). |
| DELETE_CHAR | N | Accepts an argument n and deletes n characters. |
| DELETE_LINE | N | Accepts an argument n and deletes n lines. |
| DEVICE_ATTRIBUTES | N | Terminal's response to a "What are you?" sequence. |
| DOUBLE_HIGH_BOTTOM | Y | Changes line to double height bottom half. |
| DOUBLE_HIGH_TOP | Y | Changes line to double height top half. |
| DOUBLE_WIDE | Y | Changes line to double width. |
| END_ALTERNATE_CHAR | N | Ends alternate character set. |
| END_AUTOPRINT_MODE | N | Ends autoprint mode. |
| END_AUTOREPEAT_MODE | N | Ends autorepeat mode. |
| END_AUTOWRAP_MODE | N | Ends autowrap mode. |
| END_BLINK | N | Ends blinking characters. |
| END_BOLD | N | Ends bolding mode. |
| END_DELETE_MODE | N | Ends delete mode. |
| END_INSERT_MODE | N | Ends insert mode. |
| END_LINE_DRAWING_CHAR | Y | Ends line-drawing characters. |
| END_REVERSE | N | Ends reverse video characters. |
| END_UNDERSCORE | N | Ends underscore. |
| ERASE_DISPLAY_TO_CURSOR | N | Erases display to virtual cursor position. |
| ERASE_LINE_TO_CURSOR | N | Erases line to virtual cursor position. |
| ERASE_TO_END_DISPLAY | N | Erases to end of display. |
| ERASE_TO_END_LINE | Y | Erases to end of line. |
| ERASE_WHOLE_DISPLAY | Y | Erases whole display. |
| ERASE_WHOLE_LINE | N | Erases whole line. |
| ERROR_ICON | Y | Defines character that indicates an error. |
| FF_GRAPHIC | Y | Uses this character to indicate a form feed when control characters are displayed rather than executed. |
| HOME | Y | Defines home cursor. |
| HORIZONTAL_BAR | Y | Displays line-drawing character horizontal bar. |
| HT_GRAPHIC | Y | Uses this character to indicate a horizontal tab when control characters are displayed rather than executed. |
| INDEX | N | Moves the cursor down one line without changing the column position (contents of the screen scroll up if necessary). |
| INIT_STRING | Y | Defines terminal initialization string. |
| INSERT_CHAR | N | Accepts an argument n and inserts n characters. |
| INSERT_LINE | N | Accepts an argument n and inserts n lines. |
| INSERT_PAD | N | Accepts an argument n and inserts n pad characters after character inserted. |
| KEY_0 | Y | Returned by keypad 0 in applications mode. |
| KEY_1 | Y | Returned by keypad 1 in applications mode. |
| KEY_2 | Y | Returned by keypad 2 in applications mode. |
| KEY_3 | Y | Returned by keypad 3 in applications mode. |
| KEY_4 | Y | Returned by keypad 4 in applications mode. |
| KEY_5 | Y | Returned by keypad 5 in applications mode. |
| KEY_6 | Y | Returned by keypad 6 in applications mode. |
| KEY_7 | Y | Returned by keypad 7 in applications mode. |
| KEY_8 | Y | Returned by keypad 8 in applications mode. |
| KEY_9 | Y | Returned by keypad 9 in applications mode. |
| KEY_BACKSPACE | N | Returned by backspace key. |
| KEY_COMMA | Y | Returned by keypad comma key. |
| KEY_DOWN_ARROW | Y | Returned by down arrow key. |
| KEY_E1 | Y | Returned by E1 (editing key 1). |
| KEY_E2 | Y | Returned by E2 (editing key 2). |
| KEY_E3 | Y | Returned by E3 (editing key 3). |
| KEY_E4 | Y | Returned by E4 (editing key 4). |
| KEY_E5 | Y | Returned by E5 (editing key 5). |
| KEY_E6 | Y | Returned by E6 (editing key 6). |
| KEY_ENTER (k) | Y | Returned by keypad enter key. |
|
KEY_F1
.
. . |
Y |
Returned by F1 (function key 1).
.
. . |
| KEY_F20 | Y | Returned by F20 (function key 20). |
|
KEY_LABEL_F1
.
. . |
N |
Legend on F1 (function key 1).
.
. . |
| KEY_LABEL_F20 | N | Legend on F20 (function key 20). |
| KEY_LEFT_ARROW | Y | Returned by left arrow key. |
| KEY_MINUS | Y | Returned by keypad minus key. |
| KEY_PERIOD | Y | Returned by keypad period key. |
| KEY_PF1 | Y | Returned by PF1 key. |
| KEY_PF2 | Y | Returned by PF2 key. |
| KEY_PF3 | Y | Returned by PF3 key. |
| KEY_PF4 | Y | Returned by PF4 key. |
| KEY_RIGHT_ARROW | Y | Returned by right arrow key. |
| KEY_UP_ARROW | Y | Returned by up arrow key. |
| LEFT_T_CHAR | Y | Displays line-drawing character left t. |
| LF_GRAPHIC | Y | Uses this character to indicate a line feed when control characters are displayed rather than executed. |
| LIGHT_SCREEN | Y | Makes screen background color light (reverse video). |
| LOWER_LEFT_CORNER | Y | Displays line-drawing character lower left corner. |
| LOWER_RIGHT_CORNER | Y | Displays line-drawing character lower right corner. |
| NAME | Y | Defines terminal name; must be the first field in the entry. |
| NEWLINE_CHAR | N | Defines new-line character. |
| NEXT_LINE | N | Displays next line. |
| NO_PRINTER | N | Defines no attached printer status. |
| PAD_CHAR | N | Defines pad character (if other than null). |
| PRINT_SCREEN | N | Prints contents of screen. |
| PRINTER_READY | N | Defines printer ready status. |
| PRINTER_NOT_READY | N | Defines printer not ready status. |
|
PRIVATE_STR_1
.
. . |
N |
User-defined capability 1.
.
. . |
| PRIVATE_STR_10 | N | User-defined capability 10. |
| REQUEST_CURSOR_POSITION | N | Requests the active cursor position. |
| REQUEST_PRINTER_STATUS | N | Requests status of attached printer. |
| RESTORE_CURSOR | N | Restores cursor to previously saved position. |
| REVERSE_INDEX | N | Moves the cursor to the same column on the preceding line (contents of the screen scroll down if necessary). |
| RIGHT_T_CHAR | Y | Displays line-drawing character right t. |
| SAVE_CURSOR | N | Saves cursor position. |
| SCROLL_FORWARD | N | Accepts an argument n and scrolls forward n lines. |
| SCROLL_REVERSE | Y | Accepts an argument n and scrolls backward n lines. |
| SEL_ERASE_TO_END_DISPLAY | N | Selectively erases from cursor to end of display (does not change attributes). |
| SEL_ERASE_TO_END_LINE | N | Selectively erases from cursor to end of line (does not change attributes). |
| SEL_ERASE_WHOLE_DISPLAY | N | Selectively erases entire display (does not change attributes). |
| SEL_ERASE_WHOLE_LINE | N | Selectively erases entire line (does not change attributes). |
| SET_APPLICATION_KEYPAD | Y | Begins applications keypad mode. |
| SET_CHAR_NOT_SEL_ERASE | N | Designates all subsequent characters as not selectively erasable. |
| SET_CHAR_SEL_ERASE | N | Designates all subsequent characters as selectively erasable. |
| SET_CURSOR_ABS | Y | Directs cursor addressing (accepts row and column arguments). |
| SET_CURSOR_OFF | Y | Sets cursor to invisible. |
| SET_CURSOR_ON | Y | Sets cursor to visible. |
| SET_JUMP_SCROLL | Y | Sets scrolling to jump scroll. |
| SET_NUMERIC_KEYPAD | Y | Ends keypad applications mode (resumes numeric mode). |
| SET_ORIGIN_ABSOLUTE | N | Allows cursor positioning outside current scrolling region. |
| SET_ORIGIN_RELATIVE | N | Prohibits cursor positioning outside current scrolling region. |
| SET_PRINTER_OUTPUT | N | Sends output to printer port rather than screen. |
| SET_SCREEN_OUTPUT | N | Sends output to terminal screen. |
| SET_SCROLL_REGION | Y | Sets scrolling region (accepts as arguments top margin and bottom margin). |
| SET_SMOOTH_SCROLL | Y | Sets scrolling to smooth scroll. |
| SET_TAB | N | Sets tab at current column. |
| SINGLE_HIGH | Y | Changes this line to single height, single width. |
| TAB_CHAR | N | Defines tab character (other than Ctrl/I or tab with padding); note that this field should be used only for non-ASCII terminals. |
| TOP_T_CHAR | Y | Displays line-drawing character top t. |
| TRUNCATION_ICON | Y | Defines the character that indicates overflow characters were truncated. |
| UNDERLINE_CHAR | N | Underlines a character. |
| UPPER_LEFT_CORNER | Y | Displays line-drawing character upper left corner. |
| UPPER_RIGHT_CORNER | Y | Displays line-drawing character upper right corner. |
| VERTICAL_BAR | Y | Displays line-drawing character vertical bar. |
| VT_GRAPHIC | Y | Defines the character that indicates a vertical tab when control characters are displayed rather than executed. |
| WIDTH_NARROW | Y | Sets terminal width to narrow (usually 80 columns). |
| WIDTH_WIDE | Y | Sets terminal width to wide (usually 132 columns). |
Table 5-4 lists the STRING_2 capabilities. In order to construct one of the user-defined renditions SMG$M_USER1 through SMG$M_USER8, you must provide an appropriate definition in the file TERMTABLE.TXT using STRING_2 capabilities.
| OpenVMS Name | Used by SMG | Description |
|---|---|---|
| BEGIN_STATUS_LINE | Y | Begins output to hardware status line. |
| BEGIN_USER1 | Y | Begins first user-defined attribute. |
| BEGIN_USER2 | Y | Begins second user-defined attribute. |
| BEGIN_USER3 | Y | Begins third user-defined attribute. |
| BEGIN_USER4 | Y | Begins fourth user-defined attribute. |
| BEGIN_USER5 | Y | Begins fifth user-defined attribute. |
| BEGIN_USER6 | Y | Begins sixth user-defined attribute. |
| BEGIN_USER7 | Y | Begins seventh user-defined attribute. |
| BEGIN_USER8 | Y | Begins eighth user-defined attribute. |
| END_STATUS_LINE | Y | Ends output to hardware status line. |
| END_USER1 | N | Ends first user-defined attribute. |
| END_USER2 | N | Ends second user-defined attribute. |
| END_USER3 | N | Ends third user-defined attribute. |
| END_USER4 | N | Ends fourth user-defined attribute. |
| END_USER5 | N | Ends fifth user-defined attribute. |
| END_USER6 | N | Ends sixth user-defined attribute. |
| END_USER7 | N | Ends seventh user-defined attribute. |
| END_USER8 | N | Ends eighth user-defined attribute. |
| BLACK_SCREEN | Y | Makes screen background color black. |
| BLUE_SCREEN | Y | Makes screen background color blue. |
| CYAN_SCREEN | Y | Makes screen background color cyan (green-blue). |
| GREEN_SCREEN | Y | Makes screen background color green. |
| MAGENTA_SCREEN | Y | Makes screen background color magenta. |
| RED_SCREEN | Y | Makes screen background color red. |
| WHITE_SCREEN | Y | Makes screen background color white. |
| YELLOW_SCREEN | Y | Makes screen background color yellow. |
| USER1_SCREEN | Y | User-defined background color. |
| USER2_SCREEN | Y | User-defined background color. |
| Previous | Next | Contents | Index |
|
|
| privacy and legal statement | ||
| 5935PRO_005.HTML | ||