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

STEPLIB
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.
SYSPRINT
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
SYSIN
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                                       
  )

/*