PHYSICAL TERMINAL

PHYSICAL-TERMINAL statements document the physical CRT, TTY, and printer devices in a teleprocessing system. In the DC/UCF environment, physical terminals are associated with logical terminals. In CA IDMS DDS environments, DDS physical terminals are associated with DDS lines (refer to CA IDMS DDS Design and Reference section).

idmscu19

It is recommended that you maintain PHYSICAL TERMINAL definitions using the system generation compiler, not
the DDDL compiler. If a system generation component is processed by the DDDL compiler, only dictionary security is checked, not
system generation security. For more information on using the system generation compiler, refer to CA IDMS Administrating section
.

If the SET OPTIONS statement specifies SECURITY FOR IDMS-DC IS ON, the user must be assigned the proper authority to issue PHYSICAL-TERMINAL statements.

Syntax

PHYSICAL-TERMINAL Statement


 
►►─┬─ ADD ─────┬─┬─ PHYsical-terminal ─┬─ name is physical-terminal-name ─────►
   ├─ MODify ──┤ └─ PTErm ─────────────┘
   ├─ REPlace ─┤
   └─ DELete ──┘

 ►─┬────────────────────────────────────────────┬─────────────────────────────►
   └─ Version is ─┬─ version-number ──────────┬─┘
                  └─┬─────────┬─┬───────────┬─┘
                    └─ NEXt ──┘ ├─ HIGhest ─┤
                                └─ LOWest ──┘

 ►─┬─────────────────────────────────────────────────────────┬────────────────►
   └─┬─ PREpared ─┬─ by user-id ──┬────────────────────────┬─┘
     └─ REVised ──┘               └─ PASsword is password ─┘
 
 ►─┬──────────────────────────────────────────────────────┬───────────────────►
   └─ physical-terminal DEScription is description-text ──┘

 ►─┬────────────────────────────────────────┬─────────────────────────────────►
   └─ DEVice TYPe is physical-device-type ──┘

 ►─┬──────────────────────────────────────────────────────┬───────────────────►
   └─ MAXimum PERmanent ERRors is ─┬─ 3 ◄ ──────────────┬─┘
                                   └─ line-error-count ─┘
 
   ┌─────────────────────────────────────────────────────────────────┐
 ►─▼─┬─────────────────────────────────────────────────────────────┬─┴────────►
     └─┬─ INClude ◄ ─┬─ USEr is user-id ──┬──────────────────────┬─┘
       └─ EXClude ───┘                    └─ user-specification ─┘

(for complete user-specification syntax, see USER clause)

 ►─┬──────────────────────────────────────────────────────┬───────────────────►
   └─ PUBlic access is ─┬───────────┬─ for ─┬─ ALL ◄ ───┬─┘
                        └─ ALLOwed ─┘       ├─ NONe ────┤
                                            ├─ UPDate ──┤
                                            ├─ MODify ──┤
                                            ├─ REPlace ─┤
                                            ├─ DELete ──┤
                                            └─ DISplay ─┘
 
   ┌──────────────────────────────────────────────────────────────────────────
 ►─▼┬─────────────────────────────────────────────────────────────────────────►─
    └┬ INClude ◄ ┬ within SYStem system-name ┬──────────────────────────────┬─
     └ EXClude -─┘                           └ Version is ┬ version-number ┬┘
                                                          ├ HIGhest ───────┤
                                                          └ LOWest ────────┘

  ─────────────────────────────────────────────────────────────────┐
─►───────────────────────────────────────────────────────────────┬─┴──────────►
  ─┬───────────────────────────────────────────────────────────┬─┘
   └─ LINe is line-name ─┬───────────────────────────────────┬─┘
                         └─ Version is ─┬─ version-number ─┬─┘
                                        ├─ HIGhest ────────┤
                                        └─ LOWest ─────────┘
 
   ┌────────────────────────────────────────────────────────────────────────┐
 ►─▼─┬─────────────────────────────────────────────────────────────────────┬┴─►
     └┬─ INClude ◄ ┬─ class-name is attribute-name ─┬────────────────────┬─┘
      └─ EXClude ──┘                                └ TEXt is user-text ─┘

   ┌────────────────────────────────────────────────────────────────────────┐
 ►─▼┬──────────────────────────────────────────────────────────────────────┬┴─►
    └ DC option is ─┬─ LINe is line-name ─┬─────────────────────────────┬┬─┘
                    │                     └─ Version is version-number ─┘│
                    ├─ PRInter class is printer-class ───────────────────┤
                    └─┬─ ENAbled ◄ ─┬────────────────────────────────────┘
                      └─ DISabled ──┘
 
   ┌───────────────────────────────────────────────────────────────┐
 ►─▼─┬───────────────────────────────────────────────────────────┬─┴──────────►
     │                            ┌────────────────────┐         │
     └─ EDIt ─┬─ COMments ────┬───▼─ edit-instruction ─┴─ QUIT ──┘
              ├─ DEFinition ──┤
              └─ comment-key ─┘

   ┌──────────────────────────────────────────────────┐
 ►─▼─┬─────────────────────────────────────────────┬──┴───────────────────────►◄
     └─┬─ COMments ─────┬── is ─┬─ NULl ─────────┬─┘
       ├─ DEFinition ───┤       └─ comment-text ─┘
       └─ comment-key ──┘





