z/OS MVS System Messages, Vol 3 (ASB-BPX)
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


ATB020E

z/OS MVS System Messages, Vol 3 (ASB-BPX)
SA38-0670-00

ATB020E
THE NUMBER OF APPC ACTIVE CONVERSATIONS FOR ASID num1 HAS CROSSED THE PRE-ESTABLISHED THRESHOLD. NUMBER OF ACTIVE CONVERSATIONS: num2; APPC ACTIVE CONVERSATION THRESHOLD: num3.

Explanation

The APPC active conversations threshold specified by the CONVMAX parameter has been exceeded. This message is displayed either when CMACTION is set to MSGONLY on the APPC PROC statement, or when the CMACTION keyword is omitted from the APPC PROC statement.

For each APPC active conversation on the system, APPC reserves a certain amount of system storage. A runaway transaction program, which creates many conversations but never deallocates them, could potentially exhaust the fixed amount of system storage that APPC has obtained. To inform the installation of such a program, APPC allows the installation to specify a threshold which will cause notification of such a problem.

You can define the APPC active conversation threshold on the CONVMAX subparameter of the PARM parameter of the EXEC statement in the APPC member of SYS1.PROCLIB. The CONVMAX value is a 1- to 5-digit number indicating the maximum APPC active conversations a single address space can have before a critical action console message is issued for operator intervention, if CMACTION is set to be MSGONLY or the CMACTION is omitted from the APPC PROC statement.

The minimum possible value is CONVMAX=100. If you specify a value between 1 and 99 on the CONVMAX parameter, the system sets the maximum APPC conversions threshold to 100.

The maximum possible value is CONVMAX=20000. If you do not specify a value for CONVMAX, the system uses a default of 2000.

If you specify a value greater than 20000, the system sets the maximum APPC active conversations threshold to 20000.

If you specify a value of 0 (zero) then the system will not monitor the total number of conversations for an address space, regardless of the quantity.

In the message text:
num1
Address space identifier.
num2
Number of active conversations.
num3
APPC active conversations threshold.

System action

The system continues processing.

Operator response

Contact the system programmer to determine further action.

System programmer response

Investigate whether the critical action console message is due to a programming error in an APPC transaction program or due to some APPC stress workload for this address space. (A transaction program which allocates conversations but fails to deallocate the same results in many dangling conversations, which could exhaust APPC storage.) If it is a programming error then cancel the problematic transaction program, fix it, and re-run it. If it is not a problem with the transaction program and also if it is normal for the number of conversations to exceed the conversation threshold limit for that transaction program, then consider changing the CONVMAX parameter to a reasonably higher value such that this message will not appear on a regular basis and re-run the transaction program.

Module

ATBVSCM

Source

APPC/MVS

Routing Code

2

Descriptor Code

7,11

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014