This document covers the following topics:
See also User-decided Mapping under COBOL to IDL Mapping for guidelines on IDL extraction by COBOL syntax.
A COBOL source program mostly does not contain all the information needed for IDL mapping. With the Mapping Editor you enter this missing information. In general, mapping the COBOL data items to IDL with the Mapping Editor is a two-step process:
First, select the COBOL data items of the COBOL interface.
Then map the COBOL interface to the IDL interface. Define
which COBOL data items are mapped to IDL (Select REDEFINE paths, Suppress Unneeded COBOL Data Items)
the direction of the COBOL data items (Map to [In, Out, InOut])
field values for COBOL data items that are not sent by clients to the COBOL server (Set COBOL Data Items to Constant)
COBOL server with multiple functions (Map to Multiple IDL Interfaces)
COBOL server output depends on COBOL input (Map to Multiple IDL Interfaces)
COBOL server with conditional output (Set Multiple Possible Output (MPO) Structures)
COBOL table usage (Set Arrays (Fixed <-> Unbounded))
etc.
The following table provides guidelines on IDL extraction per interface type. See Supported COBOL Interface Types. For the CICS interface types DFHCOMMAREA and DFHCOMMAREA Large Buffer, the guidelines distinguish further between COBOL server programs overlaying the input data structure with a different output data structure and COBOL server programs using same structures on input and output. You already selected this in the checkbox Input Message same as Output Message in Step 4: Define the Extraction Settings and Start Extraction:
Environment | Interface Type | CICS Message on Input and Output | Guidelines |
---|---|---|---|
CICS | DFHCOMMAREA (3) | same (1,4) | More info |
different (2,5) | More info | ||
Large Buffer | same (1) | More info | |
different (2) | More info | ||
Channel Container | More info | ||
webMethods Integration Server | COBOL Converter (for use by EntireX Adapter) | same (1) | More info |
different (2) | More info | ||
Batch | Standard Linkage | More info | |
IMS | BMP with Standard Linkage | More info | |
MPP Message Interface (IMS Connect) | More info | ||
Micro Focus | Standard Linkage | More info |
Notes:
DFHCOMMAREA
COBOL server must be DPL-enabled to be directly supported by EntireX.
The distributed program (DPL) link function enables a CICS client program to call another CICS program
(the server program) in a remote CICS region.
Technically, a COBOL server is DPL-enabled if
CICS is able to call the COBOL server remotely
the DFHCOMMAREA
layout does not contain pointers