Your Browser is not longer supported

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

{{viewport.spaceProperty.prod}}

SHOW-TERMINAL-ATTRIBUTES

&pagelevel(3)&pagelevel

Show terminal attributes

Component:

TIAM

Functional area:

Job processing

Domain:

JOB                                                                                                         

Privileges:

STD-PROCESSING
TSOS
HARDWARE-MAINTENANCE
SAT-FILE-EVALUATION
SAT-FILE-MANAGEMENT
SECURITY-ADMINISTRATION

Function

The SHOW-TERMINAL-ATTRIBUTES command allows the user to have the entire range of attributes of his or her terminal output to SYSOUT. The command is not allowed in batch operation.

By default, the logical attributes of the terminal are shown which are defined in the system through system parameters at the time of system generation, when the terminal was generated, by the terminal itself and through the VTSU operating parameters. These values apply at the beginning of the dialog task, but the user can modify them in the course of the task using the MODIFY-TERMINAL-OPTIONS command. The output is the same as the output for the SHOW-TERMINAL-OPTIONS command.

Furthermore, the user can obtain information on the terminal’s hardware attributes and connection.

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

Format

SHOW-TERMINAL-ATTRIBUTES                                                                                                             

INFORMATION = *OPTIONS / *IDENTIFICATION / *DIMENSION / *CAPABILITIES / *ALL

Operands

INFORMATION = *OPTIONS / *IDENTIFICATION / *DIMENSION / *CAPABILITIES / *ALL
Specifies the attributes that are displayed.

INFORMATION = *OPTIONS
The terminal’s logical attributes which can be modified with the MODIFY-TERMINAL-OPTIONS command are displayed. Output is the same as for the SHOW-TERMINAL-OPTIONS command. 

INFORMATION = *IDENTIFICATION
All attributes identify the terminal uniquely are displayed:

  • terminal type

  • partner type

  • station name

  • processor name

  • hardcopy device available

  • ID card reader available

  • chipcard reader available

INFORMATION = *DIMENSION
The attributes concerning the presentation dimensions are displayed:

  • supports 24 lines and 80 columns

  • supports 32 lines and 80 columns

  • supports 43 lines and 80 columns

  • supports 27 lines and 132 columns

  • maximum number of lines

  • maximum number of columns

  • screen buffer size

INFORMATION = *CAPABILITIES
Other attributes are displayed:

  • number of colors supported

  • hardware information line

  • line mode supported

  • extended line mode supported

  • physical mode supported

  • form mode supported

  • protocol type (810 or 3270 protocol)

  • extended field attributes supported

  • status query

  • encryption

  • Number of 8-bit and Unicode character sets supported

  • CCS displayed

INFORMATION = *ALL
All the terminal’s attributes are displayed. 

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

Command executed successfully

2

0

TIA0200

Information on terminal attributes not available


1

CMD0202

Syntax error (command not allowed in batch mode)


32

CMD2009

Error during generation of S variables


64

CMD0216

Privilege error

Output format

Output fields with INFORMATION = *OPTIONS

The output fields and their possible values correspond to the operands and operand values of the MODIFY-TERMINAL-OPTIONS command.

Output field                             

Possible values                              

Meaning

ACKNOWLEGE-OUTPUT

YES / NO

Acknowledgment procedure

APL-CHARACTER-SET

YES / NO

APL character set used

CODED-CHARACTER-SET

7-BIT / 8-BIT-DEFAULT /
<name 1..8>

Coding table

GRAPHICS

YES / NO

Graphics used

HARDCOPY

NO / LOCAL / CENTRAL

Hardcopy printer supported

LINE-END-CHARACTER

(<x-string 2..2>)

Line end character

LINE-LENGTH

<integer 10..255>

Length of output line

LOWER-CASE

YES / NO

Uppercase/lowercase

MAXIMUM-LINES

<integer 3..255>

Number of lines to screen overflow

OVERFLOW-CONTROL

USER-ACKNOWLEDGE /
NO-CONTROL /
TIME(TIMEOUT=<integer 0..60>)

Control type for screen overflow

WRITE-READ-MODE

MODIFIED-FIELDS /
NO-FIELDS

Output presentation control and type of input

