This section provides a list of sample programs and notes on running the sample program. The list of sample programs is divided into two lists such as 1) List including types of Enterprise Bean and overview of operations and 2) List including available technologies, resources and mode of operations.

Note

For Enterprise Bean sample programs use the version, or the revision of the product in use. Operations of old version or old revision sample programs are not guaranteed.

(a) List of sample programs (types of Enterprise Bean and operation contents)

Table M-1 List of sample programs (types of Enterprise Bean and operation contents)

Legends:

N: Not applicable

#: EAR file (converter.ear) with the compiled and archived jsptag sample is also provided

(b) List of sample programs (connected resources and types of clients)

The following table describes the list of sample programs, connected resources, and types of clients. Note that the sample program uses the 1.4 mode as the J2EE server start mode.

Table M-2 List of sample programs (Connected resources and types of clients)

Legend:

Y: Applicable

N: Not applicable

#1 There are required settings for each resource to be connected. For the applicable details on the connected resources, see Appendix M.2(1)(c) Setting the database used in sample programs, Appendix M.2(1)(d) Setting the mails used in sample programs or Appendix M.2(1)(e) Setting JMS used in sample programs.

#2 Execution methods change according to the type of client. For details, see Appendix M.2(1)(f) Types of the clients of sample programs.

(c) Setting the database used in sample programs

This section describes the settings of the database used in sample programs.

Use the database as a resource in sample programs marked as "Y" in the "Database" column of Table M-2. Ensure the proper setting of the database and database connectivity before running sample programs.

You can use Oracle or HiRDB as the database.

The required settings are as follows:

• While using HiRDB, enable the specification of foreign key (limited reference).
  For the method of setting the database, see the HiRDB Installation and Design Guide.
  
• Execute the "createTable_Oracle.sql" (for Oracle) or the "createTable_HiRDB.sql" (for HiRDB) provided in the sample, in accordance with the available database types, and initialize the tables in the database. When using HiRDB, the "createTable_HiRDB.sql" fails to execute if the specification of a foreign key (limited reference) is disabled.
• Set DB Connector with the server management commands
  We recommend that you use DBConnector_Oracle_CP.rar or DBConnector_HiRDB_Type4_CP.rar for DB Connector. If DBConnector_Oracle_XA.rar or DBConnector_HiRDB_Type4_XA.rar is used, disable the write transaction functionality; then start the J2EE server, and set DB Connector. Specify true for the ejbserver.distributedtx.XATransaction.enabled key of the usrconf.properties to disable the write transaction functionality.
  
• Resolve the link of the resources as and when required.
  Resolve the link with the Cosminexus application property file "cosminexus.xml" provided in the sample. Specify the resource display name in the <resource-ref> tag of "cosminexus.xml" and set with the server management command. Deploy the application after resolving the link of the resources.
  
• In the "product" and "cmp20product" of sample programs, "user1" is set in the <schema-name> tag of "cosminexus.xml". Depending on the database environment used, change to an appropriate value and then deploy the application.
• While using HiRDB to execute the "teller" of sample programs, rewrite the location with the specification of the date function in TellerEJB.java file and compile for HiRDB.

(d) Setting the mails used in sample programs

This section describes the settings of the mail used in sample programs.

Use mail as a resource in sample programs marked as "Y" in the "Mail" column of Table M-2. Ensure the proper connection to the mail server before executing sample programs.

Following settings are required:

• Incoming mail addresses must be coded in the source file (ConfirmerClient.java) of EJB client application. Rewrite the appropriate incoming mail addresses in this location, and then compile.
• Mail configuration must be set with the server management commands. For instructions on the usage of the server management command, see 6.3 Setting the mail configuration in the uCosminexus Application Server Application Setup Guide.
• Resolve the link to resources. However, the link need not be resolved if the display name of mail configuration is defined as "Cosminexus_SMTP_Server". Resolve the link if any other display name is defined.
  Resolve the link with the Cosminexus application property file "cosminexus.xml" provided in the sample. Specify the resource display name in <resource-ref> tag of "cosminexus.xml" and set with the server management command. Deploy the application after resolving the link of the resources.
  

(e) Setting JMS used in sample programs

This section describes the settings of JMS used in sample programs.

Use JMS as a resource in sample programs marked as "Y" in the "JMS" column of Table M-2. Ensure the proper connection to JMS before running sample programs.

Required settings are as follows:

• Install TP1/Message Queue - Access in advance to use TP1/Message Queue - Access as JMS. Also prepare OpenTP1 and TP1/Message Queue server runtime environment in advance.
• Set up the TP1/Message Queue - Access with the server management commands.
  Disable the write transaction functionality, then start the J2EE server, and set TP1/Message Queue - Access. Specify true in the ejbserver.distributedtx.XATransaction.enabled key of usrconf.properties to disable the write transaction functionality.
  Set the transaction support level of TP1/Message Queue - Access to "XATransaction".
  
