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

Basic RPC CALC Example

CALC Client using Call Interface (CALCCLT)

The CALC CICS client example CALCCLT is implemented with interface type "CICS with standard linkage calling convention". See Client Interface Types for more information.

Name Type Sublibrary (4) Description Notes
README1.TXT Text file EXAMPLE.COBCLTC Client build instructions and description.  
CALCCLT.C COBOL source code EXAMPLE.COBCLTC An RPC client application calling the remote procedure (RPC service) CALC. 1
CALC.C COBOL source code EXAMPLE.COBCLTC Client interface object for IDL program CALC. 2
CALC.C COBOL copybook EXAMPLE.COBCPYC Client interface object copybook for IDL program CALC. 2
ERXCOMM.C COBOL copybook EXAMPLE.COBCPY RPC Communication Area copybook. 2
COBSRVID.C COBOL source code EXAMPLE.COBCLTC Generic RPC Service module for CICS with call interface. 5
CALCMAP.A CICS map EXAMPLE.COBCLTC CICS map for RPC client CALCCLT.  
CALCMAP.C COBOL copybook EXAMPLE.COBCPYC Generated CICS Map COBOL Definitions. 3
CALCLT.J JCL EXAMPLE.COBCLTC Job control to build the RPC client CALCCLT. 4
CALCDFH.J JCL EXAMPLE.COBCLTC CICS CSD definitions job control for RPC client CALCCLT.  

Notes:

  1. Built according to the client-side build instructions, see Using the COBOL Wrapper for CICS with Call Interfaces (z/OS and z/VSE).
  2. Generate these objects with the Designer.
  3. Generated from CALCMAP.A during execution of CALCCLT.J.
  4. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.
  5. See Generation and Usage of Generic RPC Service Module COBSRVI.

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

CALC Client using DFHACOMMAREA (CALC1CLT)

The CALC CICS client example CALC1CLT is implemented with interface type "CICS with DFHCOMMAREA calling convention". See Client Interface Types for more information.

Name Type Sublibrary (4) Description Notes
README3.TXT Text file EXAMPLE.COBCLTC Client build instructions and description.  
CALC1CLT.C COBOL source code EXAMPLE.COBCLTC An RPC client application calling the remote procedure (RPC service) CALC. 1
CALC1.C COBOL source code EXAMPLE.COBCLTC Client interface object for IDL program CALC. 2
CALC1.C COBOL copybook EXAMPLE.COBCPYC Client interface object copybook for IDL program CALC. 2
ERXCOMM.C COBOL copybook EXAMPLE.COBCPY RPC Communication Area copybook. 2
COBSRVIC.C COBOL source code EXAMPLE.COBCLTC Generic RPC Service with EXEC CICS LINK interface. 5
CALC1MAP.A CICS map EXAMPLE.COBCLTC CICS map for RPC client CALC1CLT.  
CALC1MAP.C COBOL copybook EXAMPLE.COBCPYC Generated CICS Map COBOL Definitions. 3
CALC1CLT.J JCL EXAMPLE.COBCLTC Job control to build the RPC client CALC1CLT. 4
CALC1DFH.J JCL EXAMPLE.COBCLTC CICS CSD definitions job control for RPC client CALC1CLT.  

Notes:

  1. Built according to the client-side build instructions, see Using the COBOL Wrapper for CICS with DFHCOMMAREA Calling Convention (z/OS and z/VSE).
  2. Generate these objects with the Designer.
  3. Generated from CALC1MAP.A during execution of CALC1CLT.J.
  4. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.
  5. Built as COBSRVI.PHASE by CALC1CLT.J. See Generation and Usage of Generic RPC Service Module COBSRVI.

For more information, refer to the README3.TXT file in EntireX directory examples/RPC/CobolClient/vseCICS/Callinterface under Linux or Windows.

CALC Server (CALC)

The CALC CICS server example is built with COBOL Wrapper interface type "CICS with DFHCOMMAREA calling convention". See Server Interface Types for more information.

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

Notes:

  1. Application built according to the server-side build instructions, see Using the COBOL Wrapper for CICS with DFHCOMMAREA Calling Convention (z/OS and z/VSE).
  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 README1.TXT file in EntireX directory examples/RPC/CobolServer/vseCICS under Linux or Windows.

Basic RPC SQUARE Example

SQUARE Client using Call Interface (SQRECLT)

The SQUARE CICS client example SQRECLT is implemented with interface type "CICS with standard linkage calling convention". See Client Interface Types for more information.

