
 [1,2]TIE.HLP
	TIE is a means of compiling and task building a source
	program from instructions contained in the source program.

	To use TIE, your source program must contain the compile and task
	build instructions in valid comment lines followed by a TAB.
 i.e
 	PROGRAM PROG					.;	MCR INS $IPP
 C	MCR TIME					.;	ipp tie=tie
 C	F77 PROG,TI:=PROG or MAC PROG,NL:=PROG	    	.;	MCR REM IPP
 C	PROG/CP/PR:0,NL:=PROG,LB:[1,1]FOROTS/LB     
 C	/			Start of TKB options
 C	COMMON =
 C	//			Note: this line is always required. 
 C	MCR INS PROG/PRI=1.	Note: MCR commands must be contiguous. ie the
        first line that does not contain C	MCR or C- indicates the end
	To initiate TIE enter TIE PROG[.EXT] [OPTION] [OPTION]

	further help type
	HELP TIE INITIATE ( Starting / using )
	HELP TIE CHECKS		HELP TIE DEFAULTS	HELP TIE OPTIONS
	HELP TIE SYNTAX		HELP TIE MCR		HELP TIE MISC
	HELP TIE TKB
2 INITIATE

  [1,2]TIE.HLP/INITIA




                       S T A R T I N G     T I E




 TIE CAN BE STARTED BY ENTERING

	a: TIE 		(Prompts for file name)

	b: TIE PROG	(checks for default file types ie .ftn .sub .mac .c)

	c: TIE PROG.EXT

	d: @[1,3]TIE PROG.EXT	(for use in indirect command files)




2 SYNTAX

  [1,2]TIE.HLP/SYNTAX

                          T I E       S Y N T A X


	Your source program must contain compile and taskbuild instructions
	embedded in valid comment lines within the first 40 lines of source.

	The last command must be C	// even if no options are required.

	If you are working on a disk other than the system disk issue the local
	assignment YOURDISK=SY:. ie DR1:=SY:

                                 E X A M P L E
		C	MCR TIME
		C	FOR PROG,NL:=PROG
		C	PROG/CP/,NL:=PROG,LB:[1,1]FOROTS/LB
		C	/
		C	COMMON =
		C	MAXBUF =
		C-	TASK = ...PRO 
		C	//
		C	MCR INS PROG/PRI=1.
 Note: C- instucts TIE to ignore this line.

 Note: MCR commands must be contiguous. ie the first line that does not
 contain C	MCR or C- indicates the end of MCR commands
2 CHECKS

  [1,2]TIE.HLP/CHECKS

	            T I E       C H E C K S       F O R


	a: A MCR command ( before compile and after task build )

	b: A valid compiler name. FOR F77 C MAC or IPP

	c: A - after the comment. If found the instruction is not used.

	d: A TASK = option. If found the optional name is used to remove
		the task.

	e: An INStalled task. If found the task is REMoved and INStalled.

	f: A active task. If found two options are available:
			  1: ABOrt REMove INStall and RUN program.
			  2: Leave the running copy intact and DELETE
			     the new .tsk

2 DEFAULTS

  [1,2]TIE.HLP/DEFAULT



	    D E F A U L T S       U S E D       B Y       T I E



	SOURCE A source extension of .FTN is presumed. Other extensions
		searched for are F77 C MAC & SUB CMD

	All other file extensions are standard unless specifically altered
	by your compile and/or task builder instructions.

	C O M P I L E R				    T A S K   B U I L D E R

	LIST   FILE .lst				OBJECT FILE .obj
	OBJECT FILE .obj				LIST   FILE .map
							TASK   FILE .tsk
2 OPTION

  [1,2]TIE.HLP/OPTION		T I E       O P T I O N S
	TIE PROG LIST NOTKB ( any 5 options )

	NOASK	The option NOASK will suppress all questions from TIE.
		Useful when TIE is used in a command file.

	LIST	The option LIST/NOLIST will include/suppress a compiler source
	NOLIST	listing file.
		The compiler instuction for list file is ignored.

	NOTKB	The option NOTKB will disable the task build.

	NOPIP	The option NOPIP will suppress any PIP purges or deletes
		that are normally done by TIE.

	NOMCR 	The option NOMCR will suppress any MCR commands contained
		in your source program.

	NOINS	The option NOINS will not remove the old task. The check for
		an active task is also bypassed.

	BATCH	Submits compile/TKB to batch. Any 5th option overwritten.
	Type HELP TIE OPTION option for additional help ie HELP TIE OPT LIST
3 NOASK

  [1,2]TIE.HLP/OPTION NOASK

	NOASK	The option NOASK will suppress all questions from TIE.
		Useful when TIE is used in a command file.

	NOASK is always in effect if BATCH requested.


3 LIST/NOLIST

  [1,2]TIE.HLP/OPTION LIST/NOLIST

	LIST	The option LIST/NOLIST will include/suppress a compiler source
	NOLIST	listing file.
		The compiler instuction for list file is ignored.


	LIST and NOTKB will quickly produce a list file that can be used
	with EDT.

