Using Mainframe Express | JCL Jobstreams |
Use a TSO session to run TSO commands, CLISTs and REXX execs on your PC. Within Mainframe Express, the TSO session is an interactive environment emulating TSO. You can build, run and debug CLISTs and REXX execs as if you were in a TSO environment.
You need to have read the chapter Start Here for the Tutorials and worked through the first session, Using Mainframe Express, before you do this session.
In this session, we assume you are familiar with TSO on a mainframe.
This session takes you through maintaining and running an application using TSO on your PC. It shows you how to create and build a project that includes a CLIST file and a REXX exec.
The demo applications used in this session are simple applications that you might have downloaded from a mainframe.
In this session, you get them working on your PC.
Creating a project for an application that uses TSO is just the same as for one that uses JCL, which you did in the chapter Using Mainframe Express.
To save you creating the project used in this session, we supply the project tsodemo.mvp.
The full path is \mfuser\projects\gsdemo\tsodemo\tsodemo.mvp. If you use Open on the File menu, you need the Files of Type field on the Open dialog box set to Project files (*.mvp) to see this file.
You'll see the .tso, rex and .cbl files in the Files View. If you click the Catalog tab you'll see the input file TSODEMO.DATA.TESTDATA in the Catalog View.
In this session you:
To build the project:
As you saw in the chapter Using Mainframe Express, the correct compiler is automatically called for the COBOL source file.
The build finishes with "Build finished with no errors".
To run the CLIST:
The Application Output window appears. The TSO initialization phase is run and the CLIST starts. When the CLIST ends, the TSO termination phase is run.
The first time you run this CLIST you will see messages indicating that the data set TSODEMO.DATA.OUT was not found and so was not deleted. You can ignore these. The CLIST contains a DELETE command to delete the output data set from the previous run so that the CLIST can be run more than once. The first time it is run that data set does not exist.
If three asterisks appear in the Application Output window, press Enter to complete the run.
The data from TSODEMO.DATA.TESTDATA has been copied to TSODEMO.DATA.OUT. You can check the run has worked by looking at the input and output files - double-click them both in the Catalog View. Close these windows when you've finished with them..
You can leave the Application Output window visible, as the next section uses it as well.
You can debug the COBOL program used by the CLIST application like any other COBOL program:
The TSO session is started, as before, but when the COBOL program is entered a source view window appears and execution pauses.
This demonstrates that you can single-step an application in TSO in the same way as in any other environment. All the same debugging features are available. We will not debug this application further, but will simply complete the run.
Again, if three asterisks appear in the Application Output window, press Enter to complete the run.
You can leave the Application Output window visible, as the next section uses it as well.
To run the REXX exec:
The Application Output window appears. The TSO initialization phase, the REXX exec, and then the TSO termination phase are run.
The data from TSODEMO.DATA.TESTDATA has been copied to the screen. You can check the run has worked by comparing this output with the input file - double-click the file in the Catalog View. Close this window when you've finished with it.
You can leave the Application Output window visible, as the next section uses it as well.
If you want to run TSO commands individually, you can start a TSO session without a CLIST or REXX exec. You simply set the Clist or REXX exec to execute field in the Start Debugging dialog box to spaces.
The Application Output window appears. The TSO initialization phase is run and the READY prompt appears.
If three asterisks appear in the Application Output window, press Enter to complete the run.
The TSO termination phase is run and the TSO session ends.
Hide the Application Output window.
Close the project. If you want to take a break before going on to the next session, you can close Mainframe Express.
Return to the Tutorials Map in the chapter Start Here for the Tutorials and choose which session to go on to next, depending on your interests.
Copyright © 1999 MERANT International Limited. All rights reserved.
This document and the proprietary marks and names
used herein are protected by international law.
Using Mainframe Express | JCL Jobstreams |