CL Command Reference - DLTDST

CL Command List > DLTDST Reference

Description:

The Delete Distribution (DLTDST) command allows you to delete your own distributions or to delete distributions for another user. This command also allows system operators to delete damaged distribution objects and dangling distribution objects (distribution objects that are not controlled by a distribution tracking object).

Restrictions:

1. If you are working on behalf of another user, you must have *ALLOBJ special authority or have been granted permission to work on behalf of the other user with the Grant User Permission (GRTUSRPMN) command.

2. The requester of the command must be enrolled in the system distribution directory.

3. Personal distribution cannot be requested if the requester is working on behalf of another user.

4. Damaged and dangling distribution objects can be deleted only by the user who signs on and has *ALLOBJ authority.


Examples:

Example 1: Deleting Incoming Distribution Sent to User

DLTDST DSTID((¡¯RCH38P BAKER 0019¡¯)) USRID(*CURRENT)
DSTIDEXN(02)

This command deletes an incoming distribution sent to the user.



Example 2: Deleting Status of Outgoing Distribution

DLTDST DSTID((¡¯SYSTEM20 BRUCE 1361¡¯))
USRID(*CURRENT) DSTIDEXN(00)
OPTION(*OUT) CMDCHRID(101 37)

This command deletes the status associated with an outgoing distribution. The DSTID parameter value is encoded with a character identifier where the code page is 37 and the character set is 101. The system performs translation on the DSTID parameter value before trying to locate the distribution on the distribution recipient index.



Example 3: Deleting Incoming Distribution to Signed-On User

DLTDST DSTID((¡¯CHICAGO JONES 0013¡¯))

This command deletes an incoming distribution sent to a user who is signed on. The distribution extension defaults to ¡¯01¡¯ for incoming distributions. If duplicate distributions were sent, this command would only delete the first one.



Example 4: Deleting All Damaged Distributions

DLTDST DSTID(*ERROBJ) OBJ(*ALL)

This command deletes all damaged and dangling distributions on the system.