| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Distribution Description (CHGDSTD) command changes descriptive information (such as author, subject, or keywords) or access information about a distribution document in the mail basket. For some parameters, descriptive information can be deleted or added.
Restrictions: (1) To work on behalf of another user, you must be 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 mail distribution cannot be requested by a requester working on behalf of another user.
| Top |
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| DSTID | Distribution identifier | Character value | Required, Positional 1 |
| DSTIDEXN | Distribution ID extension | 1-99, *NONE | Optional |
| COMMENT | Comment | Character value, *SAME, *RMV | Optional |
| USRID | User identifier | Single values: *CURRENT Other values: Element list |
Optional |
| Element 1: User ID | Character value | ||
| Element 2: Address | Character value | ||
| SENSITIV | Sensitivity | *SAME, *NONE, *PERSONAL, *PRIVATE, *CONFIDENTIAL | Optional |
| PERSONAL | Personal | *SAME, *NO, *YES | Optional |
| IMPORTANCE | Content importance | *SAME, *NORMAL, *LOW, *HIGH | Optional |
| PTY | Priority | *SAME, *NORMAL, *HIGH | Optional |
| DOCD | Document description | Character value, *SAME | Optional |
| DOCDATE | Document date | Date, *SAME, *RMV | Optional |
| EXPDATE | Expiration date | Date, *SAME, *RMV | Optional |
| ACTDATE | Action due date | Date, *SAME, *RMV | Optional |
| CMPDATE | Completion date | Date, *SAME, *RMV | Optional |
| REFERENCE | Reference | Character value, *SAME, *RMV | Optional |
| STATUS | Status | Character value, *SAME, *RMV | Optional |
| PROJECT | Project | Character value, *SAME, *RMV | Optional |
| DOCLANGID | Language ID | Character value, *JOB, *SAME | Optional |
| DOCCNTRYID | Country or region ID | Character value, *JOB, *SAME | Optional |
| DSTEXPDATE | Distribution expiry indicator | Element list | Optional |
| Element 1: Date | Date, *SAME, *CURRENT, *RMV | ||
| Element 2: Time | Time, *SAME, *CURRENT, *ENDOFDAY | ||
| AUTHOR | Author | Single values: *SAME Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Author | Character value | ||
| Element 2: New author | Character value, *ADD, *RMV | ||
| DOCCLS | Document class | Character value, *SAME, *RMV | Optional |
| KWD | Keyword | Single values: *SAME Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Keyword | Character value | ||
| Element 2: New keyword | Character value, *ADD, *RMV | ||
| SUBJECT | Subject | Single values: *SAME Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Subject | Character value | ||
| Element 2: New subject | Character value, *ADD, *RMV | ||
| FILCAB | File cabinet location | Character value, *SAME, *RMV | Optional |
| CPYLST | Copy list | Single values: *SAME Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Copy list | Character value | ||
| Element 2: New copy list | Character value, *ADD, *RMV | ||
| CMDCHRID | Command character identifier | Single values: *SYSVAL, *DEVD Other values: Element list |
Optional |
| Element 1: Graphic character set | Integer | ||
| Element 2: Code page | Integer | ||
| DOCCHRID | Document character identifier | Single values: *SYSVAL, *DEVD, *SAME Other values: Element list |
Optional |
| Element 1: Graphic character set | Integer | ||
| Element 2: Code page | Integer |
| Top |
Specifies the unique distribution identifier of the distribution. The identifier is assigned to the distribution by the system that originated it. Only incoming distributions can be changed. If the identifier represents an outgoing distribution, an error message is returned.
This is a required parameter.
| Top |
Specifies the extension of the distribution identifier (if any) specified on the Distribution identifier prompt (DSTID parameter). This 2-digit extension has a value ranging from 01 through 99 that uniquely identifies duplicate distributions. The default value is 01.
| Top |
Specifies comments that describe the distribution document.
| Top |
Specifies which user ID address is associated with this request.
| Top |
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.
| Top |
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.
| Top |
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.
| Top |
Specifies the speed with which the distribution is sent. The prior version's purpose for priority is no longer valid because it relates to the speed by which the distribution arrived at the system. To ensure compatibility with applications from previous releases, this parameter will remain. If the command is prompted without this parameter specified, this parameter is not displayed.
| Top |
Specifies the description of the document being changed. This is the Document Interchange Architecture Profile document name field.
| Top |
Specifies any date the user wants to assign to the distribution document.
| Top |
Specifies the document expiration date beyond which the distribution document is no longer needed.
| Top |
Specifies the date when the action requested is due.
| Top |
Specifies the date when the action requested is completed.
| Top |
Specifies a reference associated with the distribution document.
| Top |
Specifies the user-defined status indicator (In Process, Pending Approval, or Retired) of the distribution document.
| Top |
Specifies the project name with which the distribution document is associated.
| Top |
Specifies the language identifier to be placed in this distribution document's interchange document profile (IDP).
This parameter can be used to add a language identifier to the document's IDP if the identifier has not been specified previously, or to change the value of an existing language identifier.
Note: If you specify a value on this parameter and no value has previously been specified on the Country or region ID prompt (DOCCNTRYID parameter), you must also specify a country or region identifier.
| Top |
Specifies the country or region identifier to be placed in this distribution document's interchange document profile (IDP).
This parameter can be used to add a country or region identifier to the document's IDP if an identifier has not been specified previously, or to change the value of an existing country or region identifier.
Note: If you specify a value on this parameter and no value has previously been specified on the Language ID prompt (DOCLANGID parameter), you must also specify a language identifier.
| Top |
Specifies the date and time at which the distribution is no longer needed in the mail log.
The possible Distribution Expiration Date values are:
If *SAME is specified for both the distribution expiration date and distribution expiration time, no changes are made to the distribution expiration date and time.
If *SAME is specified for the distribution expiration date and a value other than *SAME is specified for the distribution expiration time, the command checks for the existence of the distribution expiration date. If the distribution expiration date exists, the date remains unchanged and the time is changed as specified. If the distribution expiration date does not exist, an error message is issued indicating this condition, and you must specify something other than *SAME.
The possible Distribution Expiration Time values are:
If *SAME is specified for both the distribution expiration date and distribution expiration time, no changes are made to the distribution expiration date and time.
If *SAME is specified for the distribution expiration time and a value other than *SAME is specified for the distribution expiration date, the system checks for the existence of the distribution expiration time. If the distribution expiration time exists, the time does not change and the date is change as specified. If the distribution expiration time does not exist, an error message is issued, and you must specify something other than *SAME.
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 QTIMSEP 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 |
Specifies the author or authors of the distribution document. A maximum of 20 characters can be specified, enclosed in apostrophes.
You can enter multiple values for this parameter.
The possible author values are:
The possible new author values are:
| Top |
Specifies the class associated with this distribution document.
| Top |
Specifies the keywords that can be used to describe the distribution document.
You can enter multiple values for this parameter.
The possible keyword values are:
The possible new keyword values are:
| Top |
Specifies the subject of the distribution document.
You can enter multiple values for this parameter.
The possible subject values are:
The possible new subject values are:
| Top |
Specifies the physical location where the distribution document is stored. This parameter is intended for printed distribution documents. It changes only the Document Interchange Architecture Profile field that refers to the printed document.
| Top |
Specifies names or addresses of users who receive this distribution document.
You can enter multiple values for this parameter.
The possible copy list values are:
The possible new copy list values are:
| Top |
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.
Element 1: Graphic character set
Element 2: Code page
| Top |
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.
Note: Both parts can be up to 5 digits in length.
| Top |
Example 1: Deleting an Author
CHGDSTD DSTID('NEWYORK SMITH 0201') DSTIDEXN(01)
AUTHOR('John W. Baker' *DLT)
KWD('PC Attached Scanners' *ADD)
This command deletes one of the authors associated with a distribution document and adds a new keyword to the distribution document.
Example 2: Changing the User-Defined Document Name
CHGDSTD DSTID('NEWYORK SMITH 0201') DSTIDEXN(02)
DOCD('S/38 1984 Sales') USRID(JACOBSON RCHJACOB)
In this example, a person authorized to work on behalf of JACOBSON is changing the user-defined document name associated with a document on the second distribution sent to the user.
| Top |
*ESCAPE Messages
| Top |