ipdelay Files which are embargoed and messages for clients who wish to take advantage of cheaper telecom tariffs are saved in a delay queue until their time of departure is exceeded. This program scans the delay directory once a minute and checks the FIP header field DE which contains the release time. If this time has passed, then the file is moved to spool/2go for program IPWHEEL to distribute normally. The format of the DE field is a long number which matches the unix time function. If no DE field exists, field 'CE' is looked for. This can have one of four formats : If the '-R' input switch is specified : sss where sss is the number of seconds to delay by from ths moment the file arrived. If the '-r' input switch is specified : hh:mm+d where d is no of days relative from now If the '-r' input switch is NOT specified : hh:mm_dd_mm where dd/mm is the day/month If the '-r' input switch is NOT specified and the USADATE enviornment variable is set : hh:mm_mm_dd where mm/dd is the month/day if parameter usadate is set Random spaces may be inserted (and are ignored) for readability. Any punctuation can be used as separators except HASH and you are advised NOT to used Unix metachrs like '*' etc. If there is a parameter file, it is (optionally) called by the '-z' switch and holds just FipSeq - for the -N switch for example plus 'early-warning' messages These are to pre-announce or early warn that a file is about to be released ! This is triggered ONLY for those files that have non-empty FipHdr field as specified by the early-warning-fiphdr field early-warning-fiphdr: (FipHdr) early-warning-extra: (FipSeq) Extra FipHdr info to add to any EarlyWarning file - but NOT the main trigger early-warning: (no of secs before release time) (FipHdr and message in FipSeq) There can be a number (up to 20) early-warnings eg early-warning-fiphdr: QP combie:QP PR|XP early-warning:3600 DI:File SN will be released in one hour early-warning:600 DI:File SN will be released in 10 mins early-warning-extra: DA:CAn eary-warning-script: (script to run) Same as the -S input switch Run the script when outputting the early-warning message check-primary-server: pseudo-host name that is specified in tables/sys/DEST_REDUN Use this when an ipdelay on 2 systems is accessing the same remote folder - in a redundant way. that is used whether the current host should be getting the files or not. ie in the parameter file is check-primary-server:webserver and in the DEST_REDUN is ; psuedohost primary secondary webserver fip1 fip2 and in the SYSTEM file for both fip1 AND fip2 there is a line rem1 local ipdelay Then if fip1 is up, the ipdelay on fip1 will always send while on fip2 it will wait, check at the last moment and NOT send if fip1 is down, the 'ipspool' on fip2 will start getting the files. hostname: (hostname) Hostname to use for this server for using with redundancy balance-group: (group) Name of the Group in sys/BALANCE for sending to ipdelay on the secondary system script: (script to run) Same as the -s switch below Run this script when releasing the file log-line: (FipSeq) replacement log line if input switch '-L' default: Input parameters are (all optional) : -9 : do NOT run speedy on a speedy system -d : done queue default: input is deleted after sending -F : when relesed from hold, create new FipHdr H* fields -G : resolve all times against GMT default: local, system time with the released time/date (overwriting any existing fields) default:no -h : holding queue for items to be sent.default: spool/hold_delay -i : queue to scan default: spool/delay -l : do NOT log undelays default: log each file when released -L : log incomings too default: log each file when released -M : Maximum no of days you can delay a file for ...default:90 days -N : 2 letter FipHdr field to create filename in the hold/delay folder. Normally this is NOT required as it can lead to newer versions zapping old ones. -o : output queue for sending default: spool/2go if this is 'delete' the file is deleted (usually after running a script). -q : queue to scan default: spool/delay -i and -q are interchangeable -Q : do not complain if hold file has been zapped default: do -r : date in the CE FipHdr field is RELATIVE to today default: date is specified in dd/mm format -R : time in the CE FipHdr field is number of secs to delay default: date is specified in dd/mm format -s : scriptname default: none This will be triggered Before the file is released. Take care not to run for a long time as the file is NOT sent until the script has finished. -T : release file this many seconds BEFORE time.default: 3 -UTC time in the DE FipHdr field is in UTC format ie 20050928123400 or 20071129T115959+0430 -w : wait in seconds after a file has been released default: 1 second -W : file stable time for NFS or scripted files default: 0 secs -z : name of optional parameter file default: none -v : print version no and exit The environment variable for USA style dates is setenv FIP_USA_DATE yes The maximum number of items is 5000. Version Control ;011x17 19apr99 added -R and and max items 200 -> 4000 ;a 18jun99 added delete as an option and -Q for quiet ;b 14jan00 WINNT mods for new version ;c 01feb00 added -M for maximum no of days ;d 27may02 on restart, -R now checks file-time. (max is now 5000) ;e 8dec02 added -F for new H*: FipHdr fields with date/time of release ;f 28apr03 added -T delay offset (default is 3) ;g 06jun04 bugette in WINNT stuff ;h-j 23sep04 speedy for outque ;k 09mar05 added -UTC for DE is in UTC time ;l 17sep05 added -N (fiphdr) ;m-n 11aug06 added -z pram file and early-warning: ;o-p 03nov06 added DR and balance ;q 15nov06 added offset to UTC ;r-t 17nov06 early-warning-extra: added and -d doneque ;u-w 15mar07 slice time reduced.. ;x9 23jul07 added -w - wait plus bugette in copy - not using the right fiphdr! ;9 10mar09 bugette for win2k and DST ;10 31mar11 added -x replace ;11-16 poss occasional bugette in hdr and added log-line ;17 added file-trace (copyright) 2014 and previous years FingerPost Ltd.