Send Distribution (SNDDST)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Send Distribution (SNDDST) command allows you to send a distribution to a user, to a list of users, or to a distribution list.

Restrictions:

If you are working on behalf of another user, you must have been granted permission to work for that user through the Grant User Permission (GRTUSRPMN) command.
You need to be enrolled in the system distribution directory.
You cannot request personal distribution if you are working for another user.

Top

Parameters

Keyword	Description	Choices	Notes
TYPE	Information to be sent	MSG, DOC, FILE, IDP, DSTID, LMSG	Required, Positional 1
TOUSRID	Recipient	Values (up to 300 repetitions): Element list	Optional, Positional 2
	Element 1: User ID	Character value
	Element 2: Address	Character value
	Element 3: Recipient type	PRI, CC, *BCC
TOINTNET	Internet Recipient	Values (up to 300 repetitions): Element list	Optional
	Element 1: Internet address	Character value, *NONE
	Element 2: Recipient type	PRI, CC, *BCC
DSTD	Description	Character value	Optional, Positional 3
MSG	Message	Character value, NONE, DSTIDMSG	Optional
LONGMSG	Long Message	Character value, *NONE	Optional
CFMDEL	Confirmation of delivery	NO, YES	Optional
SENSITIV	Sensitivity	NONE, PRIVATE, PERSONAL, CONFIDENTIAL	Optional
PERSONAL	Personal	NO, YES	Optional
IMPORTANCE	Content importance	NORMAL, LOW, *HIGH	Optional
PTY	Priority	NORMAL, HIGH, *LOW	Optional
USRID	User identifier	Single values: *CURRENT Other values: Element list	Optional
	Element 1: User ID	Character value
	Element 2: Address	Character value
DOCFILE	Document file	Single values: *NONE Other values: Qualified object name	Optional
	Qualifier 1: Document file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
DOCMBR	Document member	Name, *FIRST	Optional
DOCTYPE	Document type	2-65535, DFT, FFT, *RFT	Optional
SNDFMT	Send format	NOCHG, NOTE, *FINALFORM	Optional
SYSCOD	System code	Character value, *DFT	Optional
DOCCHRID	Document character identifier	Single values: SYSVAL, DEVD Other values: Element list	Optional
	Element 1: Graphic character set	Integer
	Element 2: Code page	Integer
DSTID	Distribution identifier	Character value, *NONE	Optional
DSTIDEXN	Distribution ID extension	0-99, *NONE	Optional
DOC	Document	Character value, *DOCID	Optional
FLR	In folder	Character value, *NONE	Optional
DOCID	Document identifier	Character value, *NONE	Optional
IDPFILE	Profile file	Single values: NONE, DOCFILE, *DSTIDIDP Other values: Qualified object name	Optional
	Qualifier 1: Profile file	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
IDPMBR	Profile member	Name, *FIRST	Optional
DOCD	Document description	Character value, DFT, DSTD	Optional
AUTHOR	Author	Single values: NONE, USRID Other values (up to 50 repetitions): Character value	Optional
DOCCLS	Document class	Character value, *NONE	Optional
KWD	Keyword	Single values: *NONE Other values (up to 50 repetitions): Character value	Optional
SUBJECT	Subject	Single values: NONE, DOCD Other values (up to 50 repetitions): Character value	Optional
DOCDATE	Document date	Date, NONE, CURRENT	Optional
FILCAB	File cabinet location	Character value, *NONE	Optional
CPYLST	Copy list	Single values: *NONE Other values (up to 50 repetitions): Character value	Optional
EXPDATE	Expiration date	Date, *NONE	Optional
CRTDATE	Creation date	Date, NONE, CURRENT	Optional
REFERENCE	Reference	Character value, *NONE	Optional
ACTDATE	Action due date	Date, NONE, CURRENT	Optional
RPYDATE	Reply requested	Element list	Optional
	Element 1: Date	Date, NONE, CURRENT, *ANY
	Element 2: Time	Time, *ENDOFDAY
