Systematic Start/End of MDRapid Jobs
MDSTRRAP – Restart MDRapid Jobs command
MDCMS is delivered with a command-based API that allows external processes to restart MDRapid jobs for an RFP. An RFP must have status CR (MDRapid Copy Running) or 03 (Ready to Install) in order to be considered by the API.
The MDCMS command is named MDSTRRAP and is in library MDCMS.
All MDSTRRAP API transactions are logged to file MDCMS/MDDARAP.
MDSTRRAP Parameter Table
| Name | Type | Length | Description |
|---|---|---|---|
| APPL | CHAR | 6 | Application Code (required) |
| RFP | INTEGER | 7 | RFP Number. 0=Restart MDRapid for all RFPs in the Application that were previously started and are currently in status CR=Copy Running or 03=Waiting for Installation |
| MINF | CHAR | 10 | Minimum File Name Value – the minimum alphabetic value of files in the list to restart. *FIRST = Files beginning with the first file in the list |
| MAXF | CHAR | 10 | Maximum File Name Value – the maximum alphabetic value of files in the list to restart. *LAST = Files ending with the last file in the list |
| MON | CHAR | 4 | Restart Monitor Job – if the MDRapid monitor job should be restarted. *YES – if the monitor job is not active, it will be restarted. *NO – do not restart the monitor job |
| 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=<OBJN>, Reason=<the error reason>. *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. |
MDENDRAP – End MDRapid Jobs command
MDCMS is delivered with a command-based API that allows external processes to end MDRapid jobs for an RFP. An RFP must have status CR (MDRapid Copy Running) or 03 (Ready to Install) in order to be considered by the API.
The MDCMS command is named MDENDRAP and is in library MDCMS.
All MDENDRAP API transactions are logged to file MDCMS/MDDARAP.
MDENDRAP Parameter Table
| Name | Type | Length | Description |
|---|---|---|---|
| APPL | CHAR | 6 | Application Code (required) |
| RFP | INTEGER | 7 | RFP Number. 0=End MDRapid for all RFPs in the Application that were previously started and are currently in status CR=Copy Running or 03=Waiting for Installation |
| MINF | CHAR | 10 | Minimum File Name Value – the minimum alphabetic value of files in the list to end. *FIRST = Files beginning with the first file in the list |
| MAXF | CHAR | 10 | Maximum File Name Value – the maximum alphabetic value of files in the list to end. *LAST = Files ending with the last file in the list |
| MON | CHAR | 4 | End Monitor Job – if the MDRapid monitor job should be ended. *YES – if the monitor job is active, it will be ended. *NO – do not end the monitor job |
| 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=<OBJN>, Reason=<the error reason>. *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. |