MDUPDPRJG - Update Project Group command
MDCMS is delivered with a command-based API that allows external tools or applications to add or remove an involved User Group from an existing Project in MDCMS.
The MDCMS command is named MDUPDPRJG 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 MDUPDPRJG in library MDCMS. In this case, be certain that the parameters sent to the program exactly match the parameters in command MDUPDPRJG.
Successful MDUPDPRJG transactions are logged in file MDCMS(ENV)/MDDTHST and visible from the Full History listing in the MDWorkflow web application.
NOTE: If Location Synchronization is used (MDCMS Settings option 6), the API will only need to be invoked for 1 system. The other partitions or physical systems will automatically be synchronized.
If the target Project is closed or if the Group or User aren't defined in MDCMS, the entry will not be processed.
MDUPDPRJG Parameter Table
| Name | Type | Length | Description |
|---|---|---|---|
| Name | Type | Length | Valid Values and Format |
| Project ID | CHAR | 12 | unique ID - Required |
| Group ID | CHAR | 10 | Valid User Group - Required |
| User ID | CHAR | 10 | A specific user that is a member of the group that will be involved with this project. Leave this parameter blank if any user that is a member of the group may be involved. |
| Role | CHAR | 1 | A - The role of Acceptance/Test will be applied. This indicates that the group/user will be responsible for accepting RFPs that have been installed in a level requiring acceptance before being allowed to migrate to the next level. T - The role of Technical will be applied. This indicates that the group/user will be responsible for carrying out work on behalf of the project. |
| Option | CHAR | 7 | *ADD - Add the provided Group/User combination for the given Role to the Project. If the combination already exists, execution will be ignored. *REMOVE - Remove the provided Group/User combination for the given Role from the Project. If the combination doesn't exist, execution will be ignored. |
| 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 |