Client and Server Examples for z/OS CICS

This document describes the RPC examples provided. After installation of the EntireX Development Tools package, all examples here can be found in the EntireX directory examples/RPC. They are also available as a z/OS data set, see Installing RPC Examples.
This document covers the following topics:

Basic RPC Client Example - CALC

For CICS on operating system z/OS, the CALCCLT client is built with a PL/I Wrapper interface type "CICS with call interfaces". For this purpose, the PL/I Wrapper target platform is set to "Batch for z/OS" ("Batch" because of the call interface).

Please note there is an additional interface type for CICS, "CICS for z/OS", see Target Platform under Generating PL/I Source Files from Software AG IDL Files. An example of this is not yet available.

Name Type Data Set Description Notes
CALC PL/I source code EXP105.QCPL Client interface object for IDL program CALC. 1
CALCCLT PL/I source code EXP105.QCPL A client application calling the remote procedure (RPC service) CALC, with associated example.idl. 2
CALCDFH CICS CSD EXP105.QCPL CSD Definition for RPC client CALCCLT.  
CALCIBM JCL EXP105.QCPL Job (JCL) to build the RPC client CALCCLT. 3
CALCMAP   EXP105.QCPL CICS Map definition for RPC clients CALCCLT.  
CALC PL/I copybook EXP105.QIPL Client interface object copybook for IDL program CALC. 1
CALCMAP PL/I copybook EXP105.QIPL Description of input and output fields of map CALCMAP.  
EXAMPLE PL/I copybook EXP105.QIPL Client interface object entry points. 1
RPCPPS PL/I copybook EXP105.QIPL PL/I Wrapper Preprocessor Switches and Settings.  

Notes:

  1. Client interface objects are delivered with the z/OS installation, but not delivered under UNIX or Windows. Use the Designer to generate the client interface objects under UNIX or Windows.
  2. Application built according to the client-side build instructions under Using the PL/I Wrapper for CICS with Call Interfaces.
  3. The JCL must be adapted according to your needs.

For more information see the readme file in EntireX directory examples/RPC/PLIClient/zosCICS under UNIX or Windows.

Basic RPC Server Example - CALC

For CICS on operating system z/OS, the CALC server is built with PL/I Wrapper target platform setting "CICS for z/OS". For more information on target platforms, see Target Platform under Generating PL/I Source Files from Software AG IDL Files.

Name Type Data Set Description Notes
CALC PL/I source code EXP105.QVPL A server application providing the remote procedure CALC (RPC service), with associated example.idl. 1
CALCDFH CICS CSD EXP105.QVPL CSD Definition for remote procedure CALC (RPC service).  
CALCIBM JCL EXP105.QVPL Job (JCL) to build the remote procedure CALC (RPC service). 2

Notes:

  1. Application built according to the server-side build instructions under Using the PL/I Wrapper for CICS.
  2. The JCL must be adapted according to your needs.

For more information see the readme file in EntireX directory examples/RPC/PLIServer/zosCICS under UNIX or Windows.