IBM Support

Updates to IMS Batch Terminal Simulator V4.1 User's Guide

Product documentation


Abstract

Updates that apply to IMS Batch Terminal Simulator V4.1 User's Guide (SC19-3230-01).

Content

The most recent update is listed first.



Update 8
Date of change: June 2016
Change description: Documentation changes by APAR PI63751. This APAR adds a new keyword, IFIUTF, for the ./E command to support UTF8 to EBCDIC conversion of IFI information for DB2 subsystem parameter UIFCIDS=YES.
Topics: Changes apply to multiple topics.

Topic: Reference > Command reference > Simulator commands > ./E command

IFIUTF keyword has been added as follows:

Format
./E ....
    [IFIUTF= YES | NO]

Keywords and operands

IFIUTF=
    Specifies to convert the IFI information from UTF8 to EBCDIC when DB2 subsystem parameter UIFCIDS=YES is specified.
    YES
        Converts the IFI information from UTF8 to EBCDIC.
    NO
        Does not convert the IFI information. The default value is IFIUTF=NO
Topic: Troubleshooting > Messages and codes > IMS Batch Terminal Simulator abend codes

The following abend code has been added:

4075

Explanation: A nonzero return code was returned after the character conversion module (CUNLCNV) of z/OS Unicode Services was loaded.
System action: IMS Batch Terminal Simulator ends abnormally.
User response: Check whether the character conversion services of z/OS Unicode Services are available, make all the necessary corrections, and rerun the job.
Topic: Troubleshooting > Messages and codes > IMS Batch Terminal Simulator messages

The following message has been added:

BTS0140W UNICODE CONVERSION SERVICES FAILED. RETURN CODE X'xx', REASON CODE X'yy', SOURCE CCSID sssss, TARGET CCSID ttttt

Explanation: The character conversion module (CUNLCNV) of z/OS Unicode Services returned the indicated return code and reason code. IMS Batch Terminal Simulator called this module to convert characters from the source CCSID to the target CCSID.
System action: IMS Batch Terminal Simulator continues processing without character conversion.
User response: See the z/OS Unicode Services User's Guide and Reference for the meaning of the return code and the reason code. If the error persists, notify the system support group of the IMS Batch Terminal Simulator program error.


Update 7

Date of change: December 2015

Change description: Documentation changes by APAR PI50185. This APAR provides the following enhancements:

· IMS managed ACBs support (No need to specify BTSACB DD with IMS V14)

· DL/I ICAL support for control data

· DL/I MRR call support

· 24-bit storage constraint relief

· ALTPCB response message handling for the Distributed Access Infrastructure client

Topics: Changes apply to multiple topics.

> 3.0 Testing applications
>> 3.2 Testing applications in batch mode
>>> 3.2.2 Running applications in batch mode
>>>> 3.2.2.2 Step 2: Specifying the IMS Batch Terminal Simulator data sets

Description of BTSACB has been updated as follows:

Table. IMS Batch Terminal Simulator DD statements for batch mode
(Table 17 in PDF)



DD name Description
BTSACB The BTSACB DD is an optional DD statement that specifies the ACB library. Consider specifying this DD when simulating the application programs that access data entry databases (DEDBs) in BMP or JBP region with IMS Version 13 or earlier.

> 3.0 Testing applications
>> 3.3 Testing applications in interactive mode
>>> 3.3.2 Running applications in interactive mode
>>>> 3.3.2.2 Step 2: Specifying the IMS Batch Terminal Simulator data sets

Description of BTSACB has been updated as follows:

Table. IMS Batch Terminal Simulator data sets for interactive mode
(Table 21 in PDF)



DD name Description
BTSACB The BTSACB data set is an optional data set that specifies the ACB library. Consider specifying this data set when simulating the application programs that access data entry databases (DEDBs) in BMP or JBP region with IMS Version 13 or earlier.

> 3.0 Testing applications
>> 3.6 Customizing JCL for specific applications
>>> 3.6.2 JCL customization by application types
>>>> 3.6.2.3 Applications that access DEDBs

