LM ERICSSON				PASGEN MANUAL                   1(3)
[L/Ufe Seved Torstendahl                1977-04-05      A        
[HAC John R. Barr                       1978-02-13      B
 
 
 
 
 
 
		PASCAL FOR PDP-11 UNDER RSX-11M
		RSX-11D, IAS, AND RSTS
		===============================
 
		COMPILER GENERATION MANUAL
		==========================
 
 
 
 
		A compiler for Pascal running on PDP-11's is available.
		There is also a crosscompiler running on DEC-10. This
		manual describes how these compilers can be generated
		from the distribution set.
 
		Both compilers generate relocatable object modules
		acceptable to TKB of RSX-11M and other PDP-11 linkers.
		It requires a library of object modules to supply the
		interface to the operating system.
 
		The first step is to transfer the following files to
		UIC [70,16] on a PDP-11:
 
			P11PAS.OBJ	*
			P11FIL.OBJ	*
			P11TTY.OBJ	*
			PASLIB.OBJ
			PASEIS.OBJ
			PASFIS.OBJ
			PASFPP.OBJ
			PASBLD.ODL	*
			*.CMD	*
 
			*	only if a PDP-11 resident compiler is wanted.
 
		Then the command file PASGEN.CMD can be executed:
			>@PASGEN



LM ERICSSON				PASGEN MANUAL                   2
                                        1977-04-05      A        
                                        1978-02-13      B
 
 
		The files contain:
 
		P11PAS.OBJ	Object modules of the general part of
				the compiler. Source: P11PAS.PAS .
 
		P11FIL.OBJ	Object modules of the part of the compiler
				that is specific for PDP-11's.
				Source: P11FIL.PAS .
 
		P11TTY.OBJ	Object modules of the part of the compiler
				written in assembler. Sources in SRCFIL.PAC .
 
		PASLIB.OBJ	Object modules to the runtime routine library.
				Sources in PASLIB.PAC .
 
		PASEIS.OBJ
		PASFIS.OBJ
		PASFPP.OBJ	Alternative object modules to the library
				for PDP-11's with extended instruction
				set, floating instruction set or floating
				point processor ( EIS, FIS or FPP ).
 
		PASGEN.CMD	Indirect command file for creation of a
				compiler and a runtime library.
 
		MV2-,MV3-,DV6-,RST-PASBLD.CMD
		PASBLD.ODL	Command file and overlay description for TKB
				to use when generating acompiler.
 
		USER.MAN	User manual.
 
		PASGEN.MAN	Compiler generation manual.
 
 
 
 
		The full distribution set also contains the source modules:
 
		P11PAS.PAS	General part of Pascal compiler.
 
		P11FIL.PAS	PDP-11-specific part of compiler.
 
		P11CRS.PAS	DEC-10-specific part of compiler.
 
		UNPACK.OBJ	Object module for a program that can be
				used to unpack source modules  packed
				by the programs pack and packlib.
				They have here the extension .PAC .
 
		PASLIB.PAC	Source modules for the runtime library.
 
		SRCFIL.PAC	Sources for special routines of the
				compiler and for the pack and unpack
				programs.



LM ERICSSON				PASGEN MANUAL                   3
             1977-04-05      A        
             1978-02-13      B
 
 
 
		Special programs:
 
		UNPACK		Asks for the name of a packed file
				and splits it into its constituent
				files.
 
		LISTPACK	List the names of files in a packed file.
 
		PACK		Can pack arbitrary source files into a
				new packed file.
 
		PACKLIB		Packs the sources of the runtime library
				into the file PASLIB.PAC .
		MTBLOCK		Magtape utility routines
		DKBLOCK		RK05 utility routines
 
 
 
		To generate a crosscompiler on a DEC-10 proceed as
		follows:
 
		Transfer the files P11PAS.PAS and P11CRS.PAS to
		DEC-10 and compile them with the PASREL compiler from
		Hamburg. Load the produced modules and save the core
		image:
			.LOAD P11PAS,P11CRS
			.SAVE P11PAS 64
		(64 is enough but maybe less will suffice.)
 
		When run the compiler will ask for the filename of the
		source. A full name including volume and p,pn is allowed.
		Filename extension is not necessary if it is .PAS .
		Two new files are produced: a list file with extension
		.LST and an object file with extension .OBJ .
		Example:
			.RUN P11PAS
			*PROG
		will produce the files PROG.LST and PROG.OBJ from PROG.PAS .
 
		The object file contains one PDP-11 byte/DEC-10 word
		and is in PDP-11 DOS format. It can be transferred
		to PDP-11 on a DECtape or other suitablemedium.
		Example:
			.MOUNT DTA:DT/V:DTNAME/WE
			.R FILEX
			*DT:/V/Q/I=PROG.OBJ
			*^C
 
 
		This object module can then be retrieved on a PDP-11
		with RSX-11M by:
			>FLX SY:/RS=DT:*.*/DO/FB