Open MVS File

Function:

This tool is used to open the remote file belonging to the selected element being edited or browsed (read only) in the editor. The tool enables you to use IDz editor facilities (for example, downloading copybooks based on property groups) while working with a Micro Focus z/Server connection. Mapping between the Micro Focus z/Server connection and an IDz z/OS Server connection has to be defined. You can define the mapping in the IDz z/OS Server Mapping list, in the Server Settings dialog page in the properties dialog of any subsystem.

You can use the tool to open an MVS file for editing or browsing if it is associated with an RSED connection. When the connection used with the AWM model containing this tool is an RSED connection, then the RSED connection is used for the remote edit or browse of MVS files.

Tool Attribute:

Attribute Type Meaning
Enable System Selection Dialog Boolean Whether a dialog should open to select a IDz z/OS Server connection, if no valid mapping is defined in the Micro Focus z/Server connection. The behavior of the tool based on this attribute is described in the table below.
Mode Selection Determines whether the tool opens the remote file in edit or browse (read only) mode. The valid values are:
  • Edit
  • Browse

Parameters:

Parameter No I/O Type Meaning
1[M] I File References the file on the remote system that should be opened in browse or edit mode.

Behavior of the tool depending on the 'Enable Connection Dialog' tool attribute:

Enable Connection Dialog Attribute IDz z/OS Server Mapping Dialog Result Result
True Not Set OK pressed IDz editor facilities are available
True Not Set Cancel pressed IDz editor facilities are not available
True Set and valid No dialog is opened  IDz editor facilities are available
True Set and invalid OK pressed IDz editor facilities are available
True Set and invalid Cancel pressed IDz editor facilities are not available
True Not set and no IDz z/OS Server connection available No dialog is opened    Error Message
False Not Set No dialog is opened    IDz editor facilities are not available
False Set and invalid No dialog is opened    Error Message
False Set and valid No dialog is opened    IDz editor facilities are available

The connection dialog opens only once. If an RSED connection is selected in the dialog, then the connection is used for later edit/browse scenarios without opening the dialog again.