Skip to content

ZMF Support for CICS Bundles

ZMF supports the creation and maintenance of CICS JSON REST bundles. The build process is provided by member CMNBUNJL (of the CMNZMF.SKELS distribution library).

The CMNBUNJL skeleton calls the IBM-supplied utility DFHJS2LS with the BUNDLE= parameter to process a specified JSON schema.

The output from this process is a number of zFS files (the bundle), which are generated in the target directory. Typically, the build process creates a Language Environment (LE) language copybook (COBOL or PL/I, for example), a listing, and the bundle. Once installed, CICS uses these components to implement the API.

Here is an example Source to Load Relationship (panel CMN2R2LD) display for a successful staging of a JSON REST schema:

CMN2R2LD        Source to Load Relationship         Row 1 to 5 of 5
Command ===>                                        Scroll ===> CSR

    Package: STEV001489     Status: DEV     Install date: 20180820

Source name . . . . JSONMINE +
Lib type . . . . .  J2B
Setssi . . . . . .  6DB28FDD

Related Load Modules:
Name            + Type Promotion    Changed         User    Setssi
JNMINE01            WCP 0 STAGING   20180427 032652 WSER58  6DB28FDD
JSONMINE            LST 0 STAGING   20180427 032655 WSER58  6DB28FDD
JSONMINE.J2B.list   LSH 0 STAGING   20180427 032655 WSER58  6DB28FDD
JSONMINE/jsbinds/JS BDL 0 STAGING   20180427 032652 WSER58  6DB28FDD
JSONMINE/jsbinds/My BDL 0 STAGING   20180427 032652 WSER58  6DB28FDD
JSONMINE/META-INF/c BDL 0 STAGING   20180427 032652 WSER58  6DB28FDD

...

In this case, a copybook (the WCP component), a listing, and three bundle components in the BDL libtype. The full names of the bundle components are:

  • JSONMINE/jsbinds/JSONMINE.jsbind

  • JSONMINE/jsbinds/My-test-client-request.json

  • JSONMINE/META-INF/cics.xml

Skeletons CMN30 and CMN30I have been enhanced with the SUBDIRS=Y parameter to enable the development libraries to be cleaned up after the package installation and baselining steps have been performed.