CA IDMS Reference 19.0

PDF
English

SYSTEM (SUBSYSTEM)

SYSTEM statements are used to document automated or manual data processing systems. Optional clauses relate systems to users and to other systems and support attribute/entity relationships and documentation entries.
idmscu19
SYSTEM statements are used to document automated or manual data processing systems. Optional clauses relate systems to users and to other systems and support attribute/entity relationships and documentation entries.
  • It is recommended that you maintain SYSTEM 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
    .
  • The keyword SUBSYSTEM can be used interchangeably with the keyword SYSTEM.
If the SET OPTIONS statement specifies SECURITY FOR IDD IS ON, the user must be assigned the proper authority to issue SYSTEM statements. Note that DDDL statements cannot be used to delete systems built by the system generation compiler.
This article describes the following information:
2
2
Syntax
SYSTEM (SUBSYSTEM) statement
 

►►─┬─ ADD ─────┬─┬─ SYStem ─────┬─ name is 
system-name
 ───────────────────────►
   ├─ MODify ──┤ └─ SUBSYstem ──┘
   ├─ REPlace ─┤
   └─ DELete ──┘
 ►─┬────────────────────────────────────────────┬─────────────────────────────►
   └─ Version is ─┬─ 
version-number
 ──────────┬─┘
                  └─┬─────────┬─┬─ HIGhest ─┬─┘
                    └─ NEXt ──┘ └─ LOWest ──┘
 ►─┬─────────────────────────────────────────────────────────┬────────────────►
   └─┬─ PREpared ─┬─ by 
user-id
 ──┬────────────────────────┬─┘
     └─ REVised ──┘               └─ PASsword is 
password
 ─┘
   ┌────────────────────────────────────────────────────────────────────────┐
 ►─▼─┬─────────────────────────────────────────────────────────────────────┬┴─►
     └ SAMe as ┬ SYStem ───┬ 
system-name
 ┬────────────────────────────────┬┘
               └ SUBSYstem ┘             └ Version is ┬─ 
version-number
 ─┬┘
                                                      ├─ HIGhest ────────┤
                                                      └─ LOWest ─────────┘
   ┌──────────────────────────────────────────────────────────────────────────
 ►─▼─┬────────────────────────────────────────────────────────────────────────►─
     └─ COPY ─┬─ ALL COMment TYPes ─┬─ FROm ─┬─ SYStem ────┬─ 
system-name
 ───
              ├─ COMments ───────────┤       └─ SUBSYstem ─┘
              ├─ DEFinition ─────────┤
              ├─ ATTributes ─────────┤
              ├─ USErs ──────────────┤
              ├─ MODules ────────────┤
              ├─ PROgrams ───────────┤
              ├─┬─ SYStems ───┬──────┤
              │ └─ SUBSYtems ─┘      │
              ├─ WIThin SYStem ──────┤
              ├─ WIThin SUBSYstem ───┤
              ├─ 
comment-key
 ────────┤
              └─ 
relational-key
 ─────┘
   ──────────────────────────────────────────┐
 ─►────────────────────────────────────────┬─┴─────────────────────────────────►
   ─┬────────────────────────────────────┬─┘
    └─ Version is ─┬─ 
version-number
 ──┬─┘
                   ├─ HIGhest ─────────┤
                   └─ LOWest ──────────┘
 ►─┬────────────────────────────────────────────────────────────────────────┬─►
   └ NEW NAMe is 
new-system-name
 ──┬──────────────────────────────────────┬─┘
                                   └ Version is ─┬─ 
version-number
 ─────┬─┘
                                   └─ NEXt ─┬─ HIGhest ─┬─┘
                                            └─ LOWest ──┘
 ►─┬───────────────────────────────────────────┬──────────────────────────────►
   └─ NEW Version is ─┬─ 
new-version-number
 ─┬─┘
                      └─ NEXt ─┬─ HIGhest ─┬─┘
                               └─ LOWest ──┘
 ►─┬─────────────────────────────────────────────────────┬────────────────────►
   └─┬──────────────┬─ DEScription is 