DISPLAY/PUNCH PHYSICAL-TERMINAL (for a single terminal)





►►─┬─ DISplay ─┬─┬─ PHYsical-terminal ─┬─ name is physical-terminal-name ─────►
   └─ PUNch ───┘ └─ PTErm ─────────────┘

 ►─┬───────────────────────────────────┬──────────────────────────────────────►
   └─ Version is ─┬─ version-number ─┬─┘
                  ├─ HIGhest ────────┤
                  └─ LOWest ─────────┘

 ►─┬───────────────────────────────────────────────────┬──────────────────────►
   └─ PREpared by user-id ─┬─────────────────────────┬─┘
                           └─ PASsword is password ──┘
 
   ┌───────────────────────────────────────────────────────────┐
 ►─▼─┬───────────────────────────────────────────────────────┬─┴──────────────►
     │                  ┌──────────────────────────────────┐ │
     └─┬─ WITh ──────┬──▼──┬─ ALL ───────────────────────┬─┴─┘
       ├─ ALSo WITh ─┤     ├─ ALL COMment TYPes ─────────┤
       └─ WITHOut ───┘     ├─ ATTributes ────────────────┤
                           ├─ COMments ──────────────────┤
                           ├─ DEFinitions ───────────────┤
                           ├─ DETails ───────────────────┤
                           ├─ HIStory ───────────────────┤
                           ├─ LINes ─────────────────────┤
                           ├─ NONe ──────────────────────┤
                           ├─┬─ SYStems ─────┬───────────┤
                           │ └─ SUBSYstems ──┘           │
                           ├─ USErs ─────────────────────┤
                           └─┬─ USEr DEFINED COMments ─┬─┘
                             └─ UDCs ──────────────────┘
 
 ►─┬──────────────────────────────────────────────────────────────────────────►─
   └─ TO ─┬─ SYSpch ──────────────────────────────────────────────────────────
          └─ MODule module-name ─┬───────────────────────────────────┬────────
                                 └─ Version is ─┬─ version-number ─┬─┘
                                                ├─ HIGhest ────────┤
                                                └─ LOWest ─────────┘

─►──────────────────────────────────────────────────────────────────────────┬─►
  ─────────────────────────────────────────────────────────────────────────┬┘
  ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘
   └ LANguage is language ┘└ PREpared by user-id ┬───────────────────────┬┘
                                                 └ PASsword is password ─┘

 ►─┬──────────────────────┬──┬─────────────────────┬──────────────────────────►◄
   └─ VERB ─┬─ DISplay ─┬─┘  └─ AS ─┬─ SYNtax ───┬─┘
            ├─ PUNch ───┤           └─ COMments ─┘
            ├─ ADD ─────┤
            ├─ MODify ──┤
            ├─ REPlace ─┤
            └─ DELete ──┘





DISPLAY/PUNCH PHYSICAL-TERMINAL (for multiple terminals)





►►─── DISplay ──┬─ ALL ──────────────────────────┬──┬─ PHYsical-terminals ─┬──►
                └─┬─ FIRst ─┬─┬─ 1 ◄ ──────────┬─┘  └─ PTErms ─────────────┘
                  ├─ NEXt ──┤ └─ entity-count ─┘
                  ├─ LASt ──┤
                  └─ PRIor ─┘

 ►─┬──────────────────────────────────────────────────┬───────────────────────►
   └─ PREpared by user-id ─┬────────────────────────┬─┘
                           └─ PASsword is password ─┘

 ►─┬─────────────────────────────────┬────────────────────────────────────────►
   └─ WHEre conditional-expression ──┘

(for complete conditional-expression syntax, see WHERE clause)
 
 ►─┬──────────────────┬───────────────────────────────────────────────────────►
   └─ BY ─┬─ SET ◄ ─┬─┘
          └─ AREa ──┘

 ►─┬──────────────────────────────────────────────────────────────────────────►─
   └─ TO ─┬─ SYSpch ──────────────────────────────────────────────────────────
          └─ MODule module-name ─┬───────────────────────────────────┬────────
                                 └─ Version is ─┬─ version-number ─┬─┘
                                                ├─ HIGhest ────────┤
                                                └─ LOWest ─────────┘
 
