WRKDSTCLGE (Work with Distribution Catalog Entries) Command Description

Note: To use this command, have the 5722-MG1 (Managed System Services for iSeries) licensed program installed.

WRKDSTCLGE Command syntax diagram

 

Purpose

The Work with Distribution Catalog Entries (WRKDSTCLGE) command allows the user to add, remove, and display distribution catalog entries and copy distribution repository objects.

 

Optional Parameters

GLBNAME

Specifies the tokens of the global name used to find the catalog entries to be displayed.

Element 1: Token 1

*ANY: The corresponding token value is ignored.

*HIGHEST: The catalog entry with the highest corresponding token value is selected.

*LOWEST: The catalog entry with the lowest corresponding token value is selected.

*NETID: The first global name token value is a network ID generated by the command from the network attributes.

*SERVER:This token is stored within the change request activity with the value &SERVER, and replaced by the short name of the change control server when the object is distributed.

*TARGET: This token is stored within the change request activity with the value &TARGET, and replaced by the short name of the target when the object is distributed.

*MDDATE: This token is stored within the change request activity with the value &DATE, and replaced when distributed by the date the object was last modified.

*MDTIME: This token is stored within the change request activity with the value &TIME, and replaced when distributed by the time the object was last modified.

global-name-token-1: Specify the first token of the global name.

Element 2-10: Token 2-10

*ANY: The corresponding token value is ignored.

*HIGHEST: The catalog entry with the highest corresponding token value is selected.

*LOWEST: The catalog entry with the lowest corresponding token value is selected.

*CPNAME: The global name token value is a control point name. This value is generated from the network attributes.

*NETID: The global name token n value is a network ID. This value is generated from the network attributes.

*SERVER:This token is stored within the change request activity with the value &SERVER, and replaced by the short name of the change control server when the object is distributed.

*TARGET: This token is stored within the change request activity with the value &TARGET, and replaced by the short name of the target when the object is distributed.

*MDDATE: This token is stored within the change request activity with the value &DATE, and replaced when distributed by the date the object was last modified.

*MDTIME: This token is stored within the change request activity with the value &TIME, and replaced when distributed by the time the object was last modified.

global-name-token-n: Specify a token of the global name.

Examples for WRKDSTCLGE

Example 1: Working with All Entries

WRKDSTCLGE

This command allows the user to work with all catalog entries.

Example 2: Working with Specific Entries

WRKDSTCLGE  GLBNAME(ABACO *HIGHEST *HIGHEST XYZ)

This command allows the user to work with a selected catalog entry.

Example 3: Working with Specific Entries

WRKDSTCLGE GLBNAME(ABACO ZONEA *ANY)

This command allows the user to work with all catalog entries with a three token global name where the first token is ABACO and the second token is ZONEA.

Example 4: Working with catalog entries having special tokens:

   WRKDSTCLGE GLBNAME(CMPNY1 *SERVER *TARGET *MDDATE *MDTIME)

This command allows the user to work with the catalog entry with global name CMPNY1 &SERVER &TARGET &DATE &TIME

Error messages for WRKDSTCLGE

*ESCAPE Messages

CPF9845

Error occurred while opening file &1.

CPF9846

Error while processing file &1 in library &2.

CPF9860

Error occurred during output file processing.

CPF9871

Error occurred while processing.

MSS0116

Maximum global name length exceeded.

MSS0117

Global name token &3 not valid. Reason code &4.

MSS011B

Distribution catalog entry not found.

MSS011C

Distribution catalog not available.

MSS0123

Internal processing error occurred.

MSS0124

Error while managing distribution catalog.

MSS0125

Distribution catalog damaged.

MSS0909

Error while accessing change control server database.