STATUS	Document status	Character value, *NONE	Optional
CMPDATE	Completion date	Date, NONE, CURRENT	Optional
PROJECT	Project	Character value, *NONE	Optional
DOCLANGID	Language ID	Character value, *JOB	Optional
DOCCNTRYID	Country or region ID	Character value, *JOB	Optional
ALWALTRCP	Allow alternate recipient	YES, NO	Optional
DISCLOSE	Disclose recipient	YES, NO	Optional
ALWX400CNV	Allow X.400 conversion	YES, NO	Optional
AUTUSR	Authorizing user	Single values: *NONE Other values: Element list	Optional
	Element 1: User ID	Character value
	Element 2: Address	Character value
DSTEXPDATE	Distribution expiry indicator	Element list	Optional
	Element 1: Date	Date, *NONE
	Element 2: Time	Time, *ENDOFDAY
CMDCHRID	Command character identifier	Single values: SYSVAL, DEVD Other values: Element list	Optional
	Element 1: Graphic character set	Integer
	Element 2: Code page	Integer

Top

Information to be sent (TYPE)

Specifies the type of information that is sent and the parameters that are valid on this command.

*MSG: Only the message specified on the Message prompt (MSG parameter) is sent.
*DOC: The document specified on the Document prompt (DOC parameter) or the Document identifier prompt (DOCID parameter) is sent. The user must have authority for the document before it can be sent.
*FILE: The database file specified on the Document file prompt (DOCFILE parameter) and the Document member prompt (DOCMBR parameter) is sent. The database file is sent without any changes. The user must have authority for the database file before it can be sent.
*IDP: The interchange document profile (IDP) that is sent is specified on the Profile file prompt (IDPFILE parameter) and the Profile member prompt (IDPMBR parameter), or is specified in the document profile built by this command.
*DSTID: The mail entry that is identified by the distribution ID is distributed. The distribution ID is called the distribution document name.
*LMSG: The text specified on the Long Message prompt (LONGMSG parameter) is sent as an final-form text document (FFTDCA) note. LONGMSG allows up to 5000 characters, which is about one page of text. The "details" parameters (Subject, Reference, Author, Due Date, etc.) are supported with TYPE(*LMSG). The TOINTNET parameter is also supported with TYPE(*LMSG).

Top

Recipient (TOUSRID)

Specifies one of the following:

The user ID and address of zero or more users to whom the distribution is being sent
The distribution list name of zero or more distribution lists containing the user ID and address of one or more users to whom the distribution is being sent.

A combination of user IDs and distribution lists can be used on the same command. Up to 300 user IDs and addresses can be specified.

If no user ID and address are specified for the TOUSRID parameter, an internet address must be specified on the TOINTNET parameter.

The possible User ID or List ID values are:

user-ID: Specify the user ID of the user to whom the distribution is sent.
list-ID: Specify the distribution list of users to whom the distribution is sent.

The possible User Address or List Qualifier values are:

user-address: Specify the user address of the user (specified in Element 1) to whom the distribution is sent.
list-qualifier: Specify the distribution list qualifier of users (specified in Element 1) to whom the distribution is sent.

The possible Recipient Type values are:

*PRI: The user or distribution list is the primary recipient of the distribution.
*CC: The user or distribution list is receiving a copy of the distribution sent to the primary recipient. However, this copy recipient is not identified on the distribution as a receiver on the distribution.
*BCC: The user or distribution list is receiving a copy of the distribution. However, this copy recipient is not identified on the distribution as a receiver on the distribution.

Top

Internet Recipient (TOINTNET)

Specifies the internet address of one or more users to whom the distribution is being sent. If TOINTNET(*NONE) is specified, at least one user ID and address must be specified on the TOUSRID parameter. Up to 300 internet addresses can be specified.

The TOINTNET parameter is not allowed when the TYPE keyword is *MSG.

*NONE: No internet address is specified. This is a single value.
character-value: Specify the internet address of a person or organization to whom the distribution is being sent. Up to 253 characters can be specified for each address.

The possible Recipient Type values are:

*PRI: The internet address is the primary recipient of the distribution.
*CC: The internet address will receive a copy of the distribution sent to the primary recipient.
*BCC: The internet address will receive a copy of the distribution. However, this copy recipient is not identified on the distribution as a receiver on the distribution.

Top

Description (DSTD)

