Netstat command fails with IPNS0806

Products

NetMaster Network Management for TCP/IP NetMaster File Transfer Management SOLVE

Issue/Introduction

Attempting to use /NETSTAT to determine whether a new application is the one using a specific port as the port was not reserved in the TCPIP Stack.

On the Test System a NETSTAT SOCK STACK=TCPIP command showed which application was grabbing the port.

On the Development it shows an error

NESTAT SOCK STACK=TCPIP1
IPNS0806 UNIX shell request OPEN has failed due to UNIX server start failed
** END OF DELIVERED MESSAGES **

SELFTEST shows

IPDI5270 Checking UNIX System Services Interface for userid 
IPDI5277    Error: UNIX environment could not be established
IPDI5278    Error: UNIX failed, RC/FDBK=8/8, reason=UNIX server start failed
IPDI527Z

Maintenance level is below Complete GA; /PARMS does not show USS or ZFS parameter groups, so any USS debug messages are missing.

Environment

Release : 12.2

Component : CA NetMaster Network Management for TCP/IP

Cause

The CC2DZFS file was not rolled out with the Netmaster upgrade so is not available to facilitate USS functionality to Netmaster.

Resolution

The CC2DZFS file is generated, mounted to zFS and populated during the install process. That SMP/E version of the file must remain mounted to the original path to facilitate correct application of future maintenance.

As with other runtime libraries, this CC2DZFS VSAM file must be rolled out to other systems.
To do so:

1. Copy the file to all systems using a backup/restore system such as CA FAVER, DFDSS, etc

2. Create the USS path and dynamically set up the MOUNTPOINT.
The I01ALLOC job from the SMP/E install contains steps to facilitate that.

3. After verifying everything is working, create a permanent MOUNTPOINT in the BPXPARM.

Alternately, you can use the steps in I01ALLOC to create and mount the CC2DZFS file using IDCAMS and follow the instructions in our manual to copy content from one USS filesystem to another

Additional Information

Related documentation from the Netmaster 12.2 Installing Guide:

Mounting the CC2DZFS file
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-mainframe-software/performance-and-storage/ca-netmaster-shared-content-library/12-2/install-or-upgrade-ca-netmaster-products/prepare-to-start-your-products.html#concept.dita_b696b131f4437bd80b9e038c88e7b93130314936_MountCC2DZFSfile

Deploy Data Sets
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-mainframe-software/performance-and-storage/ca-netmaster-shared-content-library/12-2/install-or-upgrade-ca-netmaster-products/deploy-and-configure-on-multiple-systems.html#concept.dita_a9929e29c9acd001484af223e5eb7a0a42990a4e_DeployDataSets

Setting up USS authorization
https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-mainframe-software/performance-and-storage/ca-netmaster-shared-content-library/12-2/install-or-upgrade-ca-netmaster-products/define-unix-system-service-uss-authorization.html

See also other KBs for potentially related USS problems
https://knowledge.broadcom.com/external/article?articleId=128801
https://knowledge.broadcom.com/external/article?articleId=111099
https://knowledge.broadcom.com/external/article?articleId=198259