Running the example application

Edit online

You can run the example application in two ways: you can use the BMS interface, and you can use a Web client.

Before you begin

Running the example application with the BMS interface

Edit online

The base application can be invoked using its BMS interface.

Procedure

  1. Enter transaction EGUI from a CICS terminal.

    The example application displays the following menu:
    
CICS EXAMPLE CATALOG APPLICATION  - Main Menu                               
                                                                            
Select an action, then press ENTER                                          
                                                                            
Action . . . .     1. List Items                                            
                   2. Order Item Number ____                                
                   3. Exit                                                  
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
                                                                            
F3=EXIT    F12=CANCEL

    The options on the menu enable you to list the items in the catalog, order an item, or exit the application.

  2. Type 1 and press ENTER to select the LIST ITEMS option.
    The application displays a list of items in the catalog.
    
CICS EXAMPLE CATALOG APPLICATION  - Inquire Catalog                
                                                                   
Select a single item to order with /, then press ENTER             
                                                                   
Item    Description                                 Cost   Order   
-----------------------------------------------------------------  
0010    Ball Pens Black 24pk                        2.90     /     
0020    Ball Pens Blue 24pk                         2.90     _     
0030    Ball Pens Red 24pk                          2.90     _     
0040    Ball Pens Green 24pk                        2.90     _     
0050    Pencil with eraser 12pk                     1.78     _     
0060    Highlighters Assorted 5pk                   3.89     _     
0070    Laser Paper 28-lb 108 Bright 500/ream       7.44     _     
0080    Laser Paper 28-lb 108 Bright 2500/case     33.54     _     
0090    Blue Laser Paper 20lb 500/ream              5.35     _     
0100    Green Laser Paper 20lb 500/ream             5.35     _     
0110    IBM Network Printer 24 - Toner cart       169.56     _     
0120    Standard Diary: Week to view 8 1/4x5 3/4   25.99     _     
0130    Wall Planner: Eraseable 36x24              18.85     _     
0140    70 Sheet Hard Back wire bound notepad       5.89     _     
0150    Sticky Notes 3x3 Assorted Colors 5pk        5.35     _     
                                                                   
                                                                   
F3=EXIT    F7=BACK   F8=FORWARD   F12=CANCEL
  3. Type / in the ORDER column, and press ENTER to order an item.
    The application displays details of the item to be ordered.
    
CICS EXAMPLE CATALOG APPLICATION  - Details of your order                      
                                                                               
Enter order details, then press ENTER                                          
                                                                               
Item    Description                                 Cost    Stock    On Order  
-----------------------------------------------------------------------------  
0010    Ball Pens Black 24pk                        2.90     0011        000   
                                                                               
                                                                               
                                                                               
                                                                               
        Order Quantity: 5                                                      
             User Name: CHRISB                                                 
           Charge Dept: CICSDEV1                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
F3=EXIT    F12=CANCEL
  4. If there is sufficient stock to fulfil the order, enter the following information.
    1. Complete the ORDER QUANTITY field.
      Specify the number of items you want to order.
    2. Complete the USERID field.
      Enter a 1 to 8-character string. The base application does not check the value that is entered here.
    3. Complete the CHARGE DEPT field.
      Enter a 1 to 8-character string. The base application does not check the value that is entered here.
  5. Press ENTER to submit the order and return to the main menu.
  6. Select the EXIT option to end the application.

The Web service enabled application

Edit online

You can invoke the example application from a Web browser.

Procedure

  1. Enter the following in your Web browser: http://myserver:9080/ExampleAppClientWeb/, where myserver is the host name of the server on which the Web service client is installed.

    The example application displays the page shown in Figure 1.
    Figure 1. Welcome Page for the CICS Example Application
    WELCOME page for the CICS Example Application
  2. Click the INQUIRE button.
    The example application displays the page shown in Figure 2.
    Figure 2. Inquire Page for the CICS Example Application
    INQUIRE page for the CICS Example Application
  3. Enter an item number, and click the SUBMIT button.
    Tip: The base application is primed with item numbers in the sequence 0010, 0020, ... through 0210.
    The example application displays the page shown in Figure 3, which contains a list of items in the catalog, starting with the item number that you entered.
    Figure 3. List Items Page for the CICS Example Application
    LIST ITEMS page for the CICS Example Application
  4. Select the item that you want to order.
    1. Click the radio button in the Select column for the item you want to order.
    2. Click the SUBMIT button.
    The example application displays the page shown in Figure 4:
    Figure 4. Order Details Page for the CICS Example Application
    ORDER DETAILS page for the CICS Example Application
  5. To place an order, enter the following information.
    1. Complete the Quantity field.
      Specify the number of items you want to order.
    2. Complete the User Name field.
      Enter a 1 to 8-character string. The base application does not check the value that is entered here.
    3. Complete the Department Name field.
      Enter a 1 to 8-character string. The base application does not check the value that is entered here.
    4. Click the SUBMIT button.
    The example application displays the page shown in Figure 5 to confirm that the order has been placed:
    Figure 5. Order Confirmation Page for the CICS Example Application
    ORDER CONFIRMATION page for the CICS Example Application