PM64839: RECEIVE MESSAGE - TSOLNK RC=20 (DEC) REASON CODE=24 (DEC), WHEN RUNNING IMS BATCH WITH SAF CONTROLLED AUDITING TO SMF ACTIVE.

Obtain the fix for this APAR.

APAR status

• Closed as program error.

Error description

• When running an IMS batch job, with SAF controlled auditing
  to SMF active, receive the following message:
  
    TSOLNK RC=20 (Dec) REASON CODE=24 (Dec)
  

Local fix

• Sample JCL to run FM/IMS under TSO as a work around:
  
   //STEP01   EXEC PGM=IKJEFT01,DYNAMNBR=100
   //SYSTSIN  DD *
     CALL 'FMN.SFMNMOD1(FMNIMS)'
   //SYSPRINT DD SYSOUT=*
   //SYSTSPRT DD SYSOUT=*
   //FMIMSIN DD *
   $$FILEM IEB REGNTYPE=DLI,
      .
      .
      .
   $$FILEM     PROC=*
   EXIT
   /*
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: All File Manager users                       *
  ****************************************************************
  * PROBLEM DESCRIPTION: The message 'FMNIB535 Audit failure.    *
  *                      Function terminated because auditing to *
  *                      SMF failed, TSOLNK RC=20 (Dec) REASON   *
  *                      CODE=24 (Dec)' is issued when running   *
  *                      an IMS batch job with SAF controlled    *
  *                      auditing to SMF active.                 *
  ****************************************************************
  * RECOMMENDATION: Apply the provided PTF.                      *
  ****************************************************************
  Batch SMF logging can only be performed by File Manager if the
  session is APF authorized or File Manager is running under
  TSO/batch and the TSO batch session is authorized. FM/IMS
  batch processing cannot run APF authorized - so currently SMF
  logging can only be performed if the JCL runs FM/IMS from
  a TSO batch session.
  

Problem conclusion

• The authorized requirement to perform SMF logging by File
  Manager has been removed by changing the SMF logging to use the
  UNIX BPX1SMF service.
  This APAR changes the JCL generated by FM/DB2 component, for
  executing FM/DB2 functions in batch.  The change applies only
  when audit logging to SMF is selected.  Previously generated
  FM/DB2 batch jobs should continue to work without modification.
  Customers should review any existing jobs and re-generate these
  to use the changes delivered in this APAR.
  
  Publication Closing Code: DEVCHNG
  For the documentation changes associated with this APAR,
  please refer to:
  ftp://public.dhe.ibm.com/software/websphere/awdtools/
      filemanager/fmv12apar.pdf
  
  The changes are to the following publications:
  
  PUB ID        PUB NAME
  ------------  ----------------------------------------
  
  SC19-3673-00 File Manager for z/OS V12R1 Customization
                Guide
  SC19-3674-00  File Manager for z/OS V12R1 User's Guide
                and Reference
  SC19-3675-00  File Manager for z/OS V12R1 User's Guide
                and Reference for DB2 Data
  SC19-3676-00  File Manager for z/OS V12R1 User's Guide
                and Reference for IMS Data
  
  
  The latest published manuals can be found at:
  http://www.ibm.com/software/awdtools/filemanager/library/
         index.html.
  

Temporary fix

Comments

APAR Information

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

  PM64372

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

Modules/Macros

• FMN0LVL  FMN0LVLJ FMN0LVLK FMN1LVL  FMN1LVLJ
  FMN1LVLK FMN2LVL  FMN2LVLJ FMN2LVLK
  

Fix information

• Fixed component name

  FILE MANAGER Z/

• Fixed component ID

  5655W6800

Applicable component levels

• RC1A PSY UK80271

     UP12/07/20 P F207

• RC1B PSY UK80272

     UP12/07/20 P F207

• RC1C PSY UK80273

     UP12/07/20 P F207

• RC10 PSY UK80270

     UP12/07/20 P F207

• RC11 PSY UK80275

     UP12/07/20 P F207

• RC12 PSY UK80276

     UP12/07/20 P F207

• RC13 PSY UK80277

     UP12/07/20 P F207

• RC14 PSY UK80278

     UP12/07/20 P F207

• RC15 PSY UK80279

     UP12/07/20 P F207

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.