NCSS Wiki

Program Name

arcDelete

PCS stream-state

group: TPP table: TPP state: DeleteArc

Description

arcDelete creates event deletion messages and exports them to configured destinations. The deletion message consists of the single line “DELETE <evid>”. The export mechanism can be email, scp to remote location, or two-step copy to a local directory such as the input directory for the sendfileII program.

There is one instance of arcDelete running on ucbpp, to handle events that have been DELETED by jiggle.

arcDelete runs a typical PCS client loop:

queries for the next event in its assigned stream-state
if an event is found, create the event deletion message.
distribute the file to all of the configured destinations
- MAIL: run “/usr/bin/mailx -s NC<evid>.del <to-address” to mail the file
- DIR: copy the file to the specified temporary directory, then “mv” the file to the destination directory. This ensures that only complete files are visible in the destination directory.
- SCP: run scp to copy the file to configured destinations. This requires appropriate configuration for scp on the local and remote machines.
delete the file from the work directory after it has been distributed.
set the stream-state event result to 1 and repeat the loop
if no event is found, sleep 30 seconds and repeat the loop

Program Location

post-proc systems: /home/ncss/ncpp/arcDelete/bin

Configuration File

/home/ncss/arcExport/delete/conf/arcDelete.conf

Sample configuration file:

# Config file for arcDelete
# dbase: name of database to connect to for PCS work
dbase      dcucb
PCSgroup   TPP
PCStable   TPP
PCSstate   DeleteArc
# sleepTime: how long in seconds to wait to check for next event
sleepTime  30
# workDir: directory in which to create arc files
workdir    /home/ncss/ncpp/arcDelete/delete/work
#
# Destinations: one or more of any of the following:
# Directories must already exist!
# Mail  email-address
# Dir   temp-dir final-dir
# SCP   scp-target like user@host:dist_dir
Dir  /home/ncss/run/send_arc_image1/temp /home/ncss/run/send_arc_image1/send
Dir  /home/ncss/run/send_arc_image2/temp /home/ncss/run/send_arc_image2/send

Source of Database name

Configuration file.

Cron Starter Program

8,18,28,38,48,58 * * * * /home/ncss/ncpp/arcExport/bin/startArcDelete

Log File

/home/ncss/ncpp/arcExport/delete/logs/arcDelete.log

Other Programs Called

/usr/bin/mailx, /usr/bin/scp for distributing the archive file