Archive

With the tool »ARCUTIL.EXE« you have the possibility to recreate or to modify these. Notice that it may not always be possible to reconstruct the contents of the »Subject« field. In that case the notice »ArcUtil Recover« is indicated as subject.

You can take the particular functionalities from the following links:

• Important Notices
  
• Functionality
  
• Programme Start
  
• Restore the ARCHIVE.DAT
  
• Restore the ARCHIVE.DIR
  
• Search and replace path indications
  

Accordingly effect a backup in either case, before using the tool ArcUtil!

• back to function selection
  

Functionality
Tobit ArcUtil is a programme, which allows the belated editing of an already existing DvISE Archive Structure. For example it could be used to repair faulty entries within DvISE Archives. Beyond that you should naturally be keen to find and correct the reason for that defect, to avoid a repeated appearance!
The DvISE Archive Structure constists of several particular directories (Archives).Within these archives the particular messages (Fax, Voice, eMail, TMail) are saved as files. For every archive exsists a system file (ARCHIVE.DAT), where all messages are listed, which are located in this archive. If an archive cotains further subarchives, an additional system file exists (ARCHIVE.DIR), where all these direct subarchives are listed. Generally the system files have the following file names:

• ARCHIVE.DAT
  List of entries in the actual archive
  
• ARCHIVE.DIR
  List of direct subarchives in the actual archive

Both files are generated automatically and have a special structure.Therefore they must not be edited or changed with a conventional Text Editor! If defects in the archive structure occur now, you can use the programme ArcUtil to repair these defects. But notice that the recovery of data, respectively the archive structure, is not guaranteed in all cases!

ArcUtil offers the following functions:

• Recovery of ARCHIVE.DIR
  
• Recovery of ARCHIVE.DAT
  
• Search and replace path indication (e.g. Servername, Volume) in the system files, optional also in all other subarchives

• Back to the functions selection
  

Programme Start
Register from a Workstation as user with administrator rights at theDvISE Server. Effect a drive mapping on the DvISE Server (e.g. drive F:), if it does not already exsist. If your DvISE Installation is located on a computer, which works with Windows NT, ArcUtil can be executed directly on this computer.

Start ArcUtil by effecting the file ARCUTIL.EXE from the directory\DAVID\UTIL\WINDOWS of the DvISE Server. The programme window opens. Type into the field »Path« the complete path to the DvISE Archive which should be edited. You can type in the path directly into the field or select the »Search« button. Please notice that you do not have to indicate the Show Names of the archives (the names which are displayed in the Tobit InfoCenter), but their Real Names (the names, where the concerning directories have been created on the hard disk). If you do not know the exact Real Name of the desired archives you can see the entire path in the Tobit InfoCenter. Therefore mark the regarding archive and choose »Features« out of the context menu (right mouse button). Afterwards click on the archive symbol(blue cabinet) to display the actual path.

Make sure, that the correct name of the DvISE Server is indicated in the field »Server«, whose archive structure should be edited. If the path indication has been effected completely including mapped drive letter respectively as UNC path including server name, the contents of the »Server« field will be adjusted automatically. Through the button »Search« located right next to this field you can select the according Server out of all servers of the network which are available. Further adjustments adapt to the intention, what ArcUtil should be used for. Therefore read the following chapters.

If the DvISE Service Layer (DAVID.NLM bzw. SL.EXE) actually runs on the server, ArcUtil generates a warning notice, before it effects an action. The user can decide, whether ArcUtil should continue or not. If possible you should unload all DvISE modules before operating with ArcUtil, because it might cause problems, if you would like to make any changes in an archive for example, on which a CSS-Port or the WebBox accesses at the same time.

• Back to the function selection
  

Through recovery of the ARCHIVE.DAT at least the access to the actual messages is possible. So you can open a fax or an email for example, but the subject or the sender indication is deleted, because this information has been in the ARCHIVE.DAT. All recovered entries get the standard subject »ArcUtil Recover«. If the ARCHIVE.DAT should be just damaged, and not deleted, the still exsisting information could possibly be assumed by recovering. Therefore activate the Checkbox »create from old DAT«. The possibly existing ARCHIVE.DAT will be renamed into ARCHIVE.BAK by ArcUtil.

While recovering the global send and incoming protocols (DAVID.LOG, DAVID.REC) are scanned. It will be checked, whether the names of the messages, which are in the archive, exsist within these protocols. If that is the case, these data sets can be reconstructed with the correct entry information.