description-text
 ──┘
     ├─ system ─────┤
     └─ subsystem ──┘
   ┌─────────────────────────────────────────────────────────────────┐
 ►─▼─┬─────────────────────────────────────────────────────────────┬─┴────────►
     └─┬─ 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 ────┘          └─ SUBSYstem ─┘
   ───────────────────────────────────────────────────────────────────┐
 ─►────────────────────────────────────────────────────────────────┬──┴────────►
   ─┬───────────────────────────────────┬─┬──────────────────────┬─┘
    └─ Version is ─┬─ 
version-number
 ─┬─┘ └─ TEXt is 
user-text
 ──┘
                   ├─ HIGhest ────────┤
                   └─ LOWest ─────────┘
   ┌────────────────────────────────────────────────────────────────────────┐
 ►─▼┬──────────────────────────────────────────────────────────────────────┬┴─►
    └┬─ INClude ◄ ─┬─ 
class-name
 is 
attribute-name
 ─┬────────────────────┬─┘
     └─ EXClude ───┘                                └ TEXt is 
user-text
 ─┘
   ┌──────────────────────────────────────────────────────────────────────────
 ►─▼─┬────────────────────────────────────────────────────────────────────────►─
     └─┬─ INClude ◄ ─┬─ 
relational-key
 is 
system-name
 ────────────────────────
       └─ EXClude ───┘
   ──────────────────────────────────────────────────────────────────┐
 ─►────────────────────────────────────────────────────────────────┬─┴─────────►
   ─┬────────────────────────────────────┬─┬─────────────────────┬─┘
    └─ Version is ─┬─ 
version-number
 ─┬──┘ └─ TEXt is 
user-text
 ─┘
                   ├─ HIGhest ────────┤
                   └─ LOWest ─────────┘
   ┌───────────────────────────────────────────────────────────────┐
 ►─▼─┬───────────────────────────────────────────────────────────┬─┴──────────►
     │                            ┌────────────────────┐         │
     └─ EDIt ─┬─ COMments ────┬───▼─ 
edit-instruction
 ─┴─ QUIT ──┘
              ├─ DEFinition ──┤
              └─ 
comment-key
 ─┘
   ┌──────────────────────────────────────────────────┐
 ►─▼─┬─────────────────────────────────────────────┬──┴───────────────────────►◄
     └─┬─ COMments ─────┬── is ─┬─ NULl ─────────┬─┘
       ├─ DEFinition ───┤       └─ 
comment-text
 ─┘
       └─ 
comment-key
 ──┘
DISPLAY/PUNCH SYSTEM (SUBSYSTEM) statement (for a single system)
 

►►─┬─ DISplay ─┬──┬─ SYStem ────┬─ name is 
system-name
 ───────────────────────►
   └─ PUNch ───┘  └─ SUBSYstem ─┘
 ►─┬───────────────────────────────────┬──────────────────────────────────────►
   └─ Version is ─┬─ 
version-number
 ─┬─┘
                  ├─ HIGhest ────────┤
                  └─ LOWest ─────────┘
 ►─┬───────────────────────────────────────────────────┬──────────────────────►
   └─ PREpared by 
user-id
 ─┬─────────────────────────┬─┘
                           └─ PASsword is 
password
 ──┘
   ┌────────────────────────────────────────────────────────┐
 ►─▼─┬────────────────────────────────────────────────────┬─┴─────────────────►
     │                ┌─────────────────────────────────┐ │
     ├─ WITh ──────┬──▼──┬─ ALL ─────────────────────┬──┴─┘
     ├─ ALSo WITh ─┤     ├─ ALL COMment TYPes ───────┤
     └─ WITHOut ───┘     ├─ ATTributes ──────────────┤
                         ├─ COMments ────────────────┤
                         ├─ DEFinitions ─────────────┤
                         ├─ DEStinations ────────────┤
                         ├─ DETails ─────────────────┤
                         ├─ HIStory ─────────────────┤
                         ├─ LINes ───────────────────┤
                         ├─┬─ LOGical-terminals ┬────┤
                         │ └─ LTErms ───────────┘    │
                         ├─ MAPs ────────────────────┤
                         ├─ MODules ─┬────────┬──────┤
                         │           └─ ONLy ─┘      │
                         ├─ NONe ────────────────────┤
                         ├─┬─ PHYsical-terminals ─┬──┤
                         │ └─ PTErms ─────────────┘  │
                         ├─ PROCesses ───────────────┤
                         ├─ PROgrams ────────────────┤
                         ├─ SAMe AS ─────────────────┤
                         ├─┬─ SYStems ────┬──────────┤
                         │ └─ SUBSYstems ─┘          │
                         ├─ TASks ───────────────────┤
                         ├─ QFIles ──────────────────┤
                         ├─ QUEues ──────────────────┤
                         ├─ TABles ──────────────────┤
                         ├─ USErs ───────────────────┤
                         ├─┬─ USEr DEFINED COMments ┬┤
                         │ └─ UDCs ─────────────────┘│
                         ├─┬─ USEr DEFINED NESts ─┬──┤
                         │ └─ UDNs ───────────────┘  │
                         ├─ WHEre USED ──────────────┤
                         └─ WITHIn ─┬─ SYStem ────┬──┘
                                    └─ SUBSYstem ─┘
 ►─┬──────────────────────────────────────────────────────────────────────────►─
   └─ 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 SYSTEM (SUBSYSTEM) statement (for multiple systems)
 

