LINE statements are used to document the association between a line and a physical terminal in a teleprocessing system. A physical terminal is associated with a line by means of the PHYSICAL-TERMINAL statement, described under PHYSICAL TERMINAL, later in this chapter. Optional LINE statement clauses assign characteristics for use in the DC/UCF system and the Distributed Database System (CA IDMS DDS) environments.
Note: It is recommended that you maintain LINE 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 LINE statements.
Syntax
LINE Statement
►►─┬─ ADD ─────┬─ LINe name is line-name ─────────────────────────────────────► ├─ MOdify ──┤ ├─ REPlace ─┤ └─ DELete ──┘ ►─┬───────────────────────────────────────┬──────────────────────────────────► └─ Version is ─┬─ version-number ─────┬─┘ └─ NEXt ─┬─ HIGhest ─┬─┘ └─ LOWest ──┘ ►─┬────────────────────────────────────────────────────────┬─────────────────► └┬─ PREpared ─┬─ by user-id ──┬────────────────────────┬─┘ └─ REVised ──┘ └─ PASsword is password ─┘ ►─┬─────────────────────────────────────────┬────────────────────────────────► └─ line DEScription is description-text ──┘ ►─┬───────────────────────────┬──────────────────────────────────────────────► └─ line TYPe is line-type ──┘ ┌─────────────────────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────────────────────┬─┴────────► └─┬─ 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 ─────────┘ ┌────────────────────────────────────────────────────────────────────────┐ ►─▼┬──────────────────────────────────────────────────────────────────────┬┴─► └┬─ INClude ◄ ─┬─ class-name is attribute-name ─┬─────────────────────┬┘ └─ EXClude ───┘ └─ TEXt is user-text ─┘ ►─┬────────────────────────────────┬─────────────────────────────────────────► └─ DC option is ─┬─ ENAbled ◄ ─┬─┘ └─ DISabled ──┘ ┌───────────────────────────────────────────────────────────────┐ ►─▼─┬───────────────────────────────────────────────────────────┬─┴──────────► │ ┌────────────────────┐ │ └─ EDIt ─┬─ COMments ────┬───▼─ edit-instruction ─┴─ QUIT ──┘ ├─ DEFinition ──┤ └─ comment-key ─┘ ┌──────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────┬──┴───────────────────────►◄ └─┬─ COMments ─────┬── is ─┬─ NULl ─────────┬─┘ ├─ DEFinition ───┤ └─ comment-text ─┘ └─ comment-key ──┘
DISPLAY/PUNCH LINE Statement (for a single line)
►►─┬─ DISplay ─┬─ LINe name is line-name ─────────────────────────────────────► └─ PUNch ───┘ ►─┬───────────────────────────────────┬──────────────────────────────────────► └─ 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 ───────────────────┤ ├─ 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 LINE Statement (for multiple lines)
►►─┬─ DISplay ─┬─┬─ ALL ──────────────────────────┬─ LINes ───────────────────► └─ PUNch ───┘ └─┬─ FIRst ─┬─┬─ 1 ◄ ──────────┬─┘ ├─ 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 either a new line to be established in the dictionary or an existing line to be modified, replaced, deleted, displayed, or punched. Line-name must be a 1- through 8-character alphanumeric value.
Specifies a generic line type. Line-type must be one of the following values:
|
ASYNC |
BSC2 |
|
BSC3 |
CONSOLE |
|
INOUTL |
L3270B |
|
L3280B |
S3270Q |
|
SYSOUTL |
TCAMLIN |
|
UCFLINE |
VTAMLIN |
|
VTAMLU |
|
The LINE TYPE specification is documentation only, unless the line definition is to be copied into a DC/UCF system using the system generation compiler COPY facility.
Associates (INCLUDE) the named line with or disassociates (EXCLUDE) it from a system. System-name must be the 1- through 32-character name of an existing system. The WITHIN SYSTEM specification is documentation only, unless the system generation compiler COPY facility is to be used to copy the line definition from an IDD-built system. When the COPY facility is not used, all line/system relationships are established and maintained by the system generation compiler.
Specifies whether the named line is to be enabled or disabled automatically when the system starts up.
The DC OPTION specification is documentation only, unless the line definition is to be copied into a DC/UCF system using the system generation compiler COPY facility.
Automatically enables the line at system startup. ENABLED is the default.
Disables the line until it is explicitly enabled by means of an operator command during system execution.
Includes or excludes the specified options when the named line 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, LINE TYPE, and DC OPTION specifications.
Usage
If you specify REPLACE
If you specify REPLACE, the DDDL compiler initializes to defaults and/or excludes the following options:
Line-system relationships established by the system generation compiler are not affected.
Example
In the following example, the ADD statement registers the line ROE3 within the system INVENTORY and describes the physical terminals within the line group as 3270s. The MODIFY statement removes the line from the INVENTORY system so that the line can be accessed using the system generation compiler COPY facility.
add line roe3
prepared by dba password is 'ice 9'
definition is 'line between inventory central and oebost'
- 'terminals are remote 3270s using btam'
line type is bsc3
within system inventory.
modify line roe3
revised by dba
exclude system inventory.
|
Copyright © 2014 CA.
All rights reserved.
|
|