PM31975: OTMA RESUME TPIPE DOES NOT WORK IF TOP SECRET IS THE SECURITY PACKAGE AND THE RIMS CLASS IS NOT DEFINED.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• For Resume TPIPE security OTMA checks to see if the RIMS class
  is defined.  It if is not defined there is no Resume TPIPE
  security.  If it is defined OTMA invokes SAF for Resume TPIPE
  security.  If it is not defined, no RACF checking is done.  OTMA
  checks for the existence of the RIMS class by issuing a RACROUTE
  REQUEST=LIST.  If the class is not defined RACF returns a
  non-zero return code - but Top Secret give return code zero.
  This is because Top Secret does not use the REQUEST=LIST
  facility.
  
  The way to check for the existence of a class is the RACROUTE
  REQUEST=STAT call.  Both RACF and Top Secret will indicate
  whether or not the class exists.
  

Local fix

• The local fix is for IBM to provide a Usermod until this APAR is
  available.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: IMS V10 OTMA users.                          *
  ****************************************************************
  * PROBLEM DESCRIPTION: OTMA RESUME TPIPE DOES NOT WORK IF      *
  *                      TOP SECRET IS THE SECURITY              *
  *                      PACKAGE AND THE RIMS CLASS IS NOT       *
  *                      DEFINED.                                *
  ****************************************************************
  * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF      *
  ****************************************************************
  For Resume TPIPE security, OTMA checks to see if the RIMS class
  is defined.  If it is not defined there is no Resume TPIPE
  security.  If it is defined, OTMA invokes SAF for Resume TPIPE
  security.  If it is not defined, no RACF checking is done.  OTMA
  checks for the existence of the RIMS class by issuing a RACROUTE
  REQUEST=LIST.  If the class is not defined RACF returns a
  non-zero return code - but Top Secret gives return code zero.
  This is because Top Secret does not use the REQUEST=LIST
  facility.
  The way to check for the existence of a class is the RACROUTE
  REQUEST=STAT call.  Both RACF and Top Secret will indicate
  whether or not the class exists.
  

Problem conclusion

• GEN:
  KEYWORDS:
  
  *** END IMS KEYWORDS ***
  When checking Resume TPIPE security, OTMA will use the
  RACROUTE REQUEST=STAT facility to see if the RIMS class
  is defined.  If it is not defined, then warning message
  DFS3187W will now be issued with the return code from the
  RACROUTE facility and the return and reason code from
  RACF indicating why the RACF STAT call failed.  The
  MVS/ESA Programming: Authorized Assembler Services Guide
  gives a detailed description of the return codes and
  reason codes for RACROUTE exit processing.
  
  DFSIRAC0 is changed to issue the RACROUTE call for
  STAT processing for the RIMS class.  If the class is
  not defined, the warning message will be issued and
  processing will continue.  If the RIMS class does
  exist, then no message is output.
  
  This is the content of the new message:
  DFS3187W
  
  RACF NOT ACTIVE FOR RESUME TPIPE CLASS= RIMS  RC=xx.
  RACF EXIT RC=yy  REASON CODE=zz.
  Explanation
  A failure occurred in RACROUTE exit processing while IMS
  was trying to build in-storage profiles for RACF-defined
  resources. The message displays
  
      The return code from the RACROUTE macro
      The return and reason codes from the RACF  exit.
  
  System action
  IMS restart continues.  RACF OTMA Resume TPIPE
  authorization is disabled.
  
  Operator response
  (master terminal) See MVS/ESA Programming: Authorized
  Assembler Services Guide for a detailed description of
  the return codes and reason codes for RACROUTE exit
  processing.
  

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:

  PM33685 PM33686 UK69362

Modules/Macros

• DFSIRAC0
  

Fix information

• Fixed component name

  IMS V10

• Fixed component ID

  5635A0100

Applicable component levels

• R010 PSY UK69362

     UP11/07/06 P F107

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.