Start of change

DFS7431I IFAWIC connection failed - RC= xxxxxxxx, RSN= yyyyyyyy

Explanation

IMS attempted to register with IBM® z/OS® Workload Interaction Correlator and received a nonzero return code xxxxxxxx with a reason code yyyyyyyy. The value for xxxxxxxx can be one of the following values:

RC 00000004
The combined length of the persistent component and activity areas, together with the BPE overhead, was larger than the maximum number of pages that are allowed for an IBM z/OS Workload Interaction Correlator buffer. An IBM z/OS Workload Interaction Correlator buffer currently allows 16 4K pages at maximum. For INITMT, the reason might also be either one of the lengths of the persistent component or activity areas, or the lengths of both, were negative.
RC 00000008
One or both of the persistent component length and activity areas length were not a multiple of 16. The length is required to be a multiple of 16 to preserve quadword alignment for instructions like CDSG. This return code is only for INITMT.
RC 0000000C
The SMF 98 subtype value was zero. This return code is only for INITMT.
RC 00000010
The address that was passed in BPEMTSRV_OUTBUFPTR was zero. This return code is only for INITMT.
RC 00000030
IBM z/OS Workload Interaction Correlator (Micro-Trend) services are not available on this system.
RC 00000034
The LOAD request of BPEMTX00 failed. yyyyyyyy contains the return code from the LOAD request.
RC 00000038
The LOAD request of BPEMTEN0 failed. yyyyyyyy contains the return code from the LOAD request.
RC 0000003C
The ENFREQ request for BPEMTEN0 failed. yyyyyyyy contains the return code from the ENFREQ request.
RC 00000040
IFAWIC registration received higher than a warning RC. yyyyyyyy contains the reason code returned by IFAWIC. See the IFAWIC documentation in the z/OS MVS™ Programming: Authorized Assembler Services Reference EDT-IXG manual for details.
RC 00000044
The BPEMTSRV call is not supported in a cloned copy of BPE.
RC 000000F8
The function requested is unknown.
RC 000000FC
The parmlist version is not supported by BPEMTSV0.
Note: This message will be suppressed when IMS runs on a pre-z14 machine, or if IBM z/OS Workload Interaction Correlator is not available, or both.

System action

IMS continues processing with no statics being passed to IBM z/OS Workload Interaction Correlator.

Programmer response

If IBM z/OS Workload Interaction Correlator participation is needed, see the return and reason codes to determine the cause of failure, fix the problem and restart IMS.

End of change