Work with DST Catalog Entries (WRKDSTCLGE)

Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC)
Threadsafe: No 		Parameters
Examples
Error messages

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

Top

Parameters

Keyword Description Choices Notes
GLBNAME Global name Element list Optional, Positional 1
Element 1: Global name token 1 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 2: Global name token 2 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 3: Global name token 3 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 4: Global name token 4 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 5: Global name token 5 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 6: Global name token 6 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 7: Global name token 7 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 8: Global name token 8 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 9: Global name token 9 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Element 10: Global name token 10 Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME
Top

Global name token 1 (GLBNAME)

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

The possible values for token 1 are:

*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
Specify the first token of the global name.

The possible values for tokens 2 through 10 are:

*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 global name token n value is a network ID. This value is generated from the network attributes.
*CPNAME
The global name token value is a control point name. 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
Specify a token of the global name.
Top

Examples

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

Top

Error messages

*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 data base.
Top