
Web Services Integration Toolkit for OpenVMS
Installation Guide and Release Notes
December 2008
This document contains information that will help you
install and use this release of WSIT for OpenVMS.
Software Version
Web Services Integration Toolkit
Version 3.0
Hewlett-Packard Company
© 2008 Hewlett-Packard Development Company, L.P.
Intel, Intel Inside, and Itanium are trademarks of Intel
Corporation in the
Microsoft, Windows, Windows XP, Visual Basic, Visual C++,
and Win32 are trademarks of Microsoft Corporation in the
Java and all Java-based marks are trademarks or registered
trademarks of Sun Microsystems, Inc. in the
All other product names mentioned herein may be trademarks
of their respective companies.
Confidential computer software. Valid license from HP and/or
its subsidiaries required for possession, use, or copying. Consistent with FAR
12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S.
Government under vendor’s standard commercial license.
Neither HP nor any of its subsidiaries shall be liable for
technical or editorial errors or omissions contained herein. The information in
this document is provided “as is” without warranty of any kind and is subject
to change without notice. The warranties for HP products are set forth in the
express limited warranty statements accompanying such products. Nothing herein
should be construed as constituting an additional warranty.
C O N T E
N T S
1. REQUIREMENTS
1.2 Software Installation, Development, and Runtime
Requirements
2. INSTALLATION
2.1 Installing the Web
Services Integration Toolkit for OpenVMS
2.2 After Installing
the Web Services Integration Toolkit for OpenVMS
2.3 Starting and
Stopping the Web Services Integration Toolkit
2.4 Uninstalling the
Web Services Integration Toolkit
2.5 Web Services
Integration Toolkit Directory Structure
2.6
Performance Recommendations
3.1 New Features in Version
3.0
3.2 Known Problem in
AXIS2 java2WSDL Tool Affecting Case
3.3 Backward Compatibility Change
in Version 2.0
3.4 OBJ2IDL May Not Generate Correct
Array Size When Using Zero Based Arrays
3.5 Occasional Problem
Using Javadoc Generation Feature of IDL2CODE
3.6 Large STDL File
Problem on OpenVMS Alpha
3.7 Copy WSIRTL.JAR to
Server Classpath and Restart Server (If Required)
3.8 Support for Web
Services Integration Toolkit
3.9 Tools and Files
Renamed in Pre-V1.0 Field Test Kit
4. CONTACT AND SUPPORT INFORMATION
B. Sample OpenVMS
Installation Log
C. Directories and
Files in the Web Services Integration Toolkit
About Web Services
Integration Toolkit for OpenVMS Documentation
This Installation
Guide and Release Notes includes system requirements and installation
instructions for OpenVMS, as well as release notes for the current release of
the Web Services Integration Toolkit for OpenVMS.
The Developer’s Guide
contains information about how to use the tools in the Web Services Integration
Toolkit for OpenVMS, and things to consider as you prepare your legacy
application.
For the latest release information, refer to the Web Services Toolkit for
OpenVMS web site at http://www.hp.com/products/openvms/webservices/.
1 R E Q U I R E M E N T S
The Web Services Integration Toolkit-generated server
component is a native OpenVMS image installed on the system running the wrapped
application. The generated source code
must be built on the OpenVMS system that hosts the application using
command-line driven development tools.
1.1 Hardware Requirements
The Web Services Toolkit for OpenVMS is available on OpenVMS
I64 and OpenVMS Alpha.
The Web Services Toolkit for OpenVMS I64 EXE file requires
approximately 55,500 blocks of disk space. Expanding the EXE file requires an
additional 80,000 blocks.
The Web Services Toolkit for OpenVMS Alpha EXE file requires
approximately 33,000 blocks of disk space. Expanding the EXE file requires an
additional 35,000 blocks.
1.2 Software Installation, Development, and Runtime Requirements
Following are the minimum system requirements needed to
install the Web Services Integration Toolkit and to build and run the generated
components. Optional requirements represent requirements that are not needed
for every type of application. However, several such requirements will apply to
your particular platform/component selection.
Make sure you have the latest MUPs, ECOs, and patches for
your configuration. Search for these on the Patch Download page at:
http://www2.itrc.hp.com/service/patch/mainPage.do
Always Check
Cross-Product Requirements!
Always check for cross-product software requirements, which
can change with new releases.
These product requirements may be greater than for the Web
Services Integration Toolkit itself.
For example, to run a Web Services Integration
Toolkit-generated JavaBean component requires OpenVMS Version 7.3-2 (on Alpha)
or 8.2 (on I64) or higher, and a Java 2 Runtime Environment 1.4.2-1 or higher.
Each Java SDK and RTE has specific ECO requirements.
Installation
Requirements
• OpenVMS I64
Version 8.2 or higher - or -
• OpenVMS Alpha
Version 7.3-2 or higher
• ODS-5 disk
Development
Requirements
The C Compiler is required to build all server components.
• HP C Version
6.5 or higher for OpenVMS
• HP C++ Version
6.5 or higher for OpenVMS
• Java 2 SDK
(“JDK”) Standard Edition 1.4.2-1 or higher
Java Technology for OpenVMS Download Page
http://h18012.www1.hp.com/java/download/
Runtime Requirements
• Java 2 RTE
(JRE) Standard Edition 1.4.2-1 or higher
Java Technology for OpenVMS Download Page
http://h18012.www1.hp.com/java/download/
• Java Software
Patches (ECOs) (if required)
Java Technology for OpenVMS v 1.4.2 Software Patch Page
http://h18010.www1.hp.com/java/download/ovms/1.4.2/sdk1.4.2_patches.html
Out-of-Process Account
Preparation and Requirements
If you are specifying an account in which to run
out-of-process servers, you may want the account to have a minimal amount of
privileges.
You can specify an account to run out-of-process servers
that has only the NETMBX and TMPMBX privileges.
To use an account with these privileges, perform the following steps:
1. Create an identifier within the
system UAF with the name WSI$SERVER.
(Perform this step one time only.)
2. Grant the WSI$SERVER identifier to
each account used to run a WSIT out-of-process server.
If you do not perform these steps, the privileges required
by the account are as follows:
BYPASS
SYSNAM
SYSPRV
IMPERSONATE
DETACH
TMPMBX
2 I N S T A L L A T I O N
Installation involves installing and then starting the Web
Services Integration Toolkit on OpenVMS.
2.1 Installing the Web Services Integration Toolkit for OpenVMS
Before You Begin
Log into the SYSTEM account.
If you have previously installed a version of the Web
Services Toolkit, make sure
the Web Services Toolkit is shut down by entering this
command from the SYSTEM account:
$
@SYS$STARTUP:WSI$SHUTDOWN.COM
HP recommends that you perform a system disk backup before
proceeding.
Web Download
Instructions
1. Save the Web Services Toolkit
self-extracting archive (WSIT-V0300-I64.EXE or WSIT-V0300-AXP.EXE) to a
temporary location by choosing the option to save the program to your disk.
2. If you are downloading to a Windows
machine, move the downloaded file to your OpenVMS machine using either a shared
network drive or FTP. (See Appendix A:
Sample FTP File Transfer.)
Installation
Instructions
1. Expand the Web Services Integration
Toolkit compressed EXE file by entering one of the following command, depending
on the platform on which you are installing the kit:
$ RUN WSIT-V0300-I64.EXE ! for OpenVMS I64
$ RUN WSIT-V0300-AXP.EXE ! for OpenVMS Alpha
The EXE file contains the file HP-IA64VMS-WSIT-V0300--1.PCSI$COMPRESSED
(for OpenVMS I64) or HP-AXPVMS-WSIT-V0300--1.PCSI$COMPRESSED (for OpenVMS Alpha) and the WSIT
documentation.
2. Start PCSI, the utility that
installs the Web Services Toolkit component, by entering the following command. (PCSI installs the PCSI$COMPRESSED file
directly; you do not need to expand it.)
$ PRODUCT INSTALL WSIT
/DESTINATION=ods5disk:[directory]
The Web Services Toolkit accepts a destination directory
specified on the PCSI install command line. This location is used as the root
directory for the WSIT product. If the
destination is not specified, the default is SYS$COMMON:[000000] and the directory created is SYS$COMMON:[WSIT].
3. Follow the on-screen installation
instructions. (See Appendix B: Sample OpenVMS Installation Log.)
To proceed with a default installation, press Enter/Return
in response to any other installation
questions.
Installing the Runtime
File Only
During the WSIT installation procedure, you are asked if you
want to install only the runtime file. If you answer YES, the WSIT tools,
documentation and sources will not be installed.
Do you want the defaults for all options? [YES] n
Install the full WSIT kit? [YES] n
Install the WSIT runtime only? [YES]
y
Do you want to review the options? [NO] n
Execution phase starting ...
2.2 After Installing the Web Services Integration Toolkit for OpenVMS
HP recommends that you restart J2EE environments, such as
BEA WebLogic Server, or other Bean servers, such as Tomcat, after a Web
Services Toolkit installation. Such
environments may not automatically refresh shareable images and libraries
without being restarted.
Modify your system startup command procedure
(SYS$MANAGER:SYSTARTUP_VMS.COM) to
include the Web Services Toolkit startup command:
@SYS$STARTUP:WSI$STARTUP.COM
Modify your system shutdown command procedure
(SYS$MANAGER:SYSHUTDWN.COM) to include
the Web Services Toolkit shutdown command:
@SYS$STARTUP:WSI$SHUTDOWN.COM
Finally, start the Web Services Integration Toolkit with
this command:
$
@SYS$STARTUP:WSI$STARTUP.COM
This completes the Web Services Integration Toolkit for
OpenVMS installation.
Note:
If you opt not to use the SYSTEM account:
The Web Services Toolkit startup procedure must still be run every time your
system starts. It can be run as part of your system startup or in another
account.
HP recommends that you use the SYSTEM account. However, the
account in which you run the Web Services Toolkit must have, minimally, the following
authorized account privileges:
BYPASS
SYSPRV
TMPMBX
SYSNAM
CMKRNL
DETACH
LOG_IO
2.3 Starting and Stopping the Web Services Integration Toolkit for OpenVMS
Starting the Web
Services Integration Toolkit
Use the following command to start the Web Services
Integration Toolkit:
$
@SYS$STARTUP:WSI$STARTUP.COM
Stopping the Web
Services Integration Toolkit
Stopping the Web Services Integration Toolkit requires the
same privileges as starting it. Ensure
that all client connections have been closed.
1. Log into the
SYSTEM account.
2. Use the
following command to stop the Web Services Integration Toolkit:
$
@SYS$STARTUP:WSI$SHUTDOWN.COM
2.4 Uninstalling the Web Services Integration Toolkit
To remove the Web Services Toolkit for OpenVMS from your
system, enter the following command:
$ PRODUCT
REMOVE WSIT
2.5 Web Services Integration Toolkit Directory Structure
After you install the Web Services Integration Toolkit,
browse the WSIT directories to see the location of the tools and sample
programs. Appendix C contains a listing
of all of the directories and files in the Web Services Integration Toolkit.
2.5.1 WSIT Root Directory
The root directory is represented by the logical WSI$ROOT.
This logical is created when the WSI$STARTUP.COM procedure is executed.
$ dir wsi$root:[000000]
Directory wsi$root:[000000]
Apache_Software_License_V1_1.txt;1 Apache_Software_License_V2_0.txt;1
deploy.dir;1
docs.dir;1 lib.dir;1 samples.dir;1
src.dir;1
tools.dir;1 wsi-version.txt;1
Total of 7 files.
$
2.5.2 Deploy Subdirectory
The Deploy subdirectory contains the shareable image for the
application’s server wrapper. The generated JavaBean calls the server wrapper’s
shareable image at runtime.
2.5.3 Docs Subdirectory
The Docs directory contains Web Services Integration Toolkit
documentation.
2.5.4 LIB Subdirectory
The LIB subdirectory is where the Web Services Integration
Toolkit stores the files it uses internally; for example, Velocity template
files.
2.5.5 Samples Subdirectory
The Samples subdirectory contains example programs. This kit includes sample applications written
in ACMS, C, COBOL, and FORTRAN.
The .C, .CBL and .FOR programs are the wrappers for the
original application. The .JAVA files
illustrate calling the WSIT-generated JavaBean for each wrapper. See the Developer’s Guide Appendix for the
source files of the C sample.
2.5.6 Tools Subdirectory
The tools in this directory are used to develop code that
wraps 3GL applications.
2.5.7 Source Subdirectory
The source subdirectory contains objects and classes used by
the generated code, including Java exceptions and holder classes. The files in this subdirectory are provided
for your reference.
2.6 Performance Recommendations
2.6.1 Operating System Requirements
Increase the PRCLM quota to be high enough to run the
maximum number of expected concurrent servers.
2.6.2 Java Requirements
The Java runtime environment was designed to perform
optimally on UNIX systems, where each process is given large quotas by default.
On OpenVMS, the default behavior gives each process lower quotas so that many
processes can co-exist on a system. To
get the best Java performance on OpenVMS, you are recommended to set process
quotas to match a typical UNIX system. These are also the recommended minimum
quota settings (except where noted).
These are the recommended J2SDK for OpenVMS quotas:
|
UAF Fillm Channelcnt Wsdef Wsquota Wsextent and Wsmax Pgfilquo bytlm biolm diolm tqelm |
4096 4096 2048 4096 16384 2,097,152* 2,000,000 150 150 100 |
*A good number for Pgflquo is (2 x heap-size), for example,
128 MB (2*128*1024*1024)/512 = 524288. Recall that the recommended minimum
Pgflquo is 96 MB when using the RTE. When you increase the Pgflquo parameter,
you should always increase the system's page file size to accommodate the new
Pgflquo parameter, if needed.
Note:
If you receive a WSIConnectException without a specific message attached
to it, the most likely cause is a value for bytlm that is too low. HP recommends that you set this value to at
least 2,000,000.
There are many other optimizations you can make to your Java
environment to improve performance, such as setting the compacting garbage
collector with the Fast VM.
-Xgc:compacting
This will benefit some but not all Java applications. All
such optimizations should be tested in a systematic fashion. You can try out
the techniques and tips available from the following source.
Guide to Optimizing Java on OpenVMS
http://h71000.www7.hp.com/ebusiness/OptimizingSDKGuide/OptimizingSDKGuide.html
3 R E L E A S E
N O T E S
3.1 New Features in Version 3.0
Following are the new features included in the Version 3.0 kit.
·
Automatic
stack expansion for single threaded applications. This feature removes the need for the system
manager to determine the appropriate maximum stack size for the thread that executes
the application code.
·
Support
for the generation of sample AXIS2 web services (not intended for production
environments).
·
PCSI
kit includes an option to install the WSIT runtime only.
·
ANT
is no longer bundled with WSIT.
·
Generated
web services have login and logout methods when authentication is specified
using the –l switch on the generator tool (idl2code.jar).
·
New
application tracing feature is supported (WSI$APPTRACING)
·
New
log file generation feature allows out of process applications to print to a
log file. (WSI$LOGFILE).
·
Documentation
for debugging out of process features.
·
AXIS2
services now have argument names in WSDL.
·
WSI$JNISHR_G
defined for debug environments.
·
Miscellaneous
bug fixes.
3.2 Known Problem in AXIS2 java2WSDL Tool Affecting Case
There is a bug (3017) in AXIS2 that may require users to
perform more work:
The AXIS2 java2WSDL tool modifies the name of all properties
to begin with a lowercase letter. For example, if the IDL XML has a
Structure with a Field named EMPLOYEE_NAME, the AXIS2 java2WSDL tool generates WSDL with the element eMPLOYEE_NAME. (Note that using uppercase
names is common in OpenVMS applications.)
Until this bug is fixed, you must choose between the following:
a) Using lowercase first letters in the
WSIT IDL where appropriate
or
b) Including your own WSDL file in your
AXIS2 archive file (.aar). In this scenario, you can run the tool by hand
and then modify the WSDL and add it to the archive.
The elements that need to be addressed include Structure
Field names and Parameter element names when the usage is specified as IN/OUT
or OUT. The Parameters are included because the SOAP Response class is a
composite of the returned parameters.
3.3 Backward Compatibility Change in Version 2.0
WSIT Version 2.0 requires some users to make a minor change
to their Java source code
that calls a WSIT-generated application. The generated interface for structures with a
usage of IN/OUT
changed from StructureHolder to ObjectHolder. These users will need to change their Java code to
use ObjectHolder instead of StructureHolder.
3.4 OBJ2IDL May Not Generate Correct Array Size Using Zero Based Arrays
The OBJ2IDL tool may not generate the correct size of an
array when the source language uses zero based arrays. For example, given a string in C that is 10
bytes in size, the OBJ2IDL tool may incorrectly declare the size to be 9 bytes
in the XML IDL.
As a workaround, manually adjust the size of the array in
the XML IDL. See Chapter 5 in the Developer’s Guide for information about
modifying the IDL.
3.5 Occasional Problem Using Javadoc Generation Feature of
IDL2CODE
Under some environments, the WSIT Generator (IDL2CODE) does
not automatically create the
Javadocs for a generated Java interface. In these cases, you can manually run the
Javadoc
tool to create Javadocs that describe the generated
interface.
3.6 Large STDL File Problem on OpenVMS Alpha
In rare cases, when you attempt to import a very large STDL
file using the stdl2idl utility on an OpenVMS Alpha system, the generated WSIT
IDL file will not contain a valid application definition. HP believes this is a resource problem. (This does not seem to occur on OpenVMS I64
systems.)
If you encounter this problem, you can work around it by
doing the following:
1. Delete all
WSIT generated temporary files from your SYS$LOGIN directory. These files have names similar to
WSI$IMPORT*.*, and BWX_*.TMP.
2. Create a file
in your SYS$LOGIN directory called WSI$IMPORT_TMP.LIS. This file will have a
single line which is the name of the STDL file that you want to import.
$ CREATE WSI$IMPORT_TMP.LIS
MYSTDLFILE.STDL
^z
$
3. Set default
back to the directory containing the STDL file that you want to import, and run
the stdl2idl tool.
3.7 Copy WSIRTL.JAR to Server Classpath and Restart Server (If
Required)
If you plan to call a Web Services Integration Toolkit
application from a web server or application server, the file
wsi$root:[lib]wsirtl.jar must be in the server’s classpath. The details on how to configure the server to
include this jar file are specific to each server.
For example, if you are using CSWS_JAVA for OpenVMS (Apache
Tomcat), you should copy the file wsi$root:[lib]wsirtl.jar to the common/lib
directory. To ensure that the server
becomes aware of the file, a restart if often required. However, this is also server specific.
3.8 Support for Web Services Integration Toolkit
Support for Version 3.0 of the Web Services Integration
Toolkit is provided by HP Support. (Field
test kits are supported by the Web Services for OpenVMS engineering team. Please send mail to
OpenVMS.WebServices@hp.com.)
3.9 Tools and Files Renamed in Pre-V1.0 Field Test Kit
The following tools and files were renamed in a pre-Version
1.0 kit, as shown in the following table.
The names used in Version 1.1 and higher are in the New Name column.
|
Directory |
Old Name |
New Name |
|
[wsit.tools] |
idlgen.exe |
obj2idl.jar |
|
[wsit.tools] |
wsigen.jar |
idl2code.jar |
|
[wsit.tools] |
validateIDL.jar |
validate.jar |
|
[wsit.tools] |
wsi$setenv.com |
wsi-setenv.com |
|
[wsit.tools] |
OpenVMSbasetypes.xml |
openvms-basetypes.xml |
|
[wsit.tools.templates.javabean] |
structure_java.vm |
structure-java.vm |
|
[wsit.tools.templates.javabean] |
viewname_java.vm |
interface-appname-java.vm |
|
[wsit.tools.templates.javabean] |
build_jb_com.vm |
build-appname-jb-com.vm |
|
[wsit.tools.templates.javabean] |
viewnameImpl_java.vm |
appname-impl-java.vm |
|
[wsit.tools.templates.serverwrapper] |
build_server_com. |
build-appname-server-com.vm |
|
[wsit.tools.templates.serverwrapper] |
conn-name_opt.vm |
appname-opt.vm |
|
[wsit.tools.templates.serverwrapper] |
conn-name_server_c. |
appname-server-c.vm |
|
[wsit.tools.templates.serverwrapper] |
conn-name_server_h. |
appname-server-h.vm |
|
[wsit.tools.templates.serverwrapper] |
conn-name_wsi. |
appname-wsi.vm |
|
[wsit.tools.templates.serverwrapper] |
methIDs_h.vm |
methIds-h.vm |
|
[wsit.tools.templates.serverwrapper] |
structkeys_h.vm |
structkeys-h.vm |
|
[wsit.deploy] |
wsi$default.wsi |
wsi-default.wsi |
4 C O N T A C T A N D
S U P P O R T I N F O R M A T I
O N
For OpenVMS Alpha
• Support for
customer release versions of the Web Services Integration Toolkit for OpenVMS
is provided by HP under OpenVMS Alpha service agreements through standard
support channels.
• Download is an
official distribution mechanism for the Web Services Integration Toolkit,
including updates in addition to the OpenVMS Alpha media
kit.
• Source code
kits are provided in the spirit of the open source community, but are not
supported by HP.
For OpenVMS on
Integrity Servers
• Support for
customer release versions of the Web Services Integration Toolkit for OpenVMS
is provided by HP under OpenVMS I64 Foundation Operating Environment (FOE)
service agreements through standard support channels.
• Download is a
courtesy distribution mechanism for the Web Services Integration Toolkit for
OpenVMS. Kits or updates other than security patch kits obtained via download
are unsupported.
• The OpenVMS
I64 Operating Environments media kit is the official distribution mechanism for
the Web Services Integration Toolkit for OpenVMS. Supported kits and updates
must be obtained from this mechanism or from software product update services.
A variety of service options are available from HP Support.
For more information, contact your local HP account representative or
distributor. Information is also available from Software Support Services.
You can informally exchange information with other users in
the OpenVMS newsgroup comp.os.vms.
If you would like to provide comments about the Web Services
Integration Toolkit for OpenVMS, please send mail to:
OpenVMS.WebServices@hp.com
If you would like to provide comments or general feedback
about the e-Business offerings on OpenVMS, please send mail to:
OpenVMS.eBusiness@hp.com
Web Services Toolkit Home Page
http://www.hp.com/products/openvms/webservices/
If you downloaded the Web Services Integration Toolkit
compressed EXE file to a Windows system, use commands similar to the following
to move the kit to your OpenVMS system using command-line FTP (with user input
in angle brackets):
C:\>cd temp
C:\TEMP>ftp <your.server.name.com>
Connected to your.server.name.com.
220 your.server.name.com FTP Server (Version 5.0)
Ready.
User (your.server.name.com:(none)): <user>
331 Username Yourname requires a Password
Password: <password>
230 User logged in.
ftp> binary
200 TYPE set to IMAGE.
ftp> <put WSIT-V0300-I64.EXE>
200 PORT command successful.
150 Opening data connection for disk:[user]WSIT-V0300-I64.EXE;
(16.28.0.58,4460)
226 Transfer complete.
335713 bytes sent in 0.40 seconds (837.19
Kbytes/sec)
ftp> <bye>
221 Goodbye.
C:\TEMP>
B Sample OpenVMS Installation Log (on OpenVMS I64)
Step 1: Extract the Kit
$ RUN WSIT-V0300-I64.EXE
UnZipSFX 5.51 of 22 May 2004, by Info-ZIP
(http://www.info-zip.org).
inflating:
HP-IA64VMS-WSIT-T0300--1.PCSI$COMPRESSED
$
Step 2: Run PCSI (POLYCenter Software Installation)
Utility
$ PRODUCT INSTALL WSIT/source=dka100:[products.kits]
/dest=dka100:[products]
The following product has been selected:
HP IA64VMS
WSIT V3.0 Layered
Product
Do you want to continue? [YES]
Configuration phase starting ...
You will be asked to choose options, if any, for
each selected product and for any products that may be installed to satisfy
software dependency requirements.
HP IA64VMS WSIT V3.0: Web Services Integration
Toolkit (WSIT) V3.0 for OpenVMS
(C) 2008
Hewlett-Packard Development Company, L.P.
Do you want the defaults for all options? [YES]
Do you want to review the options? [NO]
Execution phase starting ...
The following product will be installed to
destination:
HP IA64VMS
WSIT V3.0 ODS5:[WSIT]
Portion done: 0%...20%...30%...40%...50%...60%...90%
***************************************************************
Insert the
following lines at the end of SYS$MANAGER:SYSTARTUP_VMS.COM:
@sys$startup:wsi$startup.com
Insert the
following lines in SYS$MANAGER:SYSHUTDWN.COM:
@sys$startup:wsi$shutdown.com
***************************************************************
WSIT has detected that CSWS_JAVA (Apache Tomcat) is
installed on this system. Some WSIT samples require WSIT runtime files to be in
the common/lib directory.
May this
installation procedure copy the WSIT runtime to Tomcat?
Enter N to skip copying WSIT runtime to Tomcat : Y
...100%-COPIED, WSI$ROOT:[lib]wsirtl.jar;1 copied to
SYS$COMMON:[APACHE.JAKARTA.TOMCAT.COMMON.LIB]wsirtl.jar;16 (209 blocks)
The following product has been installed:
HP IA64VMS
WSIT V3.0 Layered
Product
$
C Directories and Files in the Web Services Integration Toolkit
$ set def wsi$root:[000000]
$ dir wsi$root:[000000…]
Directory WSI$ROOT:[000000]
Apache_Software_License_V1_1.txt;1 Apache_Software_License_V2_0.txt;1
deploy.dir;1
docs.dir;1 lib.dir;1 samples.dir;1
src.dir;1
tools.dir;1
wsi-version.txt;1
Total of 9 files.
$ dir [deploy]
Directory WSI$ROOT:[deploy]
AcmsApp.exe;1 AcmsApp.wsi;1 math.exe;1 math.wsi;1
wsi-default.wsi;1
Total of 5 files.
$ dir [docs]
Directory WSI$ROOT:[docs]
generator.dir;1
runtime.dir;1
wsit-develop.doc;1
wsit-develop.html;1 wsit-develop.pdf;1
wsit-develop.ps;1 wsit-develop_files.dir;1
wsit-install.doc;1
wsit-install.html;1 wsit-install.pdf;1
wsit-install.ps;1
Total of 11 files.
$ dir [lib]
Directory WSI$ROOT:[lib]
velocity-dep-1_4.jar;1 wsi$ana2wsi.exe;1 wsi$stdl2wsi.exe;1 wsirtl.jar;1 wsisamplesutil.jar;1
Total of 5 files.
$ dir [samples]
Directory WSI$ROOT:[samples]
acms.dir;1
c.dir;1
cobol.dir;1 fortran.dir;1
Total of 4 files.
$ dir [samples.acms]
Directory WSI$ROOT:[samples.acms]
acms-sample.readme;1 acmscaller.java;1 ACMSEXAMPLE_SETUP.COM;1
EMPLOYEE_INFO_APPL_WSI.ADF;1 WSI_ADD_EMPL_INFO.TDF;1
WSI_EMP_INFO_TASK_GROUP.GDF;1 WSI_GET_EMPL_INFO.TDF;1
WSI_PUT_EMPL_INFO.TDF;1
Total of 8 files.
$ dir [samples.c]
Directory WSI$ROOT:[samples.c]
math-sample.readme;1 math.c;1 mathcaller.java;1
stock-sample.readme;1 stock.c;1 stockcaller.java;1
Total of 6 files.
$ dir [samples.cobol]
Directory WSI$ROOT:[samples.cobol]
COBOLADD.CBL;1
CobolAddCaller.java;1
Total of 2 files.
$ dir [samples.fortran]
Directory WSI$ROOT:[samples.fortran]
swap.for;1
swapcaller.java;1
Total of 2 files.
$ dir [src]
Directory WSI$ROOT:[src]
COPY-TO-TOMCAT.COM;1 unpack-wsisrc.com;1 wsisrc.jar;1
Total of 3 files.
$ dir [tools]
Directory WSI$ROOT:[tools]
ant.dir;1
bwx2idl.readme;1
idl2code.jar;1 obj2idl.exe;1
openvms-basetypes.xml;1 openvms-integration.xsd;1
stdl2idl.jar;1
templates.dir;1 validate.jar;1 wsi-javadoc.com;1
wsi-setenv.com;1
Total of 11 files.
$ dir [tools.ant]
$ dir [tools.templates]
Directory WSI$ROOT:[tools.templates]
clientsamples.dir;1
javabean.dir;1
Master.vm;1 samples.dir;1
serverwrapper.dir;1
velocity.properties;1
Total of 6 files.
$ dir [tools.templates.javabean]
Directory WSI$ROOT:[tools.templates.javabean]
build-interface-jb-com.vm;1 Iinterface-java.vm;1
interfaceImpl-java.vm;1 structure-java.vm;1
ws-iinterface-java.vm;1
ws-interfaceimpl-java.vm;1 ws-structure-java.vm;1
Total of 7 files.
$ dir [tools.templates.serverwrapper]
Directory WSI$ROOT:[tools.templates.serverwrapper]
appname-opt.vm;1
appname-server-c.vm;1 appname-server-h.vm;1
appname-wsi.vm;1
build-appname-server-com.vm;1 methIds-h.vm;1
structkeys-h.vm;1
Total of 7 files.
$ dir [tools.templates.clientsamples]
Directory WSI$ROOT:[tools.templates.clientsamples]
appnamedocall-jsp.vm;1 appnamedocall-sess-jsp.vm;1
appnameindex-html.vm;1 appnamemethodlist-html.vm;1
appnamemethodlist-sess-jsp.vm;1 appnamepopulate-jsp.vm;1
appnamepopulate-sess-jsp.vm;1 appnamesessiontimeout-html.vm;1
appnameverify-sess-jsp.vm;1 build-appname-jspclient-com.vm;1
build-appname-sess-jspclient-com.vm;1 build-interface-pojoclient.vm;1
pojo-client.vm;1
structurepopulate-sess-jsp.vm;1
web-xml.vm;1
Total of 15 files.