Specifies the description of the distribution. A maximum of 44 characters can be specified. This parameter is required and can not start with a blank character or be all blank characters.

Top

Message (MSG)

Specifies whether a short message is sent with the distribution.

*NONE: No message is sent.
*DSTIDMSG: The message in the distribution document specified on the Distribution identifier prompt (DSTID parameter) is sent with the distribution.
message-text: Specify the message (256 characters maximum) to send to the users.

Top

Message (LONGMSG)

Specify the text to send to the recipients as an final-form text document (FFTDCA).

*NONE

No text is sent. This is the default and required when TYPE is not *LMSG

long-message-text

Specify the text (5000 characters maximum) to send to the recipients. The text will be put into an final-form text document (FFTDCA) that will be sent as a note.

The text must be formatted by using the following controls within the text.

:/N - Will cause a new line (Carrier return).
:/P - Will cause a new paragraph. New line plus a blank line. (Carrier return and Required carrier return)

The document is setup with 10 characters to the inch, the font ID is 11, the left margin at position 1, and the right margin at position 75. If :/N is not used to start a new line, the text will continue past the right margin and will not be viewable by some E-mail clients. Blanks are not removed from the text, but left in place for indentation and alignment. No extra text (ie. Recipient List, Date/Time, Subject, or Sender) is put into the document.

Technical note to programmers: Any of the FFTDCA controls (in hexadecimal) can be inserted in the text to provide more control of the format if the controls above are not enough.

Top

Confirmation of delivery (CFMDEL)

Specifies whether the sender receives a confirmation of delivery notification when each receiver gets the distribution. Even though confirmation of delivery is not requested, the sender is still informed when the distribution is not delivered because of an user ID is not valid, a system failure, or a routing failure. If confirmation of delivery is requested, the sender is informed when the receiver receives, deletes, or runs another command against the distribution. To get this information, the sender must use the Query Distribution (QRYDST) command with *OUT specified on the Incoming or outgoing prompt (OPTION parameter).

*NO: Confirmation of delivery is not requested.
*YES: Confirmation of delivery is requested.

Top

Sensitivity (SENSITIV)

Specifies the level of sensitivity defined by the X.400 standard. The four levels include normal, personal, private and company confidential. Private distributions cannot be viewed by a user working on behalf of another user.

*NONE: The distribution has no sensitivity restrictions.
*PERSONAL: The distribution is sent to the recipient as an individual.
*PRIVATE: The distribution contains information that should be accessed only by the recipient.
*CONFIDENTIAL: The distribution contains information that should be handled according to company procedures.

Top

Personal (PERSONAL)

Specifies whether the document distribution is private or not. This parameter is replaced by SENSITIV but the PERSONAL parameter can still be used. However, because this parameter may be removed in a later release, whenever possible use the SENSITIV parameter.

If PERSONAL(*YES) is used, the SENSITIV parameter must be omitted or it must be with the value SENSITIV(*NONE). If the command is prompted without this parameter specified, this parameter is not displayed.

*NO: Only the owner and users that have authorization to the distribution document can get access to distributions that are not sensitive. Users authorized to work on behalf of other users who have access to the distribution can access documents that are not sensitive. This value will map to SENSITIV(*NONE).
*YES: Only the owner can get access to private distribution documents. Users authorized to work on behalf of other users who have access to the distribution document cannot get access to the distribution. This value will map to SENSITIV(*PRIVATE).

Top

Content importance (IMPORTANCE)

Specify low, normal or high importance. This is an indication to the recipient of the content importance of the distribution. It is different from priority which relates to the speed with which the distribution was sent.

*NORMAL: A distribution of normal importance.
*HIGH: A very important distribution.
*LOW: A low importance distribution.

Top

Priority (PTY)

Specifies whether the distribution is sent using low priority, normal priority or high priority. For distributions to remote receivers, the priority determines which 'SNADS Next System Queue' is used. Normal priority distributions use the normal next system queue. Low priority distributions use the normal next system queue with the lowest priority available within that queue. High priority uses the priority next system queue. The difference between low, high and normal priority depends on information, specified by the user, on the Configuration Distribution Services (CFGDSTSRV) command. The handling of priority distributions by other office system nodes can vary, but generally the high priority distributions take the faster path when there is a choice of paths. For distribution to local receivers, the priority determines whether a message is sent to the receiver's message queue to notify the receiver of the distribution. No message is sent for normal distributions.

