PJ40869: GLOBLC FUNC=CLOSE,OPT=UPDATEWT

APAR status

• Closed as program error.

Error description

• See Problem Summary.
  

Local fix

• na
  

Problem summary

• APAR NUMBER:  PJ40869
  PRODUCT:  z/TPF
  FUNCTIONAL AREA:  FORMAT-2 GLOBALS
  SHIPPED IN PUT:  10
  
  ABSTRACT:
  Ensure Close of Format-2 Global after Sync Timeout
  
  PACKAGE CONTENTS:
  Source Segments:
  (C) base/macro/ierrn.mac
  (C) base/rt/cglapi.cpp
  
  Object Only Binaries:
  None.
  
  Configuration Independent Binaries:
  None.
  
  Support Files:
  None.
  
  OTHER BINARIES TO BUILD: YES
  (C) <sys>/obj/cglapi.o
  (C) <sys>/stdlib/libCTAD.so
  (C) <sys>/stdload/CTAD.so
  
  COMMENTS:
  The customer experienced a problem while closing a synchronized
  format-2 global using the update/wait option (OPT=UPDATEWT).
  One of the active processors in the z/TPF complex was not
  available at the time due to a system IPL. As a result, a Sync
  Timeout situation was detected and reported via a SNAP error.
  However, contrary to documentation, the global was not closed
  for the requesting ECB. When the same ECB later attempted to
  re-open the global, a SNAP error was issued indicating that the
  ECB already had the global opened.
  
  The customer also reported that the value for the Sync Timeout
  error (ETPFGLOB_TIMEOUT) was not defined in the macro
  ierrn.mac. It was defined in the C header file errno.h.
  

Problem conclusion

• SOLUTION:
  Updated macro segment ierrn.mac to add the value for
  ETPFGLOB_TIMEOUT. Also updated segment cglapi.cpp at the
  routine labeled * Return the global descriptor to the available
  list * to add the additional condition in the if statement of
  || (errno == ETPFGLOB_TIMEOUT) to ensure the global is marked
  as closed for this ECB after a timeout condition.
  
  COREQS: NO
  None.
  
  MIGRATION CONSIDERATIONS: NO
  None.
  
  BUILD COMMANDS AND INSTRUCTIONS: YES
  #maketpf commands for linux
  maketpf -f CTAD cglapi.o
  maketpf CTAD link TPF_VERIFY_LINK_REFS=NO
  maketpf CTAD link
  
  UPDATED INFORMATION UNITS: NO
  None.
  
  See your IBM representative if you need additional information.
  
  DOWNLOAD INSTRUCTIONS:
  http://www.ibm.com/software/htp/tpf/maint/maintztpf.html
  
  APAR URL:
  http://www.ibm.com/software/htp/tpf/ztpfmaint/put10/PJ40869.htm
  

Temporary fix

Comments

APAR Information

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

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

Fix information

• Fixed component name

  Z/TPF

• Fixed component ID

  5748T1501

Applicable component levels

• R110 PSY

     UP