Troubleshooting JSON deployment problems

Deployment errors can occur when you try to either install a PIPELINE or a WEBSERVICE resource in CICS. The most common deployment errors are described here, including the symptom of the problem, the cause, and the solution.

Procedure

The following errors might occur when you install a PIPELINE or WEBSERVICE resource in CICS:

  • You receive a DFHPI0914 error message when you attempt to install a WEBSERVICE resource. The message includes some information about the cause of the installation failure.
    1. Check that you have authorized CICS to read the web service binding file in z/OS UNIX.
    2. Check that the web service binding file is not corrupted.
      This corruption can occur, for example, if you use FTP to transfer the file to z/OS UNIX in text mode rather than binary mode.
    3. Check that two web service binding files with the same name are not in different pickup directories.
    4. Check that you are not installing a provider mode WEBSERVICE resource into a requester mode pipeline.
      Provider mode web service binding files specify a PROGRAM value, whereas requester mode binding files do not.
    5. If you are using DFHJS2LS or DFHLS2JS, check the messages that are issued by the job to see whether there are any problems that you must resolve before creating the WEBSERVICE resource.
  • The PIPELINE resource fails to install and you receive a DFHPI0700, DFHPI0712, DFHPI0714 or another error message that states that the PIPELINE resource failed.
    1. If you received a DFHPI0700 error message, you must enable PL/I language support in your CICS region.
      This support is required before you can install any PIPELINE resources. See Language Environment support for PL/I for more information.
    2. Check that you have authorized CICS to access the z/OS UNIX directories to read the pipeline configuration files.
    3. Check that the directory you are specifying in the WSDIR parameter is valid.
      In particular, check the case as directory and file names in z/OS UNIX are case-sensitive.
    4. Ensure that you do not have a PIPELINE resource of the same name in an ENABLED state in the CICS region.
  • The PIPELINE resource installs in a DISABLED state. You get an error message in the range of DFHPI0702 to DFHPI0711.
    1. Check that there are no errors in the pipeline configuration file.
      The elements in the pipeline configuration file can only appear in certain places. If you specify these incorrectly, you get a DFHPI0702 error message. This message includes the name of the element that is causing the problem. Check the element description to make sure that you have coded it in the correct place.
    2. Check that you do not have any unprintable characters, such as horizontal tab characters, in the pipeline configuration file.
    3. Check that the XML is valid.
      If the XML is not valid, this can cause parsing errors when you attempt to install the PIPELINE resource.
    4. Ensure that the pipeline configuration file is encoded in US EBCDIC.
      If you try to use a different EBCDIC encoding, CICS cannot process the file.