Skip to content

ZMF Functions for zFS Files

The following functions are available for z/OS Unix zFS files:

Refreshing a Unix zFS File

The Refresh option on the contextual menu for an zFS file refreshes the working copy of the data set member that is maintained by the workbench.

Deleting a Unix zFS File

The Delete option on the contextual menu for an zFS file deletes the selected file on the mainframe. As an alternative, you may press the Delete key.

A dialog box asks you if you really want to delete the file before executing your request. Click OK to proceed with deletion.

Downloading a Unix zFS File

The Download option on the contextual menu for an zFS file downloads a copy of the selected file to any directory you select on the desktop.

To download the contents of a zFS folder to the desktop:

  1. Select the Download option from the folder’s contextual menu. The File Download window displays.

  2. The Download From section of the File Download window is already populated and cannot be changed. Verify that this information is correct.

  3. In the Download To section of the File Download window, supply the desired target desktop directory for the download in the Directory text box or click the ellipsis (...) button to browse to another target directory.

  4. The Binary Data check box allows you to exclude binary files, such as executable code or graphics files, from EBCDIC-to-ASCII conversion on download. This setting applies to all subfolders and files within the downloaded folder.

    • Do not check this box if you are downloading source files, HTML or XML files, or other text files.
    • Do check this box if you are downloading compiled executables or graphics.

  5. Click OK.

  6. A progress bar displays while the file is downloading. If desired, you can do either of the following at any time during the download:

    • Click Run in Background to return to the Serena perspective while the download completes in the background.

    • Click Cancel to stop the download. If you have selected run in background and want to cancel, open the progress tab and click the red button on the right to cancel.

Editing a Unix zFS File

The Edit option for an zFS file opens that file for update on the mainframe from a GUI workbench editor. A tab in the workbench editors area displays the name of the file, while its contents appear in the main region of the tabbed pane. When you save changes in the editor, the file on the z/OS server is automatically updated.

Copy and paste operations between an open z/OS file and another desktop window, either inside or outside the workbench, are supported for compatible data types (such as text).

Browsing a Unix zFS File

The Browse option on the contextual menu for an zFS file opens the file for read-only access in a workbench editor. A tab in the editor area of the workbench displays the name of the member, while the contents appear in the main body of the tabbed pane.

Tip

Because Browse is a read-only function, you can browse a file’s contents even if it is locked against updates.

Checking In and Building a Unix zFS File

Component Checkin

The Checkin option on the contextual menu for a zFS file enables you to check in a component from a personal development library on the z/OS server to a change package managed by ChangeMan ZMF. The Checkin function in Serena Explorer is similar to the "Stage from Development" function in ChangeMan ZMF.

Component Builds

If the checked in resource is buildable, ZMF for Eclipse automatically prompts you for build job specifications at checkin. Default job cards and build jobs for the associated application are displayed in the prompt. You can omit the build step if desired.

Checkin from a development library is permitted only if the following criteria are met:

  • The filename extension must match a library type defined for the application.
  • The component in the change package must not be locked by another TSO user ID.
  • The component in the change package must not be a generated component.
  • The package must be in DEV status and its install date must be today’s date or later.

Caution

If another version of the data set member already exists in the target change package but is not locked, it will be overwritten. No warning message is displayed.

See Checking In a Component for step-by-step instructions concerning Checkin.

Back to top