*NORMAL: Normal priority is used.
*HIGH: High priority is used.
*LOW: Low priority is used.

Top

User identifier (USRID)

Specifies which user ID and user ID address should be associated with the request.

*CURRENT: You are performing the request for yourself.
user-ID: Specify another user's user ID or your user ID. You must have been given permission to work on behalf of another user.
user-ID-address: Specify another user's address or your address. You must have been given permission to work on behalf of another user.

Top

Document file (DOCFILE)

Specifies the names of the database file and the library that contains the document data. The database file is a user-defined file or the output file specified in either the Receive Distribution (RCVDST) command or the Retrieve Document (RTVDOC) command. If an output file is specified, only the data portion of the document data record is read from the output file. The prefix is removed from the document data record.

The possible library values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the database file. If no library is specified as the library for the job, QGPL is used.
library-name: Specify the library where the database file is located.
data-base-file-name: Specify the name of the database file that contains the document data.

Top

Document member (DOCMBR)

Specifies the document database file member that is used.

*FIRST: The first member created in the database file is used.
member-name: Specify the name of the database file member that is used.

Top

Document type (DOCTYPE)

Specifies the type of document being used. This identifier is used by the system to determine whether the data stream can be handled properly.

*DFT: The system creates the proper document type identifier based on the source of the data.
*FFT: The document is in Final Form Text. This type of document is intended to be viewed and printed, but not edited, by the receiver.
*RFT: The document is in Revisable Form Text. This type of document can be viewed, printed, and edited by the receiver.

document-type-number: Specify a document type identifier value ranging from 2 through 65,535. The numbers from 2 through 32,767 are controlled by registering them with the IBM Document Interchange Architecture and are used for IBM-defined document types. The numbers ranging from 32,768 through 65,535 are not registered with IBM and can be used for non-IBM-defined document types. The meaning of these document types must be determined by defining the value of the system code on the System code prompt (SYSCOD parameter).

Top

Send format (SNDFMT)

Allows the user to specify the format of the document being sent.

*NOCHG: The document is sent in the current format.
*NOTE: The document is sent in a final form text document content architecture (FFTDCA) data stream as a note.
*FINALFORM: The document is sent in FFTDCA.

Top

System code (SYSCOD)

Specifies the text used with the value specified on the Document type prompt (DOCTYPE parameter) to help uniquely identify the type of document being used. The receiver of the data stream determines the document data stream and processing requirements to edit, view, print, or change the document.

*DFT: The system supplies a default system code. If the value specified on the Document type prompt (DOCTYPE parameter) is a number ranging from 2 through 32,767, the default is 'IBM System i5 CL' and is retrieved from message CPX9026. If the value specified on the Document type prompt (DOCTYPE parameter) is in the range from 32,768 through 65,535, a system code must be specified.
system-code: Specify the text that uniquely identifies the type of document being sent. A maximum of 13 characters can be specified.

Top

Document character identifier (DOCCHRID)

Specifies the character identifier (graphic character set and code page) for the document data being used. The character identifier is related to the display device used to create the document data.

*SYSVAL: The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.

*DEVD: The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.

graphic-character-set code-page: Specify the graphic character set and code page values used to create the data being distributed.

Note: Both parts can be up to 5 digits in length.

Top

Distribution identifier (DSTID)

Specifies the unique distribution identifier of the distribution. The distribution identifier is assigned by the system when the distribution is originated. Distribution identifiers can be found by using the Query Distribution (QRYDST) command. Identifiers are also returned from the Send Distribution (SNDDST) command.

*NONE: No distribution identifier is used.
distribution-id: Specify the 3-part distribution identifier which is composed of the second part of the sender's user ID (padded on the right to 8 characters), the first part of the sender's user ID (padded on the right to 8 characters), and a 4-digit zoned sequence number with leading zeros. For example, 'NEWYORK SMITH 0204'. This parameter is required when *DSTID is specified on the Information to be sent prompt (TYPE parameter).

Top

Distribution ID extension (DSTIDEXN)

