Previous Topic: LTERM Statement SyntaxNext Topic: LTERM Statement Usage


LTERM Statement Parameters

LTErm logical-terminal-id

Specifies the logical terminal identifier.

Logical-terminal-id must be a one- through eight-character value.

Version is version-number

Qualifies the logical 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 logical terminal can exist in the data dictionary, only one version of a logical terminal can be used by a system at runtime. If multiple ADD LTERM statements specify the same logical terminal identifier, the system uses the version that appears first in the system definition.

AUTotask is

Specifies whether the system is to initiate a task automatically when the logical terminal is enabled.

Note: Users can override the AUTOTASK specification at runtime with the DCMT VARY LTERM ONLINE command.

task-code

Specifies the system will execute the task identified by task-code whenever the ENTER NEXT TASK CODE prompt normally would be displayed and when a DC RETURN request specifying no next task code is issued.

Task-code must be a task code previously defined in the data dictionary with a TASK statement. If the TASK statement for task-code specifies the INPUT option, the task will not begin executing until the terminal operator enters data. If the TASK statement specifies the NOINPUT option, the task begins executing as soon as it receives control.

NULl

Indicates no task will be initiated automatically for the logical terminal.

NULL is the default when you omit the AUTOTASK parameter from the LTERM statement.

Note: Logical terminals defined as printers must use the default value of NULL.

BATch

Specifies the logical terminal is a batch device.

COMmand initiated

Specifies the logical terminal will process batch data by using the task code specified in the AUTOTASK parameter.

TERminal initiated

Specifies the logical terminal will process data in response to a task code entered from the batch terminal. The system leaves a read request outstanding for the terminal. If TERMINAL INITIATED is specified, the system prompt (ENTER NEXT TASK CODE) is not displayed at the terminal.

Note: Users can override the COMMAND/TERMINAL INITIATED specification at runtime with the DCMT VARY LTERM command.

PRInter

Specifies the terminal is a printer.

BANner

Indicates a banner page is printed with each report on the printer device defined by the PRINTER parameter. A banner page separates each report and contains information about when the report was created and who created it.

BANNER is the default when you specify neither BANNER nor NOBANNER with the PRINTER parameter of the LTERM statement.

NOBanner

Indicates that no banner page will be printed.

CHEckpoint is

Specifies the printer checkpoint value to use when printing reports. At runtime, printer checkpoints are taken for all active reports at a specified interval. If printing is interrupted by a system abend or a hardware problem (for example, out-of-paper), the system resumes printing the report at the last checkpoint.

page-count

Specifies the printer checkpoint interval

Page-count must be an integer in the range 0 through 32,767. A value of 0 is synonymous with OFF.

SYStem

Directs the system to use the value specified in the PRINTER CHECKPOINT parameter of the current SYSTEM statement.

SYSTEM is the default when you omit the CHECKPOINT parameter from the PRINTER parameter of the LTERM statement.

OFF

Disables the printer checkpoint facility. The system resumes printing interrupted reports from the beginning of the file.

CLAss is

Defines the printer class list for the logical terminal.

Note: Users can override the CLASS specification at runtime with the DCMT VARY PRINTER command.

ADD

Adds one or more printer classes to the printer class list.

ADD is the default when you specify neither ADD nor DELETE in the CLASS parameter of the PRINTER parameter of the LTERM statement.

DELete

Deletes one or more printer classes from the printer class list.

DELETE is valid only for MODIFY operations.

(printer-class)

Specifies one or more printer classes.

Printer-class must be an integer in the range 1 through 64. Multiple printer classes must be separated by blanks.

ALL

Assigns all printer classes (that is, 1 through 64) to the logical terminal.

NOPrinter

For MODIFY statements only, changes a logical terminal previously defined as a printer back to an interactive device. When you specify NOPRINTER, the system generation compiler automatically clears all other printer-related parameters such as CLASS, CHECKPOINT, and BANNER. The LTERM specification reverts to the default, INTERACTIVE BREAK.

ENAbled

Indicates the logical terminal is enabled at system startup.

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

DISabled

Indicates the logical terminal is not enabled at system startup.

Note: Users can override the ENABLED/DISABLED specification at runtime with the DCMT VARY LTERM command.

PRInter CONtrol is

Specifies the printer form feed options.

SYStem

Specifies the printer control options established for the system are used for this printer. This is the default.

SCS FORmfeed is

Specifies the form feed sequence sent to SCS devices.

FF-NL

Specifies the form feed sequence is "FF" (form feed) followed by "NL" (new line). FF-NL is the default.

FF

Specifies the form feed sequence contains "FF" only.

ON REPort STArt

Specifies what happens when a report starts printing.

FORmfeed for NATive print is

Specifies the form feed processing for native mode print reports.

FORmfeed for NON-Native print is

Specifies the form feed processing for non-native mode print reports.

Parameters for the two FORmfeed options are:

INSert

A form feed is inserted, if needed.

SUPpress

The report never starts with a form feed, i.e., if the report starts with a form feed, it is removed.

NO-Insert

No change to the report contents is made.

SCS CR-LF is

Suppresses the Carriage Return/Line Feed sequence at the beginning of a report transmitted to an SCS printer.

ON REPort END

Specifies what happens when a report finishes printing.

FORmfeed for NATive print is

Specifies the form feed processing for native mode print reports.

FORmfeed for NON-Native print is

Specifies the form feed processing for non-native mode print reports.

Parameters for the two FORmfeed options are:

INSert

A form feed is inserted.

NO-Insert

No form feed is inserted.

PRIority is logical-terminal-priority

Specifies the logical terminal's dispatching priority. For tasks associated with a logical terminal, the specified priority is added to the priorities specified in the TASK statement (described in TASK Statement) to determine the priority assigned to the task at runtime.

If the sum of the above values is greater than 240, a dispatching priority of 240 is assigned at runtime. Terminal-priority must be an integer in the range 0 (lowest priority) through 240. The default is 0.

For more information about how terminal priorities are assigned, see Specifying a TERMINAL PRIORITY.

PTErm is physical-terminal-id

Specifies the physical terminal with which the logical terminal is associated.

Physical-terminal-id must be the identifier of a physical terminal previously defined in the data dictionary with a PTERM statement.

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

Note: Users can override the PTERM IS specification at runtime with the DCMT VARY LTERM command.

Version version-number

Qualifies the physical terminal identifier with a version number. Version-number must be an integer in the range 1 through 9999. The default is 1.