XNET startup encountering error xntTCP011I TCP/IP HPNS INITAPI complete retcode(-1) errno(156)

Products

• SYSVIEW Performance Management Option for DB2 for z/OS
• 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 - 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

The startup of the XNET STC fails to initialize due to error:
xntTCP011I TCP/IP HPNS INITAPI complete - retcode(-1) errno(156)

Cause

This type of INITAPI failure: retcode(-1) errno(156) can be caused by the UID associated with the XNET STC not having an OMVS segment or home directory
defined.  If it does have an OMVS segment and home directory defined, but is not defined as UID(0), the MAXPROCUSER setting in the BPXPRMxx
member has reached its limitation on the number of processes that a single user (that is, with the same UID) can have concurrently active.

 

Resolution

The resolution was to define the userID associated with the XNET STC as UID(0) for a UID (0) is not limited by the MAXPROCUSER value.