Specifies the extension of the distribution identifier (if any) specified on the Distribution identifier prompt (DSTID parameter). This extension uniquely identifies duplicate distributions. This 2-digit extension has a value ranging from 00 through 99 that uniquely identifies duplicate distributions. For incoming distributions, this extension ranges from 01 through 99. For confirmation of delivery distributions, this extension must be 00.

*NONE: There is no duplicate distribution. *NONE is equivalent to an extension of 01.
distribution-id-extension: Specify the extension associated with the distribution. This is used to uniquely identify duplicate distributions.

Top

Document (DOC)

Specifies the name of the document being sent.

document-name: Specify the user-assigned name (10 characters maximum) of the document to be sent.
*DOCID: The document being sent is identified by the library-assigned document name.

Top

In folder (FLR)

Specifies the name of the folder that contains the document being sent. This is the user-assigned name given to the folder when it is created. If document name is specified on the Document prompt (DOC parameter), then *DOCID must not be specified.

*NONE: The document is not located in a folder.
folder-name: Specify the name of the folder that contains the document being sent. A folder name can consist of a series of folder names if the document being sent is located in a folder contained within another folder or folders.

Top

Document identifier (DOCID)

Specifies the library-assigned name of the document. This is the name assigned to the document by the system when it was created. Documents filed outside the local system have only library-assigned document names. The library-assigned document names can be determined by using the Query Document Library (QRYDOCLIB) command or by the message returned from the File Document (FILDOC) command.

Library-assigned document names are 24 characters in length with the following format:

YYYYMMDDHHMNSSHSSNSNSNSN

where:

       YYYY = year
         MM = month
         DD = day
         HH = hour
         MN = minute
         SS = second
         HS = hundredths of a second
   SNSNSNSN = system name

*NONE: No library-assigned document name is required when the document is identified on the Document prompt (DOC parameter).
library-assigned-document-name: Specify the library-assigned name of the document being sent.

Top

Profile file (IDPFILE)

Specifies where the document profile information is located. If you specify this parameter, the remaining parameters after the Profile member prompt (IDPMBR parameter) are ignored, except the Command character identifier prompt (CMDCHRID parameter) and the Document character identifier prompt (DOCCHRID parameter).

*NONE: The interchange document profile (IDP) is supplied by other parameters on this command. There is no database file containing the IDP information. If *NONE is specified, the Profile member prompt (IDPMBR parameter) is ignored.
*DSTIDIDP: The IDP information associated with the distribution document is used. The Profile member prompt (IDPMBR parameter) is ignored. This is valid only when TYPE (*DSTID) is specified.
*DOCFILE: The database file specified for the document also contains the profile information. If *DOCFILE is specified, the Document fileprompt (DOCFILE parameter) and Document member prompt (DOCMBR parameter) are used for the document profile information.
data-base-file-name: Specify the name of the database file that contains the IDP. The document profile database file can be a user-defined file or the output file specified on the Receive Distribution (RCVDST) or Retrieve Document (RTVDOC) commands. If you specify a user-defined file, it must have the same format as the output file produced by RCVDST or RTVDOC. If an output file is specified, only the data portion of the document profile record is read from the output file. The prefix is removed from the document profile record.

The possible library values are:

*LIBL: All libraries in the library list for the current thread are searched until the first match is found.

*CURLIB: The current library for the job is used to locate the database file. If no current library is specified as the library for the job, QGPL is used.
library-name: Specify the library where the database file is located.

Top

Profile member (IDPMBR)

Specifies the interchange document file member name being used. This parameter is used only when a database file name is also specified on the Profile file prompt (IDPFILE parameter).

*FIRST: The first member created in the database file is used.
member-name: Specify the name of the database file member being used.

Top

Document description (DOCD)

Specifies a description for the document being distributed. This information is in the Document Interchange Architecture IDP document name field.

*DFT: The system generates a document description. For database files, the default format is library-name/file-name/member-name. For a description of a hard copy document, the default is the distribution description. For a description of a distribution document, the default is the document description associated with the distribution.
*DSTD: The distribution description specified on the Description prompt (DSTD parameter) is used for the document description.
document-description: Specify the description of the document. A maximum of 44 characters can be specified.

