How to build TCT, SST and ROCTEST

Work from top to bottom on this page. Also if needed see specific notes on building at DESY or building ZTCLIB.

Setup

In all the following cases it has been assumed that main setup files has been executed. i.e.

at UCL: @DISK$Z1:[ZEUS_ONLINE.CTD_ONLINE3]SETUP.COM
at DESY/OXFORD: @SYS$SYSDEVICE:[CTD_ONLINE]SETUP.COM

General guidelines

Try and use the same versions of HARNESS, GODEL and ZTCLIB for versions of TCT, SST and ROCTEST that might be used in a testing session. This prevents having to set up each package before it is used.

Where to build?

UCL: UCLVF - check the logical name table ZEUS_TABLE exists. If not create from a priveleged account
```
@CTD_BASE_DIR:CREATE_ZEUS_TABLE
```
DESY: ZUKVS2
Oxford: ZUKVS1

Creating directories

Set up the package and version you want to build using CTD_SET and create the directories from the package logicals. Ignore any errors reported during the setup.

Directory	TCT logicals	SST logicals	ROCTEST logicals
target.dir	`TCT_TARGET_DIR`	`SST_TARGET_DIR`	`ROCTEST_TARGET_DIR`
config.dir	`TCT_CONFIG_DIR`	`SST_CONFIG_DIR`	`ROCTEST_CONFIG_DIR`
work.dir	`TCT_WORK_DIR`	`SST_WORK_DIR`	`ROCTEST_WORK_DIR`
source.dir	`TCT_SOURCE_DIR`	`SST_SOURCE_DIR`	(see note)

Roctest differs from the other two packages by having two separate source directories, [.OCCAM_SOURCE] and [.FORTRAN_SOURCE]. To create these directories, change directory to ROCTEST_BASE_DIR and then to the top level directory of the version you are creating, from there create the directories, e.g. for version v5_0:

SET DEFAULT ROCTEST_BASE_DIR
SET DEFAULT [.V5_0]
CREATE/DIR [.OCCAM_SOURCE]
CREATE/DIR [.FORTRAN_SOURCE]

The source and config directories need to be copied from either the previous version or same version on a remote node, also copy any .CLD files which may be in the target directory.

TCT and SST

Set up the package version again using CTD_SET, this ensures everything is set up correctly for building. Change directory to the source directory and type: MMS

ROCTEST

Set up the package version again using CTD_SET, this ensures everything is set up correctly for building. Execute the following commands: N.B. lastversion is the previous version (e.g. v4_3), and version is the version being built (e.g. v4_4)

SET DEF ROCTEST_BASE_DIR
COPY [.lastversion.CONFIG]*.*   [.version.CONFIG]
COPY [.lastversion.TARGET]*.CLD [.version.TARGET]
SET DEF [.version.OCCAM_SOURCE]
COPY [.lastversion.OCCAM_SOURCE]*.WRAP []
COPY [.lastversion.OCCAM_SOURCE]SETUP_COMMANDS.COM []
@SETUP_COMMANDS
BUILD Z0 Z0                   (builds single crates)
BUILD ROCTEST 16CRATE         (builds 16 crate version)

Build any other multi crate versions you need (defined by .OLE files). Execute the following to build the fortran code:-

SET DEF [--.version.FORTRAN_SOURCE]
MMS

Building at DESY

Due to the shortage of disk space on zukvs3, all software is built on zukvs2. To create an executable version on zukvs3 set up in exactly the same way as you did on zukvs2 and create the required directories. Copy the target and config directories from zukvs2 to the new directories on zukvs3 e.g. (for roctest version ucl_v4_1)

COPY ZUKVS2::SYS$DEVICE:[CTD_ONLINE.ROCTEST.UCL_V4_1.TARGET]*.* -
 ROCTEST_TARGET
COPY ZUKVS2::SYS$DEVICE:[CTD_ONLINE.ROCTEST.UCL_V4_1.CONFIG]*.* -
 ROCTEST_CONFIG

Building ZTCLIB

ZTCLIB is used by ROCTEST, TCT and SST. Execute the main setup file. Edit the setup files in base directories (e.g. TCT_BASE_DIR if TCT will use the new ZTCLIB), so that setting up the package (TCT or SST) sets up the new ZTCLIB version. Check the correct version has been setup by looking at the logical ZTCLIB_VERSION.

Create the following directories:-

ZTCLIB_TARGET_DIR
ZTCLIB_SOURCE_DIR
ZTCLIB_CONFIG_DIR
ZTCLIB_WORK_DIR

Change directory to ZTCLIB_SOURCE_DIR and type MMS.