Version 6.3.8 for OpenVMS
 —  Tools and Utilities  —

Copying, Moving and Renaming Objects

This section provides instructions for using the copy, move and rename functions in menu mode.

Start of instruction setTo copy, move or rename single or multiple objects

  1. In the SYSMAIN menu, select Copy (or enter C), Move (or enter M) or Rename (or enter R) and then select Programming Objects.

    An object-specification window similar to the example below appears:

    +--------------------- COPY ---------------------+
    ¦                                                ¦
    ¦                    - Source -                  ¦
    ¦ OBJECT:                                        ¦
    ¦ LIBRARY: SYSTEM          CODE: X (S)ource      ¦
    ¦ DBID:     99   FNR:  51        X (C)ataloged   ¦
    ¦ USER ID:                 XREF: n               ¦
    ¦ DATE:        -  -     :                        ¦
    ¦                                                ¦
    ¦                    - Target -                  ¦
    ¦ OBJECT:                                        ¦
    ¦ LIBRARY:                 REPLACE:              ¦
    ¦ DBID:          FNR:                            ¦
    +------------------------------------------------+
  2. In the Source section, enter all object selection criteria required for specifying the source environment. For explanations of the fields contained in this window and valid input values, see Using the Fields in an Object-Specification Window.

  3. Confirm your entries in the Source section with ENTER:

  4. Select the library required.

    The object-specification screen appears with the selected library entered in the LIBRARY field of the Source section.

  5. Choose ENTER to continue:

  6. Select one or more object types required.

  7. If you use the copy or move function, a window similar to the example below appears:

    +------------------------------------------+
    ¦X Select the specified Object(s) for copy ¦
    ¦  Copy  ALL  specified Object(s)          ¦
    +------------------------------------------+
    

    If you do not want to select all matching objects individually from a list and/or rename them in the target library, mark Copy ALL specified Object(s) by choosing DOWN ARROW, then skip to Step 10.

    Or:
    If you want to select all matching objects individually from a list and/or rename them in the target library, mark Select the specified Object(s) for copy by choosing UP ARROW if required (marked by default):

  8. Select the objects you want to process by entering X in the input fields of the X column next to the objects required. If both the source object and the cataloged object exist for a selected object, you can process only the source object or the cataloged object by replacing the S or the C respectively in the S/C column with a blank character and choosing ENTER.

  9. Once you have selected the objects required, a window similar to the one below appears.

    Copy or move function:

    +----------------------------------------------------+
    ¦X Copy selected Objects using   same    Object name ¦
    ¦  Copy selected Objects using different Object name ¦
    +----------------------------------------------------+

    Rename function:

    +-------------------------------------------------+ 
    ¦X Rename every single Object with a new name     ¦ 
    ¦  Rename all selected Objects with one new name* ¦ 
    +-------------------------------------------------+
  10. If the XREF option has been set to Y (Yes), a window similar to the example below appears:

    +--------------------- XREF ---------------------+
    ¦                                                ¦
    ¦          --- PREDICT (FDIC) Files ---          ¦
    ¦                                                ¦
    ¦    - Source -              - Target -          ¦
    ¦ DBID:         0         DBID:         0        ¦
    ¦ FNR:          0         FNR:          0        ¦
    ¦ PASSWORD:               PASSWORD:              ¦
    ¦ CIPHER:                 CIPHER:                ¦
    +------------------------------------------------+
  11. If required, replace the current database ID (DBID) and/or file number (FNR) and enter a password and a cipher code. For further information, see XREF Considerations.

  12. The object-specification screen appears, which now looks similar to the example shown below:

    +--------------------- COPY ---------------------+
    ¦ 3 Object(s) selected                           ¦
    ¦                    - Source -                  ¦
    ¦ OBJECT:  PRO*                                  ¦
    ¦ LIBRARY: TESTLIB         CODE: (S)ource        ¦
    ¦ DBID:    99    FNR: 51         (C)ataloged     ¦
    ¦ USER ID:                 XREF: ON              ¦
    ¦ DATE:        -  -     :  TYPE: all             ¦
    ¦                                                ¦
    ¦                     -Target -                  ¦
    ¦ OBJECT:  PRO*                                  ¦
    ¦ LIBRARY: TESTLIB2        REPLACE: n            ¦
    ¦ DBID:     99   FNR:  51                        ¦
    +------------------------------------------------+
  13. Confirm your entries in the Target section with ENTER.

    If the target library already contains objects with the same names specified and if the REPLACE option is set to N, for each object found a window similar to the one below appears:

    +-----------------------------------------------------------------------------+
    ¦ Object(s) already exist, do you want to overwrite source ?   Y/N            ¦
    +-----------------------------------------------------------------------------+

    See also Using the Replace Option.

  14. When the copy, move or rename function completed successfully, an appropriate confirmation message appears in the object-specification window.

Top of page