IMS Connect Extensions feed JCL
The JCL to run the IMS Connect Extensions feed is concise and standalone: an EXEC statement for the feed program, CEXCA20P; feed configuration parameters in an in-stream SYSIN data set; and a SYSPRINT data set for output messages.
Example
The following JCL defines a feed that forwards data from
three IMS Connect systems: ICONP01, ICONP02,
and ICONP03. The feed consists of selected fields in JSON
Lines format sent over unsecure TCP/IP (no SSL/TLS) to port 1514 on the host named
analytics
.
//UIDCEX JOB NOTIFY=&SYSUID
//CEXCA20 EXEC PGM=CEXCA20P
//STEPLIB DD DISP=SHR,DSN=cexpre.SCEXLINK
//* Output messages
//SYSPRINT DD SYSOUT=*
//* Configuration parameters
//SYSIN DD *
* Source: IMS Connect systems (must be on the same LPAR as this job)
HWSID=ICONP01,ICONP02,ICONP03
* Destination: JSON Lines over TCP/IP
DESTINATION=JSON
HOST=analytics
PORT=1514
FIELDS(hwsname,
trancode,
resptime) /* Send only the fields you need
* Other destinations (only one destination allowed per feed job):
* DESTINATION=ARCHIVE
* DSN=...
* DESTINATION=SMF
/*
DD statements
- The library containing the IMS Connect Extensions executable load modules. You do not need to specify the name of this library if the modules reside in the system LNKLST.
- Output messages. Each message is preceded by the current time stamp and either of the following
identifiers:
- The feed job name
- The name (HWSID) of the IMS Connect system to which the message applies
- Configuration parameters.
The SYSIN data set can also contain comment lines, inline comments, and blank lines. A comment line begins with an asterisk (
*
) in column one. An inline comment starts with (/*
) after column one and any parameter.It is important to note that the values must be mentioned right after the parenthesis for the FIELDS and VOLSER parameters. If you have multiple values, separate them using commas (
,
). This ensures that the parameters are assigned to the correct fields and that your statement is executed successfully.For example:
//SYSIN DD * Comment line HWSID=ICONP01 /* Inline comment FIELDS(hwsname, <------------------ port ) /*