SUBSTITUTE-CHARACTER

(<x-string 2..2>)

Substitute characters for nonpresentable characters

SYSTEM-PROMPT

Slash (/) or
<c-string 1..32 with-low>

System input prompt

PROGRAM-PROMPT

Asterisk (*) or
<c-string 1..32 with-low>

Program input prompt (read with RDATA)

ROLL-UP

*YES
*NO

Terminal roll-up mode

Table 162: Output fields for SHOW-TERMINAL-ATTRIBUTES, INF=*OPTIONS

Output fields for INFORMATION = *IDENTIFICATION

Output field

Possible values  

Meaning

TERMINAL-TYPE

<text 1..8>

Terminal type

PARTNER-TYPE

TERMINAL / APPL

Partner type

STATION-NAME

<text 1..8>

Station name

PROCESSOR-NAME

<text 1..8>

Processor name

LOCAL-HARDCOPY

*YES / *NO

Hardcopy devices

ID-CARD-READER

*YES / *NO

ID card reader

CHIP-CARD-READER

*YES / *NO

Chipcard reader

HOST-NAME

<text 1..8>

Host name (real or virtual host)

Table 163: Output fields for SHOW-TERMINAL-ATTRIBUTES, INF=*IDENTIFICATION
Output fields for INFORMATION = *DIMENSION

Output field

Possible values

Meaning

DIM-24-80-SUPPORT

*YES / *NO

Support of 24 lines and 80 columns

DIM-32-80-SUPPORT

*YES / *NO

Support of 32 lines and 80 columns

DIM-43-80-SUPPORT

*YES / *NO

Support of 43 lines and 80 columns

DIM-27-132-SUPPORT

*YES / *NO

Support of 27 lines and 132 columns

PHYSICAL-MAX-LINES

<integer 1..32767>

Maximum number of lines

PHYSICAL-LINE-LENGTH

<integer 1..32767>

Maximum number of columns

PHYSICAL-MAX-BUFFER

<integer 1..32767>

Size of screen buffer

Table 164: Output fields for SHOW-TERMINAL-ATTRIBUTES, INF=*DIMENSION

Output fields for INFORMATION = *CAPABILITIES

Output field                                

Possible values  

Meaning

COLOUR-SUPPORT

*NO / 4 / 8

Number of colors supported

HARDWARE-INFOLINE

*YES / *NO

Hardware information line

LINE-MODE

*YES / *NO

Line mode supported

EXTENDED-LINE-MODE

*YES / *NO

Extended line mode supported

PHYSICAL-MODE

*YES / *NO

Physical mode supported

FORM-MODE

*YES / *NO

Form mode supported

PROTOCOL-TYPE

810 / 3270

Protocol type (810 or 3270 protocol)

EXTEND-FIELD-ATTRIB

*YES / *NO

Extended field attributes supported

STATUS-REQUEST

*YES / *NO

Status request

ENCRYPTION-SUPPORT

*YES / *NO

Encryption

DOORS-SUPPORT

*YES / *NO

Output only supported for reasons of compatibility

DESK2000-SUPPORT

*YES / *NO

Output only supported for reasons of compatibility

NUMBER-OF-8-BIT-CHARACTER-SET-SUPPORTED

<integer 0..16>

Number of 8-bit character sets supported (CCS)

CHARACTER-SET-1
.
.
CHARARCTER-SET-16

*NO /
<integer 1..16> /
<integer 240>

Display of CCS 1 to 16
(Example: The value i from 1 through 16 corresponds to the ISO standard ISO 8859-i, i.e. for i=1 Latin 1 Western European applies, 240 corresponds to Unicode)

Table 165: Output fields for SHOW-TERMINAL-ATTRIBUTES, INF=*CAPABILITIES

Example

/show-terminal-attributes info=all

