Deploying the XML converter to IMS Connect

If you generate the XML converter by using Rational® Developer for System z®, you need to deploy it to IMS Connect.

  1. The XML adapter function must be configured in IMS Connect. For more information, see IMS 14 System Definition information.
  2. The Rational Developer for System z host configuration must be completed. For more information, see the Rational Developer for System z Host Configuration Guide.
  3. The Rational Developer for System z SFEKLOAD (V8.0.x) or SFEKLMOD (V8.5 or later) module must be concatenated to the STEPLIB of the IMS Connect startup JCL in order to generate IRZ error messages to assist troubleshooting.

To deploy the XML converter to IMS Connect:

  1. Use FTP to copy the XML converter that is generated by Rational Developer for System z to your host data set.
  2. Compile and bind the XML converter to the target host data set.
    To compile and bind the converters into a data set concatenated with the IMS Connect STEPLIB:
    • The converter must have an alias that is linked with the converter code, using the same name as the converter, with an X suffix. If the converter name is eight-character long, the last character for the alias must be changed to an X.
    • The converter and the load module name must end with the letter D.
    • The converter should be linked with the option REUS=SERIAL so that the converter is loaded into the memory only once.
    • In the step to link edit the converter, the SYSLMOD statement must specify a PDSE.
    For example, if your converter file name is IMSSGWS1D. Your JCL would contain ENTRY, ALIAS, and NAME statements as follows:
    //LINK    EXEC PGM=HEWL,COND=(4,LT),
    //        PARM='XREF,COMPAT=MIN,REUS=SERIAL'
    ...  
    		ENTRY IMSSGWS1D 
    		ALIAS IMSSGWS1X 
    		NAME IMSSGWS1D(R)