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 Operations Guide).
Note: 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 System Generation Guide.
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
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.
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.
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.
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.
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.
Assigns options to the named physical-terminal definition for use with DC/UCF systems.
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.
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.
Automatically enables the terminal at system startup. ENABLED is the default.
Disables the terminal until it is enabled explicitly by an operator command during system execution.
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.
Includes the DESCRIPTION, DC OPTION, DEVICE TYPE, and MAXIMUM PERMANENT ERRORS specifications.
Usage
Valid device and line types
|
Line type |
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:
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.
|
Copyright © 2014 CA.
All rights reserved.
|
|