Delete Pending Cabinets

This document covers the following topics:

Description

Program

B04050

Function

Delete any type of cabinet, be it private, standalone, shared or public.

Note:
If you have set the days between registered backup and cabinet deletion function in the system defaults (see the description of the system defaults in Con-nect Administration), it is recommended that you run utility B08000 Backup before you run this utility.

Online Input Screen

 12:45 PM            * * *  C O N - N E C T  3  * * *                 16.Apr.98
 Cabinet LS                    Delete Pending Cabinets                   B04050


     Process the following pending records:

     From Cabinet ________  to Cabinet ________

                ('*' for all pending records)

     Mark _ to display cabinets pending for delete





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

Utility Parameters

Parameter Format Description
From Cabinet A8  
To Cabinet A8 Optional
Display Pending Cab A1 Online only

Pending Record

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

Press PF5 to display a list of all cabinets pending for deletion.

Procedure

This utility reads one, several or all records pending (when the specified date is reached) for deletion, depending on the parameters you enter.

If a value is supplied in the system defaults for days between registered backup and cabinet deletion (see the description of the system defaults in Con-nect Administration), this utility validates that the number of days between one of the last two registered backups and the current date is less than the number defined in the system defaults. If the length of time is greater, the cabinet is not deleted, even when the specified deletion date is reached. In this case, you must run utility B08000 Backup again before the cabinet can be deleted. If a cabinet does not contain objects, it is deleted regardless whether or not a backup was created.

Note:
If cabinet deletion control is selected when utility B08000 Backup is run, the backup is registered, even if no records are found for the specified cabinet. Thus it is possible to delete the cabinet without a complete backup.

If a value is not supplied in the system defaults, the dates of the last two registered backups are disregarded.

Next, this utility deletes all objects contained in the specified cabinet(s), e.g. the contents of all folders. Then, if the cabinet is a member of a shared or a private cabinet or any distribution list, the membership is erased. Then nickname entries are deleted. Finally, the system records defining the cabinet (i.e. folders, address records, user profile and cabinet records) are deleted. After the system records are deleted, the pending for deletion record is deleted.

Thus in the case of program failure during the execution of this utility, the program can be started again without loss of data integrity.

Note:
If a cabinet pending for deletion contains a repeat delivery item, that item will be sent only one time after the cabinet has been deleted.

Processing Sequence

  1. All items contained in folders, excluding folders and files (TRS entries, if applicable, are deleted here as well)

  2. All objects not contained in a folder (e.g. calendar entries) which belong to the cabinet to be deleted (except for folder definition records)

  3. Members of shared cabinets and system distribution lists

  4. Members of any other distribution lists

  5. Shared cabinet distribution lists (if cabinet is shared only)

  6. All member records (if cabinet is shared or private)

  7. All nickname entries in all cabinets

  8. All security log entries for the cabinet

  9. All folder/file definitions

  10. Address record

  11. User profile

  12. Cabinet record

  13. Pending record

TRS Documents

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

Move and Delete

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

Batch Example

Caution:
When running this utility in batch mode, ensure that users are not active in the cabinets which are to be deleted. Since the global variables are still active, certain functions such as SEND are still possible and, thus, records can be added. When the cabinet is left, these records remain on the Con-nect file but are not accessible.

All cabinets pending for deletion are to be processed. This would be coded as follows: 

LOGON SYSCNT2B 
MENU
B04050 *
FIN