Part 1 Overiew of the scenario 2
CHAPTER 1 INTRODUCTION 2
1.1 Scenario overview 4
1.1.1 S/390 software prerequisites 4
1.1.2 Windows NT client software prerequisites 5
1.2 Overview of the servlets 5
1.2.1 Order servlet 5
1.2.2 Bid servlet 7
1.2.3 Accept servlet 8
1.2.4 Email servlet 9
1.3 Overview of the server environment 10
1.4 Overview of the Web application 11
1.4.1 From the user's perspective 11
1.4.2 From the programmer's perspective 14
CHAPTER 2 INSTALL THE DEVELOPMENT SOFTWARE 16
2.1 Install IBM VisualAge for Java V3.02 17
2.2 Install VisualAge for Java features 18
2.3 Install IBM WebSphere Studio 3.5 18
2.4 Install a Web browser 19
2.5 Install the demo files 19
CHAPTER 3 ABOUT THE SERVER CONFIGURATON 20
3.1 About the application flow 21
3.1.1 Getting started 22
3.1.2 Retrieving customer order information 24
3.1.3 Requesting shipping options 26
3.1.4 Accepting a bid 28
3.1.5 Emailing the customer 30
3.2 About the server applications 31
3.2.1 About the customer and order applications 31
3.2.2 About the shipper applications 32
3.2.3 About the hub application 32
3.2.4 About the IMS customer application 33
3.2.5 Check database and transaction 34
3.3 About the subsystem configuration 35
3.3.1 About MQSeries configuration 35
3.3.2 About MQ/CICS Bridge configuration 36
3.3.3 About CICS configuration 36
3.3.4 About DB2 configuration 37
3.3.5 About WebSphere Application Server configuration 37
3.3.6 About IMS Connect 39
Part 2 Creating the servlets 42
CHAPTER 4 CREATE THE ORDER SERVLET 44
4.1 Create Java beans that access CICS and DB2 46
4.1.1 Create the B2BApp project 46
4.1.2 Create the order package 46
4.1.3 Create the COBOL customer record type 46
4.1.4 Create the CustomerRecord class 47
4.1.5 Create the COBOL order record type 48
4.1.6 Create the OrderRecord class 48
4.1.7 Create the RetrieveCustomerCommand class 49
4.1.8 Create the RetrieveOrderCommand class 54
4.1.9 Create the CICSRetrieveNavigator class 57
4.2 Test the CICS connection 63
4.2.1 Create a CICSNavExecute test application 63
4.2.2 Run the CICSNavExecute test 65
4.2.3 What you have proved so far 66
4.2.4 Create a version of the order package 66
4.3 Generate the order servlet and generic user interface files 67
4.3.1 Preparing the WebSphere Studio project 67
4.3.2 Generate the order servlet,HTML,and JSP files 69
4.4 Customize the order servlet 71
4.5 Publish the order servlet on the test stage 71
4.5.1 Set up Studio publishing for local testing 72
4.5.2 Publish the order files on the test stage 72
4.6 Test the order servlet in the WebSphere Test Environment 73
4.6.1 Set up the Servlet Engine classpath 73
4.6.2 Run the Servlet Engine 73
4.6.3 Run the servlet 74
4.7 Modify the order beans for publishing on the server 76
4.7.1 About the modifications 76
4.7.2 Change the code page 76
4.7.3 Change the command bean properties 77
4.7.4 Change the navigator properties 78
4.7.5 Export from VisualAge for Java to WebSphere 78
4.8 Publish the order servlet on the server 78
4.8.1 Modify the servlet configuration file 78
4.8.2 Modify the user interface files 79
4.8.3 Prepare to publish on the host 80
4.8.4 Publish the order files on the server 80
4.8.5 Check the WebSphere Application Server classpath 81
4.8.6 Provide permissions for the published files 82
4.9 Test the order servlet from a Web browser 83
CHAPTER 5 CREATE THE BID SERVLET 86
5.1 Create Java beans that access MQSeries 87
5.1.1 Create the bid package 88
5.1.2 Create the BidMessageType record type 88
5.1.3 Create the BidRequest record class 88
5.1.4 Create the AllBidsMessageType record type 89
5.1.5 Create the AllBidsReply record class 90
5.1.6 Create the BidRequestCommand class 90
5.1.7 Create the AllBidsReplyCommand class 94
5.1.8 Create the BidsNavigator class 98
5.2 Test the MQ connection 102
5.2.1 Create a TestBidsNav test application 102
5.2.2 Run TestBidsNav to test the MQ connection 104
5.2.3 Create a version of the bid package 105
5.3 Generate the bid servlet and generic user interface files 105
5.3.1 Prepare to generate 105
5.3.2 Generate the bid servlet,HTML,and JSP files 106
5.4 Customize the bid servlet 107
5.5 Publish the bid servlet on the test stage 108
5.6 Test the bid servlet in the WebSphere Test Environment 108
5.6.1 Start the WebSphere Test Environment 108
5.6.2 Run the Servlet Engine 109
5.6.3 Run the servlet 109
5.7 Publish the bid servlet on the server 110
5.7.1 Modify the servlet configuration file 111
5.7.2 Modify the user interface files 111
5.7.3 Publish the bid files on the server 112
5.7.4 Check the WebSphere Application Server classpath 113
5.7.5 Provide permissions for the published files 113
5.8 Test the bid servlet from a Web browser 114
CHAPTER 6 CREATE THE ACCEPT SERVLET 116
6.1 Create Java beans to exchange MQSeries messages 118
6.1.1 Create the accept package 119
6.1.2 Create the AcceptMessageType record type 119
6.1.3 Create the AcceptRequestMessage record class 120
6.1.4 Create the BothConfMessage record type 121
6.1.5 Create the BothConfReply record class 121
6.1.6 Create the AcceptRequestCommand class 122
6.1.7 Create the BothConfReplyCommand class 124
6.1.8 Create the AcceptNavigator class 126
6.2 Test the MQ connection 131
6.2.1 Create the TestAcceptNav class 131
6.2.2 Run TestAcceptNav to test the MQ connection 133
6.2.3 Review what you have demonstrated 133
6.2.4 Create a version the accept package 134
6.3 Generate the accept servlet and generic user interface files 134
6.3.1 Getting the accept bean files into WebSphere Studio 134
6.3.2 Generate the accept servlet,HTML,and JSP files 135
6.4 Customize the accept servlet 136
6.5 Publish the accept servlet on the test stage 137
6.6 Test the accept servlet in the WebSphere Test Environment 137
6.7 Publish the accept servlet on the server 139
6.7.1 Modify the servlet configuration file 139
6.7.2 Modify the user interface files 140
6.7.3 Publish the accept files on the server 141
6.7.4 Provide permissions for the published accept files 141
6.8 Test the accept servlet from a Web browser 141
6.9 Summary 143
CHAPTER 7 CREATE THE EMAIL SERVLET 144
7.1 Create the IMS beans 145
7.1.1 Create the package 145
7.1.2 Create a RecordType for the input message 145
7.1.3 Create a transaction input record bean 146
7.1.4 Create a RecordType for the output message 147
7.1.5 Create a transaction output record bean 148
7.1.6 Create a command class for the IMS transaction 149
7.2 Test the beans in the Websphere Test Environment 157
7.2.1 Create the test Java Server Page 157
7.2.2 Run the Java Server Page locally 158
7.3 Create the servlet and add email functionality 159
Part 3 Creating the Web application 162
CHAPTER 8 JOIN THE SERVLETS 164
8.1 Define a Web application in WebSphere Application Server 165
8.2 Provide the interactive flow 167
8.2.1 Create the opening page 168
8.2.2 Modify the order results page 169
8.2.3 Modify the order servlet configuration file 171
8.2.4 Modify the bid results page 172
8.2.5 Modify the bid servlet configuration file 175
8.2.6 Modify the accept results page 175
8.2.7 Modify the accept servlet configuration file 177
8.3 Modify the generated servlets to pass the data 177
8.3.1 Understanding the order servlet 178
8.3.2 Understanding the bid servlet 179
8.3.3 Modifying the accept servlet 180
8.4 Optionally,enhance the user interface 182
8.5 Considerations for developing your own Web applications 182
CHAPTER 9 TROUBLESHOOTING 184
APPENDIX A SERVER APPLICATIONS RERFERENCE INFORMATION 188
A.1 Message syntax 189
A.1.1 Bid messages 189
A.1.2 Accept messages 190
A.2 Server application quick reference 192