----------------------- OPTIONS ----------------------------------------
%OVERFLOW-CONTROL     = NO-CONTROL
%MAXIMUM-LINES        = 255        LINE-LENGTH          =  72
%LINE-END-CHARACTER   =  X'00'     WRITE-READ-MODE      = MODIFIED-FIELDS
%LOWER-CASE           = NO         GRAPHICS             = NO
%APL-CHARACTER-SET    = NO         HARDCOPY             = NO
%SUBSTITUTE-CHARACTER =  X'4A'     ACKNOWLEDGE-OUTPUT   = YES
%CODED-CHARACTER-SET  = 7-BIT      ROLL-UP              = NO
%SYSTEM-PROMPT        = /
%PROGRAM-PROMPT       = *
%----------------------- IDENTIFICATION ---------------------------------
%TERMINAL-TYPE        = SS-8103    PARTNER-TYPE         = APPL
%STATION-NAME         = TELSR000   PROCESSOR-NAME       = D016ZE07
%LOCAL-HARDCOPY       = NO         ID-CARD-READER       = NO
%CHIP-CARD-READER     = NO         HOST-NAME            = D016ZE07
%----------------------- DIMENSION --------------------------------------
%DIM-24-80-SUPPORT    = NO         DIM-32-80-SUPPORT    = NO
%DIM-43-80-SUPPORT    = NO         DIM-27-132-SUPPORT   = NO
%PHYSICAL-MAX-LINES   =  255       PHYSICAL-LINE-LENGTH =   72
%PHYSICAL-MAX-BUFFER  =  4088
%----------------------- CAPABILITIES -----------------------------------
%COLOUR-SUPPORT       = NO         HARDWARE-INFOLINE    = NO
%LINE-MODE            = YES        EXTENDED-LINE-MODE   = NO
%PHYSICAL-MODE        = YES        FORM-MODE            = YES
%PROTOCOL-TYPE        =            EXTEND-FIELD-ATTRIB  = NO
%STATUS-REQUEST       = NO         ENCRYPTION-SUPPORT   = NO
%DOORS-SUPPORT        = NO         DESK2000-SUPPORT     = NO
%UNICODE-SUPPORT      = NO
%NUMBER-OF-8-BIT-CHARACTER-SET-SUPPORTED = 0
%CHARACTER-SET-1      = 240        CHARACTER-SET-2      = NO
%CHARACTER-SET-3      = NO         CHARACTER-SET-4      = NO
%CHARACTER-SET-5      = NO         CHARACTER-SET-6      = NO
%CHARACTER-SET-7      = NO         CHARACTER-SET-8      = NO
%CHARACTER-SET-9      = NO         CHARACTER-SET-10     = NO
%CHARACTER-SET-11     = NO         CHARACTER-SET-12     = NO
%CHARACTER-SET-13     = NO         CHARACTER-SET-14     = NO
%CHARACTER-SET-15     = NO         CHARACTER-SET-16     = NO

The output was generated on a data display terminal (or terminal emulation) of the type 9763 and in the terminal mode Unicode. The value 240 for CHARACTER-SET-1 indicates that the Unicode code table is supported for this terminal. In this case, CODED-CHARACTER-SET=UTFE can be entered with a corresponding MODIFY-TERMINAL-OPTION command (7-bit mode is currently still entered, see CODED-CHARACTER-SET). 

Output in S variables

The command's INFORMATION operand identifies the S variables which are to be created. The following specifications are possible for INFORMATION:

Notation used in command

Abbreviated form used in table

INFORMATION = *OPTIONS

1

INFORMATION = *IDENTIFICATION

2

INFORMATION = *DIMENSIONS

3

INFORMATION = *CAPABILITIES

4

Output information

Name of the S variable          

T

Contents                   

Condition

Terminal output acknowledgment

var(*LIST).ACK-OUT

S

*NO
*YES

1

Use of an APL character set supported

var(*LIST).APL-CHAR-SET

S

*NO
*YES

1

Display of CCS 1 to 16
(example: the ISO standard ISO 8859-i corresponds to the value i from 1 through 16, i.e. for i=1 Latin 1 Western European; the value 240 corresponds to Unicode)

var(*LIST).CHAR-SET-1
.
.
var(*LIST).CHAR-SET-16

S

*NO /
<integer 1..16> /
<integer 240>

4

Chipcard reader fitted

var(*LIST).CHIP-CARD-READER

S

*YES / *NO

2

Terminal operating mode
(7-bit/8-bit/Unicode)

var(*LIST).CODED-CHAR-SET

