Sysview for Db2 (IDB2) thread cancel failure "THREAD TERMINATOR $PTTAPI INIT FUNCTION FAILED. R15 / R0 = 08 / 16"

Products

• Detector for DB2 for z/OS

Issue/Introduction

Using Sysview for Db2 (IDB2) to cancel a thread (via PTT) failure occurred: 

"THREAD TERMINATOR $PTTAPI INIT FUNCTION FAILED. R15 / R0 = 08 / 16"

The native DB2 Cancel Thread command proved successful eliminating an 'Authority' concern.

 

Environment

Release : 20.0

Component : Sysview for Db2 (IDB2), Thread Terminator (PTT)

Cause

The XmanID being used by IDB2 was not correct. 

Resolution

The $PTTAPI INIT FUNCTION FAILED. R15 / R0 = 08 / 16" error indicates that the expected Xmanager task was not active at the time of the thread cancel.  Examining the IDB2 DC's Suffix and Parmlib showed communication to the Xmanager with an XmanID of 2402.  The expected Xmanager task uses an XmanID of 2502. This mismatch supports the cause of the error message.  Correcting IDB2's sysparm Suffix and PTIPARM allocation to reference an XmanID of 2502, the IDB2 thread cancel proved successful.