Skip to content

ZMF Functions for Data Set Members

The functions available for individual data set members differ from those for data sets. The following ZMF functions are accessible from the data set member contextual menu:

Editing a Data Set Member

The Edit option for a data set member on the z/OS host opens that member for update in a workbench editor. A tab in the workbench editors area displays the name of the member, while its contents appear in the main region of the tabbed pane. When you save changes in the editor, the data set member on the z/OS server is automatically updated (as long as you have the authority on z/OS to do so).

Copy and paste operations between an open z/OS data set and another desktop window, either inside or outside the workbench, is supported for compatible data types.

Browsing a Data Set Member

The Browse option on the contextual menu for a data set member opens that member for read-only access in a workbench editor. A tab in the editors 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 data set member’s contents even if it is locked against updates. If you use the default editor, you can see that it is browse by the RO in the header. For example //C001/RO/dsname/membername.type.

Downloading a Data Set Member

The Download option on the contextual menu for a data set member downloads a copy of the selected member as a single file to any directory you select.

To download a data set member, perform the following steps.

  1. Select the Download option from the contextual menu for the member to be downloaded. The Data Set Download window displays.

    The Download From section of the Data Set Download window is already populated with the dataset name and member and cannot be changed.

  2. Verify that this information is correct.

  3. In the Download To section of the Data Set Download window, supply the desired target desktop directory information for the download.

    • Directory — Supply the path to the target directory for the download. Click the ellipsis (...) button at right to navigate to a target directory.

    • Extension — Type the filename extension that will be appended to all member file names during the download.

  4. To override the default mapping of the Windows file extension in the Extension text box, type a desired file extension in this field. (By default, the Extension text box shows the Windows file extension defined for the selected z/OS member library type by library-to-file-type mapping parameters in the ZDDOPTS configuration library of ChangeMan ZMF.)

  5. Click OK.

    A window will display progress, or you can select run in background, then a progress bar displays in the bottom right corner of the window while the member is downloading.

  6. You can observe the progress of the download or cancel it as follows:

    • Click the icon in the corner (hover the mouse and it will say "Shows background operations in Progress view") to observe progress as the download completes in the background.

    • Click the red box (hover the mouse and it will say "Cancel Operation") at the right of the progress bar to stop the download.

    On completion, the progress bar will disappear.

Checking In and Building a Data Set Member

Component Checkin

The Checkin option on the contextual menu for a data set member 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 ZMF for Eclipse is similar to the Stage function in the ISPF interface to 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 library type of the member 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.

Important

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

Submitting a Job for Execution

Executing Mainframe Jobs

Executable data set members on the mainframe may be submitted to z/OS for execution using the Submit Job option on the contextual menu for a data set member. Output from the executing job is saved to the z/OS JES (Job Entry Subsystem) spool and can be viewed under the z/OS Jobs node in the Serena Explorer view.

Note

There is no automated build support or job card insertion associated with the data set Submit Job function, as the job is being submitted from a personal development library outside the control of ChangeMan ZMF. You must include all required job cards and JCL statements with the submitted job.

Submitting an XML Services Request

  • XML Services Requests

    Requests that invoke the ChangeMan ZMF XML Services API may be submitted for execution using the Submit XML option. Only single members or individual files may be submitted using this command. You can edit your XMLIN dataset member, to prepare it for submission, and save it, and then submit directly from the list of members.

  • XML Services Replies

    Output from the XML Services request is displayed (named as membername.xml) in an editor window in the Serena perspective of ZMF for Eclipse. The resulting data stream may be edited and saved on the desktop or in the repository as desired.

  • XML Services Syntax

    Refer to the ChangeMan ZMF XML Services User’s Guide for information on coding ZMF XML Services requests.

Deleting a Data Set Member

The Delete option on the contextual menu for a data set member deletes the selected member from the z/OS data set on the host. As an alternative, you can press the Delete key to delete a data set member. You will be prompted to confirm the Data Set Member delete before executing your request. If you elect to delete, the member list is refreshed immediately.

Refreshing a Data Set Member

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

Back to top