This topic has been updated as follows:

If your application accesses data entry databases (DEDBs) with IMS Version 13 or earlier, the following requirement applies.
...
> 3.0 Testing applications
>> 3.6 Interpreting the simulation output
>>> 3.6.2 DL/I call trace listing

New field, CONTROL DATA=, has been added to the following table:

Table. DL/I call trace listing fields
(Table 27 in PDF)



Field Description
CONTROL DATA= The content of the control data area for the ICAL DL/I call. This information is available only when the AIB interface is used with a function code of ICAL and control data.

> 5.0 Reference
>> 5.1 Command reference
>>> 5.1.1 Simulator commands
>>>> 5.1.1.6 ./O command

Description for ICALOLEN= has been updated as follows:

ICALOLEN=

Specifies the length of the output data for a request area, a response area, or a control data area on an ICAL call.
Specify a 1- to 4-digit decimal number. The default is 1000 bytes. When the request length, response length, or control data length is equal to or less than the ICALOLEN value, all of the data is included in the output. When the length is longer than the ICALOLEN value, the output data is truncated to the ICALOLEN value. When ICALOLEN is 0, the data of the request, response, and control areas is not included in the output.




Update 6
Date of change: December 2014
Change description: Documentation changes by APAR PI27382. This APAR adds support for IMS Version 14.
Topics: Changes apply to the following two topics.

> 1.0 IMS Batch Terminal Simulator overview
>> 1.2 Key IMS Batch Terminal Simulator concepts
>>> 1.2.1 IMS Batch Terminal Simulator terminology

Abbreviations
  • ...
  • Start of changeIMS Version 14 refers to IMS Version 14 Release 1.End of change

============
> 4.0 Playback utility
>> 4.1 Transaction screen formatting (Playback utility)
>>> 4.1.7 Input for the Playback utility
>>>> 4.1.7.2 BTSALOG0 JCL requirements

Description of the IMSLEVEL keyword has been updated as follows:

CNTLCRDS control statement keywords
...
IMSLEVEL= keyword
...
This keyword identifies the level of IMS that was used to create the IMS log.
...
    13
      IMS Version 13
    Start of change14
      IMS Version 14 End of change



Update 5
Date of change: January 2014
Change description: Documentation changes by APAR PI07004. Four new messages have been added by this APAR.
Topic:
> 6.0 Troubleshooting
>> 6.2 Messages and codes
>>> 6.2.3 IMS Batch terminal Simulator messages

The following new messages have been added:
Start of change
BTS0500E COMMUNICATION TIMEOUT ERROR FROM DISTRIBUTED ACCESS INFRASTRUCTURE.

Explanation: IMS Batch Terminal Simulator received a communication timeout error from an internal API of Tools Base Distributed Access Infrastructure.
System action: IMS Batch Terminal Simulator ends with an abend code of U4077.
User response: Ensure the Distributed Access Infrastructure connection between the client and IMS Batch Terminal Simulator and rerun the application.
End of change

Start of change
BTS0501E THE DISTRIBUTED ACCESS INFRASTRUCTURE SERVER IS SHUTTING DOWN.

Explanation: IMS Batch Terminal Simulator received a connection error from an internal API of Distributed Access Infrastructure. The Distributed Access Infrastructure server is shutting down.
System action: IMS Batch Terminal Simulator ends with an abend code of U4076, U4077, or U4078.
User response: Restart the Distributed Access Infrastructure server and rerun the application.
End of change

Start of change
BTS0502E DISTRIBUTED ACCESS INFRASTRUCTURE XCF ERROR.

Explanation: IMS Batch Terminal Simulator received an XCF error from an internal API of Distributed Access Infrastructure.
System action: IMS Batch Terminal Simulator ends with an abend code of U4077 or U4078.
User response: Ensure that the Distributed Access Infrastructure server is running and rerun the application.
End of change

Start of change
BTS0503E ABEND DUE TO DISTRIBUTED ACCESS INFRASTRUCTURE INTERNAL ERROR.

