WebSphere on z/OS WebSphere Support Team resources, guides, and technical documents for WebSphere Application Server on z/OS. Support Help

WebSphere on z/OS

This page provides resources for running, configuring, and troubleshooting WebSphere Application Server on the z/OS platform. The content below includes WSC Techdocs archive references, ZWAS installation guidance, IBM HTTP Server on z/OS, WebSphere Liberty on z/OS, and Traditional WebSphere (TWAS) resources.

WSC Techdocs Follis Bagwell Archive Index

This page provides a summary of links to WebSphere Application Server on z/OS documents that were originally on the old Washington Systems Center Techdocs site. They can be a bit tricky to find sometimes in their new home, especially if you were used to searching for them by their original author name (i.e. Don Bagwell, Mike Loos, Mike Cox, etc). To help people find things, this spreadsheet has the title, the original author (where it could be determined), the original document number (i.e. WPxxxxxx), and the link to its current home.


ZWAS Install

ZWAS Install Documents

New Usage Patterns for IBM Installation Manager on z/OS
This document presents some best practices for simplifying the use of z/OS IBM Installation Manager to maintain and deploy sets of products across the enterprise.

Using Installation Manager portable installs on z/OS
This document explains how to use the portable installation format with z/OS IBM Installation Manager. Portable installations are collections of Installation Manager-installed products, together with their Installation Manager metadata, which can be deployed, serviced, backed-up independently, and moved across your z/OS data center.

Upgrading to Installation Manager 1.10 and above on z/OS
IBM Installation Manager on z/OS moves from 31-bit Java 8 to 64-bit Java 11 as part of Installation Manager Version 1.10. Customers upgrading to Version 1.10 or later from earlier levels must use a slightly different process to perform the upgrade.

HTTP IHS on z/OS

HTTP IHS on z/OS Documents

How to point an IBM HTTP Server 9.0 on z/OS instance at an alternate product directory
This document answers the question of how you can point an IBM HTTP Server 9.0 on z/OS instance's symlinks to an alternate product (read-only) directory.

MustGather: Documentation for diagnosing SSL failures on IBM HTTP Server for z/OS
Doc gathering instructions for problems occurring on IBM HTTP Server for z/OS with inbound or outbound TLS.

Liberty on z/OS

Liberty on z/OS Documents

Set up a Liberty collective on z/OS with SAF keyrings
A step-by-step example for setting up a collective on z/OS with Admin Center using SAF keyrings.

SimpleLogin Application – A Liberty for z/OS step by step example
This document includes a JEE application, SimpleLogin.ear, that demonstrates how to enforce TLS/SSL and enable the web authentication mechanisms of Basic Authentication, Form Based Authentication and Client Certificate Authentication in a Liberty z/OS environment using a SAF Registry with SAF Authorization and a SAF keyring Keystore.

IBM z/OS Liberty Embedded base element for z/OS Users
A table that includes APAR/PTF information for IBM z/OS Liberty Embedded base element for z/OS Users. The Embedded Liberty is shipped and maintained as part of the z/OS base operating system.

Hostname verification for Liberty for z/OS
Implications of APAR PH58796, which causes WebSphere Liberty to perform hostname verification against certificates during a TLS handshake.

Setting up the HTTP Server plug-in with SAF keyring for WebSphere Liberty for z/OS
This document describes the steps to enable TLS communication from the IBM HTTP Server on z/OS using the web server plug-in with SAF keyring to Liberty for z/OS.

Liberty on z/OS – Additional Documents

Set up Admin Center with an SSL Keyring and SAF Authorization on Liberty for z/OS
This document describes the steps needed to set up Liberty with TLS communication using a RACF/SAF keyring, and to set up roles for SAF authorization to access the Admin Center.

Enabling hardware cryptography for Liberty for z/OS using Java 8
This document provides the steps necessary to enable the Java 8 IBMJCECCA and IBMJCEHYBRID providers to make use of hardware cryptography, and to provide failover from hardware to software providers when running in a Liberty for z/OS server.

Enabling hardware cryptography for Liberty for z/OS using Java 11, Java 17, or Java 21
This document provides the steps necessary to enable the IBMZSecurity, IBMJCECCA and IBMJCEHYBRID providers to make use of hardware cryptography, and to provide failover from hardware to software providers when running with Java 11, Java 17 or Java 21 in a Liberty for z/OS server.

Connecting from Liberty for z/OS to Db2 with the type 4 JDBC Driver over SSL
This document describes the steps to enable TLS communication from Liberty Application Server for z/OS to Db2 with the type 4 JDBC driver. AT-TLS configuration is set up for inbound connections to Distributed Data Facility (DDF).

Using SITE certificates with Liberty for z/OS
This document demonstrates how two Liberty servers on z/OS can be configured to share the same personal certificate. A SITE personal certificate can be shared with multiple Liberty servers running under different IDs.

MustGather: Documentation for diagnosing SSL handshake failures on Liberty Application Server for z/OS
Use this document for problems occurring on Liberty Application Server for z/OS with inbound or outbound TLS.

WebSphere Application Server for z/OS V6
The objective of this document is to help you achieve preliminary success with the Liberty Profile on z/OS as quickly as possible. It provides a series of step-by-step exercises that start with the simplest elements of the Liberty Profile, then build on that to introduce more complex topics.

Liberty z/OS Review of “Good Practices”
The goal of this material is to provide a framework of understanding how Liberty, and Liberty z/OS specifically, operates and can be used. Included is a set of good practice recommendations to help you get the most out of Liberty z/OS.

Traditional WebSphere Application Server (TWAS) on z/OS

TWAS on z/OS Documents

MustGather: High CPU causing hang or loop running on z/OS
MustGather for problems with the WebSphere Application Server for z/OS experiencing High CPU. This technote explains how to obtain a dump of an address space in a WebSphere Application Server for z/OS environment.

MustGather: Plug-in problems in WebSphere Application Server for z/OS
MustGather for Plug-in problems with IBM WebSphere Application Server for z/OS V8.5 and V9.0. Gathering the information before calling IBM support helps familiarize you with the troubleshooting process and saves you time.

MustGather: Documentation for diagnosing SSL handshake failures on WebSphere Application Server for z/OS
For problems occurring on WebSphere Application Server for z/OS with inbound or outbound TLS, this documentation can be collected (MustGather) before contacting support to expedite problem resolution.

WebSphere Application Server for z/OS slow startup
On z/OS, if too many FFDC files are allowed to accumulate in the FFDC log directory, start-up of WebSphere Application Server can take a very long time.