DESTINATION statements are used to document groups of users or logical terminals as a single logical destination within a teleprocessing system. The inclusion of a logical destination in a DC/UCF system permits the routing of a message simultaneously to all users or logical terminals that are included in the destination definition.
Note: It is recommended that you maintain DESTINATION 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 DESTINATION statements.
Syntax
DESTINATION Statement
►►─┬─ ADD ─────┬─ DEStination name is destination-name ───────────────────────► ├─ MODify ──┤ ├─ REPlace ─┤ └─ DELete ──┘ ►─┬────────────────────────────────────────────┬─────────────────────────────► └─ Version is ─┬─ version-number ──────────┬─┘ └─┬────────┬─┬─ HIGhest ─┬──┘ └─ NEXt ─┘ └─ LOWest ──┘ ►─┬─────────────────────────────────────────────────────────┬────────────────► └─┬─ PREpared ─┬─ by user-id ──┬────────────────────────┬─┘ └─ REVised ──┘ └─ PASsword is password ─┘ ►─┬──────────────────────────────────────────────────────┬───────────────────► └─┬───────────────┬─ DEScription is description-text ──┘ └─ destination ─┘ ┌─────────────────────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────────────────────┬─┴────────► └─┬─ 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 ──┘ └─ system-specification ─┘ (expanded system-specification syntax follows this syntax diagram) ┌────────────────────────────────────────────────────────────────────────┐ ►─▼┬──────────────────────────────────────────────────────────────────────┬┴─► └┬─ INClude ◄ ─┬─ class-name is attribute-name ─┬────────────────────┬─┘ └─ EXClude ───┘ └ TEXt is user-text ─┘ ┌──────────────────────────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────────────────────────┬──┴───► └─ DC option is ─┬─ USEr is user-id ──────────────────────────────┤ ├─ LOGical terminal is logical-terminal-name ────┤ │ ┌─────────────────────────┐ │ └─ DELete ( ─┬─▼─ logical-terminal-name ─┴─┬─ ) ─┘ │ ┌───────────┐ │ └─▼─ user-id ─┴───────────────┘ ┌───────────────────────────────────────────────────────────────┐ ►─▼─┬───────────────────────────────────────────────────────────┬─┴──────────► │ ┌────────────────────┐ │ └─ EDIt ─┬─ COMments ────┬───▼─ edit-instruction ─┴─ QUIT ──┘ ├─ DEFinition ──┤ └─ comment-key ─┘ ┌──────────────────────────────────────────────────┐ ►─▼─┬─────────────────────────────────────────────┬──┴───────────────────────►◄ └─┬─ COMments ─────┬── is ─┬─ NULl ─────────┬─┘ ├─ DEFinition ───┤ └─ comment-text ─┘ └─ comment-key ──┘
Expansion of system-specification
►►─┬───────────────────────────────────┬──────────────────────────────────────► └─ Version is ─┬─ version-number ─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘ ┌───────────────────────────────┐ ►─▼─┬───────────────────────────┬─┴──────────────────────────────────────────► └─ CONnect USEr is user-id ─┘ ┌────────────────────────────────────────────────────────────────────────── ►─▼─┬────────────────────────────────────────────────────────────────────────►─ └─ CONnect ─┬─ LOGical-terminal ─┬─ is logical-terminal-name ──────────── └─ LTErm ────────────┘ ─────────────────────────────────────────┐ ─►───────────────────────────────────────┬─┴──────────────────────────────────►◄ ─┬───────────────────────────────────┬─┘ └─ Version is ─┬─ version-number ─┬─┘ ├─ HIGhest ────────┤ └─ LOWest ─────────┘
DISPLAY/PUNCH DESTINATION Statement (for a single destination)
►►─┬─ DISplay ─┬─ DEStination name is destination-name ───────────────────────► └─ PUNch ───┘ ►─┬───────────────────────────────────────────────────┬──────────────────────► └─ PREpared by user-id ─┬─────────────────────────┬─┘ └─ PASsword is password ──┘ ┌──────────────────────────────────────────────────────────┐ ►─▼─┬──────────────────────────────────────────────────────┬─┴───────────────► │ ┌──────────────────────────────────┐ │ └─┬─ WITh ──────┬─▼──┬─ ALL ───────────────────────┬─┴─┘ ├─ ALSo WITh ─┤ ├─ ALL COMment TYPes ─────────┤ └─ WITHOut ───┘ ├─ ATTributes ────────────────┤ ├─ HIStory ───────────────────┤ ├─ DETails ───────────────────┤ ├─ COMments ──────────────────┤ ├─ DEFinitions ───────────────┤ ├─ LOGical-terminals ─────────┤ ├─ 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 DESTINATION Statement (for multiple destinations)
►►─┬─ DISplay ─┬─┬─── ALL ────────────────────────┬─ DEStinations ────────────► └─ 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 a new destination to be established in the dictionary or an existing destination to be modified, replaced, deleted, displayed, or punched. Destination-name must be a 1- through 8-character alphanumeric value.
Associates the named destination with (INCLUDE) or disassociates it from (EXCLUDE) the specified system and defines the users or logical terminals that constitute the destination for that system. System-name must be the 1- through 32-character name of an existing system.
If EXCLUDE is specified without a CONNECT specification, the compiler removes the destination/system relationship and any dependent user or logical-terminal associations.
WITHIN SYSTEM is documentation only, unless the system generation compiler COPY facility is to be used to copy destination definitions from an IDD-built system. When the COPY facility is not used, destination/system relationships are established and maintained by the system generation compiler. DESTINATION statements cannot modify or delete destination definitions copied into DC/UCF systems by the system generation compiler.
The WITHIN SYSTEM clause can be repeated to establish additional destination/system relationships.
Associates a user with the destination/system relationship. User-id must reference an existing user in the dictionary. In DC/UCF environments, CONNECT is documentation only; the functional relationship must be established with the system generation compiler.
Associates a logical terminal with the destination/system relationship. Logical-terminal-name must reference an existing logical terminal that is already associated with the named system. In DC/UCF environments, CONNECT is documentation only; the functional relationship must be established with the system generation compiler.
Directs the system generation compiler to establish a destination/user or destination/logical terminal relationship when it copies the named destination into a DC/UCF system, and defines or deletes the users or logical terminals.
Specifies one or more users that constitute the destination. User-name must reference an existing user in the dictionary.
Specifies one or more logical terminals that constitute the destination. Logical-terminal-name must reference an existing logical terminal in the dictionary.
Deletes the specified list of logical terminals or users from the destination. Multiple logical-terminal/user names must be separated by a comma and one or more blanks.
Includes or excludes the specified options when the named destination 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 IS and DC OPTION clauses.
Usage
If you specify REPLACE
If you specify REPLACE, the DDDL compiler initializes to defaults and/or excludes the following options:
The WITHIN SYSTEM and DC OPTIONS specifications are replaced only if they have been established by the DDDL compiler. The following relationships established by the system generation compiler are not affected:
Example
In the following example, the ADD statement associates destination OEBOST with the online system INVENTORY. OEBOST comprises logical terminals LTR22, LTR23, and LTR24. The MODIFY statement disassociates destination OEBOST from the INVENTORY system and defines the logical terminals as components of a DC/UCF system.
add destination oebost
prepared by dba password is 'ice 9'
description 'online order entry terminals -- boston'
within system inventory
connect logical-terminal is ltr22
connect logical-terminal is ltr23
connect logical-terminal is ltr24.
modify destination oebost
revised by dgs
description 'online order entry terminals -- boston'
exclude system inventory
dc-option is logical-terminal is ltr22
dc-option is logical-terminal is ltr23
dc-option is logical-terminal is ltr24.
|
Copyright © 2014 CA.
All rights reserved.
|
|