LINE

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 , later in this section. Optional LINE statement clauses assign characteristics for use in the DC/UCF system and the Distributed Database System (CA IDMS DDS) environments.

idmscu19

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 section. Optional LINE statement clauses assign characteristics for use in the DC/UCF system and the Distributed Database System (CA IDMS DDS) environments.

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 Administrating section
.

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

LINe name is line-name

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.

LINe TYPe is line-type

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.

within SYStem system-name

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.

DC option is

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.

ENAbled

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

DISabled

Disables the line until it is explicitly enabled by means of an operator command during system execution.

WITh/ALSo WITh/WITHOut

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.

DETails

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:

DESCRIPTION

LINE TYPE

USER REGISTERED FOR

PUBLIC ACCESS

WITHIN SYSTEM (if built by the DDDL compiler)

COMMENTS/DEFINITION/comment-key

DC OPTION

Related attributes

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.

Entity-Type Syntax

CA IDMS Reference 19.0

LINE