Professional Documents
Culture Documents
Version 7.1.1
Installation Guide
Note Before using this information and the product it supports, read the information in Notices on page 47.
This edition applies to version 7, release 1, modification 1 of IBM Maximo for Oil and Gas and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright International Business Machines Corporation 2008, 2009. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.
Contents
Chapter 1. Installation overview . . . . 1 Chapter 2. Updating environment data
Updating database properties. . . Updating installation properties . . Updating the WebSphere Application Deployment host name . . . . .
. 3
. . . . . . 3 . . . . . . 4 Server Network . . . . . . 4
Loading organizations to the external system . . Loading sites to the external system . . . . . Loading locations to the external system. . . . Loading assets to the external system. . . . . Loading location meters to the external system . Loading asset meters to the external system . . Disabling the external system for initial file loads.
. . . . . . .
27 27 28 28 29 29 30
. . . 7 9
Chapter 5. Installing Maximo for Oil and Gas . . . . . . . . . . . . . . . . 11 Chapter 6. Deploying the EAR files on Oracle WebLogic Server . . . . . . . 13 Chapter 7. Adding Map tabs to Maximo for Oil and Gas applications . . . . . 15 Chapter 8. Integration components provided with Maximo for Oil and Gas . 17 Chapter 9. Date formats . . . . . . . 19 Chapter 10. Maximo for Oil and Gas Web service handler . . . . . . . . . 21 Chapter 11. Configuring the integration infrastructure for initial file loads . . . 23
Adding MIMOSA enterprise identifiers in Maximo for Oil and Gas . . . . . . . . . . . . Updating system properties . . . . . . . . Enabling the publish channels for initial file loads Enabling the external system for initial file loads . Activating the integration cron task . . . . . . 23 . 24 24 . 25 . 25
Chapter 15. Web service operations . . 37 Chapter 16. Maximo for Oil and Gas integration mappings . . . . . . . . 39
Organization mapping. . . . . . . Site mapping . . . . . . . . . . Location mapping . . . . . . . . Asset mapping . . . . . . . . . Location meter mapping . . . . . . Asset meter mapping . . . . . . . Defect and incident mapping (locations) . Defect and incident mapping (assets) . . Work order mapping (locations) . . . Work order mapping (assets) . . . . Meter reading mapping (locations) . . Meter reading mapping (assets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 39 40 40 41 42 43 43 44 45 45 46
Notices . . . . . . . . . . . . . . 47
Trademarks . . . . . . . . . . . . . . 48
iii
iv
Procedure
1. Change to the product_home\maximo\applications\maximo\properties directory. The default location is C:\IBM\SMP\maximo\applications\maximo\ properties. 2. Back up the maximo.properties file. 3. 4. 5. 6. Delete the maximo.properties file. Change to the product_home\etc directory. Back up the maximo.properties_orig file. Save this backup copy permanently. Rename the unencrypted maximo.properties_orig file to maximo.properties.
7. Copy the maximo.properties file to the product_home\maximo\applications\ maximo\properties\ directory. 8. Edit the maximo.properties file and update the credential or connection information for the database server. 9. Save the file. 10. Run the encryptproperties.bat file in the product_home\maximo\tools\ maximo\ directory on the file to encrypt it.
What to do next
Update the installation properties in the install.properties file.
Procedure
1. Change to the product_home\etc directory. 2. Edit the install.properties file and make updates. Do not change encrypted properties, which are prefixed by [enc]. You are prompted for updated values during the update operation. These values are written to the install.properties file. 3. Save the file.
What to do next
Update the WebSphere Application Server Network Deployment host name.
Procedure
1. Update the WebSphere Application Server Network Deployment host name that was used in the previous deployment. 2. Update the WAS.DeploymentManagerHostName value in the install.properties file. 3. Edit the C:\IBM\SMP\WASClient\thinwasadmin.bat file.
4. Update the following line of the file with the new, fully qualified, host name of the WebSphere Application Server Network Deployment server. set wsadminHost=-Dcom.ibm.ws.scripting.host=fully-qualified host name. 5. Run the thinwasadmin.bat file with these values: thinwsadmin.bat -domain manager user name -password. 6. When prompted, indicate that you do want to download the truststore file.
Results
After completing these updates, you can upgrade, install a fix pack, or install a product by using the corrected values.
Base requirements
Ensure that IBM Maximo Asset Management 7.1 is installed on the same Windows administrative workstation where you plan to install Maximo for Oil and Gas 7.1.1, and in the same language as Maximo for Oil and Gas 7.1.1. Ensure that Maximo Asset Management has the 7.1.1.6 or later fix pack installed.
Procedure
1. Gather login information for the middleware servers. The installation program requires access to the middleware servers that are installed with Maximo Asset Management to complete the installation. You need the administrative user IDs and passwords for the middleware servers. 2. Back up the middleware servers and administrative workstation. 3. Prepare the application server:
Application server WebSphere Application Server What to do Ensure that the middleware servers are started. The installation program connects to the middleware servers by using the middleware login information that you specify during the product installation. Ensure that the application server (MAXIMOSERVER) is stopped. If the application server is running, stop the server and wait a few minutes before you start the installation program. If the application server is not stopped, the installation process stops.
WebLogic Server
4. If you run the installation program in a double-byte language or an eastern European language, set the workstation regional settings to that language. You can reset your regional settings after you complete the installation.
10
Procedure
1. Start the launchpad. The launchpad is automatically started when you run the product DVD. If the Windows autorun feature is disabled, you can start the launchpad by running the launchpad.exe program from the root directory of the product DVD. If you cannot start the launchpad, navigate to the product_home\bin directory and double-click the solutionInstallerGUI.bat file. 2. 3. 4. 5. Click Install the Product. Click IBM Maximo for Oil and Gas 7.1.1. Select a language for your installation, and click OK. If you started the installation program from the solutionInstallerGUI.bat file, select OilAndGas711.zip from launchpad_root\Install\OILINSTALL. 6. Follow the steps in the installation program. 7. On the additional language support features panel, select the option box to specify whether you want the installation program to install additional languages.
8. If you use WebSphere Application Server, in the package options panel that shows the deployment options, ensure that the Package Options check box is cleared to redeploy the EAR files and to update the Maximo database. 9. Follow the steps in the installation program. 10. When the installation is complete, from the Package Successfully Deployed window, click Done.
What to do next
If you want to check the results of the language package installation, review the language package installation log file, TDToolkitdate-time.log, in the product_home\maximo\tools\maximo\log directory. If you use WebLogic Server, manually redeploy the EAR files. If you use WebSphere Application Server, the installation is complete. Add Map tabs to Maximo for Oil and Gas, if applicable, or configure the integration infrastructure for initial file loads.
11
12
Procedure
1. Change to the mydomain directory.
Platform Windows Location From a command prompt, change the path to: drive:\BEA_installation_location\ user_projects\domain\mydomain Open a terminal window, or if you are using Telnet to connect from a Windows computer, open a command prompt, and change the path to: /home/mxadmin/bea/ user_projects/domains/mydomain
UNIX
3. Start the MAXIMOSERVER administration console by typing the following URL in the address bar of your browser: http://hostname:7001/console. Press Enter. 4. Follow the instructions in the WebLogic console help to deploy the maximo.ear file and the maximohelp.ear file.
Results
The installation is complete.
13
What to do next
Add Map tabs to Maximo for Oil and Gas applications, if applicable, or configure the integration infrastructure for initial file loads.
14
Chapter 7. Adding Map tabs to Maximo for Oil and Gas applications
If you have installed and enabled a license for IBM Maximo Spatial Asset Management, you can add Map tabs to several Maximo for Oil and Gas applications when you install Maximo for Oil and Gas.
Procedure
1. In the product_home\maximo\applications\maximo\properties\product directory, open the oilandgas.xml file. 2. Search for the following <extendpresentation> elements and remove the comment tags (<!-- and -->)) from each element: v <extendpresentation app=PLUSGWO baseapp=WOTRACK product=spatial> v <extendpresentation app=PLUSGSR baseapp=SR product=spatial> v <extendpresentation app=PLUSGASS baseapp=ASSET product=spatial> v <extendpresentation app=PLUSGLOC baseapp=LOCATION product=spatial> 3. Save the file. 4. Run the updatedb command again. 5. Regenerate the EAR files. 6. Redeploy the EAR files.
What to do next
Configure the integration infrastructure for initial file loads.
15
16
Chapter 8. Integration components provided with Maximo for Oil and Gas
The integration process transfers data between IBM Maximo for Oil and Gas and the IBM Chemical and Petroleum Integrated Information Framework and other MIMOSA OSA-EAI V3.2.1-based systems (external systems). The product includes integration components to transfer new and updated records of the following types from Maximo for Oil and Gas to the external system: v v v v v v Organizations Sites Locations Assets Meter readings for locations Meter readings for assets
The product includes integration components to transfer new records of the following types from the external system to Maximo for Oil and Gas. These records can be associated with assets or locations: v Defects v Incidents v Work orders v Asset meter readings v Location meter readings Validation is based on the MIMOSA schema [OSA-EAI-CRIS-XSD-V032]CRIS_complete_V3-2-1_[31-Dec-2008].xsd.
17
18
19
20
Chapter 10. Maximo for Oil and Gas Web service handler
A system administrator must regularly monitor Maximo for Oil and Gas and the external system for data transfer errors. The PLUSGWEBSERVICE handler processes responses from the external system and can overwrite the Web service end point SOAP action. Each transaction that is used in the integration has a specific SOAP operation. The Web service handler processes responses as follows: v If the response is a success, the handler finishes processing the message. A success is indicated by a TRUE value for the success attribute on the <status> element of the response. v If the response is a failure, the handler marks the message for reprocessing. A failure is indicated by a FALSE value for the success attribute on the <status> element of the response. To reprocess the message, you use the Message Reprocessing application in the Integration module. This table displays the error responses that the external system sends to Maximo for Oil and Gas, and the mapping to the Maximo message.
message_code STAT_ERR_INPUT Message group plusgwebservice Message key inputError Message text The external system could not proceed with the operation because the message sent is incorrect. A technical error occurred in the external system.
STAT_ERR_TECH
plusgwebservice
techError
21
22
Chapter 11. Configuring the integration infrastructure for initial file loads
Maximo for Oil and Gas records are initially loaded to the external system through XML file transfers. Before you can load these files to the external system, you must perform several activities.
Procedure
1. Obtain a MIMOSA enterprise_id for every active and inactive organization in Maximo for Oil and Gas. 2. Associate the MIMOSA enterprise identifiers with the Maximo for Oil and Gas organizations. 3. Update the system properties. Configure the JMS queues as described in the Integration Guide. Enable the publish channels for the initial file loads. Enable the external system for the initial file loads. Activate the integration cron task. Load organization, site, location, asset, location meter, and asset meter records to the external system. 9. Disable the external system for the initial file loads. 4. 5. 6. 7. 8.
23
Procedure
1. In the Organizations (Oil) application, display the organization record that you want to update. 2. On the Organization tab, in the Open Unique Identifier field, specify the MIMOSA enterprise identifier that corresponds to the organization. 3. Save the record.
What to do next
Update the system properties.
Procedure
1. In the System Properties application, select the mxe.int.globaldir property. Update fields as needed, and then save the record. 2. If you update the mxe.int.globaldir property, select the corresponding Select Record check box, and then select Live Refresh from the Select Action menu. 3. Select the mxe.int.webappurl property. Update fields as needed, and then save the record. Specify the server host as follows: http://<IP>:<port>/meaweb. 4. If you update the mxe.int.webappurl property, select the corresponding Select Record check box, and then select Live Refresh from the Select Action menu.
What to do next
1. Configure the JMS queues as described in the Integration Guide. 2. Enable the publish channels for the initial file loads.
Procedure
1. In the Publish Channels application, on the List tab, select all the Maximo for Oil and Gas publish channels. a. In the Publish Channel field, type PLUSG, and then press Enter. b. Select the Select Records check box that is below the last row in the list.
24
c. Select the Select All Records check box that is in the table header. 2. From the Select Action menu, select Enable Event Listener, and then verify that the Enable Listener check box is selected for every PLUSG publish channel.
What to do next
Enable the external system for the initial file loads.
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the System tab, select the Enabled check box, and then save the record. 3. On the Publish Channels tab, select every Enabled check box, and then save the record.
What to do next
Activate the integration cron task.
Procedure
1. In the Cron Task Setup application, select the JMSQSEQCONSUMER cron task. 2. On the Cron Task tab, in the Cron Task instances table window, select all the Active check boxes. 3. Save the record. 4. From the Select Action menu, select Reload Request. 5. In the Reload Request window, select the Select Row check boxes that correspond to the SEQQIN and SEQQOUT instance names. 6. Click OK, and then save the record.
What to do next
Load organizations to the external system.
Chapter 11. Configuring the integration infrastructure for initial file loads
25
26
You also must import the files to the external system in the same sequence. If you do not, errors will occur.
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the Publish Channels tab, select the PLUSGORGInterface publish channel. 3. Click Data Export. In the Data Export window, do not specify an export condition. 4. Click OK.
What to do next
1. Fix any errors that occurred. 2. Import the organization records into the external system. 3. Load the site records to the external system.
27
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the Publish Channels tab, select the PLUSGSITEInterface publish channel. 3. Click Data Export. In the Data Export window, do not specify an export condition. 4. Click OK.
What to do next
1. Fix any errors that occurred. 2. Import the site records into the external system. 3. Load the location records to the external system.
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the Publish Channels tab, select the PLUSGOPERLOCInterface publish channel. 3. Click Data Export. In the Data Export window, do not specify an export condition. 4. Click OK.
What to do next
1. Fix any errors that occurred. 2. Import the location records into the external system. 3. Load the asset records to the external system.
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the Publish Channels tab, select the PLUSGASSETInterface publish channel. 3. Click Data Export. In the Data Export window, do not specify an export condition. 4. Click OK.
28
What to do next
1. Fix any errors that occurred. 2. Import the asset records into the external system. 3. Load the location meter records to the external system.
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the Publish Channels tab, select the PLUSGLOCMETERInterface publish channel. 3. Click Data Export. In the Data Export window, do not specify an export condition. 4. Click OK.
What to do next
1. Fix any errors that occurred. 2. Import the location meter records into the external system. 3. Load the asset meter records to the external system.
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the Publish Channels tab, select the PLUSGASSMETERInterface publish channel. 3. Click Data Export. In the Data Export window, do not specify an export condition. 4. Click OK.
What to do next
1. Fix any errors that occurred. 2. Import the asset meter records into the external system. 3. Disable the external system for initial file loads.
29
Procedure
1. In the External Systems application, select the PLUSGMIMDF external system. 2. On the System tab, clear the Enabled check box, and then save the record.
What to do next
Configure the integration infrastructure for data updates.
30
Procedure
1. Retrieve the Web service URL for RegistryManagementServices and for TrendManagementServices. 2. Configure the end points for Web services. 3. Deploy Web services. 4. Enable the external systems for Web services.
Procedure
1. Open the Web service wsdl file. 2. Locate the service element. One of the children of the element has a location attribute, which defines the Web address.
31
What to do next
Configure the end points for Web services.
Procedure
1. In the End Points application, on the List tab, select the PLUSGMIMWSREG end point. 2. On the End Point tab, select the ENDPOINTURL property. 3. In the Value field, specify the Web service URL for RegistryManagementServices. 4. 5. 6. 7. 8. Select the SERVICENAME property, and update its value. Save the record. On the List tab, select the PLUSGMIMWSTREND end point. On the End Point tab, select the ENDPOINTURL property. In the Value field, specify the Web service URL for TrendManagementServices.
9. Select the SERVICENAME property, and update its value. 10. Save the record.
What to do next
Deploy Web services.
Procedure
1. In the Web Services Library application, on the List tab, select all the Maximo for Oil and Gas Web services. a. In the Name field, type PLUSG, and then press Enter. b. Select the Select Records check box that appears below the last row in the list. c. Select the Select All Records check box that is in the table header. 2. From the Select Action menu, select Deploy Web Service. Verify that the Is Deployed check box that corresponds to each PLUSG Web service is selected.
32
What to do next
Enable the external systems for Web services.
Procedure
1. In the External Systems application, select the PLUSGMIMWSREG external system. 2. On the System tab, select the Enabled check box. 3. On the Publish Channels tab, select every Enabled check box. 4. On the Enterprise Services tab, select every Enabled check box. 5. Save the record. 6. Select the PLUSGMIMWSTREND external system. 7. On the System tab, select the Enabled check box. 8. On the Publish Channels tab, select every Enabled check box. 9. On the Enterprise Services tab, select every Enabled check box. 10. Save the record.
Results
The configuration for the integration process is complete. New and updated records will be transferred automatically between Maximo for Oil and Gas and the external system.
33
34
Integration components for data transfers from Maximo for Oil and Gas
This table shows the integration components that are used to send integration data from Maximo for Oil and Gas to an external system.
Object structure Organization Site Location Asset Location meter Asset meter PLUSGORG PLUSGSITE PLUSGOPERLOC PLUSGASSET PLUSGLOCMETER PLUSGASSMETER Publish channel PLUSGORGInterface PLUSGSITEInterface PLUSGOPERLOCInterface PLUSGASSETInterface PLUSGLOCMETERInterface PLUSGASSMETERInterface
Integration components for data transfers to Maximo for Oil and Gas
This table shows the integration components that are used to send integration data from an external system to Maximo for Oil and Gas.
Object structure Defect ticket (location) Incident ticket (location) Defect ticket (asset) Incident ticket (asset) Work order (location) Work order (asset) Meter reading (location) Meter reading (asset) PLUSG DEFECT PLUSG INCIDENT PLUSG DEFECT PLUSG INCIDENT PLUSGWO PLUSGWO Enterprise service PLUSGDEF SMIMCInterface PLUSGINC SMIMCInterface PLUSGDEF AMIMCInterface PLUSGINC AMIMCInterface PLUSGWO SMIMCInterface PLUSGWO AMIMCInterface Web service PLUSGMIMWSREG_ PLUSGDEFSMIMCInterface PLUSGMIMWSREG_ PLUSGINCSMIMCInterface PLUSGMIMWSREG_ PLUSGDEFAMIMCInterface PLUSGMIMWSREG_ PLUSGINCAMIMCInterface PLUSGMIMWSREG_ PLUSGWOSMIMCInterface PLUSGMIMWSREG_ PLUSGWOAMIMCInterface PLUSGMIMWSTREND_ PLUSGMETERSMIMUInterface PLUSGMIMWSTREND_ PLUSGMETERAMIMUInterface
35
36
Meter reading UpdatePLUSG (location) LOCATION METER Meter reading UpdatePLUSG (asset) ASSETMETER
37
38
Organization mapping
You use the organization mapping to send organization (enterprise) data from Maximo for Oil and Gas to the external system.
Maximo for Oil and Gas table.column ORGANIZATION.ORGID ORGANIZATION. DESCRIPTION ORGANIZATION.ACTIVE ORGANIZATION. PLUSGOPENOMUID MIMOSA attribute enterpriseTYPE user_tag_ident name rstat_type_code enterprise_id MIMOSA interface reference V3-2-5036-01CreateEnterprise.xsd
Site mapping
You use the site mapping to send site data from Maximo for Oil and Gas to the external system.
Maximo for Oil and Gas table.column SITE.SITEID SITE.DESCRIPTION SITE.ACTIVE SITE.PLUSGOPENOMUID ORGANIZATION. PLUSGOPENOMUID ORGANIZATION. PLUSGOPENOMUID (hexadecimal format) + SITE.PLUSGOPENOMUID (hexadecimal format) MIMOSA attribute siteTYPE user_tag_ident name rstat_type_code site_id enterprise_id site_code MIMOSA interface reference V3-2-5037-01CreateSite.xsd
39
Location mapping
You use the location mapping to send location data from Maximo for Oil and Gas to the external system.
Maximo for Oil and Gas table.column LOCATIONS.LOCATION LOCATIONS.DESCRIPTION LOCATIONS.STATUS MIMOSA attribute segmentTYPE user_tag_ident name lcinfo attr_name: status value: 1: operating 2: not ready 3: decommissioned rstat_type_code value: 0: not ready or decommissioned 1: operating SITE.PLUSGOPENOMUID (hexidecimal format) LOCATIONS. PLUSGOPENOMUID (look up from LOCATIONS.LOCATION) segment_site segment_id MIMOSA interface reference v V3-2-5038-01CreateSg.xsd v V3-2-5042-01UpdateSg.xsd
Asset mapping
You use the asset mapping to send asset data from Maximo for Oil and Gas to the external system.
40
Maximo for Oil and Gas table.column ASSET.ASSETNUM ASSET.DESCRIPTION SITE.PLUSGOPENOMUID (look up from ASSET.SITE) ASSET.PLUSGOPENOMUID (look up from ASSET.LOCATION) ASSET.PLUSGOPENOMUID (look up from ASSET.ASSETNUM) LOCATIONS.STATUS
asset_id
lcinfo attr_name: status value: 1: operating 2: not ready 3: decommissioned rstat_type_code value: 0: not ready or decommissioned 1: operating
41
Maximo for Oil and Gas table.column LOCATIONS. PLUSGOPENOMUID (look up from LOCATIONMETER. LOCATION) LOCATIONMETER. METERNAME LOCATIONMETER. LOCATIONMETERID LOCATIONMETER. PLUSGOPENOMUID (look up from LOCATIONMETER.SITEID) LOCATIONMETER.ACTIVE S (constant value)
rstat_type_code segment_or_asset
rstat_type_code segment_or_asset
42
Attribute ml_type_code
Undefined value 0
user_tag_ident event_type_code
The following response is sent from Maximo for Oil and Gas to the external system.
Maximo for Oil and Gas table.column INCIDENT.TICKETID MIMOSA attribute segment_eventTYPE event_id
43
Maximo for Oil and Gas table.column INCIDENT.REPORTEDBY INCIDENT.ASSETNUM ORGANIZATION. PLUSGOPENOMUID (hexadecimal format) + SITE.PLUSGOPENOMUID (hexadecimal format) INCIDENT.DESCRIPTION INCIDENT. PLUSGEXTINCREF (prefix = EVCODE)
user_tag_ident event_type_code
INCIDENT.AFFECTEDDATE gmt_event_start INCIDENT.CLASS lcinfo attr_name = event_type value = DEFECT or INCIDENT, depending on message type INCIDENT. PLUSGOPENOMUID lcinfo attr_name = open_uid value = Integer
The following response is sent from Maximo for Oil and Gas to the external system.
Maximo for Oil and Gas table.column INCIDENT.TICKETID MIMOSA attribute segment_eventTYPE event_id
segment_site
name work_req_id
44
The following mapping is used to send the ticket identifier from Maximo for Oil and Gas to the external system.
Maximo for Oil and Gas table.column WORKORDER.WONUM MIMOSA attribute work_order_for_TYPE work_order_id
asset_org_site
The following response is sent from Maximo for Oil and Gas to the external system.
Maximo for Oil and Gastable.column WORKORDER.WONUM MIMOSA attribute work_order_for_TYPE work_order_id
LOCATIONMETER.SITEID segment_site LOCATIONMETER. NEWREADING LOCATIONMETER. NEWREADINGDATE mevent_num_data. data_value mevent_num_data. gmt_event
45
ASSETMETER.ASSETNUM asset_id ASSETMETER. ASSETMETERNAME ASSETMETER.SITEID ASSETMETER. NEWREADING ASSETMETER. NEWREADINGDATE meas_loc_id asset_org_site mevent_num_data. data_value mevent_num_data. gmt_event
46
Notices
This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the users responsibility to evaluate and verify the operation of any non-IBM product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 1623-14, Shimotsuruma, Yamato-shi Kanagawa 242-8502 Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-IBM Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk.
47
IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: U.S.A. IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 78758 U.S.A. Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us. Information concerning non-IBM products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-IBM products. Questions on the capabilities of non-IBM products should be addressed to the suppliers of those products. All statements regarding IBMs future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy, the photographs and color illustrations may not appear.
Trademarks
IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Java and all Java-based trademarks and logos are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries.
48
Other company, product, and service names may be trademarks or service marks of others.
Notices
49
50
Printed in USA