  ?  This is the README.TXT file for DEVTOOLS:[TOOLS.ALPHA_COMPILE]       TOOL:   	ALPHA_COMPILE.COM  	  VERSION:    	1.3-1   22-Sep-1995  
  DESCRIPTION:   A 	The ALPHA_COMPILE.COM procedure can be used to compile a private < 	version of a module that is compiled during the build of anB 	OpenVMS Alpha base level.  This procedure attempts to compile the= 	source module using the same compiler options that were used  	during the base level build.  	 < 	This procedure uses the facility ASM data file to determine? 	the necessary prefix files and macro libraries.  Similarly, if ? 	directed by the ASM data file, the module is compiled multiple 8 	times to produce variant versions of the object module. 	 D 	Before you use this procedure you should be aware of the following: 	 G 	(1)  You need to use a directory structure that mimics the result disk H 	     structure; i.e. device:[...facility.SRC],device:[...facility.OBJ], 	     device:[...facility.LIS] 	 ? 	(2)  You need to have used the USE_BASE_LEVEL.COM procedure to ) 	     select the compilers and libraries.   E 	The procedure will display the compile command used and will attempt > 	to insert the resulting object module into the object library  	specified by the ASM data file.  ? 	You may also wish to define the logical name DSKD$ as a rooted ? 	device name that makes your local facility directory appear to = 	be a top-level directory on the DSKD$ device.  This is not a @ 	requirement for this command procedure, but it usually makes itG 	possible to use link command procedures directly from RESD$:[fac.COM].   D 	For example, if you have WORK1:[JODI_DEVO.PROJ1.SYS.SRC] you would: 	 ; 	       DEFINE DSKD$/TRANS=CONCEAL WORK1:[JODI_DEVO.PROJ1.]  	 H 	The ALPHA_COMPILE.COM procedure automatically defines the DSKD$ logicalF 	name if the directory path to the source module requires more than 2 
 	levels.    > 	Your current default device and directory should be expressedA 	in terms of DSKD$ when you invoke this procedure.  However, the  @ 	ALPHA_COMPILE.COM procedure will automatically comply with thisF 	requirement whenever it automatically defines the DSKD$ logical name. 	   * 	There are two ways to use this procedure.  	  Usage 1:     	@ALPHA_COMPILE source[switches]  D 	This procedure will attempt to obtain guidance from the appropriateH 	facilityASM.DAT file about prefix file names, output module name, macroB 	libraries, and additional compiler options.  You can also specifyD 	additional switches.  Note that if you do, you must not include anyF 	spaces between the source file name and the qualifiers.  For example:  & 		@ALPHA_COMPILE [.SRC]SYSQIOREQ/NOOPT  C 	If the source module is not found in the appropriate ASM file, the  	procedure assumes usage 2.   	  Usage 2:   4 	@ALPHA_COMPILE source1[+source2][switches] [module]  A 	Specifically, this case applies when you have specified multiple < 	source modules and/or have specified an output module name.  > 	In this case, the procedure does not take any guidance from aA 	facilityASM.DAT file.  You can exert additional control over the 5 	actions taken by defining the following DCL symbols:   ' 	olb	Object library name (def=facility) ! 	gbl	LIBRARY/gbl  (def=NOGLOBALS) ; 	ml1	Name of first macro library (def=EXECML$ or EXECLIBH$) / 	ml2	Name of second macro library (.MAR and .C) . 	ml3	Name of third macro library (.MAR and .C)/ 	ml4	Name of fourth macro library (.MAR and .C) . 	ml5	Name of fifth macro library (.MAR and .C)$ 	opt	Additional switches for compile 	   	  EXAMPLE:    	$ show default $ 	  WORK1:[SZUBOWICZ.GRYPHON.SYS.SRC] 	$ @alpha_compile sysqioreq   @ 	Logical name DSKD$ is now defined as WORK1:[SZUBOWICZ.GRYPHON.]* 	Your default directory is now DSKD$:[SYS]    . 	Reading file X681_RESD$:[SYS.COM]SYSASM.DAT;1  9 	$ define/user starlet   X681_RESD$:[SYSLIB]STARLET.MLB;2 5 	$ macro/migration/notie/machine_code/symbol /DEBUG - " 	        /lis=[SYS.lis]SYSQIOREQ -" 	        /obj=[SYS.obj]SYSQIOREQ -$ 	        resd$:[syslib]arch_defs + -3 	        X681_RESD$:[SYS.SRC]DEBUG$STATE.MAR;1 +  - 3 	        X681_RESD$:[SYS.SRC]DATA_PREFIX.MAR;1 +  - 9 	        X681_RESD$:[SYS.SRC]SYSTEM_DATA_CELLS.MAR;1 +  -  	         - ) 	        DSKD$:[SYS.SRC]SYSQIOREQ.MAR;1 - * 	        +X681_RESD$:[SYSLIB]LIB.MLB;2/libK 	$ libr/alpha/replace/NOGLOBALS/log [SYS.obj]SYS.olb [SYS.obj]SYSQIOREQ.obj J 	%LIBRAR-S-REPLACED, module SYSQIOREQ replaced in DSKD$:[SYS.OBJ]SYS.OLB;19 	$ define/user starlet   X681_RESD$:[SYSLIB]STARLET.MLB;2 5 	$ macro/migration/notie/machine_code/symbol /DEBUG - & 	        /lis=[SYS.lis]SYSQIOREQ_MON -& 	        /obj=[SYS.obj]SYSQIOREQ_MON -$ 	        resd$:[syslib]arch_defs + -3 	        X681_RESD$:[SYS.SRC]DEBUG$STATE.MAR;1 +  - 3 	        X681_RESD$:[SYS.SRC]DATA_PREFIX.MAR;1 +  - 9 	        X681_RESD$:[SYS.SRC]SYSTEM_DATA_CELLS.MAR;1 +  - 0 	        X681_RESD$:[SYS.SRC]IO_DEBUG.MAR;1 +  -) 	        DSKD$:[SYS.SRC]SYSQIOREQ.MAR;1 - * 	        +X681_RESD$:[SYSLIB]LIB.MLB;2/libO 	$ libr/alpha/replace/NOGLOBALS/log [SYS.obj]SYS.olb [SYS.obj]SYSQIOREQ_MON.obj N 	%LIBRAR-S-REPLACED, module SYSQIOREQ_MON replaced in DSKD$:[SYS.OBJ]SYS.OLB;1  @ 	Your default directory is now WORK1:[SZUBOWICZ.GRYPHON.SYS.SRC]        MAINTAINER:  B 	The ALPHA_COMPILE.COM procedure is maintained by Lenny Szubowicz.H 	If you encounter problems with the procedure or if you have suggestions7 	for improvements, please send mail to STAR::SZUBOWICZ.     