0C1 in DFHSOS03 due to a branch to low core by BPXNSSIR when using Port Sharing

Technote (troubleshooting)


Problem(Abstract)

Your CICS Transaction Server for z/OS (CICS TS) receives an abendS0C1 in DFHSOS03 due to a branch to low core. The CSOL transaction is running at the time of the abend0C1. You are using Port Sharing across an IPIC connection between CICS Transaction Gateway (CICS TG) and CICS TS; this is not a supported environment.

Symptom

Abend 0C1 in DFHSOS03 followed by abend AKEX


Cause

In this case, there are two unsupported environments that cause this problem:

  1. Port Sharing across an IPIC connection between CICS TG and CICS TS is not supported. This is documented in the CICS TS information center, see Using TCP/IP in a CICS region. The CICS TG information center in section Configuring IPIC also states:

    An IPIC connection between CICS Transaction Gateway and CICS Transaction Server must not be load balanced through any TCP/IP port sharing or load balancing software.

  2. An OEM security package modified the IBM USS product's PC table, this causes the security package to receive control before USS.
    Note: The part of the security package that causes the problem is interacting outside of CICS.

This combination prevented USS from being able to deliver a SIGNAL for the duration of the BPX1CLO call issued by CICS. As part of the BPX1CLO process, CICS cleaned up the pointer to the exit code in the AIOCB. When USS tries to get a pointer to the exit code from the AIOCB, it picks up zeros and tries to branch there.

Diagnosing the problem

The 0C1 abend in DFHSOS03 is due to a branch to low core under the CSOL transaction.
The PSW is 078D0400 80000002 IL2 IC01.
This is a branch to zero with Instruction Length 2 and Interrupt Code 1.
Abend AKEX is then issued by CICS.

The running task was working with an IPIC connection between CICS TS and CICS TG.

Register 14 (X'E') from the BEAR (Breaking Event Address Register) address pointed to an 0DEF instruction in program BPXNSSIR from HBB7750 in BPXINLPA.

The KE stack for the CSOL task looks like:
DFHSOLS
LISTEN_SOLS
REGISTER
DFHSOIS
INQUIRE
GET_SERVER_IP_ADDRESS
GET_SERVER_BIN_IP_ADDRESS

A review of the trace shows that this task (or a previous one) had just been involved in trying to close the socket:
DFHSOCK
CLOSE_SOCK
TCPIP_CLOSE
DFHSOS03

Resolving the problem

Remove the unsupported Port Sharing configuration for the IPIC connection and the delay caused by the security package will not lead to the abend.

Product Alias/Synonym

CICS/TS CICS TS CICS Transaction Server

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

CICS Transaction Server
IPIC

Software version:

3.2, 4.1, 4.2, 5.1

Operating system(s):

z/OS

Reference #:

1442347

Modified date:

2013-09-25

Translate my page

Machine Translation

Content navigation