Using z/OS Connect messages in troubleshooting

How to use messages in troubleshooting.

Which version of z/OS Connect?

Check the server's messages.log file for the line starting product =

This line contains both the version of z/OS Connect and the version of the embedded WebSphere Application Server for Liberty.

  • Example for z/OS Connect Server image.
    product = WebSphere Application Server 24.0.0.12, z/OS Connect 03.00.90 (wlp-1.0.96.cl241220241119-0657)
  • Example for z/OS Connect Server started task.
    product = WAS FOR Z/OS 24.0.0.12, z/OS Connect 03.00.90 (wlp-1.0.96.cl241220241119-0657)

zosConnect-2.0 You can find which version of z/OS Connect you are running in message BAQR0000I in the <WLP_USER_DIR>/servers/{servername}/logs/messages.log file.

Severity codes

Certain messages have a severity code. For example, BAQR0652W.

A severity code indicates whether a message is associated with a warning, is for information purposes only, or whether the message is associated with an error, or a severe error.

E
Error - Something is wrong and action is required to resolve the error condition.
I
Information only - No action is required.
W
Warning - Something might be wrong, review the specific warnings condition to see whether the warning applies to your environment.
S
Severe error - Something unexpected occurred in the Host API and the z/OS application cannot continue. If this problem persists, contact IBM Support. For more information about contacting IBM Support, see Contacting IBM Support.

For more information about z/OS Connect messages, see Messages.

Message logs confirm z/OS Connect license

Started task Applies to z/OS Connect Servers run by using a z/OS started task procedure.

The message log title and registration message identify which license your company purchased. The following examples illustrate how the message logs identify the license that is purchased by your company. The examples are only for illustration purposes and include version values that change as maintenance is applied. For more information about the Program IDs, Component IDs, and FMIDs for these products, see the relevant Program Directory that is listed in Installing IBM z/OS Connect with SMP/E.

Simultaneous Instance license (5655-CE3)
Message log title
For example:
product = WAS FOR Z/OS 24.0.0.12, z/OS Connect 03.00.90 (wlp-1.0.96.cl241220241119-0657)
Message log registration message
For example:
CWWKB0108I: IBM Corp product z/OS Connect version 03.00.90 successfully registered with z/OS.

Unlimited license (5655-CE5)
Message log title
For example:
product = WAS FOR Z/OS 24.0.0.12, z/OS Connect Unlimited 03.00.90 (wlp-1.0.96.cl241220241119-0657)
Message log registration message
For example:
CWWKB0108I: IBM Corp product z/OS Connect Unlimited version 03.00.90 successfully registered with z/OS.