PM91061: BTS V4.1 NEW FUNCTIONS

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• This APAR adds the following two new keywords to the ./E
  command:
   (1) ENDROLB= keyword to rollback the database updates made by
       the application.
   (2) PERMLOAD= keyword to keep the application loaded.
  
  This APAR also provides the following enhancements:
   (1) A new keyword, TRXLINK, which is for the CNTLCRDS DD of
       Playback module BTSAPRE0, to process the records associated
       with the specified transaction code.
   (2) All Playback modules support 31 bit addressing mode.
   (3) A new parameter, SSM, for ESAF in the BTSJBP cataloged
       procedure.
  

Local fix

• N/A
  

Problem summary

• ****************************************************************
  * USERS AFFECTED: BTS V4.1 USERS                               *
  ****************************************************************
  * PROBLEM DESCRIPTION: BTS V4.1 NEW FUNCTIONS                  *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This APAR adds the following two new keywords to the ./E
  command:
  (1) ENDROLB= keyword to rollback the database updates made by
      the application.
  (2) PERMLOAD= keyword to keep the application loaded.
  This APAR also provides the following enhancements:
  (1) A new keyword, TRXLINK, which is for the CNTLCRDS DD of
      Playback module BTSAPRE0, to process the records associated
      with the specified transaction code.
  (2) All Playback modules support 31 bit addressing mode.
  (3) A new parameter, SSM, for ESAF in the BTSJBP cataloged
      procedure.
  

Problem conclusion

Temporary fix

Comments

• IBM IMS Batch Terminal Simulator for z/OS, Version 4 Release 1,
  User's Guide (SC19-3230-01) will be updated with following
  changes:
  ================================================================
  
  Chapter 13. Transaction screen formatting (Playback utility)
  
  Input for the Playback utility
  
  BTSAPRE0 JCL requirements
  
  CNTLCRDS control statement keywords
  
  
  p.223
  
  | TRXLINK keyword
  
  |   This keyword specifies that the records associated with the
  |   specified transaction are also processed.
  
  |   Use this keyword together with the TRX= keyword. When both
  |   the TRX= keyword and the TRXLINK keyword are specified, in
  |   addition to the records identified by the TRX= keyword,
  |   BTSAPRE0 also processes the records that have the same
  |   originating timestamp as the records identified by the TRX=
  |   keyword.
  
  |   To specify the TRXLINK keyword, do not code the TRX= keyword
  |   in CNTLCRDS DD of the BTSALOG0 module. If coded, necessary
  |   records will not be extracted in the BTSALOG0 step.
  
  |   The TRXLINK keyword is optional. If this keyword is omitted
  |   and the TRX=keyword is specified, only the records that
  |   contain the specified transaction code are processed.
  
  
  Chapter 14. Command reference
  
  Simulator commands
  
  ./E command
  
  p.262
  
  |        ENDROLB= YES | NO
  |        PERMLOAD= YES | NO
  
  p.267
  
  | ENDROLB=
  |   Specifies whether to issue a Rollback (ROLB) call at the
  |   completion of the application to rollback the updates made
  |   to the database.
  |     YES
  |         Issues a ROLB call at the completion of the
  |         application to rollback the updates made to the
  |         database.
  |         When the application calls GU I/O PCB, CHKP, or SYNC,
  |         all the checkpoint calls issued to IMS are bypassed
  |         in order to backout the updates.
  |         If the ROLB call fails, the database updates made by
  |         the application are not rolled back.
  
  |     NO
  |         A ROLB call is not issued at the completion of the
  |         application
  
  
  | PERMLOAD=
  |   Specifies whether to keep the application loaded after its
  |   run.
  |     YES
  |         Requests to keep the application loaded after its
  |         runs.
  |         The application is not deleted after its run; it
  |         remains to be loaded. If the application is requested
  |         again, the loaded application is used instead of
  |         loading the application again.
  
  |     NO
  |         Requests to delete the loaded application after its
  |         run.
  |         If the application was already loaded before this run
  |         and the PERMLOAD=NO option or no PERMLOAD= keyword is
  |         specified for this run, the application remains
  |         loaded even after this run.
  
  
  Chapter 19. Messages and Codes
  
  IMS Batch Terminal Simulator messages
  
  p.368
  
  | BTS0139I BTS ISSUED ROLB FOR ENDROLB=YES OPTION
  
  | Explanation: BTS issued a ROLB call to rollback the database
  | updates because the ENDROLB=YES option is active.
  
  | User response: None.
  

APAR Information

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

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

  UK95274

Modules/Macros

• BTSACOM0 BTSAEDT0 BTSAISR0 BTSALBS0 BTSALCP0 BTSALOG0 BTSALQP0
  BTSALQR0 BTSALRP0 BTSALSR0 BTSAMSG0 BTSAPCP0 BTSAPRE0 BTSARCN0
  BTSCHDEF BTSCINT0 BTSCINT1 BTSENVR0 BTSJBP   BTSMWRT0 BTSPCBW0
  BTSPCC00 BTSPC000 BTSRC000 BTSSINTM BTSSINT0 BTSSINT1 BTSWRT00
  H22J410J
  

Fix information

• Fixed component name

  IMS BTS

• Fixed component ID

  5655A1400

Applicable component levels

• R410 PSY UK95274

     UP13/06/23 P F306

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.