IBM Support

BAQR7039E z/OS Connect API package location /var/zosconnect/servers/my_api_folder/resources/zosconnect/apis does not exist

Question & Answer


Question

Why would I have a problem with directory not being found after creating a new z/OS Connect Enterprise Edition (EE) server? I get the following message in STDERR of the server STC:

BAQR7039E: z/OS Connect API package location /var/zosconnect/servers/my_api_folder/resources/zosconnect/apis does not exist.

This happens even though at this point the server is fresh and I have not attempted to deploy the API.

When I try to deploy from the Eclipse API Editor tooling I get:

BAQR7026E: z/OS Connect API package install failed. An IO error occurred during installation.
BAQR7033E: Internal server error.

Answer

This problem maybe due to an omission in the default server template shipped by the z/OS Connect EE v2.0 product. To ensure servers are created correctly from the default template the manual fix documented in the ++HOLD data of PTF UI38699 has to be applied.

PTF UI38699 requires that a user with suitable authority creates directory <zos_connect_install_directory>/runtime/templates/servers/default/resources/zosconnect/apis

To fix the default server template do the following. At an OMVS command prompt enter the commands:

  • su -

  • umask 0002

  • mkdir -p <zos_connect_install_directory>/runtime/templates/servers/default/resources/zosconnect/apis

If the default server template directory has not been fixed when a server is created from the default template the new server will be created but will be missing the resources/zosconnect/apis directory. The resources/zosconnect/apis directory is the default location for configuring and deploying APIs, if the default API location is referenced and does not exist the error message BAQR7039E is generated.

At an OMVS command prompt go to the server's configuration directory and enter the commands:

  • umask 0002

  • mkdir -p resources/zosconnect/apis

NOTE: the default server configuration directory is /var/zosconnect/servers/<server_name>

Paul Fresson
IBM z Systems Software Engineer

[{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSGMGV","label":"CICS Transaction Server"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Component":"","Version":"","Line of Business":{"code":"LOB35","label":"Mainframe SW"}},{"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSNPJM","label":"IBM z\/OS Connect"},"Platform":[{"code":"PF035","label":"z\/OS"}],"Line of Business":{"code":"LOB35","label":"Mainframe SW"}}]

Product Synonym

CICS/TS CICSTS CICS TS CICS Transaction Server;zCEE

Document Information

Modified date:
14 February 2023

UID

dwa1315875