TERM request
You can use the TERM request to terminate the IMS DB/CCTL connection and a remove the DRA from the CCTL environment. The DRA terminates after all threads have been resolved. No new DRA or thread requests are allowed, and current requests in progress must complete.
You must fill in the following input fields in the PAPL:
- Field
- Contents
- PAPLFUNC
- PAPLTERM, DRA terminate function code
- PAPLCTOK
- The DRA request token (output from an INIT request)
In addition to the required input parameters, the optional input parameters include:
- Field
- Contents
- PAPLTECB
- To use the default Suspend exit routine and Resume exit routine, each DRA request must have the field PAPLTECB set with the address of a CCTL ECB to be used if the thread is waited or posted. If your CCTL does not provide Suspend and Resume exit routines, the DRA default exit routines will be used.
After receiving the TERM request results, the CCTL might remove DFSPPRC0.
The fields returned in the PAPL to the CCTL are:
- Field
- Contents
- PAPLRETC
- The return code
- PAPLMXNB
- The number of times the maximum thread count was encountered during this DRA session
- PAPLMTNB
- The number of times the minimum thread count was encountered during this DRA session
- PAPLHITH
- The largest number of thread TCBs that were scheduled during this DRA session
- PAPLTIMX
- The elapsed time at maximum thread for this DRA session