z/OS Connect Enterprise Edition

z/OS Connect

z/OS Connect

Truly RESTful APIs to and from your IBM Z mainframe

 View Only
  • 1.  catalogManager sample program for API requester

    Posted Fri April 18, 2025 03:16 AM
    Hello everyone.
     
    I understand that the sample program BAQCATPO in the following scenario is for the API requester.
     
     
    However, there is no explanation of how this program should be resource defined to CICS.
     
    If you know how to do it, could you please advise?


    ------------------------------
    Toyokazu Kobayashi
    ------------------------------


  • 2.  RE: catalogManager sample program for API requester

    Posted Mon April 21, 2025 03:34 AM

    This link shows what you need to do to configure CICS to connect to the zCEE server

    https://www.ibm.com/docs/es/zos-connect/3.0.0?topic=application-configuring-cics-access-zos-connect-server

    You just define BAQCATPO to CICS like any other normal COBOL program



    ------------------------------
    Edward McCarthy
    WAS on System z
    ------------------------------



  • 3.  RE: catalogManager sample program for API requester

    Posted Mon April 21, 2025 11:09 AM

    Hi Toyokazu

    You need to enable the communication stub BAQCSTUB in the CICS region to allow CICS application to call the catalog manager API through the IBM z/OS Connect. Please follow the link below to configure resources in CICS region in order to setup the IBM z/OS Connect communication stub in CICS

    https://www.ibm.com/docs/es/zos-connect/3.0.0?topic=application-configuring-cics-access-zos-connect-server



    ------------------------------
    Jainendra Mani Tiwari
    ------------------------------



  • 4.  RE: catalogManager sample program for API requester

    Posted Tue April 22, 2025 05:26 AM

    Thank you for your reply.

    An example of compile/link and executing BAQCATPO is described here, but there is no explanation of the resource definition for this program to CICS.

    Testing the scenario - Documentación de IBM

    I'll try to define programs and transactions in CICS and test them.



    ------------------------------
    Toyokazu Kobayashi
    ------------------------------



  • 5.  RE: catalogManager sample program for API requester

    Posted Wed April 23, 2025 12:46 PM

    To enable the API Requester function in CICS, follow the directions at https://www.ibm.com/docs/en/zos-connect/3.0.0?topic=requesters-configuring-cics-access-zos-connect-call-apis   Since BAQCATPO is a normal application program, it would be defined to CICS as any other application program -- or allowed to be autoinstalled if that is configured for your CICS region. Since this is just a sample, I would recommend accepting all the default attributes on the PROGRAM definition. Although not documented, you could simply invoke this program using CECI. Or define a TRANSACTION resource to allow you to invoke it from a terminal without using CECI.

    Note that the sample BAQCATPO program has no EXEC CICS commands in it and could easily be used as a batch program making the API Requester call. Therefore, when running in CICS, you will see no messages sent to the terminal. The only output is from the DISPLAY commands in the program.



    ------------------------------
    Leigh Compton
    Consulting IT Specialist - CICS and Enterprise Integration
    IBM
    ------------------------------