MDADDSOG - Add MDCMS Send Object Group command
Command MDADDSOG in library MDCMS(env) provides the ability to create an RFP in the Send list containing all objects associated with an MDWorkflow Object Group based on that group's object inclusion and exclusion rules.
If successful, the RFP will be available in the Send listing ready to be sent.
Each MDADDSOG transaction is logged in MDCMS/MDDASOG. In addition to displaying the input parameters, the log also shows the generated RFP Number, and, if an exception occurs, a short description of the error.
Restrictions:
- The user entered for parameter USER must have MDSEC authority to Edit RFPs in Send List (code 48) for the entered Application Level as well as authority to use the Project (and Task/Subtask, if entered). .
- The user performing MDADDSOG must have at least *USE authority for the USER parameter profile.
- The user performing MDCRTSCO must have been granted authority to execute the command in the MDSEC Command Security listing.
MDADDSOG Parameters
| Name | Type | Length | Description |
|---|---|---|---|
| Name | Type | Length | Description |
| APPL | CHAR | 6 | Application to send from |
| LVL | INTEGER | 3 | Application Level to send from |
| OGRP | CHAR | 10 | The MDWorkflow Object Group |
| RFPD | CHAR | 160 | The description to be placed on the RFP in the Send List |
| PROJ | CHAR | 12 | A valid Project ID to be applied to each object |
| TASK | INTEGER | 7 | The optional Task Number within the Project to be applied to each object |
| STSK | INTEGER | 7 | The optional Subtask Number within the Project Task to be applied to each object |
| USER | CHAR | 10 | The User ID to apply to the Send RFP and its objects *USER - the user of the job invoking the command |
| LOC | CHAR | 10 | The Location to send the RFP to by default when the send occurs *ALL = All target locations defined for the RFP's level that have the Default to Send property set to Y=Yes or M=Yes for Manual Send. |
| TLVL | INTEGER | 3 | The target level of remote locations to send to by default. 0 = all defined target levels for all default locations or the specific location in parameter LOC. |
| ENV | CHAR | 4 | Specifies the MDCMS environment that should be used when running the command. The ID correlates to the suffix of the MDCMS library name. For example, TEST correlates to library MDCMSTEST. *DFT = The default environment will be used. This correlates to library MDCMS. |
| VREF | CHAR | 20 | Specifies the Vendor Generated Identifier in order for an external process to easily identify the transaction record in the MDDASOG table. Any value up to 20 characters in length can be used. |
| EMSG | CHAR | 7 | Specifies if and to what extent an exception message should be returned to the calling program. An exception message occurs when an input parameter value is invalid, causing the addition of the request to fail. *DIAG = A diagnostic message will be placed in the calling program's message queue in the following format: MDSBMRFP Exception. Object= *ESCAPE = The full diagnostic message as described above will be placed in the calling program's message queue and then followed by escape message CPF0001 for which the calling program can monitor. *NONE = An exception message will not be returned to the calling program's message queue. |