{"id":2202,"date":"2020-01-20T02:41:31","date_gmt":"2020-01-19T23:41:31","guid":{"rendered":"http:\/\/kusuaks7\/?p=1807"},"modified":"2024-01-25T17:00:52","modified_gmt":"2024-01-25T17:00:52","slug":"joining-the-api-economy","status":"publish","type":"post","link":"https:\/\/www.experfy.com\/blog\/software-ux-ui\/joining-the-api-economy\/","title":{"rendered":"Joining the API economy"},"content":{"rendered":"\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t
\n\t\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tMainframes are brilliant. They are full of fantastic applications that can do lots of wonderful things quickly and easily. But, in many ways, they are limited to doing all those wonderful things only on the mainframe. What you need is to be able to take the best parts of those applications and, possibly, combine them with the best parts of other applications that exist elsewhere on cloud or mobile platforms, and create incredible new applications that people will want to use. And you don\u2019t want to have to make any changes to your original mainframe applications.\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tThis is basically, what they call, the API (Application Programming Interface) economy. Making the best use you can of existing applications and data by making them available as APIs and then developing new applications to meet a need of customers and potential customers. One way to do that is by using IBM\u2019s z\/OS Connect Enterprise Edition.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tIBM\u2019s z\/OS Connect Enterprise Edition provides a framework enabling z\/OS-based data and programs to become part of the API economy and connect with users and other APIs in the cloud and on mobile devices. z\/OS Connect EE makes CICS, IMS, WebSphere MQ, Db2, and batch accessible through RESTful APIs with JSON-formatted messages. RESTful APIs and JSON are frequently used with mobile application development. And that means those developers can work with mainframes without needing to know too much about mainframes. Your mainframe makes a good API host because: it has a fast response time; it\u2019s extremely reliable; it handles high workload volumes; and it is highly available.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tA bit of background. There are three types of API, they are public, partner, and private. REST stands for Representational State Transfer. It\u2019s an architectural style for accessing and updating data, typically using HTTP. Although not all HTTP interfaces are \u2018RESTful\u2019. REST is popular because it\u2019s based on HTTP, which operates on TCP\/IP, which is a ubiquitous networking topology. Compared to other technologies (for example, SOAP\/WSDL), the REST\/JSON pattern is a relatively light protocol and data model, which maps well to resource-limited devices (like phones). The REST interface is simple. So, developing the client involves very few things, eg: an understanding of the URI requirements (path, parameters); and any JSON data schema. REST\/JSON is becoming more and more a\u00a0de facto<\/i>\u00a0\u2018standard\u2019 for exposing APIs and microservices. REST is, by definition, a stateless protocol, which implies greater simplicity in topology design. There\u2019s no need to maintain, replicate, or route based on state.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tIf you don\u2019t use z\/OS Connect EE, what do you use? For CICS it would be CICS Transaction Gateway (CTG) or CICS SOAP\/JSON Web services. For IMS it would be IMS Mobile Feature pack. For Db2 it would be DB2 JSON. For MQ it would be a broker. And for WebSphere Application Service (WAS) it would be JAX RS Java API for RESTful Web Services). And that means there would be multiple endpoints for developers to call and maintain access to. z\/OS Connect EE provides a single entry point, making the developers life much easier.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tThe next question is how do you know what APIs you have available? z\/OS Connect EE includes a deployment artefact, called an API package. This can be deployed to the z\/OS Connect EE run time as a z\/OS-based RESTful API. These RESTful API definitions are discoverable through automatically generated Swagger documents, which are created by the supplied z\/OS Connect EE API Editor. Swagger, in case you were unsure, is an open-source software framework that helps developers design, build, document, and consume RESTful Web services. So, these descriptions tell other application developers how to use the API. The enterprise API catalog can be populated with z\/OS Connect EE-hosted APIs alongside any other provider and can be used in the same way.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\tLet\u2019s look at the six steps needed to expose a z\/OS asset:\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t
    \n \t
  1. Install, set up, and start to use z\/OS Connect EE server.<\/li>\n \t
  2. Create your service definition \u2013 to start mapping an API, z\/OS Connect EE needs a representation of the underlying z\/OS application, ie a Service Archive file (.sar).<\/li>\n \t
  3. Create your API by importing your .sar file into the API toolkit, and start designing your API. From the editor, then create an API Archive file(.aar), which describes your API and how it maps to underlying services.<\/li>\n \t
  4. Configure the system-appropriate service provider to connect to your backend system in your server.xml<\/li>\n \t
  5. Deploy your service, ie deploy the .sar file generated by the service definition utility by copying the .sar file to the services directory.<\/li>\n \t
  6. Deploy your API using the right-click deploy in the API toolkit, or by copying the .aar file to the apis directory.<\/li>\n<\/ol>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t\t\t\t\t\tLooking at things in more details, there is a z\/OS Connect EE API Editor, which lets developers create RESTful APIs from IMS or CICS, etc, making those mainframe assets available in the cloud or on mobile. z\/OS Connect EE easily integrates with API management solutions. And you can have RESTful APIs to and from your mainframe. It provides point-and-click API mapping, so no code changes are required.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t\t\t\t\t\tThe z\/OS Connect EE API package can be deployed manually, or it can be automated by extending an existing enterprise change control process. According to IBM: \u201cThe associated deployment capabilities provide an enterprise with the ability to meet the demands of the fast-paced API economy. z\/OS Connect EE includes a significant new mapping capability that is used before the transformation from JSON messages to the required format of the z\/OS subsystems. This mapping capability adds a powerful abstraction layer between the API consumer and the underlying z\/OS assets and allows inline manipulation of requests, such as the mapping of HTTP headers, pass-through, redaction, or defaulting of JSON fields.\u201d\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t\t\t\t\t\tThe great thing about using z\/OS Connect EE is that developers can access most mainframe assets from a single product. It also makes it easy for mainframes to join in the API economy. And the developers that you use, can access mainframe APIs without needing to know very much about mainframes. They can treat the mainframe like any other server.\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t
    \n\t\t\t\t
    \n\t\t\t\t\t\t\t\t\tThe mainframe can now be even better!\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"

    The great thing about using z\/OS Connect EE is that developers can access most mainframe assets from a single product. It also makes it easy for mainframes to join in the API economy. And the developers that you use, can access mainframe APIs without needing to know very much about mainframes. They can treat the mainframe like any other server. Making the best use you can of existing applications and data by making them available as APIs and then developing new applications to meet a need of customers and potential customers.<\/p>\n","protected":false},"author":696,"featured_media":3388,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[200],"tags":[106],"ppma_author":[3497],"class_list":["post-2202","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-software-ux-ui","tag-software"],"authors":[{"term_id":3497,"user_id":696,"is_guest":0,"slug":"trevor-eddolls","display_name":"Trevor Eddolls","avatar_url":"https:\/\/www.experfy.com\/blog\/wp-content\/uploads\/2020\/04\/medium_c0bcd8d5-35e9-492d-8082-c20fbfbd588a-150x150.jpg","user_url":"https:\/\/itech-ed.com\/%20","last_name":"Eddolls","first_name":"Trevor","job_title":"","description":"Trevor Eddolls is Head at the iTech-Ed Group, which comprises the mainframe and IT consultancy. A popular speaker and blogger, he is also clinical director at iTech-Ed Hypnotherapy, head of IT for the AfSFH Exec., and director of training for SFH+. He is also editorial director for the Arcati Mainframe Yearbook, and published three mainframe-related books and six books on hypnotherapy."}],"_links":{"self":[{"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/posts\/2202","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/users\/696"}],"replies":[{"embeddable":true,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/comments?post=2202"}],"version-history":[{"count":5,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/posts\/2202\/revisions"}],"predecessor-version":[{"id":35667,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/posts\/2202\/revisions\/35667"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/media\/3388"}],"wp:attachment":[{"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/media?parent=2202"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/categories?post=2202"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/tags?post=2202"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/www.experfy.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=2202"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}