Client and Server Examples for z/OS CICS

This document describes the examples provided for the PL/I Wrapper for CICS. It covers the following topics:

All examples here can be found in the EntireX examples/RPC directory under UNIX and Windows.

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 EXP101.QCPL Client interface object for IDL program CALC. 1
CALCCLT PL/I source code EXP101.QCPL A client application calling the remote procedure (RPC service) CALC, with associated example.idl. 2
CALCDFH CICS CSD EXP101.QCPL CSD Definition for RPC client CALCCLT.  
CALCIBM JCL EXP101.QCPL Job (JCL) to build the RPC client CALCCLT. 3
CALCMAP   EXP101.QCPL CICS Map definition for RPC clients CALCCLT.  
CALC PL/I copybook EXP101.QIPL Client interface object copybook for IDL program CALC. 1
CALCMAP PL/I copybook EXP101.QIPL Description of input and output fields of map CALCMAP.  
EXAMPLE PL/I copybook EXP101.QIPL Client interface object entry points. 1
RPCPPS PL/I copybook EXP101.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 EntireX Workbench 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 EXP101.QVPL A server application providing the remote procedure CALC (RPC service), with associated example.idl. 1
CALCDFH CICS CSD EXP101.QVPL CSD Definition for remote procedure CALC (RPC service).  
CALCIBM JCL EXP101.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.