IMS explorer for development

© 2015 IBM Corporation

IMS Explorer for Development


Acknowledgements and DisclaimersAvailability. References in this presentation to IBM products, programs, or services do not imply that they will be available in all

countries in which IBM operates.

© Copyright IBM Corporation 2015. All rights reserved.

– U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract

with IBM Corp.

IBM, the IBM logo, ibm.com, IMS, DB2, CICS and WebSphere MQ are trademarks or registered trademarks of International Business

Machines Corporation in the United States, other countries, or both. If these and other IBM trademarked terms are marked on their first

occurrence in this information with a trademark symbol (® or ™), these symbols indicate U.S. registered or common law trademarks

owned by IBM at the time this information was published. Such trademarks may also be registered or common law trademarks in other

countries. A current list of IBM trademarks is available on the Web at “Copyright and trademark information” at

www.ibm.com/legal/copytrade.shtml

Other company, product, or service names may be trademarks or service marks of others.

The workshops, sessions and materials have been prepared by IBM or the session speakers and reflect their own views. They are

provided for informational purposes only, and are neither intended to, nor shall have the effect of being, legal or other guidance or advice

to any participant. While efforts were made to verify the completeness and accuracy of the information contained in this presentation, it is

provided AS-IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of,

or otherwise related to, this presentation or any other materials. Nothing contained in this presentation is intended to, nor shall have the

effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the

applicable license agreement governing the use of IBM software.

All customer examples described are presented as illustrations of how those customers have used IBM products and the results they may

have achieved. Actual environmental costs and performance characteristics may vary by customer. Nothing contained in these

materials is intended to, nor shall have the effect of, stating or implying that any activities undertaken by you will result in any specific

sales, revenue growth or other results.

http://www.ibm.com/legal/copytrade.shtml


IMS user interfaces

IMSISPF

IBM® Management Console for IMS and DB2 for z/OS

(Web Browser)

AdministratorsDevelopers

IMS Explorer for Development (Eclipse)


Cloud-based

Services Enterprise

Systems

Integration

Enterprise

Applications

Enterprise

Data

On-Premise Enterprise APIs Enterprise

Transaction

Processing

IBM

WebSphere

Liberty

z/OS Connect

New

CICS,

IMS

Batch,

WAS

• IBM WebSphere Liberty z/OS Connect – Shipped with WAS, CICS, and IMS

• Designed for z/OS – builds on z/OS qualities of service

• Unifies z/OS connectors – a common solutions for mobile, cloud, and web

• Simplified integration – Hide complexity of connecting to z/OS using REST

• Discover z/OS assets – Enhance user experience with System of Record

Cloud APIs

Mobile-Optimized APIs

Systems of Engagement Systems of Record



Using IMS Mobile Feature Pack

and IMS Explorer for Development to

create a web-service using an

existing IMS transaction.

Step by step instructions


Open the IMS Mobile perspective


Open the IMS Mobile perspective


This is the IMS Mobile perspective


Create message metadata

Navigate to the Transactions folder

Right click and select “Create message metadata”


Create message metadata

Set the TRANCODE of the transaction you want to expose as a

mobile service.

Then hit “OK”.


Define the messages (Input/Output)

Click on “Data Structures”

Click the “Import data structure” button.



1. Click the “Browse” button and navigate to the location of the COBOL or PL/I data structure for your

transaction.

2. Select the data structure name from the drop down list.

3. Click the “Add to Import List” button.

4. Click the “Finish” button.



You can modify the names of the fields of the data structure you imported.

The new manes will be used in the mobile service.

Just click on the field and then click on the “Edit” button and change the

value.



Enter the new name you want to use for the field and hit “Finish”.

Notice that the original field’s name cannot be modified.



Now you can see the new name of that field.

Repeat for other fields if you wish.



Now import the data structures for the “Output Messages”.

The same steps as for “Input Messages”.

The only difference is that you choose the output data structures in the

“Import Input or Output Message Data Structures” window.


Save your progress

Save the work we have done so far by clicking on the “Save” button or hitting

(Ctrl+S) on the keyboard.


Create a connection profile

The connection profile is used to specify the location of the IMS datastore that

will run the transaction for our mobile service

Right click on IMS Connection profiles

Click on “Create an IMS connection profile”


Fill in the connection profile information

Enter the required information and then hit “Finish”.


Create a connection profile - complete

We have a new connection profile


Create an IMS interactions properties profile

The interactions properties profile contains the name of the

destination IMS system as well as other information related to the

interaction with the IMS system

Right click on “IMS interaction properties profiles”

Click on “Create an IMS interaction properties profile”


Fill in the interaction properties profile information

Enter the required information and then hit “Finish”.


Create an interaction properties profile - complete

We have a new interaction properties profile


Create the IMS Mobile service

We have all the info we need to create the mobile service for the IMS

transaction using all the definitions we created earlier.

Right click on “Services”

Click on “Create an IMS mobile transaction service”


Choose the definitions we created before

Fill in the required fields:



Click the “Browse” button to select the transaction and choose the input and

output message data structures. Click “OK” when done.



Select the interaction properties profile.

Remove any connections you do not want to use for this IMS Mobile service.



Click “Finish”


Create the IMS Mobile service - complete

We have a new IMS Mobile service


Create a new IMS Transaction Service Test

The test builds an application that allows us to test the service we have just

created.


Select the project type

Select IMS Explorer Transaction Service Test Case

and click Next.


Create a new project or select an existing one


Specify the service you want to test

The server name is the IMS Gateway Server hosting the IMS Mobile service we

created.


Run the new testcase

Right click the test case name and select “Run As” then click “IMS

Transaction”



Perform the one time setup for the test case launcher.

Click the “Project” tab and choose the test case project from the drop down

list.

Click “Run”



Double click the box for “Field value,” enter the value you want to send to the

IMS transaction, and click “OK”.



Click the Run button (green circle with a white arrow)

Enter your security credentials to access the IMS Mobile Gateway server


Run the new testcase - complete

Notice the output in the output message section of the testcase window.

This particular transaction was defined with the option “EDIT=UC” to request

that IMS transform the input message to uppercase before it is enqueued.

The transaction sends the input message back as the output message.


That’s it – very simple

THE END

Technology

IMS explorer for development