• Resolve the link of resources. However, the link need not be resolved if the default display name of TP1/Message Queue - Access is not changed and "QUEUE1" is defined as the display name in the queue definition file. You must resolve the link if the default display name of TP1/Message Queue - Access is changed and "QUEUE1" queue is not defined as the display name in the queue definition file.
  Resolve the link by using the Cosminexus application property file "cosminexus.xml" provided in the sample. Specify the resource display name in the <resource-ref> tag, <resource-env-ref> tag and <message-ref> tag of "cosminexus.xml", and set with the server management command. Deploy the application after resolving the link to resources.
  

(f) Types of the clients of sample programs

Client of sample programs comprises of 2 types of applications such as EJB client application and the application displayed on Web browser.

• The sample programs marked as "Y" in the "EJB client application" column of Table M-2 are EJB client applications. Use "testClient.bat" provided as a sample to start the client application.
• Sample programs marked as "Y" in "Web browser" column of Table M-2 are Web applications that operate from the Web browser. If you want to operate the application from the client, start the Web browser and specify the following URL:
  

   
  http://Machin- name : Port number/ContextRoot/Target file
   

  For example, in case of sample "adder" operating on the local host, specify as follows:
  

   
  http://localhost/adder/adder_war/adder.html
   

This subsection shows the sample execution example, with the example of converter. The converter is the program for calling Enterprise Bean from Java application of the client. This program does not use the resources such as the database. When you want to use the resources, you must follow the procedure mentioned here, and prepare the resources accessible environment. For the details on setting the resources, see 3.3 Resource connection in the uCosminexus Application Server Common Container Functionality Guide.

(a) Overview of the converter

The converter converts the currency from Dollar to Yen, and from Yen to Euro. Following figure shows the configuration of the converter:

Figure M-1 Configuration of the converter

(b) Compiling

Use batch files (compileBean.bat and compileClient.bat) provided in the sample to compile Enterprise Bean and the client. These batch files create an application (.ear file).

C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\converter
C:\Program Files\Hitachi\Cosminexus\CC\...\converter>compileBean
C:\Program Files\Hitachi\Cosminexus\CC\...\converter>
C:\Program Files\Hitachi\Cosminexus\CC\...\converter>compileClient
C:\Program Files\Hitachi\Cosminexus\CC\...\converter>

(c) Setting the J2EE server

See Appendix M.1(1) Setting the J2EE server.

(d) Customizing the J2EE server

See Appendix M.1(2) Customizing the J2EE server.

(e) Starting the J2EE server

See Appendix M.1(3) Starting the J2EE server.

(f) Deploying the application

Use the batch file (deployApp.bat) provided in the sample to deploy the application. This batch file imports the application into the J2EE server, sets and starts the application, and acquires EJB stub as well as interface file.

Process executed by this batch file is as follows:

• Importing, setting, starting, and listing the application
  For execution contents, see Appendix M.1(5) Importing, setting and starting the application.
  
• Acquiring Enterprise Bean stub and interface file
  Acquire Enterprise Bean stub and the interface file with the cjgetsubsjar command.
  

(g) Executing the application

Use the batch file (testClient.bat) provided in the sample to execute the application. Execution is successful if the following message appears on the Start console window of the EJB client application after execution

C:\>cd C:\Program Files\Hitachi\Cosminexus\CC\examples\ ejb\ejb20\converter
C:\Program Files\Hitachi\Cosminexus\CC\examples\ ejb\ejb20\converter>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\Hitachi\Cosminexus\CC\examples\ 
ejb\ejb20\converter, PID = 3684)
12160.0
0.77
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
C:\Program Files\Hitachi\Cosminexus\CC\examples\ ejb\ejb20\converter>

(h) Undeploying the application

See Appendix M.1(6) Stopping and deleting the application.

(i) Stopping the J2EE server

See Appendix M.1(7) Stopping the J2EE server.

This section gives an overview and describes the examples of the configuration and execution of Enterprise Bean (2.0) sample. For required settings, see Appendix M.2(1)(b) List of sample programs (connected resources and types of clients).

(a) Overview of the account

The account calculates the balance according to deposits and withdrawals, and updates the bank account table. The following figure shows the configuration of the account:

Figure M-2 Configuration of account

Following is the execution example of the account:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\account>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\Hitachi\Cosminexus\CC\examples\ 
ejb\ejb20\account, PID = 3684)
balance = 68.25
balance = 32.55
456: 44.77
730: 19.54
268: 100.07
456: 44.77
836: 32.55
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\account>

(b) Overview of the adder

The adder calculates the total of the numerical values entered from the browser. Following figure shows the configuration of the adder:

