Remove DST Catalog Entry (RMVDSTCLGE)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Remove Distribution Catalog Entry (RMVDSTCLGE) command allows the user to remove a specific catalog entry from the distribution catalog. If the associated data object is stored in the distribution repository, the repository object is also deleted.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| GLBNAME | Global name | Element list | Required, Positional 1 |
| Element 1: Global name token 1 | Character value, *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 (GLBNAME)
Specifies the tokens of the global name used to find the unique catalog entry to be removed.
This is a required parameter.
The possible values for token 1 are:
- *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: Remove a Catalog Entry
RMVDSTCLGE GLBNAME(ABCCO *LOWEST *HIGHEST *ANY XYZ)
This command removes an entry from the catalog. Tokens one and five match the corresponding catalog entry tokens. The catalog entry with the lowest value is selected for the second token. The highest value is selected for the third token. Token 4 is ignored. The priority of the search examines the tokens from left to right.
Example 2: Remove a Catalog Entry
RMVDSTCLGE GLBNAME(CMPNY1 *SERVER *TARGET *MDDATE *MDTIME)
This command removes the entry with global name CMPNY1 &SERVER &TARGET &DATE &TIME
| Top |
Error messages
*ESCAPE Messages
- MSS0066
- Internal processing error occurred.
- MSS0111
- Distribution repository object not available.
- MSS0112
- Distribution repository not available.
- MSS0113
- Not authorized to distribution repository.
- 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.
- MSS011D
- More than one distribution catalog entry found.
- MSS0121
- Distribution repository not found.
- MSS0122
- Distribution repository damaged.
- MSS0123
- Internal processing error occurred.
- MSS0124
- Error while managing distribution catalog.
- MSS0125
- Distribution catalog damaged.
- MSS0173
- Not authorized to delete repository object.
- MSS0174
- Distribution catalog entry not removed.
- MSS0176
- Distribution catalog entry not removed.
- MSS0904
- Number of tokens in global name not valid.
- MSS0905
- Token &2 not valid for global name.
- MSS0906
- Global name contains more than one date or time tokens.
| Top |