VSI-I64VMS-WSIT-V0305-0D-1-RNOTES.PDF

This document describes the Web Services Integration Toolkit (WSIT) for OpenVMS I64, Version 3.5D (February 2021), a collection of tools designed to integrate OpenVMS 3GL applications (C, BASIC, COBOL, FORTRAN, ACMS) with modern programming languages and technologies like Java, C#, Python, and JavaScript.

Key Updates in this Release:

• Enhanced Server Configuration: New XML tags (<protocol>, <CLOPT>) for out-of-process server configuration in server configuration files.
• RabbitMQ/AMQP Support: Introduction of a generic RabbitMQ consumer component (wsi$server_amqp.exe) for AMQP-based out-of-process deployments, replacing the traditional WSIT ICC protocol. The ICC-based server is renamed to wsi$server_icc.exe.
• Expanded Language Support: New Velocity templates and libraries to facilitate interface generation and communication with OpenVMS servers for Java, C#, Python, and JavaScript using RabbitMQ AMQP.
• RESTful Microservices: Support for a Node.js-based RESTful microservices framework for implementing REST-based web service interfaces.
• Management Tool: A new command-line tool (wsiman.exe) for managing WSIT applications (start, stop, monitor).

Requirements:

• Hardware: Approximately 80,000 disk blocks for installation.

• Software (OpenVMS):

  • OpenVMS I64 Version 8.4-1H1 or higher.
  • ODS-5 disk.
  • VSI C V7.4-001 or higher (for building server components).
  • OpenJDK 8 for VSI OpenVMS I64 (for Java development/runtime).

• Account Privileges: Specific privileges (e.g., NETMBX, TMPMBX with WSI$SERVER identifier, or a broader set like BYPASS, SYSPRV, DETACH) are required for accounts running out-of-process servers or the WSIT toolkit itself.

Installation & Configuration:

• Procedure: Installed via an OpenVMS PCSI kit (PRODUCT INSTALL WSIT).
• Pre-installation: Requires shutting down any previous WSIT versions (WSI$SHUTDOWN.COM ALL) and performing a system disk backup.
• Post-installation: Requires modifying system startup (SYSTARTUP_VMS.COM) and shutdown (SYSHUTDWN.COM) procedures to include WSIT commands.
• Starting/Stopping: Uses @SYS$STARTUP:WSI$STARTUP.COM and @SYS$STARTUP:WSI$SHUTDOWN.COM ALL commands.
• Directory Structure: The toolkit installs into a root directory represented by the logical WSI$ROOT, containing subdirectories like deploy, docs, lib, samples, tools, and source.

Performance Recommendations (for Java on OpenVMS):

• Increase the PRCLM quota and specific UAF/system parameters like FILLM, CHANNELCNT, WSDEF, WSQUOTA, WSEXTENT, WSMAX, PGFILQUO, BIOLM, DIOLM, TQELM, and crucially, BYTLM (recommended 6,000,000) and CTLPAGES for environments with many concurrent ICC connections to prevent exceptions.

Known Issues:

• The AXIS2 java2WSDL tool may convert property names to lowercase, requiring manual adjustment of WSDL files or using lowercase in the WSIT IDL.
• The wsi$root:[lib]wsirtl.jar file must be copied to the server's classpath (e.g., Tomcat's common/lib) for web server/application server integration.