ipxnued (Sat Oct 25 2014 01:31:01)

ipxnued

This program is used to receive files from New Afx editorial system.

A parameter file for the data is held in tables/setup and defaults to NED.

Keywords for NED parameter file are :
	; comment line
	filename: New filename for output file in FipSeq
	outfmt:	Name for the output format field, DF
	chrset: Name of the SC or Source chrset for xchgs
	sendq:	Output queue if NOT send to spool/2go for distribution
		If this does NOT start with a '/', it is assumed under spool.
	doneq:	Done queue for original files once sent - or 'delete' to zap
		If this does NOT start with a '/', it is assumed under spool.
	defdest: Default Destination for files if nothing is found in the
		'Routing' field - the Fip DU field as per sys/USERS
	force: Force the Destination to ALWAYS go to this destination (DU)
	date	: Delay and/or Limit dates are in absolute
			ie actual days/month like 16/03 for 16th March
			The default is relative dates : +1 for tomorrow
	maxdelay : Maximum number of days for Delay and Limit.
			This logs a message in the Item Log if the delay is
			longer. Without this parameter, files are NEVER delayed.
						default: no delay
	olddelay :(no of days) If the Delay or Limit field is BEFORE the current
			date/time and within this period, send it immediately.
			default: ignored if no maxdelay, 60 days otherwise.
	logcopy: Logging Destination for a copy of ALL files (default none).
		This is an ordinary destination in sys/USERS to shoot back
		to the database. - It can also be a list of other dests too
		just to confuse you.
	delay-logcopy: ditto for DELAYed copy incase these need to be sent
		somewhere-else.
		default is same as 'logcopy' which defaults to none.
	hdrcodes: (TagDest)	(series of single letter Source Header fields)
		Define the format of the 2nd line.
		hdrcode:AFX	B,Z,I,T
		will add fields XB, XZ, XI, and XT as the next four fields on that line.

The date/time line which is after the company lines and before the Story Header
is checked against the current time. If a second time/date is specified as in :
	31 Oct 96 12:39:07/31 Oct 96 12:45:20

and this time is in advance, FIP header fields DE for DELAY will hold the
date/time for when the file should be delayed before sending.

Default output format field (DF) is NED
Default chrset field (SC) is NED.
Default Source (SU) is XNED (unless overridden by -n)
Default send queue is spool/2go.
Default Priority is 3
The original destination code is in FipHdr SE.

---- NO Routing --------------------------------
If -R is not set (ie routing is enabled ), the DU is set to the default
(defdest) while SE is filled in with the original code.

---- Routing -----------------------------------
A routing file, tables/setup/NED.ROUTE has the format :
;
;	Routing table for NEw Edito Sys
;
tst	yukodests hehe+leplep
where the searched-for string is 'tst' and valid destinations cover the rest of
the line. Theese destinations should be in the tables/sys/USERS file.


If no default destination is specified (defdest:) and there is nothing in the
NewEd 'Routing' field, it will be sent to a destination which is the last part
of the input queue name.

Where sections of FipHdr fields are required or changes to the output style,
use keywords : fixed, partial, combie, optional, repeat and/or style. (see The
SysAdmin manual for more information).
 
	They are normally specified :
		fixed:QZ	1234543
		partial:QT	ST,3,2,U,<,>
		combie:QY	ep|na,(0000000)a 
		option:QE	ep,11,7,s
		repeat:QK	XK,-,3  
	or	repeat:QP	PK,,4,#X
		style:QS	XN,%.03d

Input Parameters are :
either	-i : input queue			default: spool/xned	
		If this does NOT start with a '/', it is assumed under spool.
or	-P : TCP Port 				default: spooled
	-s : hostname if not the default
	-n : name of service			default: XNED
	-z : parameter file in tables/setup	default: tables/setup/NED
	-r : routing file in tables/setup	default: tables/setup/NED.ROUTE
	-R : do NOT route any files. This
		assumes the files will be passed to 'iproute' for routing.
		ie use -R -o 2brouted
	-w : file wait for files arriving across a network.	def: 8 secs
	-W : use .lock files and no waits	default: use filewait
	-u : owner if not that of the logon	default: logon at start
	-l : do NOT log files in		default: log
	-o : output queue			default: spool/2go	
		If this does NOT start with a '/', it is assumed under spool.
		This is overridden by the 'sendq' parameter if it exists.
	-D : Disable delay - all files to be	default: chk delay 1st
		sent immediately.
	-T : change default network timeout	default: 60 secs
	-Z : run in secure mode (TCP only)	default: no
		the user must supply logon and password details which
		MUST match LANARK.LOGON in tables/setup
	-v : print version number and exit

Extel V7 fields are
	Line	Field Name	Fip Header field (if X?, it is part of the SH)
	1	Service Desig		XS	v7_S
		Service Number		XN	v7_N
		OriginCode		XO	v7_O
		Reference Field		XR	v7_R
		UniqueStoryNo		XU	v7_U
	2	Priority		XP	v7_P
		Correction Code		XY	v7_Y
		Service Code		XC	v7_C	* also the routing code
		SubjectCode.1-4		XB	v7_B
		CountryCode.1-4		XT	v7_T
		IndustryCode.1-4	XI	v7_I
		Examiner Code		XX	v7_X
		BenefitsCode		XZ	v7_Z
	3-7?	CompanyName.1-5		E?/F?/G?	v7_E
		Ticker.1-5		E?	v7_E
		Country.Reg.1-5		E?	v7_E
		Sedol.1-5		E?	v7_E
		ISIN.1-5		E?	v7_E
		Extel/Wang No		WA-F	v7_W
		(up to 15 companies lines)
	98	DateTime		EZ	v7_E
	99	Headline		HK	v7_K

Plus bit between MMMM and NNNN is FipHdr E9

Note the Headline is HK not the more usual XK.


(copyright) 2014 and previous years FingerPost Ltd.