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

Using the Zowe Desktop

Last updated
:  |
... min read
|
Edit this page
Print
Open doc issue

Using the Zowe Desktop

You can use the Zoweâ„¢ Application Framework to create application plugins for the Zowe Desktop. For more information, see Extending the Zowe Application Framework.

From the Zowe Desktop, you can access Zowe applications.

Accessing the Zowe Desktop​

From a supported browser, open the Zowe Desktop at https://zowe.externalDomains[0]:zowe.externalPort/zlux/ui/v1/ or you can navigate to the direct Desktop URI at https://zowe.externalDomains[0]:zowe.externalPort/zlux/ui/v1/ZLUX/plugins/org.zowe.zlux.bootstrap/web/index.html

Where:

  • zowe.externalDomains is the host on which you are running the Zowe Application Server, its the value that was assigned in the zowe configuration file.
  • zowe.externalPort is the value of Gateway port that was assigned in the zowe configuration file.

Logging in and out of the Zowe Desktop​

  1. To log in, enter your TSO credentials in the Username and Password fields.
  2. Press Enter. Upon authentication of your user name and password, the desktop opens.

To log out, click the User icon in the lower right corner and click Sign Out.

Changing user password​

  1. Open the Preferences panel by clicking on the Preferences icon in the bottom right of the desktop.
  1. Click the Change Password icon.
  2. Fill out the Old Password and New Password fields.
  3. Upon successful password change, you will be taken to the desktop.

Updating an expired password​

  1. Upon logging in with an expired password, a screen will be displayed prompting you to change your password.
  2. Enter and confirm your new password in the corresponding fields.
  3. Upon successful password change, you will be taken to the desktop.

Pinning applications to the task bar​

  1. Click the Start menu in the bottom left corner of the home screen.
  2. Locate the application you want to pin.
  3. Right-click the application icon and select Pin to taskbar.

Open application in new tab​

  1. Click the Start menu in the bottom left corner of the home screen.
  2. Locate the application you want to open in new tab.
  3. Right-click the application icon and select Open In New Browser Tab.

  • While opening an application in new tab you can also do the following:

    • You can use url to send data to the application, for example you would specify https://zowe.externalDomains[0]:zowe.externalPort/zlux/ui/v1/ZLUX/plugins/org.zowe.zlux.bootstrap/web/?pluginId=org.zowe.editor:data:{"type":"openFile","name":"<path of file>"}
    • You can use url to open application directly on browser with and without credentials using showLogin in url.
      1. If showLogin = true then you need to login with your credentials before using an application for example. https://zowe.externalDomains[0]:zowe.externalPort/zlux/ui/v1/ZLUX/plugins/org.zowe.zlux.bootstrap/web/?pluginId=org.zowe.terminal.tn3270&showLogin=true.
      2. If showLogin = false then you can access application directly without login.

Keyboard shortcuts​

The following keyboard shortcuts can be used in the Desktop to navigate or perform actions with only the keyboard.

Keyboard ShortcutCommand
CTRL+ALT+MOpen the Zowe launchbar menu. Use the UP/DOWN arrow keys to select an app, RIGHT arrow key to spawn context menu, ENTER to launch app, and ESC to close menu
CTRL+ALT+UPMaximize active app. Press again to restore
CTRL+ALT+DOWNMinimize active app. Press again to restore
CTRL+ALT+<Switch to next recently active app
CTRL+ALT+>Switch to least recently active app
CTRL+ALT+WClose active app

Changing application elements size​

There are 3 supported ways of changing size within the Desktop.

  1. Use your browser's zoom feature (keyboard shortcuts: Ctrl +, Ctrl - for various supported browsers) to change all elements' size. Recommended: 67%

