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.
| Attribute | Type | Description |
|---|---|---|
| Enable System Selection Dialog | Boolean | Specifies 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 | Specifies whether the tool opens the remote file in edit or browse (read only) mode. The valid values are:
|
| Parameter No | I/O | Type | Description |
|---|---|---|---|
| 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.