Top

Author (AUTHOR)

Specifies the author or authors of the document.

You can enter multiple values for this parameter.

*NONE: No author is identified for the document.
*USRID: The user ID and address specified on the USRID parameter User identifier prompt(USRID parameter) is used as the author's name.
document-author-name: Specify the name of the author or authors. A maximum of 50 authors can be specified.

Top

Document class (DOCCLS)

Specifies the class associated with this document, such as MEMO, FORM, or SHEET.

*NONE: No class is assigned to the document.
document-class: Specify the document class. A maximum of 16 characters can be specified.

Top

Keyword (KWD)

Specifies the keywords that describe the document.

You can enter multiple values for this parameter.

*NONE: No keywords are defined for this document.
document-keyword: Specify the keywords to describe the document. A maximum of 50 keywords can be specified. Each keyword can have a maximum of 60 characters.

Top

Subject (SUBJECT)

Specifies the subject or subjects of the document.

You can enter multiple values for this parameter.

*NONE: No subject is defined for the document.
*DOCD: The document description is used as the subject for the document.
document-subject: Specify the subject or subjects of the document. A maximum of 50 subjects can be specified and each subject can have a maximum of 60 characters of text.

Top

Document date (DOCDATE)

Specifies any date the user needs to assign to the document.

*NONE: No date is assigned to the document.
*CURRENT: The system assigns the current system date to the document.
document-date: Specify the document date. The date must be specified in the job date format.

Top

File cabinet location (FILCAB)

Specifies the location of the document. This parameter is intended to describe the location of printed documents. The interchange document profile (IDP) that refers to the printed document is distributed. This parameter is required if *IDP is also specified on the Information to be sent prompt (TYPE parameter) and *NONE is specified on the Profile file prompt (IDPFILE parameter).

*NONE: No filing cabinet reference is defined for this document.
filing-cabinet-reference: Specify the text that describes where the printed document is located. A maximum of 60 characters can be specified.

Top

Copy list (CPYLST)

Specifies the names of the users that receive this document.

You can enter multiple values for this parameter.

*NONE: No copy list is included for this document.
recipient-list: Specify the names of the users that receive the document. A maximum of 50 names can be specified. Each name can have a maximum of 60 characters.

Top

Expiration date (EXPDATE)

Specifies the date on which the document is no longer needed.

*NONE: No document expiration date is specified.
expiration-date: Specify the document expiration date. The date must be specified in the job date format.

Top

Creation date (CRTDATE)

Specifies the date the document was created.

*NONE: No document creation date is specified.
*CURRENT: The current system date is used as the date the document was created.
create-date: Specify the document creation date. The date must be specified in the job date format.

Top

Reference (REFERENCE)

Specifies a reference associated with the document.

*NONE: No reference field is included for this document distribution.
reference: Specify text that describes the reference associated with the document. A maximum of 60 characters can be used.

Top

Action due date (ACTDATE)

Specifies the due date for the requested action. If no action due date is specified and a reply request date is specified the action due date is set from the reply request date.

*NONE: No action due date is specified.
*CURRENT: The current date is used.
action-due-date: Specify the value used as the action due date. The date must be specified in the format specified by the system value QDATFMT.

Top

Reply requested (RPYDATE)

Specifies the date and time a reply to the distribution is requested. This applies only to primary recipients.

The possible Reply by date values are:

*NONE: No reply is required.
*CURRENT: The current date is used. The time defaults to *ENDOFDAY and is set to 23:59:59.
*ANY: A reply is requested but no date and time are specified.
reply-by-date: Specify the value used as the reply requested date. The date must be specified in the format specified by the system value QDATFMT.

The possible Reply by time values are:

*ENDOFDAY

A reply is requested by the end of the specified date. The time is set to 23:59:59.

reply-by-time

Specify the value used as the reply requested time.

The time is specified in 24-hour format and can be specified with or without a time separator.

Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh=hours, mm=minutes, and ss=seconds. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.

With a time separator, specify a string of 5 or 8 digits (hours and minutes, or hours, minutes, and seconds). The time separator specified by the system value QTIMSEM is used to separate the hours, minutes, and seconds. If the command is entered from the command line, the string must be entered in apostrophes. If a time separator other than the separator used for your job is used, the command fails. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.

