Step 5: Starting the session

You start an interactive session by running the TSO CLIST procedure.

Procedure

  1. Run the TSO CLIST procedure by entering the following command. 
    EXEC 'cmdlib(clist_name)'
  2. When you are prompted with the following message, enter ALLOCDS and press Enter. 
    CHOOSE ONE OF THE FOLLOWING OPTIONS: ALLOC ALLOCDS FREE DELETE OR JUST HIT ENTER
    The meaning of the options are as follows:
    ALLOC
    Dynamically allocates the existing data sets that are required to run the IMS Batch Terminal Simulator job by issuing the TSO ALLOCATE command, and runs the IMS Batch Terminal Simulator job.
    ALLOCDS
    Dynamically allocates the new data sets that are required to run the IMS Batch Terminal Simulator job by issuing the TSO ALLOCATE command, and runs the IMS Batch Terminal Simulator job.
    FREE
    Deallocates the data sets that were previously allocated for IMS Batch Terminal Simulator jobs by issuing the TSO FREE command.
    DELETE
    Deletes the data sets that were previously allocated for IMS Batch Terminal Simulator jobs by issuing the TSO DELETE command.
    ENTER
    Runs the IMS Batch Terminal Simulator job.
    Tips:
    • The following tips can help you use these options:
      • To delete and re-create new output data sets:
        1. Enter DELETE and press Enter.
        2. Issue the EXEC ’cmdlib(clist_name)’command again.
        3. Enter ALLOCDS and press Enter.
      • To run a different test case and you want to change the data set names:
        1. Enter FREE and press Enter.
        2. Issue the EXEC ’cmdlib(clist_name)’command again.
        3. Enter ALLOC and press Enter.
      • To repeat the same test case and you want to use the same data set names, enter ENTER and press Enter.
    • You do not need to reallocate data sets between IMS Batch Terminal Simulator executions during the same TSO session. You can restart IMS Batch Terminal Simulator by entering the simulation commands.

    IMS Batch Terminal Simulator starts. When it is completely initialized, it reads the specifications in the BTSIN data set. When it reaches the end of file, you are prompted with the following message:

    ENTER BTS COMMAND OR /FORMAT OR /*.
  3. If you want to enable the full screen image support (FSS), enter the /FORMAT command followed by the MFS control block name. Press Enter.

    The TSO screen displays the formatted screen. After that, FSS is invoked every time IMS Batch Terminal Simulator has a complete screen image of an IMS screen image for output.

    Tip: FSS can be used only in a TSO foreground address space. When IMS Batch Terminal Simulator is started, it checks to see if it is running in the TSO foreground. If you want to run IMS Batch Terminal Simulator in the TSO foreground but without FSS, you must include an ./O TSO=NO command in the BTSIN data set. ./O TSO=NO, if coded, must be presented to IMS Batch Terminal Simulator before end of file is reached on BTSIN.