Modify logical terminal properties
Component: | TIAM |
Functional area: | Job processing |
Domain: | JOB |
Privileges: | STD-PROCESSING |
Function
The MODIFY-TERMINAL-OPTIONS command allows users to change the logical properties of their terminals. This command may be used only in timesharing mode. The logical properties of the terminal are defined in the system by setting system parameters, by the (emulated) type of the terminal and through VTSU operating parameters.
The user can obtain information on the current settings and terminal attributes with the aid of the SHOW-TERMINAL-ATTRIBUTES command.
The user can set the following logical properties:
Logical property | Operand | Preset by |
|---|---|---|
Type of control of screen overflow. | OVERFLOW-CONTROL | System parameter TCHOFLO |
Number of lines after which screen overflow occurs | MAXIMUM-LINES | Emulated terminal type |
End-of-line character. | LINE-END-CHARACTER | VTSU operating parameter |
Controls the display of outputs and | WRITE-READ-MODE | System parameter TCHREAD |
Case-sensitive | LOWER-CASE | Emulated terminal type |
Use of graphics characters | GRAPHICS | Emulated terminal type |
Use of an APL character set | APL-CHARACTER-SET | Emulated terminal type |
Support of a hardcopy printer | HARDCOPY | Emulated terminal type |
Substitute characters for | SUBSTITUTE-CHARACTER | Dependent on terminal type:
|
Acknowledgment procedure | ACKNOWLEDGE-OUTPUT | System parameter TCHTACK |
Code table | CODED-CHARACTER-SET | Dependent upon
(see table below) |
System input prompt | SYSTEM-PROMPT | Default is a slash(/) |
Program input prompt (read with RDATA) | PROGRAM-PROMPT | Default is an asterisk (*) |
Terminal roll-up mode | ROLL-UP | VTSU operating parameter TERMROLL |
The following table shows the preset code tables for CODED-CHARACTER-SET, dependent of the terminal type, the user entry for the standard code, and the VTSU operating parameter TIAM-PERM8.
Terminal type / Terminal mode | 7-bit | 8-bit | 8-bit / Unicode | 8-bit / Unicode |
Standard CCS | - | EDF03IRV | EDFxxx | EDFxxx |
TIAM-PERM8 | - | - | N1 | Y2 |
Code table(setting after system startup) | EDF03iRV | EDF03IRV | EDF03IRV | EDFxxx |
1 | corresponds to /MODIFY-TERM-OPTIONS CODED-CHARACTER-SET=*7-BIT |
2 | corresponds to /MODIFY-TERM-OPTIONS CODED-CHARACTER-SET=*8-BIT-DEFAULT |
The default value *UNCHANGED in the corresponding operands means that the previously valid definition still applies.
Format
MODIFY-TERMINAL-OPTIONS | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
OVERFLOW-CONTROL = *UNCHANGED / *NO-CONTROL / *USER-ACKNOWLEDGE / *TIME(...)
Type of control in the event of screen overflow.
An overflow is assumed by the system whenever the number of screen lines (still) to be output exceeds the maximum number of lines (MAXIMUM-LINES). At the start of an output the last user input is taken into consideration in calculating the screen overflow. If the overflow control is effected through acknowledgments (*USER-ACKNOWLEDGE), the acknowledgment request issued by the system is included in the maximum number of screen lines to be output.
OVERFLOW-CONTROL = *NO-CONTROL
No overflow control. In cases of long screen outputs, the system takes no steps to enable the ESCAPE function (K2 key) or to prevent the premature overwriting of data on the screen.
OVERFLOW-CONTROL = *USER-ACKNOWLEDGE
Overflow control by means of acknowledgments. When screen overflow occurs, the system requests the terminal user with the message % PLEASE ACKNOWLEDGE to enter an acknowledgment. The user can thus determine when the output is to be continued following a screen overflow. Any input other than ESCAPE and BREAK counts as an acknowledgment. After an acknowledgment is received, output is continued with the next screen.
OVERFLOW-CONTROL = *TIME(...)
Overflow control is effected on a time basis. The screen output is continued after the specified delay time has elapsed. When the last screen line is reached, the screen contents displayed are “scrolled” up appropriately with each further output line, and input or output data at the top of the screen is overwritten.
TIMEOUT = *STD / <integer 0..60>
Delay time, in seconds, that is to pass when screen overflow has occurred before further output is displayed.
TIMEOUT = *STD
The last value defined by the user applies. If the user does not specify a value, a wait time of 6 seconds is set.
Note
The value set for time-based control (TIMEOUT) applies even when there is a switch in screen mode (e.g. a switch on termination of a line-mode output back to the formatted input mode of guided dialog).
MAXIMUM-LINES = *UNCHANGED / <integer 3..255>
Maximum number of lines that may be displayed until the next overflow control.
LINE-END-CHARACTER = *UNCHANGED / *NONE / <c-string 1..1>
The operand only exists for reasons of compatibility and has no effect on any supported data display terminal types currently supported.
WRITE-READ-MODE = *UNCHANGED / *MODIFIED-FIELDS / *NO-FIELDS
Controls the display of output messages and the type of input.
WRITE-READ-MODE = *MODIFIED-FIELDS
Reads modified fields. Data is displayed on the screen in fields. Only the modified fields are transferred to the system.
WRITE-READ-MODE = *NO-FIELDS
Reads unprotected fields. Data is displayed on the screen without fields, input takes place from the beginning of the screen or from the cursor position.
LOWER-CASE = *UNCHANGED / *YES / *NO
Specifies whether output of lowercase letters is to be possible.
GRAPHICS = *UNCHANGED / *YES / *NO
Specifies whether a graphics option can be used.
APL-CHARACTER-SET = *UNCHANGED / *YES / *NO
Specifies whether an APL character set can be used.
HARDCOPY = *UNCHANGED / *NO / *LOCAL / *CENTRAL
Specifies what type of hardcopy logging is to be possible.
HARDCOPY = *NO
No hardcopy printer.
HARDCOPY = *LOCAL
Local hardcopy printer, operable directly at the terminal. This operand is interpreted only if a local hardcopy device was assigned when the connection was established. Otherwise, the operand is ignored.
HARDCOPY = *CENTRAL
The operand value only exists for reasons of compatibility and is equivalent to HARDCOPY=*NO.
SUBSTITUTE-CHARACTER = *UNCHANGED / *STD / <c-string 1..1> / <x-string 1..2>
Substitute character to be used in place of nonprinting characters. In output texts, nonprinting characters are replaced by the specified substitute character.
SUBSTITUTE-CHARACTER = *STD
A device-specific smudge character is used as the substitute character.
ACKNOWLEDGE-OUTPUT = *UNCHANGED / *YES / *NO
Specifies whether terminal output is to be acknowledged within the system. The value set explicitly for ACKNOWLEDGE-OUTPUT applies for all subsequent output in program and system mode until a new setting is made with MODIFY-TERMINAL-OPTIONS or until EXIT-JOB/LOGOFF.
ACKNOWLEDGE-OUTPUT = *NO
No internal acknowledgment.
Messages that are output immediately prior to EXIT-JOB or LOGOFF may be lost due to the connection being cleared down.
CODED-CHARACTER-SET = *UNCHANGED / *7-BIT / *8-BIT-DEFAULT / <name 1..8>
Specifies whether the terminal is to operate in 7-bit or 8-bit mode.
CODED-CHARACTER-SET = *7-BIT
The terminal operates in 7-bit mode.
CODED-CHARACTER-SET = *8-BIT-DEFAULT
Activates the 8-bit code table of the user entry provided the entry contains an 8-bit code table. The terminal then operates in 8-bit mode. If the user entry contains no 8-bit code table, the terminal continues to operate in 7-bit mode.
CODED-CHARACTER-SET = <name 1..8>
Name of a code table (CCS). Depending on the explicit specification of a code in the VTSUCB (VTSU Control Block), the following situations may arise:
Standard CCS | 7 | 7 | 7 | 7 | 7 | 7 | name | name | name1 | name | name | name1 |
8-bit terminal | n | n | n | j | j | j | n | n | n | j | j | j |
MOD-TERM-OPT C-C-S = | 7 | 8 | name | 7 | 8 | name | 7 | 8 | name2 | 7 | 8 | name2 |
Result | 1) | 2) | 2) | 3) | 4) | 7) | 1) | 2) | 2) | 5) | 6) | 8) |
The command is accepted.
The terminal works in 7-bit mode. First item of information supplied by TSTAT: blank Second item of information supplied by TSTAT: blank
The command is rejected.
The terminal works in 7-bit mode. First item of information supplied by TSTAT: blank Second item of information supplied by TSTAT: blank
The command is accepted.
The terminal works in 7-bit mode, if no VTSUCB is used or if blanks were detected in the VTSUCB. First item of information supplied by TSTAT: blank Second item of information supplied by TSTAT: blank
The command is rejected.
The terminal works in 7-bit mode, if no VTSUCB is used or if blanks were detected in the VTSUCB. First item of information supplied by TSTAT: blank Second item of information supplied by TSTAT: blank
The command is accepted.
The terminal works in 7-bit mode, if no VTSUCB is used or if blanks were detected in the VTSUCB. The terminal works in 8-bit mode if a valid extended code name or *EXTEND was defined in the VTSUCB. In this case, the standard CCS name is used. First item of information supplied by TSTAT: name Second item of information supplied by TSTAT: blank
The command is accepted.
The terminal works in 8-bit mode (with the character set name) if no VTSUCB is used or if blanks were detected in the VTSUCB. It likewise works in 8-bit mode if a valid character set name or *EXTEND was detected in the VTSUCB. In this case, the character set name is used. First item of information supplied by TSTAT: name Second item of information supplied by TSTAT: name
The command is accepted if the name is supported by the terminal.
The terminal works in 8-bit mode (with the character set name) if no VTSUCB is used or if no character set name is specified in the VTSUCB. First item of information supplied by TSTAT: blank Second item of information supplied by TSTAT: name
The command is accepted if name2 is supported by the terminal.
The terminal works in 8-bit mode (with the character set name2) if no VTSUCB is used or if no character set name is specified in the VTSUCB First item of information supplied by TSTAT: name1 Second item of information supplied by TSTAT: name2
Working with Unicode code tables
The Unicode variant UTFE (CODED-CHARACTER-SET=UTFE specification) permits Unicode code tables to be used. To select this variant, the terminal mode must be Unicode and the terminal type DSS9763.
The CODED-CHARACTER-SET=UTFE specification is rejected if this variant cannot be selected. The entry is possible if the output of the SHOW-TERMINAL-ATTRIBUTES command displays the value 240 in one of the up to 16 code tables which are possible (see CHARACTER-SET-i output field in the CAPABILITIES information block, where i=1 to 16).
SYSTEM-PROMPT = *UNCHANGED / *STD / <c-string 1..32 with-low>
Specifies with which type of prompt the system requests command input.
SYSTEM-PROMPT = *STD
The system prompt is a slash (/). This is the value set when the task is started.
SYSTEM-PROMPT = <c-string 1..32 with-low>
The system prompts input with this character string. A maximum of 32 characters may be entered. The string may contain wildcards for which the relevant value will be substituted:
Wildcard | Value substituted |
|---|---|
#H | Host name |
#J | Job name |
#P | Processor name |
#S | Station name |
#U | user ID |
PROGRAM-PROMPT = *UNCHANGED / *STD / <c-string 1..32 with-low>
Specifies with which type of prompt programs will request input read with RDATA.
PROGRAM-PROMPT = *STD
Program entries read with RDATA are prompted with an asterisk (*). This is the value set when the task is started.
PROGRAM-PROMPT = <c-string 1..32 with-low>
Program entries read with RDATA are prompted with this character string. A maximum of 32 characters may be entered. The string may contain wildcards for which the relevant value will be substituted (see SYSTEM-PROMPT operand).
ROLL-UP = *UNCHANGED / *STD / *YES / *NO
Specifies how “old” screen contents is to be treated (terminal roll-up mode).
ROLL-UP = *STD
The value defined in the VTSU operating parameter TERMROLL in the VTSU parameter file applies.
ROLL-UP = *YES
Old screen contents is rolled up.
ROLL-UP = *NO
The old screen contents is deleted up to the write mark when reissued.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | Command executed successfully | |
1 | 0 | CMD2201 | Command not effective until the overflow control has been reactivated |
2 | 0 | TIA0500 | Command executed with warning; at least one entry has been ignored because of a semantic error |
1 | TIA0502 | Syntax error | |
32 | TIA0122 | Unrecoverable VTSU-B error | |
64 | CMD0216 | Privilege error |
Example
/show-file proc.time —————————————————————————————————————————————— (1)
/SET-PROC-OPT ERROR-MECHANISM=*BY-RETURNCODE /DECL-VAR LOOP /FOR-1: FOR LOOP = *COUNTER(1,10,1) / WRITE-TEXT '** Es ist jetzt &(TIME()) Uhr.' / END-FOR /EXIT: EXIT-PROC /ERROR: IF-BLOCK-ERROR / WRITE-TEXT '** Fehler mit Subcode1 &(SC1) und Subcode2 (SC2) *' / HELP-MSG MSG-ID=&(MC) / END-IF % SHO0301 WARNING: END OF FILE REACHED e S*SOF+ 1( 1)
% SHO0500 ':2OSG:$USERXY01.PROC.TIME' CLOSED
/mod-term-opt overflow-control=*no ————————————————————————————— (2)/call-proc proc.time ——————————————————————————————————— (3)
** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr. ** Es ist jetzt 14:19:50 Uhr.
/mod-term-opt system-prompt='Host07:' ———————————————————————————— (4)
Host07:mod-term-opt overflow-control=*user-ack,max-lines=3 —————————— (5) Host07:call-proc proc.time ————————————————————————————— (6)
** Es ist jetzt 14:23:43 Uhr. %PLEASE ACKNOWLEDGE ** Es ist jetzt 14:23:43 Uhr. ** Es ist jetzt 14:23:49 Uhr. %PLEASE ACKNOWLEDGE ** Es ist jetzt 14:23:49 Uhr. ** Es ist jetzt 14:23:58 Uhr. %PLEASE ACKNOWLEDGE ** Es ist jetzt 14:23:58 Uhr. ** Es ist jetzt 14:23:59 Uhr. %PLEASE ACKNOWLEDGE ** Es ist jetzt 14:23:59 Uhr. ** Es ist jetzt 14:24:01 Uhr. %PLEASE ACKNOWLEDGE ** Es ist jetzt 14:24:01 Uhr.
Host07:mod-term-opt overflow-control=*time(timeout=30) ————————— (7)
Host07:call-proc proc.time ————————————————————————————— (8)
** Es ist jetzt 14:24:46 Uhr. ** Es ist jetzt 14:24:46 Uhr. ** Es ist jetzt 14:24:46 Uhr. ** Es ist jetzt 14:25:16 Uhr. ** Es ist jetzt 14:25:16 Uhr. ** Es ist jetzt 14:25:16 Uhr. ** Es ist jetzt 14:25:46 Uhr. ** Es ist jetzt 14:25:46 Uhr. ** Es ist jetzt 14:25:46 Uhr. ** Es ist jetzt 14:26:16 Uhr.
(1) | The SHOW-FILE command displays the contents of the file PROC.TIME. This is an S procedure which determines the current time ten times (builtin function TIME()) and outputs it to SYSOUT by means of the WRITE-TEXT command. E (END) terminates the output of the SHOW-FILE command. |
(2) | Overflow control is deactivated (OVERFLOW-CONTROL=*NO-CONTROL). |
(3) | Calls the procedure PROC.TIME. Since no screen overflow occurs, the message giving the time is output ten times in succession. The time displayed does not change on account of the instantaneous output. |
(4) | The character string Host07: is defined as the input prompt for commands. |
(5) | Overflow control is set to *USER-ACKNOWLEDGE with a maximum of 3 output lines. |
(6) | Calls the procedure PROC.TIME. After every 3 lines the system requests an acknowledgment from the user. The first overflow occurs immediately after the first time output since the procedure call and acknowledgment request are included in calculating the maximum number of lines. The user acknowledges, for example by pressing the [DUE] key. The output then continues. Different times are displayed on account of the delay. |
(7) | Overflow control is set to a delay of 30 seconds. The maximum number of lines is not changed. |
(8) | Calls the procedure PROC.TIME. A delay of 30 seconds elapses after every 3 lines. The delay can be seen from the output time: the time advances 30 seconds after every three output lines. |