Receiving LINKPGM command failure and return code (-3) invoking the RSPMAIN CLIST.

Document ID : KB000023776
Last Modified Date : 14/02/2018
Show Technical Document Details

Issue:

When invoking the CA Database Management Solutions for DB2 for z/OS products using the RSPMAIN CLIST, the CLIST is failing with the following error:

151 *-* address LINKPGM "PTLMSWRN" /**/
   +++ RC(-3) +++
TSO command failure, return code: -3
In module RSPDEF from?
LINE NUMBER IN ERROR: 151
LINE IN ERROR........: address LINKPGM "PTLMSWRN" /**/

The CLIST is being executed with the following parameters:

RSPMAIN PARMLIB(highlvl.PARMLIB) SUFFIX(xx)

Resolution:

The SUFFIX assignment determines which PTISYSxx member and in turn which DSNAMExx member of highlvl.PARMLIB is used for the execution of the products.

Review the relevant DSNAMExx PARMLIB member to ensure that the product libraries are defined correctly. In particular, this error would suggest that there is a problem with the PTILIB library definition. Correcting these definitions should resolve this RSPMAIN execution error.

Allocation of the DB2 product libraries are performed by RSPMAIN using the libraries (and LIBDEF's) specified in the DSNAMExx PARMLIB member. These product libraries must be allocated before the product can be executed.