The first thing you need to do is check that the Bankdemo application is executing correctly.
To execute the JCL, you need to run the application in an instance of the Micro Focus
Enterprise Server (sometimes abbreviated to
Enterprise Server). This demonstration includes a pre-configured enterprise server instance called Bankdemo which you need to import in
Enterprise Server and start before you execute the Bankdemo application.
Important: You need
Enterprise Developer or
Enterprise Developer for IBM zEnterprise to execute the application as running applications is not supported in
Enterprise Developer Connect.
Importing the Bankdemo server
To import the definition of the Bankdemo logical server (LSER):
- In the IDE, open the Server Explorer window.
If the window is not visible, click
(or
).
Tip: Use the Auto Hide button (
) in the Server Explorer toolbar to pin the window to the IDE window.
- Right-click
Micro Focus Servers and click
Administration.
This opens the
Enterprise Server Administration page in the IDE.
- Click
Import in the left upper corner of
Enterprise Server Administration.
- On the
Import server information page and under
Recent directories click the directory for the BANKDEMO server.
This adds the path to the
Selected source directory containing server data to restore field.
- Click
Next three times, and then click
OK to import the BANKDEMO server.
- The system returns to the main
Enterprise Server Administration page.
You can see the Bankdemo server appears in the list of servers. You need to start it before you can execute the online Bankdemo application.
Associate the Bankdemo
Enterprise Server with your project
Ensure your application is associated with the BankDemo server:
- In Server Explorer, right-click
Micro Focus Servers, and click
Refresh to show the BankDemo server.
- Right-click the Bankdemo server and click
Associate with project.
- Ensure there is a check before the name of the BankDemo application.
- Click the
BankDemo project in Solution Explorer and see that the details of the associated server appear in the
Properties window. The TN3270 port number will be populated once you start the server.
Configure the IDE settings for
Enterprise Server
Configure the IDE to start the associated BankDemo server automatically as follows:
- Click
Tools > Options.
- Expand
Micro Focus, and click
Enterprise Server.
-
Check
the following options on this page to enable the IDE to start or stop the associated server, and to enable dynamic debugging, for when it is not enabled in the server:
- Automatically start the associated server - this ensures the IDE will start the server if it is not running when you execute the application.
- Stop running servers on project close - this enables the IDE to stop the server when you close the project.
- Automatically enable dynamic debugging - this ensures the IDE will check whether the server has dynamic debugging enabled and, if it is not, will enable it when you start debugging.
- Click
OK.
Starting the Bankdemo
Enterprise Server and Showing the Server Log
These are the steps to start the server manually, and are included for completeness. You do not have to start the server manually, as you have configured the IDE to start the server automatically.
- In Server Explorer, right-click
BANKDEMO under
Micro Focus Servers, then click
Start.
Note: You might receive an Enterprise Server Sign On dialog prompting you to provide connection details for the BANKDEMO server. This is a standard security dialog. Click
OK without specifying any sign on details. Also, you may skip enabling password recovery.
You may receive a
Windows Security Alert blocking the
MF Communications process. Click
Allow access.
- Right-click the BANKDEMO server in Server Explorer, and click
Show Console Log.
See the
Output window for the messages from the server log that show that the server has started.
- Right-click
Micro Focus Servers again, and then click
Refresh to see that the server has started.
After several seconds, the server status on the
Enterprise Server Administration page also changes to
Started. You are now ready to execute the JCL.
Executing JCL
The JCL provided in your demo causes the COBOL application to read a file, sort the data and produce a report. The .jcl file,
ZBNKSTMT.jcl, is in the
Bankdemo project. To submit this job:
- In Solution Explorer, select the JCL file in the project, and then drag it across to Server Explorer, and drop it onto the BankDemo server.
Alternatively, you can right-click the file in Solution Explorer, and select
Submit JCL
Note: If you have not started the Bankdemo server yet, since you configured the IDE to start the server automatically, you receive a notification that the server will be started. Click
OK to confirm this.
- Check the Output window to see that the job has been submitted and that the job has completed.
The Output window also includes a link for the job output, which you can open by pressing and holding
CTRL, and clicking the link with the mouse.
You now need to check the results of submitting the job.
Viewing the Catalog and the Spool
You can open the catalog and the spool directly from within the IDE.
To view the catalog:
- In Server Explorer, right-click the BANKDEMO server and click
Show Catalog.
Alternatively, in Solution Explorer, right-click the BankDemo project, and click
Enterprise Server > Show Catalog.
This opens the catalog.
- Click
List to view all file entries in the catalog.
- Click a file name (for example,
EBC.BNKACC) to preview the contents of the file.
To view the spool:
- In Server Explorer, right-click the BANKDEMO server, and click
Show Spool.
Alternatively, in Solution Explorer, right-click the BankDemo project, and click
Enterprise Server > Show Spool.
This shows the spool with the
Output button selected to see a list of jobs. If you cannot see your job, click
Out Hold. Your job is the last in the list.
- Check the check box next to your job, and click
Display.
This opens a page with a variety of information for the job progress, showing return condition code (COND) of 0000:
In the details, there are:
You can now start to look at how to run the online application.