This document describes the examples provided for the COBOL Wrapper for z/OS Batch. It covers the following topics:

• Overview of Client and Server Examples for IBM i

• Installing and Running the Client Examples for IBM i

• Installing and Running the Server Examples for IBM i

---

Overview of Client and Server Examples for IBM i

The following examples are delivered for IBM i in the library EXAMPLE of the Developer's Kit for IBM i.

Module	Source file	Windows File Name	Description	Notes
CALCMENU	QCBLLESRC	- not delivered here -	COBOL client display file (source)	1
CALCMAIN	QCBLLESRC	- not delivered here -	COBOL client dialog program (source)	1
CCALC	QCBLLESRC	- not delivered here -	client interface object (generated)	1
RPCSRVI	QCBLLESRC	- not delivered here -	generic RPC service module	1
CALC	QCBLLESRC	- not delivered here -	RPC server calc (source)	2

Module

The name of the delivered module.

Source file

The name of the source file where the modules are delivered.

Windows File Name

IBM i examples are not delivered in the Windows installation

Description

The purpose of the module

Notes:

1. The client application is built by the source members: CALCMENU, CALCMAIN, CCALC and RPCSRVI. You can find the associated IDL file example.idl in the Windows installation.
2. The server application.

Installing and Running the Client Examples for IBM i

To run the client examples for IBM i

1. The EntireX product library EXX must be in your library list. It contains the Broker ACI service program EXA.

2. Confirm that the broker and the RPC server are active.

3. Start the client application CALCCLIENT that you built, see Using the COBOL Wrapper for Batch (z/OS, BS2000/OSD, z/VSE and IBM i).

4. A menu similar to the following will be displayed:

   Calculator Menu
   -----------------------------------------------------
   
   Operation:    +         (type + - * / to calculate or
                            type .       to terminate)
   Operand 1:    _____
   
   Operand 2:    _____
   
   Result:  ___________
   
   
   Broker-ID: localhost:1971    Server: SRV1

Specify the ID of the remote Broker and the name of the server that provides the CALC program. Specify the numbers you want to compute and press ENTER. If the Broker connection fails, you will get an appropriate error message.

Installing and Running the Server Examples for IBM i

To install and run the server examples for IBM i

1. For IBM i, the delivered program CALC in QCBLLESRC source file must be provided to the RPC server under IBM i.

2. Confirm that the broker is active.

3. Start the RPC server under IBM i.