Top

Document status (STATUS)

Specifies the user-defined status of the document. Examples of status are: In Process, Pending Approval, or Retired.

*NONE: No status is included in this document.
status-of-document: Specify text that describes the status of the document. A maximum of 20 characters can be specified.

Top

Completion date (CMPDATE)

Specifies the date when the requested action is completed.

*NONE: No completion date is included.
*CURRENT: The current system date is used as the completion date.
date-complete: Specify the action completion date. The date must be specified in the job date format.

Top

Project (PROJECT)

Specifies the project associated with the document.

*NONE: No project field information is included in this document.
project: Specify text that describes the project of the document. A maximum of 10 characters can be specified.

Top

Language ID (DOCLANGID)

Specifies the language identifier to be placed in this document's interchange document profile (IDP).

Note: This parameter is ignored if the Profile file prompt (IDPFILE parameter) is specified, or if *MSG or *DOC is specified on the Information to be sent prompt (TYPE parameter).

*JOB: The language identifier specified for the job in which this command is entered is used.
language-identifier: Specify a language identifier. Press the F4 key from the Language ID prompt (DOCLANGID parameter) to see a list of valid identifiers.

Top

Country or region ID (DOCCNTRYID)

Specifies the country or region identifier to be placed in this document's interchange document profile (IDP).

Note: This parameter is ignored if the Profile file prompt (IDPFILE parameter) is specified, or if *MSG or *DOC is specified on the Information to be sent prompt (TYPE parameter).

*JOB: The country or region identifier specified for the job in which this command is entered is used.
country-or-region-identifier: Specify a country or region identifier. Press the F4 key from the Country or region ID prompt (DOCCNTRYID parameter) to see a list of valid identifiers.

Top

Allow alternate recipient (ALWALTRCP)

Specify if the distribution can be delivered to an alternate recipient, determined by the receiving system. This function is used only by X.400 network systems. This function provides the ability to direct certain mail to a specific user.

The default of this field is *YES. Because the user might change the sensitivity field to private but might not change the alternate recipient field to no, The user might send a private item to an alternate recipient. No error message is generated for this condition.

*YES: Specifies the distribution can be delivered to an alternate recipient.
*NO: Specifies the distribution cannot be delivered to an alternate recipient.

Top

Disclose recipient (DISCLOSE)

Specifies whether or not each recipient gets a list of the other recipients.

*YES: Disclose recipients.
*NO: Do not disclose recipients.

Top

Allow X.400 conversion (ALWX400CNV)

Specifies whether an X.400 conversion is allowed on the distribution being submitted. In certain circumstances, the end user knows the capabilities of the recipient and may indicate that the distribution is not to be converted. The system administrator can define whether or not conversion is to take place. This field allows the user to override that setting on a message by message basis. For example, if the gateway allows conversion, the user could specify that conversion is to be prohibited. This will take precedence over the gateway setting. The distribution would then not be converted.

Note: This field is valid only for X.400 support. This field will not affect System i5 data stream transformations, such as RFT to FFTDCA.

*YES: Conversion may be performed on the distribution by the receiving system.
*NO: No conversion is permitted on the distribution by the receiving system.

Top

Authorizing user (AUTUSR)

Specifies the user ID and address of the user that authorized the content of this distribution. The authorizing user will receive a copy of the distribution.

*NONE: No authorizing user.

The possible User ID value is:

user-ID: Specify the user ID of the user from whom the distribution is authorized.

The possible User Address value is:

user-address: Specify the user address of the user from whom the distribution is authorized.

Top

Distribution expiry indicator (DSTEXPDATE)

Specifies the date and time on which the distribution is no longer needed in the mail log.

The possible Distribution Expiration Date values are:

*NONE: The distribution has no expiration date.
dist-expiration-date: Specify the value to use as the expiration date for the distribution. The date must be in the format specified by the system value QDATFMT.

The possible Distribution Expiration Time values are:

*ENDOFDAY

An expiration time is requested by the end of the specified date. The time is set to 23:59:59.

dist-expiration-time

Specify the value as the expiration time.