But this search does not have any sense, if the according entries have been deleted from the global protocols by the data simplification. The search will also be unsuccessful, if the entries have been displaced within the DvISE Archive, because in this case file and path name have changed. In large protocols the search will take a lot of time. For that reason you can deactivate this function, by activating the control casket "do not involve LOG". With »Scan Directories« you can define, whether ArcUtil should effect the desired action just for the selected archive or also for all subdirectories. Activate this control casket, if subarchives should be involved. Finally confirm this selection of options with »OK«. An overview of the selected adjustments will be shown, which you should proof carefully, whether everything is right.

If the adjustments are correct, click on »Yes«, to start conversion. In a special pop up window you are permanently informed about the progress of converting by appearing entries .

• Back to the function selection
  

Recovery of the ARCHIVE.DIR
Activate the Checkbox »create ARCHIVE.DIR«, if you want to use ArcUtil, to restore accidentally deleted or damaged ARCHIVE.DIR files. In every archive, which disposes of direct subarchives, there is a file named ARCHIVE.DIR. This file contains a list of all direct subarchives of the actual archive. If this file should be damaged or missing, the according subarchives in the Tobit InfoCenter could neither be displayed nor opened.

ArcUtil creates a new ARCHIVE.DIR, where all subarchives are listed, which are located in the actual archive. The directory name (Real Name) of a subarchive corresponds to its Show Name, which e.g. is displayed in Tobit InfoCenter afterwards. If a ARCHIVE.DIR file should still be located in the actual archive, it will be renamed into ARCHIVE.DI_. Notice that individual features which have been made before for this archive as well as their Show Names will not be available after recovery.

Over the function »scan directories« you can define, whether ArcUtil should effect the desired action just for the selected archive or also for the included subarchives. Activate this control casket, if the subarchives should be involved.
Afterwards confirm the selection of options by »OK«. An overview of the selected features appears, which you should proof on whether everything is right.

If the features are correct click on »Yes«, to start the conversion. In a special pop up window you are permanently informed about the progress of converting by appearing entries .

• Back to the function selection
  

Search and replace path indications
Searching and Replacing of path indications is necessary, if e.g. the server name and/or the volume of the DvISE installation have changed and the archive structure should be adjusted accordingly. In that case changes going out from the Archive Root (\DAVID\ARCHIVE) have to be effected over the entire archive tree. For this purpose activate the function »scan directories«, to involve all subarchives.

The following files are included and will be adjusted accordingly within the process:

• ARCHIVE.DAT
  List of entries in the actual archive
• ARCHIVE.DIR
  List of direct subarchives in the actual archive
• ARCHIVE.ADD
  Various adjustments (archive features)
• ARCHIVE.URT, *.URT
  Tobit InfoCenter Allocations

First of all click on the index card »Search and replace«. Here you can indicate the string that should be searched for, as well as the one, which should be attached instead. Before you start the process, you should proof the particular path indication in the ARCHIVE.DIR respectively ARCHIVE.DAT with a HEX Editor for security resons. Such a path indication could be e.g.: OLD_SERVER\SYS:DAVID\ARCHIVE\USER\080000BD.
If you want to replace the server name and the volume now, the path e.g. would be as follows: NEW_SERVER\VOL1:DAVID\ARCHIVE\USER\080000BD.

Now the path indications, you must enter into the index card »Search and replace« stand firm. You have to pay attention on the correct spelling, because faults in the syntax may leed to data leakage! Here it is important that you e.g. do not replace a Backslash (\) with a Slash (/). Furthermore no additional Slash or Backslashmust be inserted behind the colon of a volume indication:

False:NEW_SERVER/VOL1:\DAVID \ARCHIVE \USER \080000BD
Right:NEW_SERVER \VOL1:DAVID \ARCHIVE \USER \080000BD

The upper and lower case is not important wíthin the path indication, because ArcUtil automatically converts all small letters into capital letters.
Finally confirm the agreed indications with »OK«. An overview of the selected features appears, which you should proof on whether everything is right.
If the features are correct click on »Yes«, to start the conversion. In a special pop up window you are permanently informed about the progress of converting by appearing entries .

• Back to the function selection
  

You can receive further information about the particular tools from the Tobit Partners or directly from Tobit Software.