Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Display logical terminal properties

Component:	TIAM
Functional area:	Job processing
Domain:	JOB
Privileges:	STD-PROCESSING TSOS HARDWARE-MAINTENANCE SAT-FILE-EVALUATION SAT-FILE-MANAGEMENT SECURITY-ADMINISTRATION

Function

The MODIFY-TERMINAL-OPTIONS command allows users to output the logical properties of their terminals to SYSOUT.
The logical properties of the terminal are defined in the system by means of class 2 system parameters at system generation time, through generation of the terminal, by the terminal itself, and through VTSU operating parameters. These defined values are in force at the start of the interactive task; they can be modified within the user’s task by means of the MODIFY-TERMINAL-OPTIONS command.
Information on the terminal’s entire range of attributes can be requested with the SHOW-TERMINAL-ATTRIBUTES command.

The command supports structured output in S variables (see "Output in S variables").

Format

SHOW-TERMINAL-OPTIONS

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command successfully executed
2	0	TIA0200	Information about terminal properties not available
	1	CMD0202	Syntax error (command not allowed in batch jobs)
	32	CMD2009	Error during S variable generation
	64	CMD0216	Privilege error

Output format

The output fields and the values displayed correspond to the operands and operand values of the MODIFY-TERMIMAL-OPTIONS command.

Output field	Possible values	Meaning
ACKNOWLEGE-OUTPUT	YES / NO	Acknowledgment mechanism
APL-CHARACTER-SET	YES / NO	Use of APL character set
CODED-CHARACTER-SET	7-BIT / <name 1..8>	Code table
GRAPHICS	YES / NO	Use of graphics characters
HARDCOPY	NO / LOCAL / CENTRAL	Support for hardcopy printer
LINE-END-CHARACTER	<x-string 2..2>	Line-end character
LINE-LENGTH	<integer 10..255>	Output line length
LOWER-CASE	YES / NO	Uppercase/lowercase differentiation
MAXIMUM-LINES	<integer 3..255>	Number of lines after which screen overflow occurs
OVERFLOW-CONTROL	USER-ACKNOWLEDGE / NO-CONTROL / TIME(TIMEOUT=<integer 0..60>)	Type of screen overflow control
WRITE-READ-MODE	MODIFIED-FIELDS / NO-FIELDS	Control of display of outputs and the type of input
SUBSTITUTE-CHARACTER	<x-string 2..2>	Substitute characters for displaying nonprinting characters
SYSTEM-PROMPT	Slash (/) or <c-string 1..32 with-low>	System prompt
PROGRAM-PROMPT	Asterisk (*) or <c-string 1..32 with-low>	Program prompt (read with RDATA)
ROLL-UP	YES NO	Terminal roll-up mode

Table 166: Output fields of the SHOW-TERMINAL-OPTIONS command

Output in S variables

Output information	Name of the S variable	T	Contents
Terminal output acknowledgment	var(*LIST).ACK-OUT	S	NO YES
Use of an APL character set supported	var(*LIST).APL-CHAR-SET	S	NO YES
Terminal operating mode (7-bit/8-bit/Unicode)	var(*LIST).CODED-CHAR-SET	S	<name 1..8> *7-BIT
Use of a graphics option supported	var(*LIST).GRAPHIC	S	NO YES
Hardcopy logging mode	var(*LIST).HARDCOPY	S	CENTRAL LOC *NO
End-of-line character	var(*LIST).LINE-END-CHAR	S	*NONE <c-string 1..1>
Line length	var(*LIST).LINE-LEN	I	<integer 10..255>
Lowercase output supported	var(*LIST).LOW-CASE	S	NO YES
Maximum number of lines of screen overflow	var(*LIST).MAX-LINE	I	<integer 3..255>
Screen overflow control mode (no control, control by acknowledgment, control by timeout)	var(*LIST).OV-CONTR	S	NO-CONTR TIME(TIMEOUT=xx) *USER-ACK
Program prompts that read using RDATA (default “*”)	var(*LIST).PROGRAM-PROMPT	S	’*’ <c-string 1..32>
Terminal roll-up mode	var(*LIST).ROLL-UP	S	YES NO
Substitutes for nondisplayable characters	var(*LIST).SUBST-CHAR	S	<c-string 1..1>
System prompt (default “/”)	var(*LIST).SYSTEM-PROMPT	S	’/’ <c-string 1..32>
Output message display control and input mode control	var(*LIST).WRITE-READ-MODE	S	MOD-FIELD NO-FIELD

Example

/show-term —————————————————————————————————————————————————————————— (1)

%OVERFLOW-CONTROL     = USER-ACKNOWLEDGE
%MAXIMUM-LINES        =  24        LINE-LENGTH          =  80
%LINE-END-CHARACTER   =  X'00'     WRITE-READ-MODE      = MODIFIED-FIELDS
%LOWER-CASE           = YES        GRAPHICS             = NO
%APL-CHARACTER-SET    = NO         HARDCOPY             = LOCAL
%SUBSTITUTE-CHARACTER =  X'07'     ACKNOWLEDGE-OUTPUT   = NO
%CODED-CHARACTER-SET  = 7-BIT      ROLL-UP              = NO
%SYSTEM-PROMPT        = /
%PROGRAM-PROMPT       = *

/mod-term ov-contr=*time(timeout=10) ———————————————————————————————— (2) /show-term —————————————————————————————————————————————————————————— (3)

%OVERFLOW-CONTROL     = TIME(TIMEOUT = 10)
%MAXIMUM-LINES        =  24        LINE-LENGTH          =  80
%LINE-END-CHARACTER   =  X'00'     WRITE-READ-MODE      = MODIFIED-FIELDS
%LOWER-CASE           = YES        GRAPHICS             = NO
%APL-CHARACTER-SET    = NO         HARDCOPY             = LOCAL
%SUBSTITUTE-CHARACTER =  X'07'     ACKNOWLEDGE-OUTPUT   = NO
%CODED-CHARACTER-SET  = 7-BIT      ROLL-UP              = NO
%SYSTEM-PROMPT        = /
%PROGRAM-PROMPT       = *

(1)	Outputs the logical terminal properties.
(2)	Overflow control is effected on a time basis at 10-second intervals.
(3)	Outputs the logical terminal properties again.

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-TERMINAL-OPTIONS