The time is specified in a 24-hour format and can be specified with or without a time separator.

With a time separator, specify a string of 5 or 8 digits (hours and minutes, or hours, minutes, and seconds). The time separator specified by the system value QTIMSEM is used to separate the hours, minutes, and seconds. If the command is entered from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator used for your job is used, the command fails. Valid values for hh range from 00 to 23. Valid values for mm and ss range from 00 to 59.

Top

Command character identifier (CMDCHRID)

Specifies the character identifier (graphic character set and code page) for the data being entered as command parameter values. The character identifier is related to the display device used to enter the command.

In some cases, the data is translated to a code page and character set that is interchangeable with other IBM OfficeVision/400 products. The interchangeable character set and code page is '697 500', except for the User identifier prompt (USRID parameter), Recipient prompt (TOUSRID parameter), and Distribution identifier prompt (DSTID parameter), for which it is '930 500'. In other cases, the code page and character set are attached to the field and sent with the field to allow the receiving terminal to correctly print and display the field.

The following parameters are translated:

Recipient (TOUSRID)
Internet Recipient (TOINTNET)
User identifier (USRID)
Distribution identifier (DSTID)
Document system code (SYSCOD)
Message (MSG)
Description (DSTD)

The code page and character set is attached to the following parameters:

Long Message (LONGMSG)
Document description (DOCD)
Author (AUTHOR)
Document class (DOCCLS)
Keyword (KWD)
Subject (SUBJECT)
File cabinet location (FILCAB)
Copy list (CPYLST)
Reference (REFERENCE)
Document status (STATUS)
Project (PROJECT)

Single values

*SYSVAL: The system determines the graphic character set and code page values for the command parameters from the QCHRID system value.

*DEVD: The system determines the graphic character set and code page values from the display device description where this command was entered. This option is valid only when entered from an interactive job. If this option is specified in a batch job, an error occurs.

Element 1: Graphic character set

1-32767: Specify the graphic character set to use.

Element 2: Code page

1-32767: Specify the code page to use.

Top

Examples

Example 1: Sending a Distribution on Behalf of Another User

SNDDST   TYPE(*FILE)  TOUSRID((JACKSON RCH38DB))
         DOCTYPE(20000)  SYSCOD(BRANDX)
         DOCFILE(DEPT46ELIB/XTEXT)  DOCMBR(GOLD1IPFS)
         PTY(*HIGH)  USRID(JACOBSON RCH38NBS)
         DSTD('IPFS FOR GOLD1 PROJECT')  CFMDEL(*YES)
         MSG('Update section 1.2.4. Return for final printing')

This command sends a distribution that is being sent by someone (such as a secretary) who is authorized to work on behalf of JACOBSON. The document being sent is a BRANDX text document that is sent to another user who also has the BRANDX text processor.

Example 2: Sending a Mail Log Entry

SNDDST   TYPE(*DSTID)  DSTID('NEWYORK SMITH 0204')
         DSTIDEXN(02)  TOUSRID((JACKSON RCH38DB))
         MSG(*DSTIDMSG)  CFMDEL(*YES)

This command sends a mail log entry that is identified by the distribution document name NEWYORK SMITH 0204 that is distributed to user JACKSON at address RCH38DB. The message in the distribution document is distributed with the distribution.

Top

Error messages

*ESCAPE Messages

CPF8A87: Document name &2 not correct.
CPF8A97: Folder name &1 not correct.
CPF89AA: *FINALFORM for send format (SNDFMT) valid only for *DOC for type (TYPE).
CPF89AB: Specify *IDP or *MSG for type (TYPE) only with *NOCHG for send format (SNDFMT).
CPF900B: User ID and address &1 &2 not in System Distribution Directory.
CPF900C: Sign on and verify of user failed.
CPF901A: Send distribution request failed.
CPF903D: Incorrect document identifier specified.
CPF905C: Error occurred trying to find a translation table.
CPF9096: Cannot use CMDCHRID(*DEVD), DOCCHRID(*DEVD) in batch job.
CPF9845: Error occurred while opening file &1.
CPF9846: Error while processing file &1 in library &2.
CPF9847: Error occurred while closing file &1 in library &2.

Top