MDAPRRFP - RFP Approver command
MDCMS is delivered with a command-based API that allows external processes to approve some or all RFPs. An RFP must have status 02 (Waiting for Approval) in order to be considered by the API.
By default, users are not authorized to use this command. Authority can be granted from the MDSEC Command Security feature.
The MDCMS command is named MDAPRRFP and is located in library MDCMS*.
All MDAPRRFP API transactions are logged to file MDCMS/MDDARFP.
MDAPRRFP Parameter Table
| Name | Type | Length | Description |
|---|---|---|---|
| Name | Type | Length | Description |
| APPL | CHAR | 6 | Application Code or *ALL for any application |
| RFP | INTEGER | 7 | Specific RFP Number - if left blank, then the range of RFP numbers will be considered |
| RFPT | CHAR | 8 | Specific RFP Type - the type of specific RFP number passed in parameter RFP. *CURRENT = the current number for an RFP *FROM = The RFP number refers to the RFP installed into the prior level, which then automatically generated the RFP with a different number to be deleted. *ORIG = Each RFP to be deleted originated from the specified RFP number, which was installed into the initial level for a chain of migrations across systems. |
| FROMLVL | INTEGER | 3 | Minimum Application Level to consider |
| TOLVL | INTEGER | 3 | Maximum Application Level to consider |
| FROMRFP | INTEGER | 7 | Minimum RFP Number to consider |
| TORFP | INTEGER | 7 | Maximum RFP Number to consider |
| PROJ | CHAR | 12 | Project Filter - only install RFP if one or more Objects in the RFP are requested for the Project |
| TASK | INTEGER | 7 | Task Filter - only install RFP if one or more Objects in the RFP are requested for the Project Task |
| STSK | INTEGER | 7 | Subtask Filter - only install RFP if one or more Objects in the RFP are requested for the Project Subtask |
| PIPE | CHAR | 10 | Pipeline Filter - Specifies the Pipeline Server ID of a Pipeline TraceKey request. This value is required if a value for TRCKEY is provided. If values for PIPE/TRCKEY are provided, an RFP will only be included if it contains an object request of type *PIPE with the Pipeline server ID and TraceKey in the object name. |
| TRCKEY | CHAR | 128 | Pipeline TraceKey Filter - Specifies the Pipeline TraceKey of a Pipeline TraceKey request. This value is required if a value for PIPE is provided. If values for PIPE/TRCKEY are provided, an RFP will only be included if it contains an object request of type *PIPE with the Pipeline server ID and TraceKey in the object name. |
| ENV | CHAR | 4 | Specifies the MDCMS environment that should be used to place the Request. 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. |
| 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: MDINSRFP 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. |