─►──────────────────────────────────────────────────────────────────────────┬─►
  ─────────────────────────────────────────────────────────────────────────┬┘
  ─┬──────────────────────┬┬──────────────────────────────────────────────┬┘
   └ LANguage is language ┘└ PREpared by user-id ┬───────────────────────┬┘
                                                 └ PASsword is password ─┘

 ►─┬──────────────────────┬──┬──────────────────────────────────────┬─────────►◄
   └─ VERB ─┬─ DISplay ─┬─┘  └─ AS ─┬─ SYNtax ───┬──┬─────────────┬─┘
            ├─ PUNch ───┤           └─ COMments ─┘  └─ RECursive ─┘
            ├─ ADD ─────┤
            ├─ MODify ──┤
            ├─ REPlace ─┤
            └─ DELete ──┘

Parameters

PHYsical-terminal name is physical-terminal-name

Identifies a new physical terminal to be established in the dictionary, or an existing physical terminal to be modified, replaced, deleted, displayed, or punched. PTErm is a synonym for physical-terminal. Physical-terminal-name
must be a 1- through 8-character alphanumeric value.

DEVice TYPe is physical-device-type

Specifies the device type of the named physical terminal. The specified device type must be a valid device for the line type defined for the line with which the named physical terminal is associated. Valid values are listed under Usage
.

MAXimum PERmanent ERRors is 3/line-error-count

Specifies the number of retries performed after a terminal I/O error before the teleprocessing monitor will disable the physical terminal. Line-error-count
must be an integer in the range 0 through 255; the default for ADD is 3.

within SYStem system-name

Associates the named physical terminal with the specified system. System-name
must be the 1- to 32-character name of an existing system. One physical terminal can be associated with multiple systems. The WITHIN SYSTEM specification is documentation only, unless the system generation compiler COPY facility is to be used to copy physical-terminal definitions from an IDD-built system. When the COPY facility is not used, all functional physical-terminal/system relationships are established and maintained by the system generation compiler.

LINe is line-name

Associates an existing line with the physical-terminal/system relationship. A physical-terminal/system relationship can be associated with only one line. In the DC/UCF environment, the LINE parameter is documentation. The functional physical-terminal/system relationship is established by means of the DC OPTION clause (described below) or directly through the system generation compiler.

DC option is

Assigns options to the named physical-terminal definition for use with DC/UCF systems.

LINe is line-name

Associates a line with the named physical terminal. Note that an explicit version number must be specified; the keywords NEXT HIGHEST and NEXT LOWEST are not valid.

PRInter class is printer-class

Assigns a printer class to the physical terminal. Printer-class
must identify a printer class defined in the LOGICAL-TERMINAL statement and must be an integer in the range 1 through 64. Omit this specification if the physical terminal itself is a printer device such as a 3284.

ENAbled

Automatically enables the terminal at system startup. ENABLED is the default.

DISabled

Disables the terminal until it is enabled explicitly by an operator command during system execution.

WITh/ALSo WITh/WITHOut

Includes or excludes the specified options when the named physical terminal is displayed or punched. Detailed information for each DISPLAY/PUNCH option is under SET OPTIONS Syntax. The option that is listed below presents special considerations for this entity type.

DETails

Includes the DESCRIPTION, DC OPTION, DEVICE TYPE, and MAXIMUM PERMANENT ERRORS specifications.

Usage

Valid device and line types

	Device type
ASYNC	CRT/ASR33/2741/RO33
BSC2	R3275S/R3741S/R3780S
BSC3	R3275/R3277/R3278/R3279/R3284 R3286/R3287/R3288/R3289/R3741 R3780
CONSOLE	OPERATOR
DDS	SVC/CTC/BSC/VTAM
INOUTL	INOUTT
L3270B	L3277/L3278/L3279
VTAMLIN	V3277/V3278/V3279/V3284/V3286 V3287/V3288/V3289
L3280B	L3284/L3286/L3287/L3288/L3289
SYSOUTL	SYSOUTT
S3270Q	S3277/S3278/S3279
TCAMLIN	TCAMTRM
UCFLINE	UCFTERM
VTAMLU	LU/3600LU/3600PL/3614/LU62

If you specify REPLACE

If you specify REPLACE, the DDDL compiler initializes to defaults and/or excludes the following options:

DESCRIPTION

DEVICE TYPE

MAXIMUM PERMANENT ERRORS

USER REGISTERED FOR

COMMENTS/DEFINITION/comment-key

PUBLIC ACCESS

WITHIN SYSTEM

DC OPTION

Related attributes

Physical-terminal/system relationships established by means of the system generation compiler are not affected.

Examples

The following ADD statement defines the physical terminal TM026 within the teleprocessing system INVENTORY; the DEVICE TYPE and LINE clauses further identify the physical terminal as a valid device type within the line A103.


add physical-terminal tm026
    physical-terminal description is 'desk 26: assigned dgs'
    device type is l3277
    within system inventory
       line is a103.

The following MODIFY statement disassociates the physical terminal from the system INVENTORY in preparation for use by a DC/UCF system; the DC OPTION clause associates the physical terminal with the LINE occurrence.


modify physical-terminal tm026
    exclude within system inventory
    dc option is line is a103.

Entity-Type Syntax

CA IDMS Reference 19.0

PHYSICAL TERMINAL