[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.