DLTDST (Delete Distribution)
Purpose
The Delete Distribution (DLTDST) command allows users to delete their own distributions or distributions for another user if the authority to work on behalf of the other user has been given. 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).
Outgoing distributions represent the outgoing confirmation request. This deletes the confirmation entries associated for the particular mail from the confirmation log. The deletion affects only the confirmation request. The request to deliver the mail remains in effect. Also, the request can delete error status information from the undelivered status.
Restrictions
- To work on behalf of other users, a user must have special permission given
with the Grant User Permission (GRTUSRPMN) command.
- The requester of the command (the user who is signed on) must be enrolled
in the system distribution directory.
- Personal distribution cannot be deleted if the requester is working on
behalf of another user.
- Damaged and dangling distribution objects can be deleted only by the user who signs on and has *ALLOBJ authority.
Required Parameters
- DSTID
- Specifies the distributions to be deleted.
*ERROBJ: The distributions to be deleted are damaged or dangling distribution objects.
Note: To delete a damaged or dangling distribution, a value must be specified also on the OBJ parameter. distribution-identifier: Specify the unique identifier of the distribution to be deleted. The distribution identifier is assigned to the distribution by the system that created it.
Up to 50 distribution IDs can be specified. The distribution identifier consists of the sender's address (padded on the right with blanks up to 8 characters), the sender's user ID (padded on the right with blanks up to 8 characters), and a 4-digit zoned sequence number with leading zeros. For example,
'NEWYORK SMITH 0204' or UADDRESSUSERIDID0099
The apostrophes are needed if there are blanks or special characters in the distribution identifier. The distribution identifier is specified this way because blank characters are valid in a user ID or address.
The distribution identifier can be determined with the Query Distribution (QRYDST) command.
Note: The distribution specified cannot be damaged or dangling.
Optional Parameters
- OPTION
- Specifies whether incoming, outgoing, or error distribution information is
deleted.
*IN: Information about incoming distribution is deleted. An incoming distribution is a distribution being sent to a user. If confirmation of delivery is requested by the sender, notice of the deleted status is returned to the sender.
*OUT: Information about an outgoing distribution is deleted. An outgoing distribution is the status saved by the system for a distribution that was sent to one or more users with a request for delivery confirmation.
*ERR: Information about an error or undelivered distribution is deleted. A distribution is sent that was undelivered because an error occurred while routing the distribution.
- USRID
- Specifies the user ID and address of the user making this request.
*CURRENT: The user profile that is currently running is used.
Element 1: User ID
user-ID: Specify the user ID of the user for whom the distribution information is deleted.
Element 2: User Address
user-address: Specify the user address of the user for whom the distribution information is deleted.
- DSTIDEXN
- Specifies the extension of the distribution identifier specified by the
DSTID parameter. This extension identifies duplicate distributions. This
extension is a 2-digit extension that ranges from 00 through 99. For incoming
distributions, this extension ranges from 01 through 99. For outgoing and
undelivered status distributions, this extension is always 00. For example, if
the distribution ID is 'NEWYORK SMITH 0204' and two copies of this
distribution were sent to a user, the user has two distributions with the same
distribution ID. To distinguish the two distributions, an extension is added to
each distribution ID and one extension is NEWYORK SMITH 020401 and the
other one is NEWYORK SMITH 020402. If there are no duplicates, the
extension defaults to 01. These extensions map one-to-one with the distribution
ID specified on the DSTID parameter.
*NONE: There is no duplicate distribution. This is equivalent to an extension of 00 for outgoing distributions and 01 for incoming distributions.
distribution-ID-extension: Specify the extension associated with the distribution. This is used to identify duplicate distribution IDs. Up to 50 distribution IDs can be specified.
- OBJ
- Specifies the damaged or dangling distribution objects to be deleted.
*NONE: No damaged or dangling distribution objects are deleted.
*ALL: All damaged and dangling distribution objects are deleted.
object-name: Specify the name of the damaged or dangling distribution object to be deleted.
The object named can be a local or remote object.
- Local object names consist of the sender's address (padded on the right
with blanks to a maximum of 8 characters), the sender's user ID (padded on the
right with blanks to a maximum of 8 characters), and a 4-digit zoned sequence
number with leading zeros. For example:
'NEWYORK SMITH 0204' or UADDRESSUSERIDID0099
The apostrophes are needed if there are blanks or special characters in the distribution identifier. The distribution identifier is specified this way because blank characters are valid in a user ID or address.
- Remote object names consist of the remote system name and the system date
and time. For example:
'QOSRDIST091112509152355'
where QOSRDIST is the remote system name, 0911125 is the system date (November 25, 1991), and 09152355 is the system time (9:15:23:55).
The distribution identifier for damaged or dangling distributions can be determined when the Save Document Library Object (SAVDLO) command is run and damaged or dangling distribution objects are identified.
A maximum of 50 objects can be named to be deleted.
- Local object names consist of the sender's address (padded on the right
with blanks to a maximum of 8 characters), the sender's user ID (padded on the
right with blanks to a maximum of 8 characters), and a 4-digit zoned sequence
number with leading zeros. For example:
- CMDCHRID
- Specifies the character identifier (graphic character set and code page)
for data being specified as parameter values on this command. This character
identifier (CHRID) is related to the display device used to specify the
command. More information about CHRID processing is in the Application Display Programming
book.
Note: This parameter translates the USRID and DSTID parameters to character set and code page of '930 500'. The SNA Distribution Services 
book contains the character set and code
page table for '930 500'.*SYSVAL: The system determines the graphic character set and code page values for the command parameters from the QCHRID system values.
*DEVD: The system determines the graphic character set and code page values for the command parameter from the display device description where the command is entered. This option is valid only when specified from an interactive job. If this value is specified in an interactive CL program or a batch job, an error message is sent.
Element 1: Character Set
graphic-character-set: Specify the graphic character set values used to create the command parameter.
Element 2: Code Page
code-page: Specify the code page. Valid values range from 1 through 9999.
Examples for DLTDST
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.
Error messages for DLTDST
*ESCAPE Messages
- CPF89BD
- The object must be specified with DSTID(*ERROBJ).
- CPF900A
- &2 distribution deleted, could not delete &1 distribution.
- CPF900B
- User ID and address &1 &2 not in System Distribution Directory.
- CPF900C
- Sign on and verify of user failed.
- CPF9016
- Request to cancel distribution &2-&3-&4 unsuccessful for &1.
- CPF905C
- Error occurred trying to find a translation table.
- CPF906C
- Distribution not deleted.
- CPF9096
- Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.