Skip to main content
Version: v2.4.x LTS

ZSS Error Message Codes

ZSS Error Message Codes

The following error message codes may appear on ZSS log. Use the following message code references and the corresponding reasons and actions to help troubleshoot issues.

ZSS informational messages#

ZWES0013I#

ZSS Server has started. Version '%s' '%s'

Reason:

ZSS Server has started.

Action:

No action required.

ZWES0014I#

ZIS status - '%s' (name='%.16s', cmsRC='%d', description='%s', clientVersion='%d')

Reason:

The message shows status of the connection to Privileged Server: ZIS status - <OK or Failure> (name=<Privileged Server Name>, cmsRC=<RC>, description=<description, clientVersion=<version>)

Action:

if Status is OK then no action required. If Status is Failure see check <cmsRC> and description. In the cases listed below check that the ZWESISTC started task is running. If not, start it with the TSO command /S ZWESISTC:

  • cmsRC=12, description='Global area address is NULL'
  • cmsRC=39, description='Cross-memory server abended'
  • cmsRC=47, description='ZVT is NULL'
  • cmsRC=64, description='PC is unavailable'

ZWES0035I#

ZSS Server settings: Address='%s', port='%d', protocol='%s'

Reason:

Server is starting using Address=<IP address>, port=<port>, protocol=http or https

Action:

No action required.

ZWES0039I#

Installing '%s' service...

Reason:

<Service> is about to install.

Action:

No action required.

ZWES0061I#

TLS settings: keyring '%s', label '%s', password '%s', stash '%s'

Reason:

ZSS uses TLS settings: keyring <keyring> or <p12-file>, label <cert-label>, password "****" or (no password), stash <stash-file> or (no stash).

Action:

No action required.

ZWES0063I#

Caching Service settings: gateway host '%s', port %d

Reason:

Caching Service settings are gateway host <Gateway-host>, port <Gateway-port>. HA is mode enabled.

Action:

No action required.

ZWES0064I#

Caching Service not configured

Reason:

Caching Service not configured. HA mode is disabled.

Action:

No action required.

ZWES1100I#

Product Registration is enabled.

Reason:

Product Registration is enabled.

Action:

No action required.

ZWES1101I#

Product Registration is disabled.

Reason:

Product Registration is disabled.

Action:

No action required.

ZWES1102I#

Product Registration successful.

Reason:

Product Registration successful.

Action:

No action required.

ZWES1600I#

JWT will be configured using JWK URL '%s'

Reason:

JWT will be configured using JSON Web Key(JWK) at URL <url>.

Action:

No action required.

ZWES1601I#

Server is ready to accept JWT with(or without) fallback to legacy tokens

Reason:

Server is ready to accept JWT with or without fallback to legacy tokens.

Action:

No action required.

ZSS error messages#

ZWES1006E#

Error while parsing plugin definition file '%s': '%s'.

Reason:

An error occurred while parsing <plugin-definition-file>: <error-details>.

Action:

If you are a plugin developer check <error-details> and fix the error by editing <plugin-definition-file>, otherwise, report the error to the plugin vendor.

ZWES1034E#

Server startup problem: Address '%s' not valid.

Reason:

IP address nor hostname is not valid.

Action:

Use valid IP address or hostname, e.g. 0.0.0.0.

ZWES1036E#

Server startup problem: Ret='%d', res='0x%x'

Reason:

Server has failed to start.

Action:

If the next message is ZWES1037E then refer ZWES1037E. Otherwise, examine the reason code with bpxmtext command, e.g. use bpxmtext 744c7247 if you got res='0x744c7247'

ZWES1037E#

This is usually because the server port '%d' is occupied. Is ZSS running twice?

Reason:

ZSS port number is already occupped.

Action:

Check if another ZSS instance is already running, or chose another free port number and restart Zowe.

ZWES1065E#

Failed to configure https server, check agent https settings

Reason:

Failed to configure https server.

Action:

Check agent https settings.

ZSS warning messages#

ZWES1000W#

Privileged server name not provided, falling back to default.

Reason:

Privileged server name not defined in configuration file.

Action:

If your privileged server name is ZWESIS_STD then no action required. Otherwise set components.zss.crossMemoryServerName property in configuration to the correct name.

ZWES1005W#

Plugin ID was not found in '%s'

Reason:

pluginId property wasn't found in <path-to-pluginDefinition.json> file. The plugin skipped.

Action:

If you are a plugin developer add pluginId property into <path-to-pluginDefinition.json> file. Otherwise, contact the plugin vendor.

ZWES1012W#

Could not open pluginsDir '%s': Ret='%d', res='0x%x'

Reason:

Could not open <pluginsDir>: Ret=<return-code>, res=<reason-code>

Action:

Check that <pluginsDir> exists and allows reading. Examine the reason code with bpxmtext command for additional information.

ZWES1060W#

Failed to init TLS environment, rc=%d(%s)

Reason:

Failed to initialized TLS environment GSKit return code <rc>(<description>)

Action:

Ensure that ZSS certificate is configured correctly. Check GSKit return code and description for additional information.

ZWES1103W#

Product Registration failed, RC = %d

Reason:

Failed to register ZSS.

Action:

Examine the return code at [https://www.ibm.com/docs/en/zos/2.2.0?topic=requeststatus-return-codes] and correct the error.

ZWES1201W#

Could not %s file '%s': Ret='%d', res='%d'

Reason:

Unixfile REST Service could not <action> file <filename>: Ret=<return-code>, res=<reason-code>

Action:

Action depends on return/reason code. For additional information examine the reason code with bpxmtext command.

ZWES1103W#

Could not get metadata for file '%s': Ret='%d', res='%d'

Reason:

Unixfile REST Service could not get metadata for file <filename>: Ret=<return-code>, res=<reason-code>

Action:

Action depends on return/reason code. For additional information examine the reason code with bpxmtext command.

ZWES1602W#

JWK is in unrecognized format

Reason:

JSON Web Key(JWK) is in unrecognized format.

Action:

Report an issue at [https://github.com/zowe/zlux/issues]

ZWES1603W#

Failed to construct public key using JWK

Reason:

JSON Web Key(JWK) has invalid public key info.

Action:

Report an issue at [https://github.com/zowe/zlux/issues]

ZWES1604W#

JWK: failed to init HTTP context, ensure that APIML and TLS settings are correct

Reason:

Failed to init HTTP context for requesting JSON Web Key(JWK).

Action:

Check the zowe keystore configuration and specification of it within the zowe server config.

ZWES1605W#

Server will not accept JWT

Reason:

ZSS Server will not accept JWT.

Action:

No action required.

ZWES1606W#

Failed to get JWK - %s, retry in %d seconds

Reason:

Failed to get JWK - <reason>, retry in <n> seconds. ZSS Server was unable to get JSON Web Key(JWK), it will try to repeat the attempt in <n> seconds.

Action:

No action required.