Client and Server Examples for z/VSE 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.
This document covers the following topics:

Basic RPC Client Examples - CALC, SQUARE

CALC Client

The CALC client is built with COBOL Wrapper interface type "Batch with standard linkage calling convention". See Client Interface Types for more information.

Name Type Sublibrary(3) Description Notes
README1.TXT Text document EXAMPLE.COBCLTB Client build instructions and description.  
CALCCLT.C COBOL source code EXAMPLE.COBCLTB A client application calling the remote procedure (RPC service) CALC, with associated example.idl. 2
CALC.C COBOL source code EXAMPLE.COBCLTB Client interface object for IDL program CALC. 1
CALC.C COBOL copybook EXAMPLE.COBCPYB Client interface object copybook for IDL program CALC. 1
ERXCOMM.C COBOL copybook EXAMPLE.COBCPY RPC Communication Area copybook. 1
COBSRVIB.C COBOL source code EXAMPLE.COBCLTB Generic RPC Service for Batch. 4
CALCCLT.J JCL EXAMPLE.COBCLTB Job control to build the RPC client CALCCLT. 3
CALCRUN.J JCL EXAMPLE.COBCLTB Job control to execute the RPC client CALCCLT. 3

Notes:

  1. Generate these objects with the Designer.
  2. Application built according to the client-side build instructions, see Using the COBOL Wrapper for Batch (z/OS, BS2000, z/VSE and IBM i).
  3. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.
  4. See Generation and Usage of Generic RPC Service Module COBSRVI.

For more information refer to the file README1.TXT in EntireX directory examples/RPC/CobolClient/vseBatch under UNIX or Windows.

SQUARE Client

For batch under operating system z/VSE, the SQUARE client is built with COBOL Wrapper interface type "Batch with standard linkage calling convention". See Client Interface Types for more information.

Name Type Sublibrary (2) Description Notes
README1.TXT Text document EXAMPLE.COBCLTB Client build instructions and description  
SQRECLT.C COBOL source code EXAMPLE.COBCLTB A client application calling the remote procedure (RPC service) SQUARE, with associated example.idl. 1
SQUARE.C COBOL source code EXAMPLE.COBCLTB Client interface object for IDL program SQUARE. 3
SQUARE.C COBOL copybook EXAMPLE.COBCPYB Client interface object copybook for IDL program SQUARE. 3
ERXCOMM.C COBOL copybook EXAMPLE.COBCPY RPC Communication Area copybook. 3
COBSRVIB.C COBOL source code EXAMPLE.COBCLTB Generic RPC Service for Batch. 4
SQRECLT.J JCL EXAMPLE.COBCLTB Job control to build the RPC client SQRECLT. 2
SQRERUN.J JCL EXAMPLE.COBCLTB Job control to execute the RPC client SQRECLT. 2

Notes:

  1. Application built according to the client-side build instructions, see Using the COBOL Wrapper for Batch (z/OS, BS2000, z/VSE and IBM i).
  2. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.
  3. Generate these objects with the Designer.
  4. See Generation and Usage of Generic RPC Service Module COBSRVI.

For more information, refer to the file README1.TXT in EntireX directory examples/RPC/CobolClient/vseBatch under UNIX or Windows.

Basic RPC Server Examples - CALC, SQUARE

CALC Server

For batch under operating system z/VSE, the CALC server is built with COBOL Wrapper "Batch with standard linkage calling convention" interface type. See Server Interface Types for more information.

Name Type Sublibrary (2) Description Notes
README1.TXT Text file EXAMPLE.COBSRVB CALC server build instructions and description  
CALC.C COBOL source code EXAMPLE.COBSRVB A server application providing the remote procedure CALC (RPC service), with associated example.idl. 1
CALC.J JCL EXAMPLE.COBSRVB Job control to build the remote procedure CALC (RPC service). 2

Notes:

  1. Application built according to the server-side build instructions, see Using the COBOL Wrapper for Batch (z/OS, BS2000, z/VSE and IBM i).
  2. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.

For more information refer to the file README1.TXT in EntireX directory examples/RPC/CobolServer/vseBatch under UNIX or Windows.

SQUARE Server

For Batch on operating system z/VSE, the SQUARE server is built with COBOL Wrapper interface type "Batch with standard linkage calling convention". See Client Interface Types for more information.

Name Type Sublibrary(2) Description Notes
README1.TXT Text file EXAMPLE.COBSRVB SQUARE server build instructions and description  
SQUARE.C COBOL source code EXAMPLE.COBSRVB A server application providing the remote procedure SQUARE (RPC service), with associated example.idl 1
SQUARE.J JCL EXAMPLE.COBSRVB Job control to build the remote procedure SQUARE (RPC service) 2

Notes:

  1. Application built according to the server-side build instructions, see Using the COBOL Wrapper for Batch (z/OS, BS2000, z/VSE and IBM i).
  2. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.

For more information refer to the file README1.TXT in EntireX directory examples/RPC/CobolServer/vseBatch under UNIX or Windows.