PK06595: PE01994 NSGR NSPG EXCEPTION METHOD FAILED TSO EUI SET PROGRAM

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• PE01994-F504
  After PTF UK01994 APAR PK00324 TSO EUI PROGRAM SET action
  results in message:
  EYUEI0558E An internal error has occurred. Method NSPG
  2 (EXCEPTION),3 (METHOD FAILED)
  .
  The CMAS auxtrace contains the following exceptions for a
  PROGRAM PHASEIN or NEWCOPY request:
  .
  NSGR NSPG CONL MAS EXCP.    474 InqQueue
  XQLK XQIQ CONL QUE EXCP.      2 QLOKEXC
  XQIQ NSGR CONL QUE EXCP.      1 QINQXCP
  .
  Additional Symptom(s) Search Keyword(s): queue token
  existence bit zeros QID
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: All CICSPlex/SM V3R1M0 Users                 *
  ****************************************************************
  * PROBLEM DESCRIPTION: After applying PTF UK01994 for APAR     *
  *                      PK00324, action commands for the TASK   *
  *                      and PROGRAM view families issued from   *
  *                      the EUI against MASes running CICS 6.3  *
  *                      or 6.4 will fail, with the exception of *
  *                      the PROGRAM DISCARD action.             *
  *                                                              *
  *                      The failure received for TASK actions   *
  *                      is:                                     *
  *                                                              *
  *                        EYUEI0558E An internal error has      *
  *                        occurred. Method NSTK in <mas>: 2     *
  *                        (EXCEPTION), 3 (METHOD_FAILED)        *
  *                                                              *
  *                      The failure received for PROGRAM        *
  *                      actions is:                             *
  *                                                              *
  *                        EYUEI0558E An internal error has      *
  *                        occurred. Method NSPG in <mas>: 2     *
  *                        (EXCEPTION), 3 (METHOD_FAILED)        *
  *                                                              *
  *                      Additionally, any similar action issued *
  *                      from the CPSM API through the SET,      *
  *                      PERFORM SET, or PERFORM OBJECT commands *
  *                      with the NOREFRESH operand will fail    *
  *                      with a RESPONSE of 1029 (FAILED) and a  *
  *                      REASON of 1359 (EXCEPTION)              *
  ****************************************************************
  * RECOMMENDATION: After applying the PTF that resolves this    *
  *                 APAR, all MASes running CICS 6.3 or 6.4 must *
  *                 be restarted.  Note that the restarts do not *
  *                 need to occur at the same time.              *
  ****************************************************************
  When any of the TASK or PROGRAM actions is issued (with the
  exception of DISCARD PROGRAM), method EYU0NSTK (NSTK - TASK) or
  EYU0NSPG (NSPG - PROGRAM) is called in the MAS.  If the MAS is
  running CICS 6.3 or 6.4, NSTK/NSPG will call method EYU0NSGR to
  perform the action, passing a queue token for NSGR to use when
  refreshing the affected TASK or PROGRAM records.  If the request
  is issued from the EUI or through an API SET, PERFORM SET, or
  PERFORM OBJECT command that specifies the NOREFRESH operand, the
  queue token passed to NSGR is invalid.  This causes a failure in
  NSGR when it attempts to validate the queue token (code added by
  APAR PK00324), which is propagated back to NSTK/NSPG.
  

Problem conclusion

• NSTK and NSPG have been updated to only pass a queue token to
  NSGR when a refresh is required.
  

Temporary fix

• FIX AVAILABLE BY PTF ONLY
  

Comments

• After applying PTF UK01994 for APAR
  PK00324, action commands for the TASK
  and PROGRAM view families issued from
  the EUI against MASes running CICS 6.3
  or 6.4 will fail, with the exception of
  the PROGRAM DISCARD action.
  
  The failure received for TASK actions
  is:
  
    EYUEI0558E An internal error has
    occurred. Method NSTK in <mas>: 2
    (EXCEPTION), 3 (METHOD_FAILED)
  
  The failure received for PROGRAM
  actions is:
  
    EYUEI0558E An internal error has
    occurred. Method NSPG in <mas>: 2
    (EXCEPTION), 3 (METHOD_FAILED)
  
  Additionally, any similar action issued
  from the CPSM API through the SET,
  PERFORM SET, or PERFORM OBJECT commands
  with the NOREFRESH operand will fail
  with a RESPONSE of 1029 (FAILED) and a
  REASON of 1359 (EXCEPTION)
  
  
  When any of the TASK or PROGRAM actions is issued (with the
  exception of DISCARD PROGRAM), method EYU0NSTK (NSTK - TASK) or
  EYU0NSPG (NSPG - PROGRAM) is called in the MAS.  If the MAS is
  running CICS 6.3 or 6.4, NSTK/NSPG will call method EYU0NSGR to
  perform the action, passing a queue token for NSGR to use when
  refreshing the affected TASK or PROGRAM records.  If the request
  is issued from the EUI or through an API SET, PERFORM SET, or
  PERFORM OBJECT command that specifies the NOREFRESH operand, the
  queue token passed to NSGR is invalid.  This causes a failure in
  NSGR when it attempts to validate the queue token (code added by
  APAR PK00324), which is propagated back to NSTK/NSPG.
  
  
  NSTK and NSPG have been updated to only pass a queue token to
  NSGR when a refresh is required.
  

APAR Information

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

  PK06276

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

  UK04142

Modules/Macros

•    EYUUNAEQ EYU0NQGR EYU0NQRC EYU0NSGR EYU0NSPG
  EYU0NSTK EYU0XQPQ
  

Fix information

• Fixed component name

  CPSM CICS 3.1

• Fixed component ID

  5655M1501

Applicable component levels

• R100 PSY UK04142

     UP05/06/08 P F506

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.