    *** EXTREMELY IMPORTANT ***G  In  order to help Yves Noyelle in developing DCC and make this utility G  stronger and better, we urge you to  report  bugs,  hints/suggestions, G  problems,  questions, comments, flame/blame or any reaction whatsoever G  you may have while using dcc.  This is YOUR contribution to  dcc.   So D  please, let us know what you think about it by leaving a message at  5 	http://nucwww.chem.sunysb.edu/dccboard/wwwboard.html     Help can be found at - 	http://nucwww.chem.sunysb.edu/info/dcc.htmlx   $  Most recent version downloaded from@ 	http://nucwww.chem.sunysb.edu/htbin/software_list.cgi?sort=date   D  All of the above URL references can be found from the starting page- 	http://nucwww.chem.sunysb.edu/info/dcc.htmlx      	This being said ...      -  To install DCC, I used the following steps :      0) Compilation      -----------     $ MM{K|S}   G  You must have either MMS or MMK as a make utility in order to assemble G  this software.  MMK is a freeware Copyright  MadGoat Software and  is G  available  at  http://www2.wku.edu/www/fileserv/.   MMS  is   Digital   Equipment Corporation.      1) Pre-Installation     ----------------     a) DCC root directory  G  First,  chose  where you want to install DCC files on your system.  If G  you want to have DCC available on  all  nodes  within  an  homogeneous ;  cluster, you you MUST chose a directory seen by all nodes.   G  In  a  mix VAX/Alpha architecture cluster, you should have 2 separates <  root directories to avoid having the improper header files.  G  In  the document herein, we have chose SYS$COMMON:[VMSAPPS.DCC] as the G  root directory for DCC installation and VMSAPPS (a local logical)  for   the executable installation.       b) Header files  +  DCC needs the header files to  function.     G  You   will   need   to   extract   them   from   the   text  libraries G  DECC$RTLDEF.TLB,SYS$STARLET_C.TLB,SYS$LIB_C.TLB.   To accomplish that, G  I have added EXTRACTHDRFILESVMS.COM file to extract the C header files G  from  the  text  library in case this is not done on your system.  For G  DECC6.0 on Alpha, you have to be sure  that  you  have  provision  for   21788 blocks.  G  You  may also try to define it to point on your GNU_CC_INCLUDE path in 0  case you use GCC includes. This was NOT tested.  G  You  may  also  use SYS$COMMON:[DECC$LIB.REFERENCE.DECC$RTLDEF] as the G  header file path.  This assumes that you have chosen  to  install  the G  header  files  while  installing DEC-C compiler.  The files present in G  this directory will NOT be sufficient (only the RTLDEF are there)  for G  DCC  to  check code containing VMS specific includes.  Therefore, I DO :  prefer the first solution and extracted all header files.    c) Our path  >   $ define DCCEXECFILESDIR SYS$COMMON:[VMSAPPS.DCC]	! DCC RootA   $ define DCCSYSHDRDIR SYS$COMMON:[VMSAPPS.DCC.H]	! Header files        2) Installation     ------------   G  Assuming  that  DCCEXECFILESDIR  is  defined  ...  This directory will '  contain files used by DCC at run time.   G  The   DCC   executable   itself   may   be   moved   elsewhere.    The -  INSTALLDCCVMS.COM  ask you for its location.      3) Post-Installation    -----------------G  For  a  global/cluster-like installation, you MUST define the logicals G  DCCEXECFILESDIR and DCCSYSHDRDIR at boot time.  You  can  place  those G  command  in  your  system startup file or any file executed at startup G  and suitable for your site.  No need to say that they do  have  to  be   defined /SYSTEM .     4) Documentation      -------------  are provided as  ) 	DCCARTICLE.PS		PostScript Documentation.  	DCCARTICLE.ASCII	Ascii version # 	DCC.HLP			VMS help file (partial).     G  A  DCREADME.POD (and DCCHELP.MMS) were used to format the help in this G  distribution.  Note that DCREADME.POD  was  build  from  the  original G  DCREADME.TXT  now  removed  from the VMS distribution. You will NOT be G  able to re-build the DCC  help  if  you  do  not  have  perl  an  perl G  utilities installed (see the .MMS files).  All help files generated by 4  DCREADME.POD are provided in this distribution i.e.   	DCC.MAN		Unix manpage 	DCC.PS		PostScript version  	DCC.TXT		Plain text version 	DCC.HLP		VMS help format     )  You may want to make those files public.       3 5) Report of what I did (quick compile and Install) 3    ------------------------------------------------   G  This  is  the  DCC  session I had assuming that the above logicals are 	  defined.      $ @INSTALLDCCVMS.COM4 'dcc' needs two logical names to be defined to work:K - dccexecfilesdir  directory where its execution files are to be installed, M - dccsyshdrdir     directory where C system header files ('stdio.h' etc.) are                     located. 1 Are those names defined and up-to-date ? (y/n): Y G Save previous version ? (if yes, kills previous saved version) (y/n): N B Language for warning/error messages ? ('eng'lish or 'fre'nch): eng" copy dccFiles.mng dccFiles.mngOrigA Option -zgpr (less checking of "good programming practice") to be  turned on by default ? (y/n): Y  >>> Compiling and linking dcc  $ copy dcmsg.ENG dcmsg.txt $ purge/keep=1 dcmsg.txtA $ if arch .eqs. "VAX"   then copy starter.dccvmsvax   starter.dcc A $ if arch .eqs. "ALPHA" then copy starter.dccvmsalpha starter.dcc  $ @adaptstarterfilevms ALPHA  $ ! File adaptstarterfilevms.com $ set noverify  8 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcblk.c9 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcdecl.c 8 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcdir.c8 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcexp.c8 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcext.c8 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcfmt.c9 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcinst.c D cc/debug/warn=disable=(ptrmismatch,notconstqual)/prefix=all dcmain.c9 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcprag.c 8 cc/debug/warn=disable=(ptrmismatch,notconstqual) dcrec.c; cc/debug/warn=disable=(ptrmismatch,notconstqual) dcrecdir.c ; cc/debug/warn=disable=(ptrmismatch,notconstqual) dctxttok.c I link/exe=dc dcblk.obj,dcdecl.obj,dcdir.obj,dcexp.obj,dcext.obj,dcfmt.obj, D dcinst.obj,dcmain.obj,dcprag.obj,dcrec.obj,dcrecdir.obj,dctxttok.objP link/exe=dcd/debug dcblk.obj,dcdecl.obj,dcdir.obj,dcexp.obj,dcext.obj,  dcfmt.obL j,dcinst.obj,dcmain.obj,dcprag.obj,dcrec.obj,dcrecdir.obj,      dctxttok.objH >>> dcc now being tested on itself; should generate no error nor warning$ $ temp = F$TRNLNM("dccexecfilesdir")P $ define/nolog dccexecfilesdir STELL_USER1:[JLAURET.APPS_DEV.PROJECTS.DCC-V2_5F] $ dcc := $dccexecfilesdir:dc $ @tstdccvms $ ! TSTDCCVMS.COM  $ dcc -zcc -ztr dcblk  $ dcc -zcc -ztr dcdecl $ dcc -zcc -ztr dcdir  $ dcc -zcc -ztr dcexp  $ dcc -zcc -ztr dcext  $ dcc -zcc -ztr dcfmt  $ dcc -zcc -ztr dcinst $ dcc -zcc -ztr dcmain $ dcc -zcc -ztr dcprag $ dcc -zcc -ztr dcrec  $ dcc -zcc -ztr dcrecdir $ dcc -zcc -ztr dctxttok $ ! End TSTDCCVMS.COM C $ define/nolog dccexecfilesdir NUCAX0$DKA0:[VMS$COMMON.VMSAPPS.DCC]  $ set noverifyP Install dcc execution files in 'dccexecfilesdir', that is NUCAX0$DKA0:[VMS$COMMO# N.VMSAPPS.DCC] directory ? (y/n): Y " >>> Installing dcc execution files/ $ copy *.adj        dccexecfilesdir:/prot=(w:r) / $ copy starter.dcc  dccexecfilesdir:/prot=(w:r) / $ copy dynarray.h   dccexecfilesdir:/prot=(w:r) ) $ purge/keep=1      dccexecfilesdir:*.dcc ) $ purge/keep=1      dccexecfilesdir:*.adj . $ purge/keep=1      dccexecfilesdir:dynarray.h $ set noverify4 Directory where to install dcc executable ?: VMSAPPS >>> Installing dcc binary @ $ copy/prot=(w=e) dc.exe $4$DKA0:[VMS$COMMON.VMSAPPS.AXP]dcc.exe6 $ purge/keep=1 $4$DKA0:[VMS$COMMON.VMSAPPS.AXP]dcc.exe" $ delete/noconfirm/nolog dc*.obj;* $ purge/keep=2 * $ set noverify! >>> dcc installation successful !        5) Quick Installation     -------------------  / $ copy *.adj        dccexecfilesdir:/prot=(w:r) / $ copy starter.dcc  dccexecfilesdir:/prot=(w:r) / $ copy dynarray.h   dccexecfilesdir:/prot=(w:r) ) $ purge/keep=1      dccexecfilesdir:*.dcc ) $ purge/keep=1      dccexecfilesdir:*.adj . $ purge/keep=1      dccexecfilesdir:dynarray.h) $ copy/prot=(w=e) dc.exe VMSAPPS:dcc.exe   $ purge/keep=1 VMSAPPS:dcc.exe         G  The  executable provided in this distribution has been build using DEC &  C V6.0-001 on OpenVMS Alpha V6.2-1H3.        6) Finally      --------    G  I  have  tested this software on an Alpha OpenVMS 6.2 using CC version   6.0 and it's running great.      K --------------------------------------------------------------------------- ( J. Lauret <jlauret@mail.chem.sunysb.edu>K ---------------------------------------------------------------------------   