PK16305: BTSAISR0 GETS TYPE, SIZE AND FEAT DEFINITIONS AUTOMATICALLY INSTEAD OF SPECIFYING ./D STATEMENT IN BTSIN DD CARD

Obtain the fix for this APAR.

APAR status

• Closed as new function.

Error description

• BTSAISR0 gets TYPE, SIZE and FEAT definitions automatically
  using LTERM name of the first record in TRXIN and DFSCLV0x
  decided by a new keyword ./E IMSSUF= instead of specifying ./D
  statement in BTSIN DD card.
  This is a Fits MR0823055639 requirement.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED: BTS V3 Users with Playback                   *
  ****************************************************************
  * PROBLEM DESCRIPTION: Gets TYPE, SIZE and FEAT definitions    *
  *                      automatically instead of specifying ./D *
  *                      ./D statement in BTSIN DD card.         *
  ****************************************************************
  * RECOMMENDATION: Apply the maintenance for this APAR.         *
  ****************************************************************
  This is a FITS MR0823055639 requirement.
  This APAR provides a small programming enhancement (SPE).
  Enhancement of this BTS V3 Playback includes support to get
  TYPE, SIZE and FEAT definitions from the MFS automatically
  instead of specifying ./D statement in BTSIN DD card.
  When BTS simulates with the extracted data by DLIISRT calls, BTS
  needs the terminal device type of the screen image. If the
  client does not know the terminal device type of the screen
  image, BTS supports to get the device type attribute
  automatically using LTERM name of the first record in TRXIN and
  DFSCLV0x decided by a new keyword ./E IMSSUF=.
  

Problem conclusion

Temporary fix

Comments

• BTSSDEV0 is added to get the device type attribute automatically
  using LTERM name of the first record in TRXIN and DFSCLV0x
  decided by a new keyword ./E IMSSUF=.
  
  The IMS BTS User's Guide and Reference ( SC18-7149-00 )
  will be updated with following changes:
  
  Chapter 4. Operations Information
  ./E Command
  <<add>>
  
  IMSSUF=
    Specifies one alphanumeric suffix character appended to
    DFSCLV0x (the generated composite control block, nucleus, MFS
    device characteristics table, and security directory module
    names).
    It is effective only when the transaction code is BTSAISR0.
    It is ignored if either ./D DDOF= or ./D TYPE= is specified.
  
  
  Chapter 8. Messages and Codes
  <<add>>
  BTS0123W ALL OF ./E IMSSUF=, ./D DDOF= AND ./D TYPE= ARE NOT
           SPECIFIED FOR BTSAISR0.
     Explanation: ./E IMSSUF= is not specified though ./D DDOF=
      or ./D TYPE= is not specified when running with BTSAISR0.
      One of ./D DDOF=, ./D TYPE=, or ./E IMSSUF= is needed for
      BTSAISR0 runs correct.
     System action: BTS does not load DFSCLV0x and runs with
      a default device type (DEV TYPE=(3270,2),FEAT=IGNORE).
     User response: If need, specify one of ./E IMSSUF=, ./D DDOF=
      or ./D TYPE= and rerun the job.
  
  BTS0124W BOTH ./D DDOF= AND ./D TYPE= ARE NOT ALLOWED TO
           SPECIFY WITH ./E IMSSUF= FOR BTSAISR0.
     Explanation: ./E IMSSUF= is  specified though ./D DDOF= or
      ./D TYPE= is specified at the same time.
     System action: BTS does not load DFSCLV0x and ignores ./E
      IMSSUF=.
     User response: If need, specify one of ./E IMSSUF=, ./D DDOF=
      or ./D TYPE= and rerun the job.
  
  BTS0125W LOAD FAILED FOR DFSCLV0x
     Explanation: DFSCLV0x load error.  x is suffix code specified
      by ./E IMSSUF=.
     System action: BTS runs with a default device type
      (DEV TYPE=(3270,2),FEAT=IGNORE).
     User response: If need, Correct the value of ./E IMSSUF= and
      rerun the job.
  
  BTS0126W UNABLE TO FIND LTERM: lterm IN DFSCLV0x
     Explanation: The first LTERM name in TRXIN records does not
      exist in DFSCLV0x, when the transaction BTSAISR0 runs with
      ./E IMSSUF=.  x is suffix code specified by ./E IMSSUF=.
     System action: BTS ignores ./E IMSSUF=. and runs with a
      default device type (DEV TYPE=(3270,2),FEAT=IGNORE).
     User response: Correct the value of ./E IMSSUF= in BTSIN or
      SKIP= in CNTLCRDS, and rerun the job.
  
  BTS0127W OPEN FAILED FOR xxxxxxxx
     Explanation: OPEN failed for CNTLCRDS or TRXIN data sets.
      When the transaction BTSAISR0 runs with ./E IMSSUF=.
     System action: BTS ignores ./E IMSSUF=. and runs with a
      default device type (DEV TYPE=(3270,2),FEAT=IGNORE).
     User response: Check the DD statement in the JCL.  If need,
      correct DD and rerun the job.
  
  BTS0128W LTERM IS NOT IDENTIFIED FROM TRXIN.
     Explanation: TRXIN DD is empty or all data is skiped by
      SKIP= in CNTLCRDS data set. BTS can not idetify LTERM name
      for finding the screen device type.
     System action: BTS ignores ./E IMSSUF= and runs with a
      default device type (DEV TYPE=(3270,2),FEAT=IGNORE).
     User response: Check the TRXIN data set and rerun the job.
  
  BTS0129I IMSSUF=x PROCESS STARTED.
     Explanation: Gets TYPE, SIZE and FEAT definitions
      automatically because device type is not specified by ./D.
     System action: BTS continues processing.
     User response: None.
  
  
  Appendix E. BTS Playback
  <<add>>
  
  E.1.9 Default Device Type for BTSAISR0
  
  BTS provides to decides the device type attribute automatically
  using LTERM name of the first record in TRXIN and DFSCLV0x
  decided by a new keyword ./E IMSSUF= instead of specifying
  ./D statement in BTSIN DD card, when the transaction BTSAISR0
  runs.
  
  This function is available under the following conditions.
    - TC= (Transaction code) in BTSIN DD is BTSAISR0.
    - Both ./D DDOF= and ./D TYPE= are not specified in BTSIN DD.
    - New keyword ./E IMSSUF= is specified in BTSIN DD.
  
  If ./D DDOF or ./D TYPE= is specified, it is used as the device
  (./D ) type even though ./E IMSSUF= is specified. The message
  BTS0124W is shown and ./E IMSSUF= is ignored.
  
  BTS provides a default device type for BTSAISR0.
  The default is DEV TYPE=(3270,2),FEAT=IGNORE.
  If all of ./E IMSSUF=, ./D DDOF=, and ./D TYPE= are not
  specified, BTSAISRT0 runs with a default device type after the
  message BTS0123W.
  
  Restriction
  BTS can't change the device type on a LTERM to a LTERM basis.
  

APAR Information

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

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

  UK10046

Modules/Macros

•    BTSCOM00 BTSDEV00 BTSENVR0 BTSF     BTSICLI
  BTSMWRT0 BTSPC000 BTSSDEV0 H22J310J
  

Fix information

• Fixed component name

  IMS BTS

• Fixed component ID

  5655A1400

Applicable component levels

• R310 PSY UK10046

     UP05/12/20 P F512

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.