S

<name 1..8>
*7-BIT

1

Number of colors supported

var(*LIST).COLOUR

S

*NO / 4 / 8

4

Output only supported for reasons
of compatibility

var(*LIST).DESK-SUPPORT

S

*YES / *NO

4

Supports 24 lines and 80 columns

var(*LIST).DIM-24-80

S

*YES / *NO

3

Supports 27 lines and 132 columns

var(*LIST).DIM-27-132

S

*YES / *NO

3

Supports 32 lines and 80 columns

var(*LIST).DIM-32-80

S

*YES / *NO

3

Supports 43 lines and 80 columns

var(*LIST).DIM-43-80

S

*YES / *NO

3

Output only supported for reasons of compatibility

var(*LIST).DOORS-SUPPORT

S

*YES / *NO

4

Encryption

var(*LIST).ENCRYPTION

S

*YES / *NO

4

Extended field attribute supported

var(*LIST).EXT-FIELD-ATTR

S

*YES / *NO

4

Extended line mode supported

var(*LIST).EXTEND-LINE-MODE

S

*YES / *NO

4

Form mode supported

var(*LIST).FORM-MODE

S

*YES / *NO

4

Use of a graphics option supported

var(*LIST).GRAPHIC

S

*NO
*YES

1

Hardcopy logging mode

var(*LIST).HARDCOPY

S

*CENTRAL
*LOC
*NO

1

ID card reader fitted

var(*LIST).ID-CARD-READER

S

*YES / *NO

2

Hardware information line present

var(*LIST).INFOLINE

S

*YES / *NO

4

End-of-line character

var(*LIST).LINE-END-CHAR

S

*NONE
<c-string 1..1>

1

Line length

var(*LIST).LINE-LEN

I

<integer 10..255>

1

Line mode supported

var(*LIST).LINE-MODE

S

*YES / *NO

4

Hardcopy device fitted

var(*LIST).LOCAL-HARDCOPY

S

*YES / *NO

1

Lowercase output supported

var(*LIST).LOW-CASE

S

*NO
*YES

1

Maximum number of lines before screen overflow

var(*LIST).MAX-LINE

I

<integer 3..255>

1

Number of 8-bit / Unicode encoded character sets (CCS)

var(*LIST).NUM-OF-8B-CHAR-SET

I

<integer 1..16>

4

Screen overflow control mode (no control, control by acknowledgment, control by timeout)

var(*LIST).OV-CONTR

S

*NO-CONTR
*TIME(TIMEOUT = xxx)
*USER-ACK

1

Partner type

var(*LIST).PARTNER-TYPE

S

TERMINAL / APPL

2

Maximum line length

var(*LIST).PHYS-LINE-LEN

I

<integer 1..32767>

3

Maximum number of lines

var(*LIST).PHYS-MAX-LINES

I

<integer 1..32767>

3

Size of screen buffer

var(*LIST).PHYS-MAX-BUF

I

<integer 1..32767>

3

Physical mode supported

var(*LIST).PHYS-MODE

S

*YES / *NO

4

Processor name

var(*LIST).PROCESSOR-NAME

S

<text 1..8>

2

Program prompts that read using RDATA (default “*”)

var(*LIST).PROGRAM-PROMPT

S

’*’
<c-string 1..32>

1

Protocol type (810 or 3270 protocol)

var(*LIST).PROTOCOL-TYPE

S

810 / 3270 

4

Terminal roll-up mode

var(*LIST).ROLL-UP


*YES
*NO

1

Station name

var(*LIST).STATION-NAME

S

<text 1..8>

2

Status request

var(*LIST).STATUS-REQUEST

S

*YES / *NO

4

Substitutes for nondisplayable characters

var(*LIST).SUBST-CHAR

S

<c-string 1..1>

1

System prompt (default “/”)

var(*LIST).SYSTEM-PROMPT

S

’/’
<c-string 1..32>

1

Terminal type

var(*LIST).TERMINAL-TYPE

S

<text 1..8>

2

Output message display control and input mode control

var(*LIST).WRITE-READ-MODE

S

*MOD-FIELD
*NO-FIELD

1

Powered by Atlassian Confluence and Scroll Viewport.