You can list the business-level applications of a session so that you can complete further business-level application administration such as deleting a business-level application. A business-level application is an administrative model that captures the definition of an enterprise-level application so that you can perform specific business functions, such as accounting.
Before you can list business-level applications of a session, you must have created an empty business-level application.
You can list business-level applications of a session using programming, the administrative console, or the wsadmin tool. This topic describes how to list business-level applications using programming.
List all the business-level applications of a session unless you set the blatID parameter to specify the business-level application that you want to list. You can optionally list the business-level applications with a description for those that have a description if you set the includeDescription parameter to true. After you list the business-level applications, you can use the information to do further administration, such as starting or deleting business-level applications.
Perform the following tasks to list business-level applications of a session using programming.
After you successfully run the code, a list of business-level applications for a session is displayed.
The following example shows how to list the business-level applications of a session based on the previous steps. Some statements are split on multiple lines for printing purposes.
package com.ibm.ws.management.application.task; import java.util.Properties; import com.ibm.websphere.management.AdminClient; import com.ibm.websphere.management.AdminClientFactory; import com.ibm.websphere.management.Session; import com.ibm.websphere.management.cmdframework.AdminCommand; import com.ibm.websphere.management.cmdframework.CommandMgr; import com.ibm.websphere.management.cmdframework.CommandResult; import com.ibm.websphere.management.async.client.AsyncCommandClient; public class ListBLAs { public static void main(String[] args) { try { // Connect to the application server. // This step is optional if you use the local // command manager. Comment out the lines to and including // CommandMgr cmdMgr = CommandMgr.getClientCommandMgr( // soapClient); // to get the soapClient soap client if you use the local // command manager. String host = "localhost"; String port = "8880"; // Change to your port number if // it is not 8880. Properties config = new Properties(); config.put(AdminClient.CONNECTOR_HOST, host); config.put(AdminClient.CONNECTOR_PORT, port); config.put(AdminClient.CONNECTOR_TYPE, AdminClient.CONNECTOR_TYPE_SOAP); System.out.println("Config: " + config); AdminClient soapClient = AdminClientFactory.createAdminClient(config); // Create the command manager. CommandMgr cmdMgr = CommandMgr.getClientCommandMgr(soapClient); // Comment out the previous lines to create a client command // manager if you are using a local command manager. // Uncomment the following line to create a local command // manager: // // CommandMgr cmdMgr = CommandMgr.getCommandMgr(); System.out.println("\nCreated command manager"); // Optionally create an asynchronous command handler. // Comment out the following line if no further handling // of command notification is required: AsyncCmdTaskHandler listener = new AsyncCmdTaskHandler(); // Create an asynchronous command client. // Set up the session. String id = Long.toHexString(System.currentTimeMillis()); String user = "content" + id; Session session = new Session(user, true); // If no command handler is used, replace listener with // null for the AsyncCommandClient object. AsyncCommandClient asyncCmdClientHelper = new AsyncCommandClient(session, listener); System.out.println("\nCreated async command client"); // Create the command that lists the business-level applications. String cmdName = "listBLAs"; AdminCommand cmd = cmdMgr.createCommand(cmdName); cmd.setConfigSession(session); // list all the business-level applications // using the session created. System.out.println("\nCreated " + cmdName); // Optionally set the blaID parameter. // Uncomment the following code to set the blaID parameter to // only list the business-level applications with the ID specified. Otherwise all // business-level applications are listed. Change the blaID parameter according // to your scenario. // Examples of valid formats for the blaID parameter are: // - bName // - blaname=bName // - WebSphere:blaname=bName // All business-level applications that match the ID specification // are listed. The ID must include at least the business-level // application name. // String blaID = "bla1"; // cmd.setParameter("blaID", blaID); //System.out.println("\nSet blaID parameter to " // + cmd.getParameter("blaID")); // Optionally include a description by setting // the includeDescription parameter to true instead of false. String includeDescription = "true"; cmd.setParameter("includeDescription", includeDescription); System.out.println("\nSet includeDescription parameter to " + cmd.getParameter("includeDescription")); // Call the asynchronous client helper to process parameters. try { asyncCmdClientHelper.processCommandParameters(cmd); System.out.println("\nCompleted process command " + "parameters"); } catch (Throwable th) { System.out.println("Failed from " + "asyncCmdClientHelper.processCommandParameters(cmd)."); th.printStackTrace(); System.exit(-1); } // Run the command to list business-level applications. asyncCmdClientHelper.execute(cmd); System.out.println("\nCompleted running of the command"); // Check the command result. CommandResult result = cmd.getCommandResult(); if (result != null) { if (result.isSuccessful()) { System.out.println("\nCommand ran successfully " + "with result\n" + result.getResult()); } else { System.out.println("\nCommand ran with " + "Exception"); result.getException().printStackTrace(); } } } catch (Exception e) { e.printStackTrace(); } } } package com.ibm.ws.management.application.task; import com.ibm.websphere.management.cmdframework.provider.CommandNotification; import com.ibm.websphere.management.async.client.AsyncCommandHandlerIF; public class AsyncCmdTaskHandler implements AsyncCommandHandlerIF { public void handleNotification(CommandNotification notification) { // Add your own code here to handle the received notification System.out.println("\nEXAMPLE: notification received: " + notification); } }
You can complete other tasks associated with business-level applications, such as deleting, starting, or stopping business-level applications.
In this information ...Related concepts
Related tasks
| IBM Redbooks, demos, education, and more(Index) |