General Commands for Managing Different Types of Objects

This document covers the following topics:

General Information

The commands described in this chapter work similarly with all types of objects. The descriptions below are not repeated in later sections of this documentation which deal with the different types of objects.

Editing an Object

You can edit datasets, files, members, LMS elements and LMS element versions.

When you edit an object, an editor window appears in which you can modify the content of the object.

Start of instruction setTo edit an object

  1. Select the appropriate object (either in the object workspace or list view window).

  2. Invoke the context menu and choose Edit.

    z/VSE files only: A dialog box appears in which you enter your preferences for editing the file. You then have to choose the OK button to display the editor window.

    Preferences for z/VSE files

    Note:
    This dialog box only appears for z/VSE files, not for other types of objects.

    The selected object appears in an editor window in the content pane (the example below shows a z/VSE file).

    Edit window for VSE file

    In addition, the Edit menu is now shown in the menu bar and a special toolbar for the editor appears. See Commands for Editing an Object.

  3. Apply all required changes to the object.

  4. From the Object menu, choose Save to save your changes in the editor window.

    Or:
    Choose the following toolbar button.

    Toolbar button

    Or:
    Press CTRL+S.

    A dialog box appears informing you that the object has been saved.

  5. From the Object menu, choose Close to close the editor window.

    Or:
    Choose the following toolbar button.

    Toolbar button

    Or:
    Press CTRL+F4.

    Or:
    Or choose the standard close button at the top right of the window.

    When you close the editor window and recent changes have not yet been saved, a dialog box appears asking whether you want to save the changes. You have to choose one of the following command buttons:

    Command Button Description
    Yes Save the changes and close the editor window.
    No Abandon the changes and close the editor window.
    Cancel Return to the editor window.

Commands for Editing an Object

The following table lists the editing commands that are available in an editor window. The commands can be invoked from the Edit menu, or from a context menu which is invoked directly in the editor window. In addition to the commands, the following table also lists the toolbar buttons and shortcut keys that can be used instead of a command.

Toolbar Button Command Shortcut Key Description

Toolbar button

 Undo CTRL+Z Undo the last editing step.

Toolbar button

 Redo CTRL+Y Redo an "undone" editing step.

Toolbar button

 Cut CTRL+X Cut a marked section of code or text and copy it to the clipboard for pasting to another position in the editor window or to an external editor.

Toolbar button

 Copy CTRL+C Copy a marked section of code or text to the clipboard for pasting to another position in the editor window or to an external editor.

Toolbar button

 Paste CTRL+V Paste a section of code or text to a selected position the editor window.

Toolbar button

 Delete DEL Delete a marked section of text or code.

Toolbar button

 Select All CTRL+A Select all code or text in the editor window.

Toolbar button

 Find CTRL+F Find a string of text or code. A dialog box appears in which you can enter search criteria.

Toolbar button

 Find Next F3 Find the search string again.

Toolbar button

 Replace CTRL+H Find and replace all instances of a string of code or text. A dialog box appears, in which you can enter selection criteria for the search, and enter code or text for the replacement.

Toolbar button

 Replace Next CTRL+F3 Find and replace the next instance of a string of code or text. A dialog box appears, in which you can enter selection criteria for the search, and enter code or text for the replacement.

Toolbar button

 Go To CTRL+G Go to a specified line of code or text. A dialog box appears in which you can enter the line number.

Toolbar button

 Print CTRL+P Print using the standard Windows functionality.

Toolbar button

 Submit - Submit the object as a job.

Browsing an Object

You can display an object in read-only mode. The content of the object is then displayed a browse window. You can copy the contents, but you cannot modify it.

You can browse all objects which can also be edited. In addition, it is also possible to browse sysout datasets, jobs and active jobs.

Browsing is limited to a record length of 2500 bytes. If a record is longer, it is truncated and only the first 2500 bytes are displayed.