3 NOTKB

  [1,2]TIE.HLP/OPTION NOTKB

	NOTKB	The option NOTKB will disable the task build.

	NOTKB can be used to compile and check your programs for compile errors
3 NOPIP

  [1,2]TIE.HLP/OPTION NOPIP

	NOPIP	The option NOPIP will suppress any PIP purges or deletes
		that are normally done by TIE. These are

	PIP SY:[UIC]PROG.OBJ;*/DE/NM

	PIP SY:[UIC]PROG.BLD;*/DE/NM,PROG.MAP;*

	PIP SY:[UIC]PROG.*/PU/NM

	The only exception to NOPIP is that when an existing task is active,
	and you choose to leave it running, the new ( the one you have just
	built ) will always be deleted.

3 NOMCR

  [1,2]TIE.HLP/OPTION NOMCR

	NOMCR 	The option NOMCR will suppress any MCR commands contained
		in your source program.


	NOMCR will only suppress MCR commands that are included in your source
	program ie
	C	MCR INS TIE/TASK=...LIN

	NOMCR has no effect on mcr commands that are normally issued by TIE
	ie an installed task will still be removed and reinstalled.

	NOTE MCR commands can be commented out by adding a minus sign to the
	c comment in column 1 ie 	C-	MCR INS TIE/TASK=...LIN


3 NOINS

  [1,2]TIE.HLP/OPTION NOINS

	NOINS	The option NOINS will not remove the old task. The check for
		an active task is also bypassed.

	The NOINS option should be used with care as it bypasses
		the check for an active task      AND
		the check for an installed task

	The new task image will not be installed. Old versions will not be
	purged.

	This could result in the following future problems.

	An installed task may be deleted by a future purge.

	A new ( and possibly untested ) task will be installed the next time
	the system is initialized.


3 BATCH

  [1,2]TIE.HLP/OPTION BATCH
	BATCH	Submits compile/TKB to batch. Any 5th option is overwritten by
	a NOASK option.

	When BATCH is requested TIE will create and submit a batch job to the
	default batch que. The name of the batch job is the same as your source
	with an extension of .TAT ( for Tie bATch ). The .TAT and .LOG files
	are purged not deleted.

	When in BATCH mode tie will broadcast back to the issuing terminal the 
	results of the batch job.


2 MCR

  [1,2]TIE.HLP/MCR

                        T I E       M C R

	Tie will processes MCR commands that are embeded in the source
	program as comments followed by a TAB and the keyword MCR.
	MCR commands must proceed the compiler line or follow the TKB
	instructions.

	EXAMPLE SYNTAX

	C	MCR TIME ( MCR is required syntax )
	C	MCR LBR LIBRARY/RP = NEWMOD.OBJ
	C	MCR PIP NEWMOD.OBJ;*/DE/NM

	MCR command processing is terminated by the first non MCR command
	line ( but not by C- ). The MCR instructions must be contained within
	the maximum number of lines checked. 

	If you need extensive use of this feature it may be easier to have a 
	seperate command file. ie C	MCR @MYFILE


2 MISC

  [1,2]TIE.HLP/MISC

	The compile and task build commands must be within the first
	50 lines. To modify change SETN MAX lines.

	TIE command lines must be a valid COMMENT LINE for your compiler
	followed by a tab
	IE
	C	MCR TIME				For MCR
	C	FOR PROG,TI:=PROG !			for fortran	   **
	;	MAC PROG,NL:=PROG) !			for macro
	.;	IPP TIE=TIE				for indirect .CMD
	C	PROG/CP,NL:=PROG,LB:[1,1]FOROTS/LB !	for taskbuild	   **
	C	/					Start of TKB options
	C	COMMON =
	C	SUPLIB =
	C	UNITS =
	C	//					End of TKB options **
	C	MCR A VALID MCR COMMAND
	C	MCR (ie) INSTALL YOURPROG/TASK=NEWNAME/INC=00000.
	C	MCR @MYCOMMAND.FILE
	C- Mcr command processing continues if C- present
	C	MCR TIME
	C This line stops mcr command processing
					** Note: These are required

	NOTE: 
	A) The compiler command must begin with the name of the compiler ie FOR

	B) The last TKB instruction must be // even if you enter no options.

	C) Any TKB instructions that have a - (minus sign) attached to the
	   comment will be ignored. (ie C-	LIBR = )

	D) If you are working on a disk other than the system disk issue the
	   local assignment YOURDISK:=SY:	ie	ASN DK1:=SY:

2 TKB

  [1,2]TIE.HLP/TKB

	TIE will skip its check and requirements for TKB lines when the
	file extension is .SUB or .CMD

	TIE will always add an IDENT = even if it is not present in your source.
	The syntax of the IDENT is day/month/year ie 05JN95
	MCR TAS
	...TIE 05JN95	50.	00015400 DU0:-00051324

	If you include an IDENT = in the TKB instructions it will override
	the default.

	TIE checks for a TKB TASK = instuction. If found this name is used in
	the checks for installed and active tasks.


