ipscan
ipscan
IPSCAN counts the number of files caught in certain queues and displays these
and the totals for the last 2 scans. The first 5 files in that queue are also
displayed.
Parameter file tables/sys/SCAN is used to define which queues in spool to
monitor. Optionally two levels can be adjusted to give a total where a warning
is triggered and one where an error is triggered. In either case a message is
displayed and the program beeps. A script file can also be optionally started.
The syntax of the SCAN Parameter file is :
; comment
banner:\r\n--QUEUE----TOTALS-this-last-before
defwarn:"** Warning total exceeded **"
deferror:"** Error total exceeded **"
Where ..
banner: Heading or banner printed at the top of the screen
endpage: End of page printed at the bottom
default-warning:
or defwarn: Warning message
default-warning:
or deferror: Error message
default-delay:2
or defdelay:2 only log the error (or run script) after the 2nd scan
For each queue, the syntax is (each on a new line) :
; just scan 2brouted
queue:2brouted
; for 2go, BEEP if more than 20 files and run script if over 50
queue:2go warn:20:BEEP error:50:/fip/local/move2go
queue:woops error:1:"/fip/local/move2go \$h:\$n:\$b"
; if the queue is NOT under /fip/spool, start with a '/'
queue:/data1/fpo/opi/rubbish
The subkeywords for 'queue' are (all optional)
warn:(number of file):(optional script)
Use this total to flag a warning and (optionally) run a script
error:(number of file):(optional script)
Use this total to flag an error and (optionally) run a script
log:
If the number of files exceeds the error total, write an error to the Fip
ALL log.
delay:(positive number)
Only log/run script after the nth scan has passed
You can ignore the names of certain files and/or sub-queues with the ignore:
parameter. These take effect for ALL queues. By default, if a sub-queue called
'.rsrc' or begins 'Desktop' are ignored. 3 ignores are permitted.
ignore:NetworkTrash
ignore:G1SI05
Normally BEEP will do everytime the queue is over its total but the script is
ONLY run once. To run this script every cycle if timed out rather than
(default) on transition only - ie when times out and when recovers - use the
'everytime:' parameter on a line on its own.
everytime:
You can send the results of the scan to a Fip destination for further
processing using the 'file:(destination)' parameter where destination is a
valid DU in the USERS file. 'extra-fiphdr: (FipSeq) can be added to fill any
non-standard fields.
file:statussys
extra-fiphdr:#SZ:hosta,hostb#XZ:
If using the -d Daemon flag, the columns are automatically 'html-ified' with
<tr><td> etc
In this case, use something like :
; Column headings
banner:<table>\n<tr>\n<td><td
colspan=8>Number\sof\sFiles</tr>\n<tr>\n<td>Directory
Name</tr>\n
endpage:</table>
; name of output file - if there is NO -N input switch
newname: (FipSeq)
; run a script every cycle
script: (name of script in FipSeq)
email-address: (one or more addresses separated by a comma) default: none
email-queue: under spool default: 2smtp
email-extra: (optional fipseq string to add to the FipHdr) default: none
email-top: (optional fipseq string to add before any data) default: none
email-tail: (optional fipseq string to add after any data) default: none
email-data: (yes/no) default: no
Input flags are :
-1 : single run then stop default: continuous
(see also -N for output filename)
or
-b : do NOT beep on warning/error default: beep
-c : No of Columns - ie last totals - default: 8 (was 3)
maximum is 60
-d : daemon/service flag. Run in background to default: no
generate show files for IPSVCE.
If there is no -N, this leaves the file in x/SCAN.(name of parameter file)
forced uppercase.
It also ignores any screen formatting.
-f : name of parameter file in tables/sys default: SCAN
-f and -z are the same
-h : output in HTML default: daemon in HTML else plain
-H : output in plain text default: daemon in HTML else plain
-l : no of files to display per queue default: 5
-N : output file name in FipSeq default: name of parameter file
-o : output folder
default: /fip/spool/2go for file:destination
Note this is only used if there is a 'file' parameter
default: /fip/x for -d
default: none for normal running as the file is displayed and not saved to
disk
-O : Start scan on this number of seconds off the minute. default:26
-Q : show script errors for error and warn default:ignore them
-t : intervals between checks default: 60 secs
-z : name of parameter file in tables/sys default: SCAN
-f and -z are the same
-v : print version no and exit.
If 'ipscan' is being started by 'local/rc.fip' on reboot there is every chance
there will be no shell and no environment set - and in particular, no PATH. So
the full pathname of the script must be specified in the parameter file.
Use double quotes around any script which needs added parameters or has spaces
or other metacharaters in the name.
Version Control
;12w8 17feb98 added daemon and 'everytime'
;a 28apr98 WINNT inputs now work
;b/c 15apr99 minor mods
;d 07dec99 upped no of queues to 100
;e/f 22dec99 upped maximum directory name to 35 characters
;g/h 14may01 clr/clear for WINNT
;j 05oct01 added -c for NoOfColumns
;k/m 22oct01 allow programs/scripts to be in FipSeq plus bugette in counting
;n 15feb02 cleanup HTML version
;o 12apr02 added log:
;p 25apr03 small bugette in everytime
;q 01mar04 upped no of queues to 300
;r added dest and extrafiphdr
;s 07apr05 added endpage and put banner back in Daemon
;t 06apr06 file:dest used to work ONLY with -d daemon
;u-w5 7jun07 OK and scripts and delay ;3 added -Q NOTquiet for scripts ;4
21may12 -O added
;w6-8 15nov16 added newname -N and script
(copyright) 2024 and previous years FingerPost Ltd.