PM64372: 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 invokes FM/IMS from
  a TSO batch session (IKJEFT01).
  

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/fmv11apar.pdf
  
  The changes are to the following publications:
  
  PUB ID        PUB NAME
  ------------  ----------------------------------------
  
  SC19-3133-03 File Manager for z/OS V11R1 Customization
                Guide
  
  
  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:

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

  PM64839 UK79407 UK79408 UK79409 UK79410 UK79411 UK79412 UK79413
  UK79414 UK79415

Modules/Macros

• FMNAUD2  FMNBB68  FMNBE80  FMNDB51  FMNIB39
  FMNIB53  FMNLOCAL FMNLOG2  FMNPBK   FMNRXIBV FMNVE    FMNWTO
  FMN0LVL  FMN0LVLJ FMN0LVLK FMN0MENU FMN0MJPN FMN0MKOR FMN1AGNS
  FMN1EGHL FMN1INIT FMN1IVP  FMN1IXB  FMN1LOCL FMN1LVL  FMN1LVLJ
  FMN1LVLK FMN1MENU FMN1MJPN FMN1MKOR FMN1POPD FMN1POPI FMN1POPT
  FMN1SSID FMN2DBC  FMN2DBI  FMN2DBP  FMN2DBX  FMN2DCMD FMN2D2E
  FMN2D2G  FMN2D2SP FMN2FTEX FMN2INTP FMN2IPSU FMN2LVL  FMN2LVLJ
  FMN2LVLK FMN2MENU FMN2MJPN FMN2MKOR FMN2MXXX FMN2SCON FMN2SEDX
  FMN2SENX
  

Fix information

• Fixed component name

  FILE MANAGER Z/

• Fixed component ID

  5655W4700

Applicable component levels

• RB1A PSY UK79408

     UP12/06/13 P F206

• RB1B PSY UK79409

     UP12/06/13 P F206

• RB1C PSY UK79410

     UP12/06/13 P F206

• RB10 PSY UK79407

     UP12/06/13 P F206

• RB11 PSY UK79411

     UP12/06/13 P F206

• RB12 PSY UK79412

     UP12/06/13 P F206

• RB13 PSY UK79413

     UP12/06/13 P F206

• RB14 PSY UK79414

     UP12/06/13 P F206

• RB15 PSY UK79415

     UP12/06/13 P F206

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.