Explanation: IMS Batch Terminal Simulator received an error from an internal API of Distributed Access Infrastructure. This error condition is different from the other Distributed Access Infrastructure API errors that are described by BTS0500E, BTS0501E, and BTS0502E messages.
System action: IMS Batch Terminal Simulator ends with an abend code of U4076, U4077, or U4078.
User response: Notify the IMS Batch Terminal Simulator support personnel of the error.
End of change



Update 4
Date of change: June 2013
Change description: Documentation changes by APAR PM91061. This APAR adds a new keyword to the CNTLCRDS control statement of BTSAPRE0, and two new keywords to the ./E command.
Topics: Changes apply to multiple topics.

> 4.0 Playback utility
>> 4.1 Transaction screen formatting (Playback utility)
>>> 4.1.7 Input for the Playback utility
>>>> 4.1.7.3 BTSAPRE0 JCL requirements

The following new keyword has been added to the "CNTLCRDS control statement keywords" section:

Start of change
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.
End of change
============
> 5.0 Reference
>> 5.1 Command reference
>>> 5.1.1 Simulator commands
>>>> 5.1.1.1 Simulator command summary

The following entries have been added to the table:

Table 2. Simulator commands: Default values and syntax specifications
(Table 36 in PDF and BookManager formats)
Simulator command Keyword value Default value Rep Length Magnitude
Min. Max. Min. Max.
./E Start of changeENDROLB
Start of changePERMLOAD
NO
NO
1
1
3
3
-
-
-End of change
-End of change

------------
>>>> 5.1.1.5 ./E command

The following two keywords have been added:


./E      ...      
          [ENDROLB= YES | NO ]
          [PERMLOAD= YES | NO ]


Start of change
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
End of change
Start of change
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.
End of change
============
> 6.0 Troubleshooting
>> 6.2 Messages and codes
>>> 6.2.3 IMS Batch Terminal Simulator messages

The following new message has been added:

Start of change
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.
End of change



Update 3
Date of change: June 2013
Change description: User's guide updates.
Topics: Changes apply to multiple topics.

> 3.0 Testing applications
>> 3.2 Testing applications in batch mode
>>> 3.2.2 Running applications in batch mode
>>>> 3.2.2.2 Step 2: Specifying the IMS Batch Terminal Simulator data sets

The following update has been made:

Table 1. IMS Batch Terminal Simulator DD statements for batch mode
(Table 17 in PDF and BookManager formats)
DD name Description
BTSIN The BTSIN DD is a required DD statement that defines the input data set for IMS Batch Terminal Simulator. This data set contains the simulator commands and simulator statements.

Important:
  • The BTSIN data set must not be a concatenated Start of changeSMS-managedEnd of change data set. If BTSIN is a concatenated Start of changeSMS-managedEnd of change data set, unpredictable results might occur.
  • ...
... ...

------------
>> 3.3 Testing applications in interactive mode
>>> 3.3.2 Running applications in interactive mode
>>>> 3.3.2.2 Step 2: Specifying the IMS Batch Terminal Simulator data sets

The following update has been made:

Table 1. IMS Batch Terminal Simulator DD statements for batch mode
(Table 21 in PDF and BookManager formats)
DD name Description
BTSIN The BTSIN data set is a required input data set. This data set can contain simulator commands and simulator statements. You can enter simulator commands and statements directly to the TSO terminal; however, you can also define a complete test run in the BTSIN data set.

Important:
  • The BTSIN data set must not be a concatenated Start of changeSMS-managedEnd of change data set. If BTSIN is a concatenated Start of changeSMS-managedEnd of change data set, unpredictable results might occur.
  • ...
... ...

============
> 4.0 Playback utility
>> 4.1 Transaction screen formatting (Playback utility)
>>> 4.1.7 Input for the Playback utility
>>>> 4.1.7.2 BTSALOG0 JCL requirements

The following updates have been made in the "JCL statements" section:

LOG (Input)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change, or equivalent DCB, if the log data sets were created with a different LRECL.

