Accessing Process Engine Information

This section describes how to access information about the WebLogic Integration process engine. It includes the following topics:

Getting the Server Version

To get the server version, use the following com.bea.wlpi.server.serverproperties.ServerProperties method:

public com.bea.wlpi.common.VersionInfo getServerVersion(
) throws java.rmi.RemoteException

VersionInfo version = properties.getServerVersion();

Getting the Package Version

To get the package version that is supported by the server, use the following com.bea.wlpi.server.serverproperties.ServerProperties method:

public com.bea.wlpi.common.VersionInfo getPackageVersion(
) throws java.rmi.RemoteException

VersionInfo version = properties.getPackageVersion();

Getting the Template Definition Version

To get the template definition version supported by the server, use the following com.bea.wlpi.server.serverproperties.ServerProperties method:

public com.bea.wlpi.common.VersionInfo getTemplateDefinitionVersion(
) throws java.rmi.RemoteException

VersionInfo version = properties.getTemplateDefinitionVersion();

Getting Server Properties

To get server properties, use the following com.bea.wlpi.server.serverproperties.ServerProperties method:

public java.util.Properties getProperties(
) throws java.rmi.RemoteException

This method returns the server properties, including the Java system properties and any other defined properties.

Note: In a clustered environment, the remote inspection of Java system properties is of limited use, as the method request is directed to a server, based on the configured routing algorithm. The information returned by the method call varies, particularly if the systems in the cluster have unique specifications.

Properties props = properties.getProperties();

Using the Convenience Methods

The com.bea.wlpi.client.common.WLPI class provides a set of convenience methods for accessing server information. The following table summarizes these methods.

Example of Accessing Information About the Process Engine

This section provides an excerpt from the command-line administration client example showing how to access server properties.

An input stream is defined to communicate with the user, and the user is prompted to specify what action to perform. If the user selects the Server Properties option, the system gets the server and template definition versions, and uses the returned VersionInfo objects to obtain other information about the server and template definition, including the name, and major, minor, and build versions. In addition, the server property names and values are displayed.

/* Display Tool Title */
   System.out.print( "\n---  Command Line Administration v1.1  ---" );

/* Display the main menu and interact with user */
while( true ) {
/* Display the menu */
   System.out.println( "\n---             Main Menu            ---" );
   System.out.println( "\nEnter choice:" ); 
   System.out.println( "1) Organizations" );
   System.out.println( "2) Roles" );
   System.out.println( "3) Users" );
   System.out.println( "4) Security Realm" );
   System.out.println( "5) Business Operations" );
   System.out.println( "6) Event Keys" );
   System.out.println( "7) Business Calendars" );
   System.out.println( "8) EJB Catalog" );
   System.out.println( "9) Server Properties" );
   System.out.println( "Q) Quit" );
   System.out.print( ">> " );
      .
      .
      .

/**
 * Method that illustrates the Public API Methods available in the 
 * ServerProperties interface (no user interaction, display mode only).
 */
public static void mngServerProperties( ) {
   Properties serverSystemProperties;
   String answer;
		
   try {
      /* Prompt user to select if we need to display the System properties */
      if( ( answer = askQuestion( "\nList system properties (y/n)?" ) ) 
         == null ) {
         /* User cancelled the operation */
         System.out.println( "*** Cancelled" );
         return;
      }
			
      /* Parse the answer */
      boolean isListSysProperties = ( answer.equals( "y" ) || 
         answer.equals( "Y" ) );
      /* Display all the server properties and attributes */
      System.out.println( "\nServer Version:" );
			
      /* WLPI Public API Method */
      /* Retrieve server attributes */
      serverVersion = serverProperties.getServerVersion( );
			
      /* Display all available attributes in WLPI v1.2.1 */
      System.out.println( "- Release Name: " + serverVersion.getName( ) );
      System.out.println( "- Version: " + serverVersion + 
         " (Major=" + serverVersion.getMajorVersion( ) +
         " Minor=" + serverVersion.getMinorVersion( ) +
         " Build=" + serverVersion.getBuild( ) + ")" );
	
      /* Display all the template definition properties and attributes */
      System.out.println( "\nTemplate Definition version supported:" );

      /* WLPI Public API Method */
      /* Retrieve template definition attributes */
      serverDTDVersion = serverProperties.getTemplateDefinitionVersion( );
			
      /* Display all available attributes */
      System.out.println( "- Release Name: " + serverDTDVersion.getName( ) );
      System.out.println( "- Version: " + serverDTDVersion + 
         " (Major=" + serverDTDVersion.getMajorVersion( ) +
         " Minor=" + serverDTDVersion.getMinorVersion( ) +
         " Build=" + serverDTDVersion.getBuild( ) + ")" );

      if( isListSysProperties ) {
         System.out.println( "\nSystem Properties: " );
	
      /* WLPI Public API Method */
      /* Retrieve server system properties */
      serverSystemProperties = serverProperties.getProperties( );
	
      /* Loop to display all properties */
      for( Enumeration e = serverSystemProperties.propertyNames( );
         e.hasMoreElements( ); ) {
         String propertyName = e.nextElement( ).toString( );
         System.out.println( "- Name: '" + propertyName + "' Value: '" +
         serverSystemProperties.getProperty( propertyName ) + "'\n" );
      } 
   } 
}
   catch( Exception e ) {
      System.out.println( "*** Failed to retrieve properties" );
      System.err.println( e );
   }
   return;
}