Note: Zoom is highly variable and depends on your display size, resolution, and many other variables so the recommended zoom may not be ideal for you

  1. View the Preferences panel (see below section) to change the scale of the Desktop UI: elements like window title bar, app icons, bottom-left start menu, app tool bar etc. and excluding main app content

  2. Change an individual application's size via its window handles or minimize/maximize buttons. You can also start an application in full screen mode by right clicking on an application's icon in the taskbar and select "Open in New Browser Tab"

Tip: Did you know you can use the whole Desktop in full screen mode by using your browser's full screen feature (keyboard shortcuts: F11 for various supported browsers)?

Personalizing the Desktop​

  1. Click the Preferences icon to open the Preferences panel.
  1. Click the Personalization icon to open the menu.
  1. Drag an image into the wallpaper grid, or press the upload button, to upload a new Desktop wallpaper.
  2. To set a new theme color, select a color from the palette or hue.
  3. Use the lightness swatch bar to adjust the lightness of the color.
  • Adjusting the lightness will also change the lightness of secondary text.
  1. Select a size (small, medium, or large) to adjust the scale of the Desktop UI.

Changing the desktop language​

Use the Languages setting in the Preferences panel to change the desktop language. After you change the language and restart Zowe, desktop menus and text display in the specified language. Applications that support the specified desktop language also display in that language.

  1. Click the Preferences icon in the lower right corner.
  2. Click Languages.
  3. In the Languages dialog, click a language, and then click Apply.
  4. When you are prompted, restart Zowe.

Zowe Desktop application plugins​

Application plugins are applications that you can use to access the mainframe and to perform various tasks. Developers can create application plugins using a sample application as a guide. The following application plugins are installed by default:

Hello World Sample​

The Hello World sample application plugin for developers demonstrates how to create a dataservice and how to create an application plugin using Angular and using React.

IFrame Sample​

Github Sample Repo: sample-iframe-app

Sample Angular App​

Github Sample Repo: sample-angular-app

Sample React App​

Github Sample Repo: sample-react-app

3270 Terminal​

The 3270 Terminal plugin provides a user interface that emulates the basic functions of IBM 3270 family terminals. On the "back end," the plugin and the Zowe Application Server connect to any standard TN3270E server.

VT Terminal​

The VT Terminal plugin provides a user interface that emulates the basic functions of DEC VT family terminals. On the "back end," the plugin and the Zowe Application Server connect to VT compatible hosts, such as z/OS UNIX System Services (USS), using standard network protocols.

API Catalog​

The API Catalog plugin lets you view API services that have been discovered by the API Mediation Layer. For more information about the API Mediation Layer, Discovery Service, and API Catalog, see API Mediation Layer Overview.

Editor​

With the Zowe Editor you can create, edit, and modify the properties of files such as ownership and permissions. You can also view and edit datasets. Navigation is controlled by the File Tree. Other actions are available using the top left menu, a toolbar above the tree, or keyboard shortcuts.

JES Explorer​

Use this application to query JES jobs with filters, and view the related steps, files, and status. You can also purge jobs from this view.

IP Explorer​

With the IP Explorer you can monitor the TCP/IP stacks, view active connections and reserved ports.

MVS Explorer​

Use this application to browse the MVSâ„¢ file system by using a high-level qualifier filter. With the MVS Explorer, you can complete the following tasks:

  • List the members of partitioned data sets.
  • Create new data sets using attributes or the attributes of an existing data set ("Allocate Like").
  • Submit data sets that contain JCL to Job Entry Subsystem (JES).
  • Edit sequential data sets and partitioned data set members with basic syntax highlighting and content assist for JCL and REXX.
  • Conduct basic validation of record length when editing JCL.
  • Delete data sets and members.
  • Open data sets in full screen editor mode, which gives you a fully qualified link to that file. The link is then reusable for example in help tickets.

USS Explorer​

Use this application to browse the USS files by using a path. With the USS Explorer, you can complete the following tasks:

  • List files and folders.
  • Create new files and folders.
  • Edit files with basic syntax highlighting and content assist for JCL and REXX.
  • Delete files and folders.

On this page