To enable Concurrent Action Processing (CAP) feature with Webservices, follow these guidelines;
- Add an additional STC/Procedure with EN$CAP DD statement.
- For Execute action, define additional Webservices STC (BC1PAPI0).
- For Submit action, define additional Package procedure (C1BM3000).
1 - Execute action
For example, define the following STC:
- Default ENDEVOR STC without CAP feature.
- ENDECAP STC with CAP feature enabled.
Follow these steps to define ENDECAP STC:
- Create a new STC/datasource definition file: TomcatDir/webapps/endevor/ENDECAP.cfg
- Add ENDECAP SERVICE and PROCESS statements to ENF (CA EVENT NOTIFICATION FACILITY) OPTLIB member
- Create ENDECAP Webservices STC in the PROCLIB with following DD statement:
//EN$CAP DD DUMMY
How to execute package:
To execute a package without CAP:
Use the following request:
PUT /ENDEVOR/packages/packageName
{
"action": "execute"
}
Execute package with CAP feature:
PUT /ENDECAP/packages/packageName
{
"action": "execute"
}
2 - Submit action
For submit action, define 2 package procedures:
Note:
For submit action, add a DD statement into the package procedure (C1BM3000).
CAP feature for submit action won't work with Webservices STC ENDECAP from 1st example.
For example, define the following procedure:
- Default procedure EPDEFLT without CAP feature.
- EPCAP procedure with CAP feature enabled.
Follow these steps to define EPCAP procedure:
- Add EPCAP SERVICE and PROCESS statements to ENF (EVENT NOTIFICIATION FACILITY) OPTLIB member
- Create EPCAP JCL procedure in your PROCLIB with following DD statement:
//EN$CAP DD DUMMY
How to submit package:
1 - Submit a package without CAP:
Use following request:
PUT /ENDEVOR/packages/packageName
with option jclProc:
{
"action": "submit",
"fromDSN": "USERID.DSN",
"fromMember": "JOBCARD",
"jclProc": "EPDEFLT"
}
2 - Submit a package with CAP feature:
PUT /ENDEVOR/packages/packageName
with option jclProc:
{
"action": "submit",
"fromDSN": "USERID.DSN",
"fromMember": "JOBCARD",
"jclProc": "EPCAP"
}
Summary:
As a result, 2 STCs and 2 procedures have been built:
- 2 Webservices STCs (BC1PAPI0) for Package execute action:
ENDEVOR
ENDECAP
- 2 Package procedures (C1BM3000) for Package submit action:
EPDEFLT
EPCAP