TRXOUT (Output)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change.

------------
>>>> 4.1.7.3 BTSAPRE0 JCL requirements

The following updates have been made in the "JCL statements" section:

CROSSREF (Output)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change.

TRXIN (Input)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change.

TRXOUT (Output)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change.

------------
>>>> 4.1.7.4 BTSAISR0 JCL requirements

The following updates have been made in the "JCL statements" section:

SNAPTRX (Output)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change.

TRXIN (Input)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change.

------------
>>>> 4.1.7.5 BTSAEDT0 JCL requirements

The following updates have been made in the "JCL statements" section:

CROSSREF (Input)
    ...
    The DCB for this data set is RECFM=VB,LRECL= Start of change32756 End of change.




Update 2
Date of change: December 2012
Change description: Documentation changes by APAR PM70739. This APAR adds support for IMS Version 13 Release 1.
Topics: Changes apply to the following two topics.

> 1.0 IMS Batch Terminal Simulator overview
>> 1.2 Key IMS Batch Terminal Simulator concepts
>>> 1.2.1 IMS Batch Terminal Simulator terminology

Abbreviations
  • ...
  • Start of changeIMS Version 13 refers to IMS Version 13 Release 1.End of change

============
> 4.0 Playback utility
>> 4.1 Transaction screen formatting (Playback utility)
>>> 4.1.7 Input for the Playback utility
>>>> 4.1.7.2 BTSALOG0 JCL requirements

Description of the IMSLEVEL keyword has been updated as follows:

CNTLCRDS control statement keywords
...

IMSLEVEL= keyword

This keyword identifies the level of IMS that was used to create the IMS log.
...
    Start of change 13
      IMS Version 13 End of change
    ...



Update 1
Date of change: June 2012
Change description: Documentation changes by APAR PM61865. This APAR adds support for IMS catalog databases (GUR call), a new operand for the ELAPTIME parameter, and additional informational messages for APPLFE.
Topics: Changes apply to the following two topics.

============
> 5.0 Reference
>> 5.1 Command reference
>>> 5.1.1 Simulator commands
>>>> 5.1.1.6 ./O command

Operand "ALL" has been added to the ELAPTIME parameter as follows:


[ELAPTIME= YES | NO  | ALL]


ELAPTIME=
    YES
      ...
    NO
      ...
    Start of changeALL
      Indicates that the elapsed time and the start timestamp of each call are to be included in the output.

      When ELAPTIME=ALL is specified, the elapsed time in seconds and the start timestamp of each call ('ELAPSED SEC=x.xxxxxx YYYY/MM/DD HH:MM:SS.SS', 48 bytes) are added to the trace output of each call. When the BTSOUT LRECL is more than 181, the output, which includes the elapsed time and the start timestamp, is printed on a single line without being split by the default LRECL 133.
    End of change
============
> 6.0 Troubleshooting
>> 6.2 Messages and codes
>>> 6.2.3 IMS Batch Terminal Simulator messages

The following new messages have been added:

Start of change
BTS0136I BTS CALLED THE APPLICATION FRONT-END ROUTINE xxxxxxxx FOR INITIALIZATION PROCESSING.

Explanation: The indicated application front-end routine is called for initialization processing.
User response: None.
End of change
Start of change
BTS0137I BTS CALLED THE APPLICATION FRONT-END ROUTINE xxxxxxxx FOR TRANSACTION PROCESSING.

Explanation: The indicated application front-end routine is called for transaction processing.
User response: None.
End of change
Start of change
BTS0138I BTS CALLED THE APPLICATION FRONT-END ROUTINE xxxxxxxx FOR SHUTDOWN PROCESSING.

Explanation: The indicated application front-end routine is called for shutdown processing.
User response: None.

Publication number

SC19-3230-01

Copyright date

1982, 2012

Original publication date

2012/6/26

Document information

More support for: IMS Tools
IMS Batch Terminal Simulator

Software version: 4.1.0

Operating system(s): z/OS

Reference #: 7027488

Modified date: 2016-06-27