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

book

Article ID: 6383

calendar_today

Updated On:

Products

CA Bind Analyzer for DB2 for z/OS CA Detector CA SQL-Ease for DB2 for z/OS CA Sysview Performance Management Option for DB2 for z/OS CA Database Detector for DB2 for z/OS CA Plan Analyzer for DB2 for z/OS CA Subsystem Analyzer for DB2 for z/OS

Issue/Introduction

The startup of the XNET STC fails to initialize due to the 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.  Or, 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.

 

Environment

Release:
Component: CIDB

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.