Name

decedi_arch − The decedi_arch command is a utility that moves DEC/EDI data from the primary on-line archive area to a secondary, and possibly off-line area. The aim of this is to remove data from the on-line system that is no-longer used whilst retaining some or all of it for recovery or auditing purposes. 
 

By default, all audit trail entries, and the physical transmission files up to midnight yesterday (i.e. ignoring todays entries) will be archived.  All other files associated with the audit trail entries, for example, detailed listings, and any audit history will be deleted. 
 
 
 

FORMAT

 
decedi_arch [-v] [-c archive_objects] [-b date ] [-a date ] [-o outspec ] [-f arcflg ]
 
 
 
 
 

Flags

-vSwitches on verbose processing. This displays informational messages describing the current phase of the archive and its duration. 
 

-c archive_objectsSpecifies the contents of the archive, where archive_objects is one or more sub-flags which define the subset of information archived.  These sub-flags represent the following:
 
 
 

• h, requests that historical information is included in the archive. 
 

• i, requests that in-house files are included in the archive. 
 

• e, requests that external format files are included in the archive. 
 

• l, requests that error listings are included in the archive. 
 

• d, requests that detailed listings are included in the archive. 
 

• t, requests that transmission files are included in the archive. 
 

• m, requests that mapper history files are included in the archive. 
 

• n, requests that nothing apart from audit information is included in the archive. This flag overrides all preceeding flags. 
 
 

Note that document, transmission file and mapper audit (event) information is always archived. The default for this flag is ’t’ which archives only transmission files (along with the audit information). 
 

 Also note that the presence of the n flag disables the archiving of transmission files. Thus, if you only wanted historical information archived then specifying ’-c nh’ would result in the desired archive contents. 
 

-b dateIntroduces the end date (in DDMMYYYY format) of the selection window (i.e. entries must have been created before this date to be selected). 
 

By default, all entries up to midnight yesterday (i.e. ignoring todays entries) will be archived. 
 

-a dateIntroduces the start date (in DDMMYYYY format) of the selection window (i.e. entries must have been created after this date to be selected). 
 

By default, all entries starting from the first entry will be archived. 
 

-o outspecDefines where the archive will be placed. For example, to specify a tape device, use a ’character device’ special file name, such as /dev/rmt0h. 
 

By default, the archive will be created in a disk file located in /var/adm/decedi/backup/DECEDI_<date>, where <date> ia the current date, in the format YYYYMMDD. 
 

-f arcflgSpecifies the set of flags that should be passed to the archive mechanism (for example, do not rewind the tape). Multiple flags should be enclosed in double quotation marks. 
 

By default, no extra flags are passed to the archive mechanism. 
 
 
 
 

Examples

  # decedi_arch -v -b 01031995 -o ./decedi_archive.tar -c it -f "-l -i"
initializing environment at Fri May  5 06:22:13 1995
selecting documents to archive at Fri May  5 06:22:16 1995....
total of 335 documents selected by Fri May  5 06:22:18 1995.
selecting transmissions to archive at Fri May  5 06:22:18 1995....
total of 67 transmissions selected by Fri May  5 06:22:19 1995.
selecting maps to archive at Fri May  5 06:22:19 1995....
total of 67 maps selected by Fri May  5 06:22:23 1995.
calling Operating System archive shell script /usr/sbin/decedi_arch_script at Fri May  5 06:22:23 1995...
Operating System archive completed by Fri May  5 06:22:27 1995
deleting archived objects at Fri May  5 06:22:27 1995...
deleted 469 database objects and 31 files so far...
deleted 469 database objects and 531 files so far...
deleted 469 database objects and 1031 files so far...
deletion completed by Fri May  5 06:27:44 1995
#
 

 
In this example all objects created before the 1’st March 1995 are archived. The archive steps are output in verbose mode, and as well as the default of archiving the audit trail contents, the in-house  and transmission files associated with the audit entries will be also placed in the archive.
 

The archive will be placed in ./decedi_archive.tar, and the archive command will be passed the flags "-l -i", to tell the tar command to ignore checksum errors, and warn if all links to files are not resolved. 
 

The script used to perform the actual archive is located in /usr/sbin/decedi_arch_script, which is the default one supplied with DEC/EDI.