Name Type Sublibrary (4) Description Notes
README1.TXT Text file EXAMPLE.COBCLTC Client build instructions and description.  
SQRECLT.C COBOL source code EXAMPLE.COBCLTC An RPC client application calling the remote procedure (RPC service) SQUARE. 1
SQUARE.C COBOL source code EXAMPLE.COBCLTC Client interface object for IDL program SQUARE. 2
SQUARE.C COBOL copybook EXAMPLE.COBCPYC Client interface object copybook for IDL program SQUARE. 2
ERXCOMM.C COBOL copybook EXAMPLE.COBCPY RPC Communication Area copybook. 2
COBSRVID.C COBOL source code EXAMPLE.COBCLTC Generic RPC Service for CICS with call interface. 2,5
SQREMAP.A CICS map EXAMPLE.COBCLTC CICS map for RPC client SQRECLT.  
SQREMAP.C COBOL copybook EXAMPLE.COBCPYC Generated CICS Map COBOL Definitions. 3
SQRECLT.J JCL EXAMPLE.COBCLTC Job control to build the RPC client SQRECLT. 4
SQREDFH.J JCL EXAMPLE.COBCLTC CICS CSD definitions job control for RPC client SQRECLT.  

Notes:

  1. Built according to the client-side build instructions, see Using the COBOL Wrapper for CICS with Call Interfaces (z/OS and z/VSE).
  2. Generate these objects with the Designer.
  3. Generated from SQREMAP.A during execution of SQRECLT.J.
  4. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.
  5. See Generation and Usage of Generic RPC Service Module COBSRVI.

For more information, refer to the README1.TXT file in EntireX directory examples/RPC/CobolClient/vseCICS/Callinterface under Linux or Windows, or the downloaded example sublibrary EXAMPLE.COBCLTC.

SQUARE Client using DFHACOMMAREA (SQRE1CLT)

The SQUARE CICS client example SQRE1CLT is implemented with interface type "CICS with DFHCOMMAREA calling convention". See Client Interface Types for more information.

Name Type Sublibrary (4) Description Notes
README3.TXT Text file EXAMPLE.COBCLTC Client build instructions and description.  
SQRE1CLT.C COBOL source code EXAMPLE.COBCLTC An RPC client application calling the remote procedure (RPC service) SQUARE. 1
SQRE1.C COBOL source code EXAMPLE.COBCLTC Client interface object for IDL program SQUARE. 2
SQRE1.C COBOL copybook EXAMPLE.COBCPYC Client interface object copybook for IDL program SQUARE. 2
ERXCOMM.C COBOL copybook EXAMPLE.COBCPY RPC Communication Area copybook. 2
COBSRVIC.C COBOL source code EXAMPLE.COBCLTC Generic RPC Service. 2,5
SQRE1MAP.A CICS map EXAMPLE.COBCLTC CICS map for RPC client SQRE1CLT.  
SQRE1MAP.C COBOL copybook EXAMPLE.COBCPYC Generated CICS Map COBOL Definitions. 3
SQRE1CLT.J JCL EXAMPLE.COBCLTC Job control to build the RPC client SQRE1CLT. 4
CALC1DFH.J JCL EXAMPLE.COBCLTC CICS CSD definitions job control for RPC client SQRE1CLT.  

Notes:

  1. Built according to the client-side build instructions, see Using the COBOL Wrapper for CICS with DFHCOMMAREA Calling Convention (z/OS and z/VSE).
  2. Generate these objects with the Designer.
  3. Generated from SQRE1MAP.A during execution of SQRE1CLT.J.
  4. The delivered JCL requires the sources, copybooks etc. to be placed in the documented sublibrary. Adapt the JCL to your needs.
  5. Built as COBSRVI.PHASE by SQRE1CLT.J. See Generation and Usage of Generic RPC Service Module COBSRVI.

For more information, refer to the README3.TXT file in EntireX directory examples/RPC/CobolClient/vseCICS/Callinterface under Linux or Windows, or the downloaded example sublibrary EXAMPLE.COBCLTC.

SQUARE Server (SQUARE)

The SQUARE CICS server example is built with COBOL Wrapper interface type "CICS with DFHCOMMAREA calling convention". See Server Interface Types for more information.

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

Notes:

  1. Application built according to the server-side build instructions, see Using the COBOL Wrapper for CICS with DFHCOMMAREA Calling Convention (z/OS and z/VSE).
  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 README1.TXT file in EntireX directory examples/RPC/CobolServer/vseCICS under Linux or Windows.