System Generation Statements › DESTINATION Statement—Group Users or Terminals › DESTINATION Statement Parameters

DESTINATION Statement Parameters

DEStination destination-id

Specifies the destination identifier.

Destination-id must be a one- through eight-character alphanumeric value.

Version is version-number

Qualifies the destination with a version number.

Version-number must be an integer in the range 1 through 9,999. The default is 1.

Although multiple versions of a destination can exist in the data dictionary, a DC/UCF system uses only one version of a destination at runtime. If multiple ADD DESTINATION statements specify the same destination identifier, the system uses the first statement that appears in the system definition.

ENAbled

Specifies the destination is enabled when the DC/UCF system starts up.

ENABLED is the default when you specify neither ENABLED nor DISABLED in the DESTINATION statement.

DISabled

Specifies the destination is not enabled when the DC/UCF system starts up.

Note: Users can override the ENABLED/DISABLED parameter at runtime for the duration of system execution with the DCMT VARY DESTINATION command.

LTErm (logical-terminal-id)

Specifies one or more logical terminals that constitute the destination.

Logical-terminal-id must be the identifier of a logical terminal previously defined in the data dictionary with an LTERM statement.

The logical terminal identifiers must be enclosed in parentheses. Multiple identifiers must be separated by one or more commas or blanks.

DELete (logical-terminal-id)

Directs the DC/UCF system to delete the specified logical terminal identifiers from the destination definition.

Logical-terminal-id must be the identifier of a logical terminal previously included in the destination.

The logical terminal identifiers must be enclosed in parentheses. Multiple identifiers must be separated by one or more commas or blanks.

This parameter is valid only for MODIFY operations.

PRInter (printer-logical-terminal-id)

Defines the destination as a printer destination and specifies one or more logical terminals that constitute the destination.

Printer-logical-terminal-id must be the identifier of a logical terminal previously defined in the data dictionary as a printer (with an LTERM statement).

DELete (printer-logical-terminal-id)

Directs the DC/UCF system to delete the specified printer identifiers from the destination definition.

Printer-logical-terminal-id must be the identifier of a printer previously included in the destination.

The printer identifiers must be enclosed in parentheses. Multiple identifiers must be separated by one or more commas or blanks.

This parameter is valid only for MODIFY operations.

USEr (user-id)

Specifies one or more users that constitute the destination. If the user identifier contains blanks or special characters, the identifier must be enclosed in site-standard quotation marks.

The user identifiers must be enclosed in parentheses. Multiple identifiers must be separated by one or more commas or blanks.

DELete (user-id)

Directs the DC/UCF system to delete the specified user identifiers from the destination definition.

User-id must be the identifier of a user previously included in the destination. If the user identifier contains blanks or special characters, the identifier must be enclosed in site-standard quotation marks.

The user identifiers must be enclosed in parentheses. Multiple identifiers must be separated by one or more commas or blanks.

This parameter is valid only for MODIFY operations.