PK28865: DEFAULT TAKEN FOR MAXOPENTCB IF SSLTCBS IS USED IN THE R640 SIT

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• You are migrating to CICS TRANSACTION SERVER 310 and are
  reassembling your DFHSIT that was used under CICS TS 22.
  DFHAUPLE results in an assembled sit with warning message:
  ASMA254I  MNOTE 4,SSLTCBS IS OBSOLETE. PLEASE USE MAXSSLTCBS
                  INSTEAD
  When you try to run with your new SIT, your MAXOPENTCBS is set
  to the default, rather than 20 which you have specified.
  ADDITIONAL KEYWORDS: migrate migration CICS TS310 CICS TS220
  TS22 ASSEMBLE
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: When a SIT with SSLTCBS=0 included is   *
  *                      migrated to CICS TS 3.1 the MAXOPENTCBS *
  *                      value specified in the SIT is ignored   *
  *                      at start up and CICS uses the default   *
  *                      value of 5. This may cause other        *
  *                      messages to be issued such as           *
  *                      DFHDB2211I stating that MAXOPENTCBS is  *
  *                      less than the DB2 TCB limit.            *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  In DFHSIT if the SSLTCBS option is specified then a warning
  message MNOTE 4 is issued stating that it is obsolete and to use
  the MAXSSLTCBS parameter instead. Next DFHSIT will validate the
  obsolete value SSLTCBS specified, in the range of 0-1024.
  Therefore a value of zero will be accepted.
  If MAXSSLTCBS is not specified then the SSLTCBS value is passed
  onto CICS during Startup, via a SET_DISPATCHER call with the
  value SITMXSSL.
  However the valid data range for SITMXSSL is 1-1024 and if a
  0 is found, later code checking in DFHEIQDI and DFHPAGP issues
  an error message about the MAXSSLTCBS being out of range. The
  SET_DISPATCHER call fails, and MAXOPENTCBS is set to the
  default value of 5 rather than the value specified in the SIT.
  

Problem conclusion

• When DFHSIT validates the SSLTCBS parameter it now uses
  the same data range as the MAXSSLTCBS parameter of 1-1024. This
  is now passed in to CICS where it is processed correctly and
  passes the internal validation checks. Any SIT which has
  SSLTCBS=0 instead of MAXSSLTCBS coded will receive an MNOTE
  stating that the value of 0 is too low and that 1 has been
  assumed.
  

Temporary fix

• CICS AR400
  APPLY FIX, AND GENERATE
  AR400 DFHSIT
  ++ APAR (AK28865).
  ++ VER (C150) FMID(HCI6400).
  ++ MACUPD (DFHSIT ) DISTLIB(ADFHMAC) SYSLIB(SDFHMAC)
      PREFIX (DFHSIT  )
     /* MODULE: DFHSIT --- TYPE: MACRO */.
  ./ CHANGE NAME=DFHSIT,SEQFLD=738
           DFHPRMCK SSLTCBS,&SSLTCBS,,N,1,1024,8
                                             @BA28865 20266000
  ./ ENDUP
  

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

  UK17417

Modules/Macros

•    DFHSIT   DFHSIT$$ DFHSIT6$
  

Fix information

• Fixed component name

  CICSTS 3.1 Z/OS

• Fixed component ID

  5655M1500

Applicable component levels

• R400 PSY UK17417

     UP06/08/26 P F608

Fix is available

• Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.