-----

Step-by-step NA44 software installation guide
(Unix and VMS)

(last modification April 4 '96, 11:55 HvH)

  • 1: choose a root location. This is system dependent.

  • 2: make the directory subtree as shown here.

  • 3a(Unix): go to the 'install' subdirectory and copy na44.login from here.
    Execute it: 'source na44.login'. If you get a message 'na44.login:: System not recognized...' then edit the file and add your machine, and mail the new copy to Hubert.
    Now all environment variables should be defined (type 'env' and you should see FINSTALL, FDEMO and all the others)
  • 3b(VMS): go to the 'install' subdirectory and copy flogin.com from here.
    Execute it: '@login.com'. If you get a message 'flogin:: System not recognized...' then edit the file and add your machine, and mail the new copy to Hubert.
    Now all logicals should be defined (type 'show log f*' and you should see FINSTALL, FDEMO and all the others)

  • 4: Do 'cd $FCMZ' and you should be in .../n011. FTP to your favorite site to pick up the n011 cmz source files. At Cern they are currently under /afs/cern.ch/na44/offline/rs_aix32/n011/src/cmz/*.cmz. At Los Alamos they are at /p2hp6/usr1/na44/n011/*.cmz. Do a binary transfer with mget.

  • 5: In the same area, pick up a copy of libmacs.kumac here, and while you are there, a copy of na44cmz.kumac here, a copy of libjoin here, and a copy of libjoind here.
    Edit libmacs and na44cmz; the SELECT command needs to reflect your site.

  • 6: Still in the same area ($FCMZ), enter CMZ and do the following commands:
            exec libmacs
            newlib
            debug
            newlib
            exit 
    
    The first command activates the librarian's macros, the second one makes the no-debug libraries (one per cmz file), then you turn on the debug flags and make the debug versions of the libraries; then you exit CMZ.
    To check what happened, do a directory of $FFOR, $FLIB and $FLIBD. There should be files in there now.

  • 7a(Unix): Do 'source libjoin'. This concatenates all libs in $FLIB into one master library. The same for the debug libraries: 'source libjoind'.
  • 7b(VMS): Do '@libjoin'. This concatenates all libs in $FLIB into one master library. The same for the debug libraries: '@libjoind'.

    -----
    Now you are done with the installation. However, there are a few things you might choose to do:

  • 8: Clean up. In $FLIB and $FLIBD, you could delete all files except libn011*.a.

  • 9: Build a new copy of dbtools: Go to $FDEMO. In CMZ, make a (dummy) file dbtest, with a dummy routine in it. Compile and get out of CMZ. Link it with flink dbtest d . . none (this is also a good test of flink and the new libraries). Then move the executable to the right place/name, for example at cernsp I would say mv dbtest ibm/dbtools_ibm. -----