# Gathering information to troubleshoot Zowe Application Framework

Gather the following information to troubleshoot Zowe™ Application Framework issues:

# z/OS release level

To find the z/OS release level, issue the following command in SDSF:


Check the output for the release level, for example:

RELEASE z/OS 02.02.00

# Zowe version and release level

  cd <zowe-installation-directory>
  cat manifest.json


Displays zowe version

    "name": "Zowe",
    "version": "1.2.0",
    "description": "Zowe is an open source project created to host technologies that benefit the Z platform from all members of the Z community (Integrated Software Vendors, System Integrators and z/OS consumers). Zowe, like Mac or Windows, comes with a set of APIs and OS capabilities that applications build on and also includes some applications out of the box. Zowe offers modern interfaces to interact with z/OS and allows you to work with z/OS in a way that is similar to what you experience on cloud platforms today. You can use these interfaces as delivered or through plug-ins and extensions that are created by clients or third-party vendors.",
    "license": "EPL-2.0",
    "homepage": "https://zowe.org",
    "build": {
      "branch": "master",
      "number": 685,
      "commitHash": "63efa85df629db474197ec8481db50021e8fdd65",
      "timestamp": "1556733977010"

# Zowe application configuration

Configuration file helps customize the Zowe app server, and is important to look at while you troubleshoot.

# navigate to zowe installation folder
cd <zowe-installation-folder>

# navigate to server configuration folder
cd zlux-app-server/deploy/instance/ZLUX/serverConfig

# display config
cat zluxserver.json

Read more about the Zowe app server configuration in the Zowe User Guide.

# Zowe Application Server ports

 # navigate to zowe installation folder
 cd <zowe-installation-folder>

 # navigate to install log directory
 cd install_log
 # list file by most recent first
 ls -lt

 # pick latest file
 cat 2019-05-02-17-13-09.log | grep ZOWE_ZLUX_SERVER_HTTPS_PORT
 cat 2019-05-02-17-13-09.log | grep ZOWE_ZSS_SERVER_PORT

# Log output from the Zowe Application Server

There are two major components of Zowe application server: ZLUX and ZSS. They log to different files.

The default location for logs for both zlux and zss is folder zlux-app-server/log. You can customize the log location by using the environment variable.

env | grep ZLUX_NODE_LOG_DIR 
env | grep ZSS_LOG_DIR  

Read more about controlling the log location here.

# navigate to zowe installation folder
cd <zowe-installation-folder>

# navigate to logs default location or custom location as described above
cd zlux-app-server/log

# custom log location can be found using environment variable

# list file by most recent first
ls -lt


List of files by most recent timestamp for both nodeServer as well ZSS.


# Error message codes

It is advisable to look into log files for capturing error codes.

# Javascript console output

Web Developer toolkit is accessible by pressing F12.

Read more about it here (opens new window).

# Screen captures

If possible, add a screen capture of the issue.

# Other relevant information

Node.js – v6.14.4 minimum for z/OS, elsewhere v6, v8, and v10 work well.

node -v

npm – v6.4 minimum

npm -v

Java – v8 minimum

java -version