Start of instruction setTo browse an object

  1. Select the appropriate object (either in the object workspace or list view window).

  2. Invoke the context menu and choose Browse.

    Or:
    Press CTRL+B.

    z/VSE files only: A dialog box appears in which you enter your preferences for browsing the file. You then have to choose the OK button to display the browse window.

    Preferences for z/VSE files

    Note:
    This dialog box only appears for z/VSE files, not for other types of objects.

    The selected object appears in a browse window in the content pane (the example below shows a z/VSE file).

    Browse window for VSE file

    In addition, the Browse menu is now shown in the menu bar and a special toolbar for browse mode appears. See Commands for Browsing an Object.

  3. From the Object menu, choose Close to close the browse window.

    Or:
    Choose the following toolbar button.

    Toolbar button

    Or:
    Press CTRL+F4.

    Or:
    Or choose the standard close button at the top right of the window.

Commands for Browsing an Object

The following table lists the browsing commands that are available in a browse window. The commands can be invoked from the Browse menu, or from a context menu which is invoked directly in the browse window. In addition to the commands, the following table also lists the toolbar buttons and shortcut keys that can be used instead of a command.

Toolbar Button Command Shortcut Key Description

Toolbar button

 Copy CTRL+C Copy a marked section of code or text to the clipboard for pasting to an external editor.
Not available. Reverse Order CTRL+R Reverse the line order of code or text in an object. The last line appears at the top of the browse window, the first line at the bottom.
Not available. Refresh F5 Refresh text or code in the browse window.

Toolbar button

 Find CTRL+F Find a string of text or code. A dialog box appears in which you can enter search criteria.

Toolbar button

 Find Next F3 Find the search string again.

Toolbar button

 Go To CTRL+G Go to a specified line of code or text. A dialog box appears in which you can enter the line number.

Toolbar button

 Print CTRL+P Print using the standard Windows functionality.

Copying an Object

You can copy datasets, files, members and LMS elements.

When you copy an object, a new instance of that object is created at the location that you specify. For example, you can copy a z/OS dataset to a different z/OS node or to a BS2000 file.

Note:
The Copy command described in this section is different from the standard Windows Copy command. It does not copy any information to the Windows clipboard. Instead, it immediately places the copied object at the specified location (without the need for a Paste command).

Start of instruction setTo copy an object

  1. Select the appropriate object (either in the object workspace or list view window).

  2. Invoke the context menu and choose Copy.

    The following dialog box appears:

    Copy object

  3. From the drop-down list box, select the target object type (dataset, member, z/VSE file, librarian member, OSD file, or LMS element).

  4. Choose the OK button.

    The dialog box for the selected target object type appears.

  5. Specify the information for the target object type as described below in the appropriate section.

    Note:
    If this is the first time you are copying to the object type and if the source and target types are identical, the default values for the target object are taken from the source object. The next time the object type is selected, the previously entered values are used by default.

  6. Choose the OK button.

The following topics are covered below:

Copying an Object to a Dataset

Copy object to dataset

Note:
If you are copying from a dataset, the Node and Dataset name text boxes contain the dataset default values.

You can specify the following information:

Option Description
Node The name of an Entire System Server node.
Dataset name A target dataset name.
Volume The serial number of the volume, if the dataset is not cataloged.
Password A system password, if the dataset is to be protected.

The selected object will be copied to the specified dataset. If the target dataset does not exist, it will be allocated, if possible.

If you are copying from a dataset, the new dataset is automatically cataloged and appears in the Datasets folder.

Copying an Object to a PDS Member

Copy object to PDS member

Note:
If you are copying from a PDS member, the Node, Dataset name and Member text boxes contain the member default values.

You can specify the following information:

Option Description
Node The name of an Entire System Server node.
Dataset name The name of the dataset which will contain the new member.
Member A target member name.
Volume The serial number of the volume on which the target dataset resides (required only if dataset is not cataloged).
Password A system password, if member is to be protected.
Replace target object Activate this check box, if you are copying to a member which already exists.

The selected object will be copied to the specified member.

Copying an Object to a z/VSE File

Copy object to z/VSE file

Note:
If you are copying from a z/VSE file, the Node, Library/Dataset name, Volume, VSAM catalog and Record format text boxes contain the file default values.

You can specify the following information:

Option Description
Node The name of an Entire System Server node.
Library/Dataset name A name for the new dataset.
Volume For non-VSAM installations: required only if the dataset has no label definition. The serial number of the volume on which the target dataset resides.
VSAM catalog For VSAM installations: required only if the dataset has no label definition. A VSAM catalog name for the target database.
Password A system password, if dataset is protected.
Record format A record format, for example:
FB Fixed block.
VB Variable block.
FBA Fixed block, ANSI control characters.
Record length The logical record length in bytes.
Block size The block size in bytes.