Figure M-3 Configuration of adder

To execute, start the browser, and specify the following string in the URL:

http://Machine name : Port number/ContextRoot/adder.html

If the in-process HTTP server is available, the following URL is specified by default:

http://localhost/adder/adder_war/adder.html

Following is the execution example of adder:

Figure M-4 Execution example of adder

(c) Overview of the bank

The bank transfers the funds from current account to savings account and manages the funds in the database. At the time of transferring the funds, the bank updates the corresponding Current account table and Savings account table. The following figure shows the configuration of the bank:

Figure M-5 Configuration of bank

Following is the execution example of the bank:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\bank>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\Hitachi\Cosminexus\CC\examples\ 
ejb\ejb20\bank, PID = 3684)
checking: 60.0
saving: 540.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\bank>

(d) Overview of the cart

This is a shopping cart to purchase books. If you place 3 books in the cart, and then try to take out a book not existing in the cart, the process generates a "BookException". Following figure shows the configuration of the cart:

Figure M-6 Configuration of the cart

Following is the execution example of the cart.

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\cart>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\Hitachi\Cosminexus\CC\examples\ 
ejb\ejb20\cart, PID = 3684)
The Martian Chronicles
2001 A Space Odyssey
The Left Hand of Darkness
Caught a BookException: Alice in Wonderland not in cart.
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\cart>

(e) Overview of the checker

The checker calculates the amount after discount on the basis of discount rate, when the amount to be discounted exceeds a particular limit. The checker also specifies the discounted amount and discount rate in Enterprise Bean environment entry. The following figure shows the configuration of the checker:

Figure M-7 Configuration of checker

Following is the execution example of Checker:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\checker>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\Hitachi\Cosminexus\CC\examples\ 
ejb\ejb20\checker, PID = 3684)
discount = 4200.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\checker>

(f) Overview of cmp20product

The cmp20product registers the product information in the database, and searches the information of registered products. This sample uses CMP 2.0 type Enterprise Bean. Following figure shows the configuration of the cmp20product:

Figure M-8 Configuration of cmp20product

The cmp20product execution example is as follows:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\cmp20product>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\cmp20product, PID = 3684)
Ceramic Dog: 10.0
Ceramic Dog: 14.0
Chrome Fish: 22.0
999: Ivory Cat 19.0
789: Ivory Cat 33.0
123: 14.0
456: 13.0
999: 19.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\cmp20product>

(g) Overview of the confirmer

The confirmer sends a confirmation mail regarding the order of products. Following figure shows the configuration of the confirmer:

Figure M-9 Configuration of confirmer

Following is the execution example of client (mail sender) of the confirmer:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\confirmer>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\Hitachi\Cosminexus\CC\examples\ 
ejb\ejb20\confirmer, PID = 3684)
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\confirmer>

After the execution of the client, the mail is sent to the address specified in ConfirmerClient.java. An example of the sent mail is as follows:

Subject:"Test Message from ConfirmerEJB"
Message:
Thank you for your order.
We received your order on 2002/03/18 12:35.

(h) Overview of the converter

For the converter, see Appendix M.2(2) Enterprise Bean (EJB2.0) sample execution procedure.

(i) Overview of the enroller

The enroller adds students and subjects, registers the lectures, and updates the corresponding Students information table, Subject table and Lectures registration information table. Following figure shows the configuration of the enroller:

Figure M-10 Configuration of the enroller

Following is the execution example of enroller:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\enroller>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\enroller, PID = 3684)
Denise Smith:
220 Power J2EE Programming
333 XML Made Easy
777 An Introduction to Java Programming
 
An Introduction to Java Programming:
823 Denise Smith
456 Joe Smith
388 Elizabeth Willis
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\enroller>

(j) Overview of jsptag

jspstag converts the currency from Dollar to Yen and from Yen to Euro, and displays the currency conversion result on the browser with JSP. Following figure shows the configuration of the jsptag:

Figure M-11 Configuration of jsptag

To execute, start the browser and specify the following string in the URL:

http://Machine name: Port number/ContextRoot/Converter.jsp

If the in-process HTTP server is available, the following URL is specified by default:

http://localhost/jsptag/converter_war/Converter.jsp

Following example shows the method of executing jsptag:

Figure M-12 Execution example of jsptag

(k) Overview of jsptobean

jsptobean calculates the balance according to deposits and withdrawals, updates the database, and displays the balance on the browser with JSP. Following figure shows the configuration of jsptobean:

Figure M-13 Configuration of jsptobean

To execute, start the browser, and specify the following string in the URL:

http://Machine name: Port number/ContextRoot/Account.jsp

If the in-process HTTP server is available, the following URL is specified by default:

http://localhost/jsptobean/account_war/Account.jsp

Following is the execution example of jsptobean:

