Previous Topic: PTERM Statement SyntaxNext Topic: PTERM Statement Usage


PTERM Statement Parameters

PTErm physical-terminal-id

Specifies the physical terminal identifier. Physical-terminal-id must be a one- through eight-character value.

Version is version-number

Qualifies physical terminal definition with a version number.

Version-number must be an integer in the range 1 through 9999. The default is 1.

Although multiple versions of a physical terminal can exist in the data dictionary, a system can use only one version of the physical terminal at runtime. If multiple ADD PTERM statements specify the same physical terminal identifier, the system uses the version that appears first in the system definition.

ENAbled

Indicates the physical terminal is enabled at system startup.

ENABLED is the default when you specify neither ENABLED nor DISABLED in the PTERM statement.

DISabled

Indicates the physical terminal is not enabled at system startup.

Note: See the CA IDMS System Tasks and Operator Commands Guide for PTERM runtime override options.

in LINe line-id

Specifies the line with which the physical terminal is associated.

Line-id must be the identifier of a line previously defined in the data dictionary with a LINE statement.

Version version-number

Qualifies the line identifier with a version number.

Version-number must be an integer in the range 1 through 9999. The default is 1.

This parameter can be omitted if the physical terminal is to be associated with the current line.

maximum ERRors is line-error-count

Specifies the maximum number of retries (after a terminal I/O error) the system is to perform before disabling the physical terminal.

Line-error-count must be an integer in the range 0 through 255. The default is 3.

PRInter BUFfer size is printer-buffer-size

Defines the size, in bytes, of the printer's physical buffer. The buffer size determines the largest data stream that can be written to the printer at one time.

Printer-buffer-size must be an integer in the range 0 through 32,767. The default is 0. If 0 is specified, the largest data stream that can be written to the printer is 480 bytes.

Note: If the value specified by this parameter exceeds the actual size of the printer buffer, data may be lost. The user is not notified when data is lost.

PRInter

Establishes the default class or destination for WRITE TO PRINTER requests issued from the physical terminal.

CLAss is printer-class

Establishes the default printer class for WRITE TO PRINTER requests issued from the physical terminal. Printer classes are associated with a printer device through the PRINTER CLASS parameter of the printer's LTERM statement (described under LTERM Statement).

Printer-class must be an integer in the range 0 through 64. The default is 1. If 0 is specified, print output is not required for the physical terminal. For example, the terminal is a printer.

DEStination is

Establishes the default printer destination for WRITE TO PRINTER requests issued from the physical terminal.

printer-destination-id

Specifies the printer destination.

Printer-destination-id is the name of a printer destination previously defined with a DESTINATION statement.

You must be sure the destination entity occurrence exists. When a destination is deleted from a system definition, all affected PTERM statements must be updated to ensure the system remains executable.

NULl

Indicates the physical terminal has no default printer destination.

REAdbuffer

For 3270-type devices only, allows the specified PTERM to execute a READ BUFFER command.

READBUFFER is the default when you specify neither READBUFFER nor NOREADBUFFER in the PTERM statement.

NOReadbuffer

For 3270-type devices only, prevents the specified PTERM from executing a READ BUFFER command.

REPeat COUnt is repeat-count

Specifies the number of times the physical and eventually associated logical terminal should be cloned when a central version is started. repeat-count must be an integer in the range 0 through 32767. Repeat-count 0 means no cloning. If a non-zero repeat-count is specified, the physical and logical terminal name should end on a sequence number and the sum of that sequence number and the repeat count should not cause a digit overflow.

SCReen type is device-table-name

Associates a device independence table with a visual-display teletypewriter terminal (glass TTY). The device independence table provides support for mapping operations to and from the TTY.

Device-table-name must be a 3-character alphanumeric name suffix of a device independence table, as specified in the NAME= parameter of the #TTYDIT macro.

Note: Users can override this parameter at runtime with the DCUF SET SCREEN command.

TYPe is physical-terminal-device-type

Specifies the physical terminal device type.

Physical-terminal-device-type must be a valid device type for the line with which the physical terminal is associated.

The TYPE parameter is required to create an executable system.

additional parameters applicable to physical-terminal-device-type

Specify optional characteristics that complete the physical terminal definition.

Syntax for the additional parameters applicable to each physical terminal device type is presented under the heading for the associated line type later in this section.