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 |