►►─┬─ DISplay ─┬─┬─ ALL ──────────────────────────┬─┬─ SYStems ────┬──────────►
   └─ PUNch ───┘ └─┬─ FIRst ─┬─┬─ 1 ◄ ──────────┬─┘ └─ SUBSYstems ─┘
                   ├─ 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
  • SYStem/SUBSYstem name is
    system-name
    Identifies a new system to be established in the dictionary, or an existing system to be modified, replaced, deleted, displayed, or punched.
    System-name
     must be a 1- through 32-character alphanumeric value.
  • NEW NAMe is
    new-system-name
    Specifies a new name for the requested system. This clause changes the name of the requested system only; it does not alter or delete any relationships in which the system participates. Subsequent references to the system must specify the new name. The concatenation of the new system name and version number must not duplicate that of an existing system occurrence. The NEW NAME clause is not valid for systems created by the CA IDMS/DC system generation compiler.
  • NEW Version is
    new-version-number
    /NEXt HIGhest/NEXt LOWest
    Specifies a new version number for the named system. The combination of system name and new version number must not duplicate that of an existing system occurrence. The NEW VERSION clause is not valid for systems created by the CA IDMS/DC system generation compiler.
  • WIThin SYStem/SUBSYstem
    system-name
    Associates (INCLUDE) the named system with or disassociates (EXCLUDE) it from the system/subsystem identified by the 1- through 32-character
    system-name
    .
  • WITh/ALSo WITh/WITHOut
    Includes or excludes the specified options when the named system is displayed or punched. Detailed information for each DISPLAY/PUNCH option is under SET OPTIONS Syntax. The options that are listed below present special considerations for this entity type.
  • DETails
    Includes the DESCRIPTION specification.
  • SYStems (SUBSYstems)
    Includes WITHIN SYSTEM specifications and user-defined nests.
Usage
If you specify REPLACE
If the REPLACE verb is specified, the DDDL compiler initializes to defaults and/or excludes the following:
  • DESCRIPTION
  • USER REGISTERED FOR
  • PUBLIC ACCESS
  • COMMENTS/DEFINITIONS/
    comment-key
  • WITHIN SYSTEM/SUBSYSTEM
  • ATTRIBUTES
The following relationships are not affected:
  • Users assigned access to the named system
  • CA IDMS/DC definitions, destinations, lines, logical terminals, maps, programs, physical terminals, queues, modules, tasks, and systems in which the named system participates as a component
Example
The following ADD statement defines the system INVENTORY, relates that system to two existing users and an existing system, and establishes two documentation relationships by means of a class/attribute structure and a relational key.

add system inventory
    prepared by dba password is 'ice 9'
    system description is 'present inventory system'
    user is accounting
    user is receiving
    within system order-control
    status is production
    'similar system' is back-order.
This second ADD statement defines version 2 of the same system by copying the definition of version 1 and removing copied options that are not applicable to the proposed system. Note that the DDDL compiler generates a PREPARED BY entry for the second system only if a SET OPTIONS statement has provided a default PREPARED BY specification; use of the SAME AS option does not generate a PREPARED BY or REVISED BY entry.

add system inventory version is 2
    same as system inventory
    exclude status is production
    status is design
    exclude 'similar system' is back-order
    exclude within system order-control
    system description is 'proposed inventory system'.