PK59009: ATTEMPTING TO DISPLAY UOWLINKS USING THE CPSM WUI SCREEN DOES NOT RETURN DATA UNLESS SPECIFYING THE ENTIRE UOWLINK NAME.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• Attempting to display UOWLINKs from the CPSM WUI CICS operations
  views, Unit of work link screen , does not work as expected.
  If leaving the 'Link token' field 'BLANK' or using '*' or 'ABC*'
  returns NO DATA.  You will see message :
  
  EYUVC1280I 0 records collected at xx/xx/xx xx:xx:xx.
  
  If you enter the complete UOWLINK name, for example: ABCLINK
  You'll get back data for that particular UOWLINK.
  
  Additional Symptom(s) Search Keyword(s):
  Resource name: UOWLINK View name: EYUSTARTUOWLINK.TABULAR
  KIXREVJXD
  
  Formatting out the CPSM WUI Auxtrace will show you the following
  Trace Entries:
  
  00026 NQUL NLRA CONA MAS EXCP     402 BAD RESP CPSM CPSMREG
                     LMAS 21:49:41.69430 21:49:41.69430  1/03/08
  
  TASK:00026  METHOD:NQUL   PRIOR:NLRA  DEBUG:BAD RESP  POINTID:
  402
              TRANID:CONA                      SEQ:         5
              MAJOBJ:MAS    ENVRN:LMAS  TYPE:EXCEPTION
              TOD:21:49:41.69430    CLOCK:21:49:41.69430
              DATE: 1/03/08
              UOW(CPSM):    SYSTM:NAME  NAME:CPSMREG
              CICS-TASK:  26
              TASK-START:21:57:06.08086
  
          MethName  NQUL,NLRA,XLOP
  
          STKHDR     LEN:000127     ALET:00000000 ADDR:14054AB8
  AND:
  MAL        LEN:000048     ALET:00000000 ADDR:14007F40
      EYUQNQUL IN
         *FUN FUNCTION( INQUOWL )
         *CHR DEBUG( MOS NQUL )
         *QID QTOKEN( 802589C500001780 )
         *STR LINK( *    )
          QRM CRITERIA( P= 00000000 N= 0000000000 )
          NLS NAMELIST( A= 00000000 O= 00000000 L= 0000000000 )
          VUE VIEWMOD( P= 00000000 N= 0000000000 )
      OUT
         *RSP RESPONSE( *         )
         *RSN REASON( *              )
  
  
  LOCAL      LEN:0002C6     ALET:00000000 ADDR:14054BE0
         0 - 00000000 00000000 00000000 00000000
        10 - 00000000 00000000 00000000 00000000
        20 - 00000000 00000000 00000000 00000000
        30 - 00000000 00000000 00000000 00000000
        40 - 00AF0200 00020000 00000202 BC0C0800
        50 - 00000000 01000000 C2C1C440 D9C5E2D7 *BAD RESP*
        60 - 00000000 14054BE0 000002C6 00000000
        70 - 00000000 00000000 00000000 00000000
        80 - 00000000 00000000 00000000 00000000
        90 - 00000000 00000000 00000000 00000000
        A0 - 00000000 00000000 00000000 00000000
        B0 - 00000000 0192D3D6 C3C1D340 40400000 *LOCAL*
        C0 - 00000000 00000000 00000000 00000000
        D0 - 00000000 00000000 00000000 00000000
        E0 - 00000000 00000000 00000000 0000D000
        F0 - 00000000 01720051 000A9042 00000067 *Bad Response*
       100 - 00000001 00000E94 00000000 00000000
       110 - 00000000 00000000 00000000 00000000
       120 - 00000000 00000000 00000000 00000000
       130 - 00000000 00000000 00000000 00000000
             LINES    140 -    2A0 Same as above
       2C0 - 00000000 0000
  
  There is an error in EYU0NQUL which causes it to check the
  filter incorrectly.  This stops NQUL from performing the
  necessary INQ UOWLINK browse.  Instead the code is trying to
  inquire on a specific (invalid UOWLINK).
  

Local fix

• Use CEMT or EUI.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: The CICSPlex SM Web User Interface      *
  *                      (WUI) or API may not return all UOWLINK *
  *                      resource table records when no filter   *
  *                      is passed.                              *
  *                                                              *
  *                      Examination of the CICSPlex SM          *
  *                      exception trace records should show an  *
  *                      exception from method NQUL, debug       *
  *                      string of 'BAD RESP' and a pointID of   *
  *                      402.                                    *
  *                                                              *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes must be recycled to pick up  *
  *                 the new code.  Note that the restarts do     *
  *                 not need to be done at the same time.        *
  ****************************************************************
  When a request is made to obtain UOWLINK resource table records
  via the API, WUI or RTA, method EYU0MOMB (MOMB - MOS MAL
  Services) is called to build a Message Argument List (MAL) for
  method EYU0NQUL (NQUL - Inquire UOWLINK Data).
  
  The NQUL MAL contains a hexadecimal field called LINK which is
  used to contain the UOWLINK link token to be inquired on.
  
  To indicate that all UOWLINK records should be obtained MOMB,
  will put a value of '*' in the NQUL LINK field.
  
  When the NQUL method is invoked, it checks the LINK field in the
  MAL. If the field is set to '*' and padded with spaces, then
  NQUL will obtain all UOWLINK records.
  
  MOMB was changed in CICSPlex SM V2R3M0 so that hexadecimal MAL
  fields are padded with nulls ('00x') rather than spaces ('40'x).
  
  This means that when NQUL checks the LINK field, the test for
  '*' padded with spaces fails, so NQUL assumes that a UOWLINK of
  '5C40404040404040'x is being inquired on. As this UOWLINK is not
  found, NQUL takes an exception trace and does not return any
  records to the caller.
  

Problem conclusion

• NQUL has been updated to obtain all UOWLINK records if the LINK
  field in the MAL is a '*' padded with nulls.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

APAR Information

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

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

  UK32975

Modules/Macros

•    EYU0NQUL
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK32975

     UP08/01/23 P F801

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.