Client and Server Examples for z/OS Batch

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 for z/OS.
This document covers the following topics:

Basic RPC Client Example - CALC

For batch on operating system z/OS the CALC client is built with PL/I Wrapper target platform setting "Batch for z/OS". See Target Platform under Generating PL/I Source Files from Software AG IDL Files under Generating PL/I Source Files from Software AG IDL Files.

Name Type Data Set Description Notes
CALC PL/I source code EXP109.PCPL Client interface object for IDL program CALC 1
CALCCLT PL/I source code EXP109.PCPL A client application calling the remote procedure (RPC service) CALC, with associated example.idl. 2
CALCIBM JCL EXP109.PCPL Job (JCL) to build the RPC client CALCCLT. 3
CALCRUN JCL EXP109.PCPL Job (JCL) to execute the RPC client CALCCLT. 3
CALC PL/I copybook EXP109.PIPL Client interface object copybook for IDL program CALC. 1
EXAMPLE PL/I copybook EXP109.PIPL client interface object entry points 1
RPCPPS PL/I copybook EXP109.PIPL PL/I Wrapper Preprocessor Switches and Settings.  

Notes:

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

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

Basic RPC Server Example - CALC

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

Name Type Data Set Description Notes
CALC PL/I source code EXP109.PVPL A server application providing the remote procedure CALC (RPC service), with associated example.idl. 1
CALCIBM JCL EXP109.PVPL 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 Batch Mode.
  2. The JCL must be adapted according to your needs.

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