DFHSO1001 date time applid A Communications Server TCP/IP callable NMI error (code X'code') has occurred in module modname.

Explanation

An error has been detected in module modname. The code X'code' is the exception trace point ID which uniquely identifies what the error is and where the error was detected, for example:

  • 0CA6 SVC call rejected

  • 0CA7 SVC call abended

  • 0CA8 NMI INQUIRE failed

NMI INQUIRE is used to obtain the value of z/OS Communications Server TCP/IP parameter SOMAXCONN for use with a TCPIPSERVICE attribute BACKLOG.

System action

An exception entry (code X'code' in the message) is made in the trace table. A system dump is taken, unless you have specifically suppressed dumps in the dump table.

CICS continues unless you have specified in the dump table that CICS should terminate. If appropriate, an error return code is sent to the caller of this domain. In this case, CICS could be terminated by the caller (for example, the domain manager, DFHDMDM). A message is issued to this effect.

Message DFHME0116, which contains the symptom string for this problem, is produced.

User response

A possible cause of this error is an incorrect set up of the CICS Type 3 SVC. Verify the CICS Type 3 SVC has been correctly installed. The exception trace entry may tell you the value returned by the CICS Type 3 SVC in register 15. Values other than -1 and 0 indicate a failure with the call to the CICS Type 3 SVC itself. This can occur with an incorrect set up of the CICS Type 3 SVC.

Alternatively if the CICS Type 3 SVC has been correctly installed, this indicates a possible error in CICS code or the called Communications Server TCP/IP NMI request. This can be the case when the value returned in register 15 is -1 or 0. The exception trace entry will tell you which request was called and the response values that were returned. z/OS Communications Server IP Programmer's Guide and Reference provides more information. The severity of its impact depends on the importance of the function being executed at the time of the error.

CICS may not have been terminated. If the message occurs once and module modname is not crucial to the running of your CICS system, you may decide to continue to run and bring CICS down at a convenient time to resolve the problem.

If the message recurs or if you cannot run without the full use of module modname, you should bring CICS down in a controlled shutdown.

In the case of a failed NMI INQUIRE, the value used for a TCPIPSERVICE attribute BACKLOG cannot be set to the value of z/OS Communications Server TCP/IP parameter SOMAXCONN.

Module

DFHSOLS

XMEOUT parameters/Message inserts

  1. date
  2. time
  3. applid
  4. X'code'
  5. modname

Destination

CSOO and Console