MDUPDATT - Update Project/Task Attachment command
MDCMS is delivered with a command-based API that allows external tools or applications to add, update or remove an attachment from an existing Project, Task or Subtask in MDCMS.
The MDCMS command is named MDUPDATT and is located in library MDCMS. It is not necessary to have the MD libraries in the library list prior to using this command. If you are unable to invoke a command from your Project Management tool, you can also directly call program MDUPDATT in library MDCMS. In this case, be certain that the parameters sent to the program exactly match the parameters in command MDUPDATT.
Every MDUPDATT transaction is logged in file MDCMS(ENV)/MDDUATT and visible from the Logging settings in the MDCMS Setup Menu.
MDUPDATT Parameter Table
| Name | Type | Length | Description |
|---|---|---|---|
| Name | Type | Length | Valid Values and Format |
| Project | CHAR | 12 | unique ID - Required |
| Task | DEC | 7 | Task Number - Leave as 0 if the attachment is to be applied directly to the Project. |
| Subtask | DEC | 7 | Subtask Number - Leave as 0 if the attachment is to be applied directly to the Project or Task. |
| IFS File Name | CHAR | 80 | The Name of the File to add, update or remove for this Project/Task |
| Option | CHAR | 7 | *UPDADD - If an attachment already exists for the given file name, it will be replaced with the file provided. Otherwise, the file will be added as a new attachment. *ADD - If an attachment already exists for the given file name, the existing file will be retained. *REMOVE - Remove the attachment of the entered name from the Project/Task. |
| IFS Folder containing File | CHAR | 240 | The full path name in the IFS where the file is located. This parameter is ignored if removing an attachment. |
| MDCMS Instance | CHAR | 5 | Specifies the MDCMS environment that should be used for the API. The ID correlates to the suffix of the MDCMS library name. Special values: *DFT - default instance (no suffix) *SAME - the current instance based on the library list |