ims explorer for development
TRANSCRIPT
© 2015 IBM Corporation
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.
© 2015 IBM Corporation
IMS user interfaces
IMSISPF
IBM® Management Console for IMS and DB2 for z/OS
(Web Browser)
AdministratorsDevelopers
IMS Explorer for Development (Eclipse)
© 2015 IBM Corporation
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
© 2015 IBM Corporation
Using IMS Mobile Feature Pack
and IMS Explorer for Development to
create a web-service using an
existing IMS transaction.
Step by step instructions
© 2015 IBM Corporation
Create message metadata
Navigate to the Transactions folder
Right click and select “Create message metadata”
© 2015 IBM Corporation
Create message metadata
Set the TRANCODE of the transaction you want to expose as a
mobile service.
Then hit “OK”.
© 2015 IBM Corporation
Define the messages (Input/Output)
Click on “Data Structures”
Click the “Import data structure” button.
© 2015 IBM Corporation
Define the messages (Input/Output)
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.
© 2015 IBM Corporation
Define the messages (Input/Output)
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.
© 2015 IBM Corporation
Define the messages (Input/Output)
Enter the new name you want to use for the field and hit “Finish”.
Notice that the original field’s name cannot be modified.
© 2015 IBM Corporation
Define the messages (Input/Output)
Now you can see the new name of that field.
Repeat for other fields if you wish.
© 2015 IBM Corporation
Define the messages (Input/Output)
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.
© 2015 IBM Corporation
Save your progress
Save the work we have done so far by clicking on the “Save” button or hitting
(Ctrl+S) on the keyboard.
© 2015 IBM Corporation
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”
© 2015 IBM Corporation
Fill in the connection profile information
Enter the required information and then hit “Finish”.
© 2015 IBM Corporation
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”
© 2015 IBM Corporation
Fill in the interaction properties profile information
Enter the required information and then hit “Finish”.
© 2015 IBM Corporation
Create an interaction properties profile - complete
We have a new interaction properties profile
© 2015 IBM Corporation
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”
© 2015 IBM Corporation
Choose the definitions we created before
Click the “Browse” button to select the transaction and choose the input and
output message data structures. Click “OK” when done.
© 2015 IBM Corporation
Choose the definitions we created before
Select the interaction properties profile.
Remove any connections you do not want to use for this IMS Mobile service.
© 2015 IBM Corporation
Create a new IMS Transaction Service Test
The test builds an application that allows us to test the service we have just
created.
© 2015 IBM Corporation
Select the project type
Select IMS Explorer Transaction Service Test Case
and click Next.
© 2015 IBM Corporation
Specify the service you want to test
The server name is the IMS Gateway Server hosting the IMS Mobile service we
created.
© 2015 IBM Corporation
Run the new testcase
Right click the test case name and select “Run As” then click “IMS
Transaction”
© 2015 IBM Corporation
Run the new testcase
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”
© 2015 IBM Corporation
Run the new testcase
Double click the box for “Field value,” enter the value you want to send to the
IMS transaction, and click “OK”.
© 2015 IBM Corporation
Run the new testcase
Click the Run button (green circle with a white arrow)
Enter your security credentials to access the IMS Mobile Gateway server
© 2015 IBM Corporation
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.