ipp3dist

This program sends our illustrious file on to the next process. It scans queue
p4wheel for incoming files.

For each new file, it reads in the FIP header (if there is one).
	- checks the MagicCode is not on a STOP
		either	- /p4/tmp/magicno/fipstop/(MAGIC)
		or	- /p4/tmp/magicno/fipstop/(MAGIC)_(PIPELINE)
		if so, file is ignored
	- finds the last stage done in the YX field
	- finds the TITLE code in the YT field - not really used except for logging
errors
	- finds the PUB code in the YP field - not used except for logging
	- determines the next stage by looking for the YS: field
		in the form YS:1.1.3.2	(process)
	- for each stage TO BE DONE at this level :
		reads the process
			finds the process in the P4PROCESS file
				stuffs the raw data form tmp/current into that queue in the DQ field as
(Unid).(StageId)
				copies the stubfile to /p4/tmp/(pub)/stubfile/(Unid).(StageId)
				(Unid).(StageId) is YI.YX
	- if no stage is found - message that we have finished.
	- Each process is checked to see if it has been suspended 
		/p4/tmp/skip.processes/(ProcessName)
		if so, the file gaily trips along to the next stage.


P4PROCESS file is in tables/p4 and its syntax is :

	; comment

	(destination) (tab) (fip-hdr1):(data1) (tab) (hdr2):(data2) ... (EOL)
where	destination is the DU field
	fip-hdr is the header field or flag
	data is the optional data for that field/flag
For example
	; P4PROCESS file
	rip		DQ:mono-rip
	distiller	DQ:distiller	PP:6066


If the process is flagged as 'p4message', a log token is sent back and the the
file is moved to the next stage(s).

Input options (all optional) :
	-q : queue to scan				default: spool/p4wheel
	-t : scan time					default: 1 sec
	-z : name of P4PROCESS file in tables/p4	default: tables/p4/P4PROCESS
	-l : do NOT log everything through		default: log
	-v : version and exit


(copyright) 2014 and previous years FingerPost Ltd.