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.
Note: 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 System Generation Guide.
Note: 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.
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
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.
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.
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.
Associates (INCLUDE) the named system with or disassociates (EXCLUDE) it from the system/subsystem identified by the 1- through 32-character system-name.
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.
Includes the DESCRIPTION specification.
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:
The following relationships are not affected:
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'.
|
Copyright © 2014 CA.
All rights reserved.
|
|