The selected object will be copied to the specified z/VSE file. If the target file does not exist, it will be allocated, if possible.

Copying an Object to a Librarian Member

Copy object to librarian member

Note:
If you are copying from a librarian member, the Node, Library/Dataset name, Sublibrary, Member, Member type, Volume and VSAM catalog text boxes contain the member default values.

You can specify the following information:

Option Description
Node The name of an Entire System Server node.
Library/Dataset name The name of the dataset which will contain the new member.
Sublibrary The name of the sublibrary which will contain the new member.
Member A name for the target member.
Member type A type for the target member. Members can be grouped and listed according to a user-defined type, which you can specify here.
Volume For non-VSAM installations: required only if the dataset has no label definition. The serial number of the volume on which the target dataset resides.
VSAM catalog For VSAM installations: required only if the dataset has no label definition. The name of the VSAM catalog which will contain the target member.
Password A system password, if dataset is protected.
Replace target object Activate this check box, if you are copying to a member which already exists.
MSHP protect Activate this check box to bypass MSHP protection; otherwise, leave this check box blank (relevant only for the Edit command).
Inline data Relevant only for the Edit command. Choose one of the following option buttons:
Yes Indicates that the member contains SYSIPT data.
No Indicates that the member does not contain SYSIPT data.
Off Switches off the SYSIPT flag for the existing member.

The selected object will be copied to the specified librarian member.

Copying an Object to an OSD File

Copy object to OSD file

Note:
If you are copying from an OSD file, the Node and File name text boxes contain the file default values.

You can specify the following information:

Option Description
Node The name of an Entire System Server node.
File name A target file name.
Password A system password, if file is protected.
Replace target object Activate this check box, if you are copying to a file which already exists.

The selected object will be copied to the specified OSD file.

Copying an Object to an LMS Element

Copy object to LMS element

Note:
If you are copying from an LMS element, the Node, File name, Element text boxes and the Type drop-down list box contain the element default values.

You can specify the following information:

Option Description
Node The name of an Entire System Server node.
File name The name of the file which will contain the new element.
Element The name of the target element.
Type A type for the target element. For example: S - source program, M - assembler macro.
Version A version number for the target element.
Password A system password, if element is protected.
Replace target object Activate this check box, if you are copying to an element which already exists.

The selected object will be copied to the specified LMS element.

Deleting an Object

You can delete datasets, files, members, z/OS and z/VSE jobs, sysout datasets, LMS elements and element versions, BS2000 job variables, and duplicated nodes.

Start of instruction setTo delete an object

  1. Select the appropriate object (either in the object workspace or list view window).

  2. Invoke the context menu and choose Delete.

    Or:
    Press DEL.

    A dialog box appears, asking to confirm the delete function for the selected object.

  3. Choose the Yes button to delete the object.

Renaming an Object

You can rename datasets, files, members, LMS elements and element versions, and BS2000 job variables.

Start of instruction setTo rename an object

  1. Select the appropriate object (either in the object workspace or list view window).

  2. Invoke the context menu and choose Rename.

    Or:
    Press F2.

    The name is selected so that you can immediately enter a new name. Any text you enter automatically deletes the selection.

    Note:
    If you want to cancel your modifications, press ESC.

  3. Enter a new name for the object.

  4. Press ENTER.

    Or:
    Click any other position in the object workspace or list view window.

Sending an Object to an E-mail Recipient

You can send datasets, files, members, sysout datasets, z/VSE jobs, LMS elements and element versions to one or more e-mail recipients.

Start of instruction setTo send an object to an e-mail recipient

  1. Select the appropriate object (either in the object workspace or list view window).

  2. Invoke the context menu and choose Send To.

    A dialog box appears. The following example shows the dialog box which appears when you have selected a dataset.

    Send object

  3. Specify the following information:

    Option Description
    To Enter the e-mail address of the recipient. If you want to send the object to more than one recipient, use a semicolon to separate the e-mail addresses.
    Cc Optional. Enter the e-mail address of one or more persons who are to receive a copy (Cc).
    Subject Optional. Change the default subject heading.
    Comment Optional. Enter a short message.

  4. Choose the OK button to send the object.