1  This is directions for compiling & linking CircleMUD for OpenVMS.
 2  Additional documentation can be found at.
 3  
 4  	http://www.ourservers.net/openvms_ports/
 5  
 6  I have personally tested this port on both VAX and Alpha with OpenVMS v7.0 
 7  and DEC C v7.0 and Multinet TCP/IP using UCX emulation.
 8  
 9  To build this, you need the following:
10  
11          .1) DEC C compiler.  I have tested with DEC C v7.0 and can help out
12              with problems with earlier versions of DEC C.  If you don't have
13  	    the DEC C compiler I suggest you get a copy through the OpenVMS
14  	    Hobbyist program at http://www.montagar.com/hobbyist.
15  
16  	.2) A TCP/IP stack for OpenVMS that supports UCX emulation.  I have
17              personally only tested out Multinet v4.1B and Multinet v4.2.
18              If you are using a TCP/IP stack that dosen't support UCX 
19  	    emulation I would suggest getting a copy of Multinet though the
20              OpenVMS hobbyist program at http://www.montagar.com/hobbyist.
21  
22  	.3) A copy of the CircleMUD distribution file.
23  
24              This can be found at ftp://ftp.circlemud.org/3.x/
25  
26  Now, you have everything, do the following...
27  
28  	.1) Unpack the CircleMUD file you got from "www.circlemud.org"
29  
30  	.2) Go to the SRC directory and locate the BUILD_CIRCLEMUD.COM file.
31  
32  	    The BUILD_CIRCLEMUD.COM file accepts the following parameters.
33  
34  		P1	ALL	Just Build "Everything".
35  			CIRCLE	Just Build [.BIN]CIRCLE.EXE.
36  			UTILS   Just Build The CircleMUD Utilities.
37  
38  		P2	DEBUG	Build CircleMUD With Debugging Information.
39  			NODEBUG Build CircleMUD Without Debugging Information.
40  
41  	    The default is "ALL" and "NODEBUG".
42  
43  	    The "BUILD_CIRCLEMUD.COM" script checks some filenames to make 
44              sure that they are correct as some of them are unpacked different
45  	    between the TAR file distribution and the ZIP file distribution.
46              It also checks for "CONF.H" and if not found copies "CONF.H_VMS"
47              to "CONF.H" for you.
48  
49  	    So if you just want to build "everything" without debugging 
50  	    information you could use...
51  
52  		$ @BUILD_CIRCLEMUD ALL NODEBUG
53  
54  			OR
55  
56  		$ @BUILD_CIRCLEMUD
57  
58              The EXE's will be placed in the CircleMUD BIN directory.
59  
60  Now, define the logical CIRCLEMUD_BIN to point to the "BIN" directory of
61  the CircleMUD directory like this...
62  
63     $ DEFINE/SYSTEM/EXEC CIRCLEMUD_BIN DISK$WORK:[CIRCLE30BPL16.BIN]
64  
65  To run CircleMUD, just execute the "VMS_AUTORUN.COM" file in the CircleMUD
66  root directory.
67  
68  To customize how CircleMUD runs, edit the "VMS_CIRCLEMUD.COM" file in the
69  BIN directory.
70  
71  To customize CircleMUD features (like player killing etc) edit the "CONFIG.C"
72  file in the SRC directory.
73  
74  To edit the CircleMUD login message, edit the GREETINGS.; file found in the
75  TEXT directory under the LIB directory.
76  
77  For the CircleMUD utilities, execute the file VMS_MUD_UTILS.COM in the
78  BIN directory and it will create the VMS symbols for the utilities.
79  
80  If you have any problems, questions, comments, feel free to e-mail me at
81  byer@mail.ourservers.net and I'll try my best to answer them all.