Figure M-14 Execution example of jsptobean

(l) Overview of localadder

localadder calculates the total of entered numerical values and displays the result on the browser. This sample calls Enterprise Bean from the servlet using the local interface. The following figure shows the configuration of localadder:

Figure M-15 Configuration of localadder

To execute, start the browser, and specify the following string in the URL:

http://Machine name : Port number/ContextRoot/adder.html

If the in-process HTTP server is available, the following URL is specified by default:

http://localhost/localadder/localadder_war/adder.html

The following example shows the method of executing localadder:

Figure M-16 Execution example of localadder

(m) Overview of the message

The message receives the message sent from Session Bean to JMS Queue by Message-driven Bean. The following figure shows the configuration of message:

Figure M-17 Configuration of message

Following is the execution example of the client of the message:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\message>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\message, PID = 3684)
sending message=MY MESSAGE
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\message>

After the execution of the client, the following message is displayed in the J2EE server startup console, if the message sending and receiving is completed successfully:

...
MessageBean: onMessage()
MessageBean: received message=MY MESSAGE
...

(n) Overview of the order

The order searches and displays the order number and corresponding product information, and manages the order numbers and the product information in the Order information table and the Product information table respectively. The following figure shows the configuration of the order:

Figure M-18 Configuration of order

Following is the execution example of the order:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\order>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\Hitachi\Cosminexus\CC\examples\ 
ejb\ejb20\order, PID = 3684)
about to create
123 1 p23 12.0
123 2 p67 89.0
123 3 p11 41.0
 
123
456
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\order>

(o) Overview of the product

The product registers the product information such as product name and price in the database, searches the information of registered products, and manages product information in the Product information table. The following figure shows the configuration of the product:

Figure M-19 Configuration of product

Following is the execution example of the product:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\product>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\product, PID = 3684)
Ceramic Dog: 10.0
Ceramic Dog: 14.0
Chrome Fish: 22.0
999: Ivory Cat 19.0
789: Ivory Cat 33.0
123: 14.0
456: 13.0
999: 19.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\product>

(p) Overview of salesrep

The salesrep adds customers, modifies the sales representative in-charge, and updates the database. It links two Enterprise Beans, searches and updates the Customer table and the Sales representative table. The following figure shows the configuration of salesrep:

Figure M-20 Configuration of salesrep

Following is the execution example of salesrep:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\salesrep>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\salesrep, PID = 3684)
customerId = 221
customerId = 388
customerId = 456
customerId = 844
 
987: Mary Jackson
221: Alice Smith
388: Bill Williamson
456: Joe Smith
844: Buzz Murphy
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\salesrep>

(q) Overview of the shipper

The shipper calculates the inventory of products against the order and updates the database. It calls the provision process if the inventory of the specified products is low. It links the two Enterprise Beans, and searches and updates the Product inventory information table. Following figure shows the configuration of the shipper:

Figure M-21 Configuration of the shipper

Following is the execution example of shipper:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\shipper>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\shipper, PID = 3684)
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\shipper>

After the execution of the shipper, the following message is displayed in the J2EE server startup console.

...
ShipperEJB: ejbCreate()
ShipperEJB: shipItem()
StockEJB: updateOnHand()
StockEJB: reorderNeeded()
...

(r) Overview of storagebin

The storagebin searches the parts information and the inventory from the database. It links the two Enterprise Beans, and searches the Parts information table and Parts inventory Information table. Following figure shows the configuration of the storagebin:

Figure M-22 Configuration of the storagebin

Following is the execution example of storagebin:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\storagebin>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\storagebin, PID = 3684)
777 388 500 1.0 Duct Tape
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\storagebin>

(s) Overview of the teller

The teller withdraws money from current account from a bank terminal and calculates the balance. It adds transaction details in the Deposits information table (bank terminal) and Transaction history information table in the database.

The following figure shows the configuration of the teller:

Figure M-23 Configuration of the teller

Following is the execution example of teller:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\teller>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\teller, PID = 3684)
checking = 500.0
checking = 440.0
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\teller>

(t) Overview of the warehouse

The warehouse updates the product inventory and the status of order received products. It also updates the Product information table and Inventory information table in the database. Following figure shows the configuration of the warehouse:

Figure M-24 Configuration of warehouse

Following is the execution example of the warehouse:

C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\warehouse>testClient
KDJE40053-I The cjclstartap command will now start. (directory for the 
user definition file = C:\Program Files\HITACHI\Cosminexus\CC\examples\ 
ejb\ejb20\warehouse, PID = 3684)
status = shipped
KDJE40054-I The cjclstartap command was stopped. (PID = 3684, exit status = 0)
 
C:\Program Files\Hitachi\Cosminexus\CC\examples\ejb\ejb20\warehouse>