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

Products

• Database Management for DB2 for z/OS - Administration Suite
• Database Management for DB2 for z/OS - Performance Suite
• Database Management for DB2 for z/OS - Recovery Suite
• Database Management for DB2 for z/OS - SQL Performance Suite
• Database Management for DB2 for z/OS - Utilities Suite
• DATABASE MANAGEMENT SOLUTIONS FOR DB2 FOR Z/OS

Issue/Introduction

When invoking the 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.