Delete Objects

This document covers the following topics:

• Description

• Procedure

• Objects

• Output

• Batch Example

Description

Program

B04000

Function

Delete various Con-nect objects.

Online Input Screen

  11:23               * * *  C O N - N E C T  3  * * *                 17.07.97
  Cabinet LS                   Delete Objects                            B04000

       From Cabinet          ________  to Cabinet    ________

       Object Name           ________________________________
       Folder Name           _______________
       Keyword               _______________

       Created/Modified from 1.01.86____    to    17.07.97___

       Object Number(s)      __  __  __  __  __  __  __  __ (Default: All)

                  To select possible Objects press PF4

  Mark _ to delete Objects from Cabinets with registered Backup
         on or after 17.07.97___

       _ to prevent Deletion of Documents marked for Archive

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

Utility Parameters

Procedure

An existing Con-nect cabinet must be specified in the From-cabinet parameter. Press PF5 to display a list of all available cabinets. To select a single cabinet, mark it with either X or Y, or specify a range of cabinets by marking the first cabinet with X and the last cabinet with Y.

The keyword parameter applies only to documents and reference documents. It does not apply to folders or files.

Press PF4 to display a list of all available object types and corresponding numbers. Up to 8 object types can be marked for deletion.

If no Object-numbers are specified, most objects are deleted, depending on the remaining input parameters.

If the last registered backup for a cabinet occurred before the date indicated in the Registered-backup-date parameter and the Delete-with-registered-backup parameter is marked, objects are not deleted from this cabinet.

Notes:

1. The date for the Registered-backup-date parameter is automatically provided. It is determined by the system default and the current date. See Con-nect Administration for further information on the system defaults.
2. The date and time of a registered backup is written to the Con-nect cabinet record when you create a backup of the cabinet using the cabinet deletion control. Date and time of the last two registered backups are saved in the cabinet record. See utility B08000 Backup for further information.

Documents that have been marked for archiving are not deleted, if the parameter Prevent-deletion has been set.

When this utility is run, all deleted objects are placed in the Wastebasket. However, documents whose expiration date has passed and objects that are not stored in a folder are completely deleted from the system.

Locked documents are deleted only if they are in this status for more than 2 days.

Objects

The following object types can be deleted:

Bulletin Board

Items on a bulletin board are not deleted. They can be deleted using utility B04130 Delete Folder Contents.

Wastebasket

Items from the Wastebasket are not deleted. They can be deleted using utility B04130 Delete Folder Contents.

Calendar

Calendar entries are not deleted. They can be deleted using utility B04060 Delete Calendar Items.

Commands

When entering a command alias in the parameter Object-name, the language code must be specified as the first character and an asterisk (*) as the last character.

Menus

Menus can be deleted by specifying the language code as the first character and then the object number in the parameter Object-name (e.g. for English menus, specify 118).

PF-Keys

PF-keys are not contained in folders, nor do they have a key date. Thus, they must be specified explicitly (enter the object number).

Enter the language code as the first character and the number for the set name as the second in the parameter Object-name (e.g. 12 would delete the PF-keys in the English "Display Object" screens). The numbers for the set names are:

Number	Set Name
1	Menu
2	Display Object
3	Send
4	Editor
6	List of Objects

Output

For each object deleted, the following information is returned by this utility:

For each cabinet from which objects were deleted, the total number of objects deleted is returned.

Once all cabinets have been processed, the total number of cabinets checked is returned. From those cabinets, the number of cabinets from which items were deleted, along with the total number of items that were deleted are returned.

Batch Example

When executing this utility in batch, enter the following card in the JCL:

//CMPRT05 DD dataset

Delete all documents and user-defined objects that have not been modified since 15.Aug.96 from cabinet LS, if the last registered backup for this cabinet meets the system default requirements for days between last registered backup and cabinet deletion. This would be coded as follows:

LOGON SYSCNT2B 
MENU
B04000 LS,,,,,,15-08-96,11,88,,,,,,,X 
.
FIN