PI63016: ITPENTER MAY GET ABEND S0C4 REASON CODE 10 OR 11 WHEN USING MANYPATH STATEMENTS

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When running TCP simulations that have more than 25 path
  statements or repeat more than 25 times a S0C4 reason code 10 or
  11 is possible.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All WSim users.                              *
  ****************************************************************
  * PROBLEM DESCRIPTION: WSim TCP enhancements corrected.        *
  *                      Previously PTF UI34087.This PTF         *
  *                      replaces UI34087;                       *
  ****************************************************************
  * RECOMMENDATION:                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  *                                                              *
  ****************************************************************
  The following enhancements are added to Workload Simulator:
  - Allows the user to start and stop a TCP/IP data trace specific
   to a client IP address and to a server port. This function
   can be accessed thru the WSim/ISPF interface panel option 4.1,
   thru the WSim Test Manager ISPF interface panel 'Add New
   Testcase' option 7, or by invoking the WSim tracing facility,
   ITPIPTRX, using JCL.To perform this function, WSim uses the
   z/OS Communication Server real-time application-controlled
   TCP/IP trace Network Management Interface (NMI).
  - Provides function to format data trace records utilizing the
   z/OS Communication Server trace record formatting NMI. This
   function can be accessed thru the WSim/ISPF interface panel
   option 4.2, or by invoking the WSim utility program, ITPIPFMT,
   using JCL.
  - Provides function to process TCP/IP HTTP packet and data trace
   records saved in a data set to generate Structured Translator
   Language (STL). This function can be accessed thru the
   WSim/ISPF interface panel option 5.4, thru the WSim Test
   Manager ISPF interface panel Add New Testcase option 8, or
   by invoking the WSim STL generating facility, ITPIPGEN, using
    JCL.
  - For a client coded in a TCP/IP network definition, allows the
   user to specify, with the PATH= operand, the number of times a
   path defined in a PATH statement will be executed during a
   simulation.
  
  Requirements:
  - Workload Simulator 1.1
  - z/OS 2.1 to utilize the z/OS Communication Server real-time
   application-controlled TCP/IP trace Network Management
   Interface (NMI)
  - To use the TCP/IP Trace Utility a user must have READ access
   to the following SAF resource profiles in the SERVAUTH class:
  * EZB.TRCCTL.sysname.tcpname.OPEN
  * EZB.TRCCTL.sysname.tcpname.DATTRACE
   where:
   * sysname is the MVS system name where the TCP/IP stack is
     running
   * tcpname is the TCP/IP stack job name
  - To use the TCP/IP Trace Utility to obtain a trace in clear
   text for a server using AT-TLS for message encryption the user
   will require READ access to the following SAF resource profile
   in the SERVAUTH class:
   *         EZB.TRCSEC.sysname.tcpname.ATTLS
  
  Note: When simulating TCP/IP clients, WSim does not have support
       for establishing a secure connection using SSL. Therefore
       when using WSim to simulate a client that requires a
       secure connection you will need to define a TCP/IP
       networking policy to ensure the simulated client uses
       AT-TLS.
  
  For further information on the SAF resources refer to the z/OS
   Communications Server IP Programmer's Guide and Reference.
  For further information on TCP/IP networking policies refer to
   the z/OS Communications Server IP Configuration Guide and the
   z/OS Communications Server IP Configuration Reference.
  
  Updates to Workload Simulator manuals are available:
  - Utilities Guide                               SC31-8947-01
  - Users Guide                                   SC31-8948-01
  - Creating WSim Scripts                         SC31-8945-01
  - Script Guide and Reference                    SC31-8946-01
  - Test Manager Users Guide and Reference        SC31-8949-01
  - Messages and Codes                            SC31-8951-01
  http://www.ibm.com/support/knowledgecenter/SSL28L_1.1.0
  http://www.ibm.com/software/awdtools/workloadsimulator/library/
  +-------------------------------------------------------------+
  + Please check our Communications Server for OS/390 homepages +
  + for common networking tips and fixes.  The URL for these    +
  + homepages can be found in Informational APAR II11334.       +
  +-------------------------------------------------------------+
  
  New functions have been added.
  

Problem conclusion

• This PTF repairs prev PTF UI34087
  If the ITERATE functionality that was introduced in that PTF
  is used there is a permanent restriction that there must be no
  more than 25 PATH statements in a message generation deck.
  Like wise there can be no more than 25 repeats.
  
  * Cross Reference between External and Internal Names
  SPA_NAME (IDSS_NAM)
  

Temporary fix

Comments

• ×**** PE18/03/02 PTF IN ERROR. SEE APAR PI93998  FOR DESCRIPTION
  

APAR Information

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

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

  UI42363

Modules/Macros

•    H281110J ITMEC    ITMECA   ITMES    ITMESN
  ITMEZ    ITMEZCI  ITMEZG   ITMEZM   ITMEZMS  ITMEZY   ITMPC
  ITMPCAA  ITMPCAAH ITMPCAC  ITMPCACH ITMPCAM8 ITMPCAM9 ITMPCAN8
  ITMPCAN9 ITMPCH   ITMPCM8H ITMPCM9H ITMPC2   ITMPS    ITMPSH
  ITMPSN1  ITMPSN1H ITMPSN3  ITMPSN3H ITMPUTL  ITMPUTLH ITMPUTL1
  ITMPUT1H ITMPZG   ITMPZGH  ITMPZTC1 ITMPZY   ITMPZYH  ITMSCTSG
  ITM0PRIE ITM05    ITM07    ITPCONV  ITPDDDEF ITPDTCMN ITPFE09
  ITPFE16  ITPFE17  ITPFE18  ITPFE20  ITPFE21  ITPFE23  ITPIPFMT
  ITPIPGEN ITPIPGRC ITPIPGST ITPIPMSG ITPIPPRT ITPIPSTL ITPIPSTM
  ITPIPTRC ITPIPTRX ITPIPV6V ITPKSCAN ITPLBBLD ITPLGDSQ ITPLUS99
  ITPMSTRC ITPPUT   ITPRCIFR ITPRSQIO ITPSCAN  ITPSELPT ITPWTO
  ITPYAEND ITP0GENP ITP0HCOM ITP0HI01 ITP0HI02 ITP0HI03 ITP0HI04
  ITP0HI05 ITP0HI08 ITP0HI09 ITP0HI10 ITP0HI13 ITP0HI14 ITP0HNDX
  ITP0HTCF ITP0HTCG ITP0HTCM ITP0HTCS ITP0HTCT ITP0H001 ITP0H002
  ITP0H031 ITP0H079 ITP0H200 ITP0H201 ITP0H202 ITP0H203 ITP0H204
  ITP0H212 ITP0H213 ITP0H214 ITP0H215 ITP0PRIE ITP0PRIP ITP0TCFP
  ITP0TCFS ITP0TCGP ITP0TCGS ITP0TCMP ITP0TCPS ITP0TCSP ITP0TCTP
  

Fix information

• Fixed component name

  IBM WORKLOAD SI

• Fixed component ID

  5655I3900

Applicable component levels

• R110 PSY UI42363

     UP16/11/11 P F611 Ø

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.