Move Pending Cabinets

This document covers the following topics:


Description

Program

B05050

Function

Move the contents of a cabinet to another (already existing) cabinet.

Online Input Screen

  12:47 PM            * * *  C O N - N E C T  3  * * *                 16.Apr.98
  Cabinet LS                    Move Pending Cabinets                     B05050


      Process the following pending records:

      From Cabinet ________ to Cabinet ________

                 ('*' for all pending records)

      Mark _ to replace duplicate items

           _ to display cabinets pending for move




 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Menu  Quit
 Complete the information above and press ENTER to continue

Utility Parameters

Parameter Format Description
From Cabinet A8  
To Cabinet A8 Optional
Replace Duplicates A1 Optional/Default: no
Display Pending Cab A1 Online only

Pending Record

This utility is performed after a cabinet has been marked to be moved in Cabinet Maintenance, i.e. after a pending record has been created to identify the cabinet(s) to be moved.

Procedure

This utility reads one, several or all records pending to be moved, depending on the parameters you enter.

This utility accesses every record in the source cabinet and moves it to the target cabinet. The records for system folders (numbers 1-20) are ignored. If an item with the same name exists in the target cabinet, it is not replaced unless you mark the "replace duplicate items" field.

Invitations are not moved, they are deleted.

If the target cabinet is deleted before this utility is run, you are notified of the deletion and no items are moved.

Moving Members of Shared and Private Cabinets

Cabinet members of shared or private cabinets are not moved.

Folder/File in the Target Cabinet

Objects contained in a system folder (except folder Work) are moved to the appropriate system folder in the target cabinet.

The contents of folder TRS-XXL are moved to folder Work in the target cabinet. To ensure that folder TRS-XXL is empty when this utility is run, you should first run utility B10000 Invert Long Documents.

All other objects are moved to the same folder/file (same names) in the target cabinet. If a folder/file with that name does not exist in the target cabinet, it is automatically added.

Folders in Folders

Folder in folder relationships are usually retained. First the definitions of the folder and second-level folder (a folder within a folder) are moved and then the contents of the folders.

Folder in folder relationships are not retained when the target cabinet already contains a folder with the same name as that in the source cabinet. In this case, a message is returned after this utility is run. Then the contents of the folder in the source cabinet is moved to the folder in the target cabinet, even though this folder may not be filed in the same first-level folder.

For example, the source cabinet contains folder A1. Folders A2, A3 and A4 are filed in folder A1. The target cabinet contains folder K1, in which folders K2, K3 and A3 are filed. When this utility is run, folder A1 as well as folder A2 and A4 are copied and moved to the target cabinet, retaining the folder in folder relationship. Since folder A3 already exists in the target cabinet, only the contents of folder A3 in the source cabinet are copied and moved to folder A3 in the target cabinet.

Distribution Lists

A member of a distribution list which is itself a distribution list is not moved. Nicknames for external addresses are not moved.

TRS Documents

Documents and reference documents filed in TRS folders are deleted from the TRS Document Directory file.

If the target folder happens to be a TRS folder, incoming documents are inverted. The TRS rules for a folder are moved if this folder does not exist in the target-cabinet.

System Records

Finally, the system records defining the source-cabinet (i.e. cabinet profile, user profile, cabinet and address records as well as the system folders) remain untouched. After the utility is completed, the pending record(s) is deleted and an empty (source) cabinet remains. Mark the cabinet for deletion on the "Administration - Cabinet Maintenance" screen and then use utility B04050 Delete Pending Cabinets to delete the cabinet as a whole.

Private Flag and Security Levels

Objects marked as private are not moved. Therefore if a folder is marked as private, the folder and all of its contents are not moved. However, if a folder is not marked as private and is filed in a private folder, this folder and its contents are copied and moved to the target cabinet.

The security levels of all moved objects are reset.

Move and Delete

It is possible to have a cabinet pending to be moved and, at the same time, have it pending for deletion (utility B04050 Delete Pending Cabinets). Utility B04050 Delete Pending Cabinets does not allow deletion as long as there is a record pending to be moved.

Batch Example

All cabinets identified as pending are to be moved. Duplicate items are to be replaced. This would be coded as follows:

LOGON SYSCNT2B 
MENU
B05050 *,,X
FIN