IBM®
Skip to main content
    United States change      Terms of use
 
 
Select a scope:    
     Home      Products      Services & industry solutions      Support & downloads      My account     
alphaWorks  >  Java technology  >  

Web Services for DB2 Cube Views

Web services that allow client applications to perform basic online analytical processing (OLAP) over the Web, using XML and XPath.


Date Posted: June 27, 2003
Overview Requirements DownloadFAQsForum Reviews

1. How do I interact with Web Services for DB2 Cube Views?
2. Should I use Apache TOMCAT or IBM WebSphere Application Server?
3. What are the limitations?
4. I have TOMCAT installed correctly, but the installation of the Web service on this platform failed. What should I do?
5. I have succesfully installed the Web services on TOMCAT, but when I run one of the Web service methods, I get the following:
[SERVER SOAPException] The call failed:
Fault Code = SOAP-ENV:Server.BadTargetObjectURI
Fault String = Unable to resolve target object: cubeviews.ws.AuroraWeb
Fault URI = /soap/servlet/rpcrouter
Why?
6. I have succesfully installed the Web services on either TOMCAT or WebSphere, but when I run one of the Web service methods, I get the following:
    <errorMessage>[DATABASE] [IBM][CLI Driver][DB2/NT] SQL0101N The statement is too long or too complex. SQLSTATE=54001 [SQLSTATE] 54001</errorMessage>
    Why?
    7. Is Web Services for DB2 Cube Views 8.2 backward compatible?
    8. Why do I get an error similar to the following:
    "<errorMessage>[XPATH] javax.xml.transform.TransformerException: Extra illegal tokens: 'Sales'</errorMessage>"
    when I invoke one of the API methods with an XPath expression (for example, the name of a cube model, dimension, or attribute, such as "Daily Sales") that contains embedded white space?
    1. How do I interact with Web Services for DB2 Cube Views?
    2. Should I use Apache TOMCAT or IBM WebSphere Application Server?
    3. What are the limitations?
    4. I have TOMCAT installed correctly, but the installation of the Web service on this platform failed. What should I do?
    5. I have succesfully installed the Web services on TOMCAT, but when I run one of the Web service methods, I get the following:
    [SERVER SOAPException] The call failed:
    Fault Code = SOAP-ENV:Server.BadTargetObjectURI
    Fault String = Unable to resolve target object: cubeviews.ws.AuroraWeb
    Fault URI = /soap/servlet/rpcrouter
    Why?
    6. I have succesfully installed the Web services on either TOMCAT or WebSphere, but when I run one of the Web service methods, I get the following:
      <errorMessage>[DATABASE] [IBM][CLI Driver][DB2/NT] SQL0101N The statement is too long or too complex. SQLSTATE=54001 [SQLSTATE] 54001</errorMessage>
      Why?
      7. Is Web Services for DB2 Cube Views 8.2 backward compatible?
      8. Why do I get an error similar to the following:
      "<errorMessage>[XPATH] javax.xml.transform.TransformerException: Extra illegal tokens: 'Sales'</errorMessage>"
      when I invoke one of the API methods with an XPath expression (for example, the name of a cube model, dimension, or attribute, such as "Daily Sales") that contains embedded white space?
      1. How do I interact with Web Services for DB2 Cube Views?
      2. Should I use Apache TOMCAT or IBM WebSphere Application Server?
      3. What are the limitations?
      4. I have TOMCAT installed correctly, but the installation of the Web service on this platform failed. What should I do?
      5.
      I have succesfully installed the Web services on TOMCAT, but when I run one of the Web service methods, I get the following:
      [SERVER SOAPException] The call failed:
      Fault Code = SOAP-ENV:Server.BadTargetObjectURI
      Fault String = Unable to resolve target object: cubeviews.ws.AuroraWeb
      Fault URI = /soap/servlet/rpcrouter
      Why?
      6. I have succesfully installed the Web services on either TOMCAT or WebSphere, but when I run one of the Web service methods, I get the following:
        <errorMessage>[DATABASE] [IBM][CLI Driver][DB2/NT] SQL0101N The statement is too long or too complex. SQLSTATE=54001 [SQLSTATE] 54001</errorMessage>
        Why?
        7. Is Web Services for DB2 Cube Views 8.2 backward compatible?
        8. Why do I get an error similar to the following:
        "<errorMessage>[XPATH] javax.xml.transform.TransformerException: Extra illegal tokens: 'Sales'</errorMessage>"
        when I invoke one of the API methods with an XPath expression (for example, the name of a cube model, dimension, or attribute, such as "Daily Sales") that contains embedded white space?
        1. How do I interact with Web Services for DB2 Cube Views?
        2. Should I use Apache TOMCAT or IBM WebSphere Application Server?
        3. What are the limitations?
        4. I have TOMCAT installed correctly, but the installation of the Web service on this platform failed. What should I do?
        5.
        I have succesfully installed the Web services on TOMCAT, but when I run one of the Web service methods, I get the following:
        [SERVER SOAPException] The call failed:
        Fault Code = SOAP-ENV:Server.BadTargetObjectURI
        Fault String = Unable to resolve target object: cubeviews.ws.AuroraWeb
        Fault URI = /soap/servlet/rpcrouter
        Why?
        6. I have succesfully installed the Web services on either TOMCAT or WebSphere, but when I run one of the Web service methods, I get the following:
          <errorMessage>[DATABASE] [IBM][CLI Driver][DB2/NT] SQL0101N The statement is too long or too complex. SQLSTATE=54001 [SQLSTATE] 54001</errorMessage>
          Why?
          7. Is Web Services for DB2 Cube Views 8.2 backward compatible?
          8. Why do I get an error similar to the following:
          "<errorMessage>[XPATH] javax.xml.transform.TransformerException: Extra illegal tokens: 'Sales'</errorMessage>"
          when I invoke one of the API methods with an XPath expression (for example, the name of a cube model, dimension, or attribute, such as "Daily Sales") that contains embedded white space?
          1. How do I interact with Web Services for DB2 Cube Views?
          2. Should I use Apache TOMCAT or IBM WebSphere Application Server?
          3. What are the limitations?
          4. I have TOMCAT installed correctly, but the installation of the Web service on this platform failed. What should I do?
          5. I have succesfully installed the Web services on TOMCAT, but when I run one of the Web service methods, I get the following:
          [SERVER SOAPException] The call failed:
          Fault Code = SOAP-ENV:Server.BadTargetObjectURI
          Fault String = Unable to resolve target object: cubeviews.ws.AuroraWeb
          Fault URI = /soap/servlet/rpcrouter
          Why?
          6. I have succesfully installed the Web services on either TOMCAT or WebSphere, but when I run one of the Web service methods, I get the following:
            <errorMessage>[DATABASE] [IBM][CLI Driver][DB2/NT] SQL0101N The statement is too long or too complex. SQLSTATE=54001 [SQLSTATE] 54001</errorMessage>
            Why?
            7. Is Web Services for DB2 Cube Views 8.2 backward compatible?
            8. Why do I get an error similar to the following:
            "<errorMessage>[XPATH] javax.xml.transform.TransformerException: Extra illegal tokens: 'Sales'</errorMessage>"
            when I invoke one of the API methods with an XPath expression (for example, the name of a cube model, dimension, or attribute, such as "Daily Sales") that contains embedded white space?


            1. How do I interact with Web Services for DB2 Cube Views?

            Web Services for DB2 Cube Views is an XML SOAP application and can be accessed regardless of the platform or programming language you use. In order to interact with the Web Services for DB2 Cube Views provider, you will have to create a SOAP client using the the WSDL of the Web service. This WSDL is included in the package.

            Since this operation requires strong knowledge of programming language and Web service architecture, the package also includes an "out-of-the-box" solution in the form of an HTML front end. We encourage you to use this front end to become familiar with the Web service. Please refer to the documentation for information on how to install and use this front end.

            Back to top Back to top

            2. Should I use Apache TOMCAT or IBM WebSphere Application Server?

            It depends on whether or not you already have one of them installed. The installation on Apache TOMCAT is fairly more complex than on IBM WebSphere; because most of the prerequisite libraries are not shipped with Apache TOMCAT, you will need to get those prerequisites in a separate download. On the other hand, Apache TOMCAT is a lighter solution. It requires significantly fewer resources in terms of memory usage and disk space, and it is available for free downloading. You can also get a free evaluation copy of WebSphere Application Server 5.0.

            Back to top Back to top

            3. What are the limitations?

            Web Services for DB2 Cube Views doesn't fully support IBM DB2 Cube Views, and only a subset of the XPath query language is supported. The restrictions are detailed below:
            • Only a subset of the XPath language is supported for the methods members and execute. Refer to the samples queries and the documentation to find the precise syntax.
            • The XML attribute schema is not supported; in consequence, all elements of the metadata must use the same schema, and two elements at the same level (for example, two cubeDimensions of the same cube) cannot have the same name.
            • Only balanced hierarchies with a standard deployment are supported.
            • Only symmetric measures are supported; that is to say, only measures with one aggregation and one template are supported.

            Back to top Back to top

            4. I have TOMCAT installed correctly, but the installation of the Web service on this platform failed. What should I do?

            The installation of the Web Service on TOMCAT can fail for many reasons:
            • Are you using the good version of TOMCAT (at least 4.1 is required)?
            • Do you have the following environment variables defined correctly:
              • CATALINA_HOME (TOMCAT main directory)
              • JAVA_HOME (JDK 1.4.1 main directory)
              • PATH contains %JAVA_HOME%\bin;%JAVA_HOME%\jre\bin
            • Do you have all the needed libraries? During the installation, the Web service is deployed on a SOAP router. To run it correctly, you must have the following libraries (Assuming TOMCAT is installed on C:\Tomcat):
              • C:\Tomcat\shared\lib\xercesImpl.jar
                C:\Tomcat\shared\lib\xml-apis.jar
                C:\Tomcat\common\lib\activation.jar;
                C:\Tomcat\common\lib\mail.jar;
                C:\Tomcat\shared\lib\soap.jar
            • Is TOMCAT running? This is necessary in order to deploy the Web service on the Web router.
            • Do you get the following error?
              • [SOAPException: faultCode=SOAP-ENV:Client; msg=Error opening socket: Connection refused ...]
              Then either TOMCAT is not running or else the URL of the SOAP router is incorrect. The script uses "http://localhost:8080/soap/servlet/rpcrouter".

            Back to top Back to top

            5. I have succesfully installed the Web services on TOMCAT, but when I run one of the Web service methods, I get the following:
            [SERVER SOAPException] The call failed:
            Fault Code = SOAP-ENV:Server.BadTargetObjectURI
            Fault String = Unable to resolve target object: cubeviews.ws.AuroraWeb
            Fault URI = /soap/servlet/rpcrouter
            Why?

            This exception may occur if TOMCAT's classpath doesn't have ws4cube-api.jar. During the installation, this library is copied to $CATALINA_HOME\shared\lib, but since the classpath loading is static, you must restart TOMCAT in order to commit the classpath change.

            Back to top Back to top

            6. I have succesfully installed the Web services on either TOMCAT or WebSphere, but when I run one of the Web service methods, I get the following:
              <errorMessage>[DATABASE] [IBM][CLI Driver][DB2/NT] SQL0101N The statement is too long or too complex. SQLSTATE=54001 [SQLSTATE] 54001</errorMessage>
            Why?

            This is caused by the limited size of STMTHEAP in the database configuration. Use the command "db2 get db cfg" to view the existing size of STMTHEAP. Use "db2 update db cfg using STMTHEAP <new size>" to increase the size of STMTHEAP (recommended at 10240).

            Back to top Back to top

            7. Is Web Services for DB2 Cube Views 8.2 backward compatible?

            No, it is not. Please download Web Services for DB2 Cube Views 8.1 if the 8.1 versions of DB2 and DB2 Cube Views are used.

            Back to top Back to top

            8. Why do I get an error similar to the following: "<errorMessage>[XPATH] javax.xml.transform.TransformerException: Extra illegal tokens: 'Sales'</errorMessage>" when I invoke one of the API methods with an XPath expression (for example, the name of a cube model, dimension, or attribute, such as "Daily Sales") that contains embedded white space?

            The XPath expressions currently supported by the Web Services for DB2 Cube Views do not accept white space and other special characters within an expression. Cube Model entities named with characters such as blank spaces or parentheses must be edited so that they contain alphanumeric characters only. A modified CVSample cube model (WSCVSample) has been provided with this installation as a working example.

            Back to top Back to top
            Download now Download now

            Related technologies

            For platform(s):
            Java, Windows

            For topics:
            analysis, business intelligence, Cube Views, XPath, SQL, relational


            Related resources

            DB2 Cube Views

            The OLAP-aware database

            developerWorks Web services zone

             

                About IBM Privacy Contact