Function=&1(C,C,16) retv=&2(X,X,4) retc=&3(X,X,4) rsnc=&4(X,X,4)
Source: Debug message from HPR or EE connection monitor tasks.
Reason: Lists the return codes after a VTAM NMI request or a GETMAIN request.
&1=name function being performed
&2=returned value for NMI request, or buffer address for getmain
&3=return code from request
&4=reason code if failure, length for successful getmain
This message indicates that the VIP agent has failed to connect with IBM’s SNAMGMT Network Management API (NM API).
A positive return value (retv=0x00000000 to retv=0x7FFFFFFF) with a return code (retc) and reason code (rsnc) of zero (retc=0 rsnc=0) means that no Enterprise Extender ports are defined for this VTAM.
A non-zero return code in the message indicates the problem more precisely.
retc=0x0000006F — EACCES permission denied. Most likely the site does not authorize–via RACF, ACF2, TOPSEC, etc.–the VIP agent’s user ID to access the SNAMGMT NM API. The agent’s user ID needs authority to access the NM API resources in the SERVAUTH class; or if SERVAUTH is not enabled, the agent’s user ID needs super-user privileges.
retc=0x00000081 rsnc=*003D ENOENT — No such file, directory, or IPC member exists. Most likely, the system has not enabled the SNAMGMT NM API.
retc=0x00000081 rsnc=*006C ENOENT — No such file, directory, or IPC member exists. Most likely, VTAM does not have authority to write to the /var directory or create the /var/sock directory. Or VTAM does not have authority to open an OMVS segment.
retc=0x00000468 ECONNREFUSED — The attempt to connect was rejected.
rsnc=0x120D0253 JRSocketNotFound — The requested socket was not found, or is not active.
To verify that the VTAM SNAMGMT option has been enabled, issue DISPLAY NET,VTAMOPTS,OPTION=SNAMGMT.
For help enabling the NM API, see the VIP Environment Checklist, available on the Downloads page of the SDS website support.sdsusa.com/downloads/. For more information, see the IBM manuals z/OS Unix System Services Messages and Codes and z/OS Communications Server IP Programmer’s Guide and Reference.