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.

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.

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

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.