Browsing, locating and cloning a workspace

You can use the Runtime Environment (Workspaces) workspace to browse the available workspaces and to locate a specific workspace for cloning.

Before you begin

You must complete some administrative steps before a workspace is cloned. For more information about these steps, see Preparing for workspace cloning.

Procedure

  1. Go to the Runtime Environment (Workspaces) workspace to browse the available workspaces.
    There are a number of ways you can go to this workspace:
    • Select File > Open. To do this, place the cursor under File on the menu bar and press Enter. Then, from the File menu select option 2.
    • Select Tools > Runtime Environment from the menu bar. The Runtime Environment workspace opens. Then, move your cursor over the Workspaces button and press Enter.
    • Move your cursor over the RTE icon in the drawer and press Enter. The Runtime Environment workspace opens. Then, move your cursor over the Workspaces push button and press Enter.
    When you make one of the previous three choices, the Runtime Environment (Workspaces) KOBWENUS workspace opens. This workspace presents two workspace subpanels that provide directory lists for the user workspace data set (UKANWENU DD) and the runtime environment workspace data set (RKANWENU DD).
    Figure 1. Runtime Environment (Workspaces), locating the workspace member.
    Runtime Environment (Workspaces) showing command l kobstart
  2. Enter the Locate command at the command line, specifying the workspace that you want to search for as an argument and press Enter.
    For example, if you enter Locate KOBSTART, the directory view positions similarly to Figure 1.
    Fast path: You can shorten the Locate command to L. For example, you can enter L KOBSTART to search for the KOBSTART workspace.
  3. Place the cursor in the input field of the workspace name that you want to clone and press Enter.
    For example, to select the KOBSTART workspace, place the cursor in the input field that precedes the workspace name and press Enter.
    The Partitioned Dataset Member (KOBPDSD) view opens showing a view of the KOBSTART workspace content.
  4. Select File > Save As to clone the workspace that is being viewed.
    For example, to clone the KOBSTART workspace, place the cursor under File on the menu bar and press Enter. Then from the File menu, select option 4, Save As by typing a or 4 and pressing Enter.
    Fast path: You can fast path to File > Save As by entering f.a in the action line.
    Figure 2. Cloning a workspace by using the File > Save As menu option.
    Screen that shows the File Save As menu option
    When you press Enter, the Member Save As dialog box opens:
    Figure 3. Cloning a workspace - the Member Save As dialog box
    The Member Save As dialog.
  5. Enter the workspace name that you want to use for the cloned workspace.
    If you are cloning a product provided workspace under the assumption that it is to supersede the product provided instance of the same workspace, the Save As name that you enter must be identical to the name of the product provided workspace, for example as shown in Figure 3.
    The saved workspace is written to the user workspace data set. The original product provided workspace is preserved intact in the runtime environment data set.
    When you press Enter, the Save As action is confirmed and you are returned to the Partitioned Dataset Member (KOBPDSD) view.
  6. Press PF3 (End) to return to the Runtime Environment (Workspaces) KOBWENUS workspace.

Results

The workspace directory view for the user workspace data set now lists the cloned workspace:
Figure 4. User workspace data set that shows a cloned workspace
User workspace data set that shows a cloned workspace
Note: When you clone a product provided workspace, the cloned instance of the workspace is used by the enhanced 3270 user interface. Cloned or user customized workspaces are identified by an asterisk (*), which is displayed after the workspace name:
Figure 5. A cloned workspace is denoted by an asterisk character (*) after the workspace name
A cloned workspace that shows an asterisk character (*) after the workspace name.

What to do next

When the workspace cloning is complete, the next step is to edit and test the workspace, customizing its contents to site requirements. Use a file editor such as the ISPF editor to edit the workspace.