dramastart - Startup drama.

Function

Startup drama.

Description

Defines the subsys_DIR, subsys_LIB and subsys_DEV environment variables (Unix/VxWorks) or logical names (VMS) for each drama sub-system. The definition of the MANPATH environment variable is modified to include the DRAMA man pages.

Under the VxWorks and VMS versions, all DRAMA commands will now be available.

Under unix, also sources equivalent files from $DRAMA/local if they exist to provide site wide commands for local applications. Also sources a user specific file named $HOME/.drama.sh or $HOME/.drama.csh (depending on the shell), if they exist, to provide user specific commands. Also, the DRAMA_USERSTART environment variable can be used to specify commands to be executed.

Note that if you specify a command to be executed, the default system shell versions of the above scripts are used.

On a 64 bit MacOsX (prior to MacOs 11 (BigCurl), host can be dependent on environment variables.

`DRAMA_MAC_64BIT_ONLY`	If set, and `OS` is 10.5 or later, build for 64 bit intel.
`DRAMA_MAC_32BIT_ONLY`	If set, and `OS` is 10.6 or earlier, build for 32 bit intel.
`DRAMA_MAC_INTEL_FAT`	If set, and `OS` is 10.5 or 10.6, do `FAT` builds for both 32 bit and 64 bit intel.

For MacOsX 10.6, the default is a FAT build. 32bit or 64 bit possible. For MacOsX 10.5, the default is a 32 bit build, 64 bit or FAT possible For MacOsX 10.4 or earlier. only option is 32 bit build.

On a 32 bit MacOsX machine, you can also generate a FAT build by setting DRAMA_MAC_INTEL_FAT to be true. You can't generate a 64 bit build, since some DRAMA tools are needed by the build. .

On MacOS versions from BigCurl (V11) onward:

`DRAMA_MAC_INTEL`	If set, then build for 64 bit intel.
`DRAMA_MAC_ARM64`	If set, then build for 64 bit arm (e.g `M1`).
`DRAMA_MAC_I_A_FAT`	If set, then build a intel/arm `FAT` build.

Note, on an ARM mac, you need to be careful of what your build environment is defaulting to. The "arch" command will tell you what it is (i386 or arm64). The impacte of having this different from your desired target is unclear, but is likely to mostly impact external (non-DRAMA) software builds. You can use "arch -i386 $SHELL" or "arch -arm64 $SHELL" to change it as needed.

On Linux 64 bit intel architecture, if DRAMA has not been built for 64 bit, then, unless IGNORE_NOTTHERE environment variable is set, we attempt to find a 32 bit build and use that. We use the "setarch i686" command to change the architecture, in this case.

Synopsis

(UNIX) dramastart [options] [<target> [<program> [<args>...]]]

(VxWorks) dramastart "<version>","<directory>"

(VMS) @dramastart start_type [options]

Options

-v file: Specifies a version file of the form "subsystem=version" If not found in the current directory, then .ver if appended. It still not found, then the drama project directory is tried. If this option is not specified, then the value in the DRAMA_USER_VERFILE envrionment variable isused. Is that is not set, then the default version of each sub-system is used.

Arguments

start_type: VMS only, either DRAMASTART for a normal dramastart command or VMSSTART to execute VMS startup files.
target: The target name (unix only). Currently, sun4, sun4_solaris, alpha_osf and vw68k are generally known about. Normally only used if the target is to be different from the host and this will only work if cross compilers are available. If you wish to specify the program argument on the local host, you an specify "host" as the target name.
program: A program to run. If specified, a new shell is not started, instead the specified program is run with all the DRAMA variables and commands defined.
args: Any number of arguments to be passed to [program.
version: A version file, VxWorks version As per the -v options. In addition, the form "-v file" is accepted for this argument. [directory] (VxWorks version, The location of the drama project. If not supplied, the value defined when the program is built will be used.

Files

$DRAMA/drama.sh $DRAMA/drama.csh $DRAMA/local/drama.sh $DRAMA/local/drama.csh $HOME/.drama.sh $HOME/.drama.csh $HOME/.drama.env

Environment Variables DRAMA_USERSTART If the environment variable DRAMA_USERSTART is defined when this is run, then this is the name of a script to be sourced after the user script ($HOME/drama.sh or $DRAMA/drama.csh) is run. This can be used to start something after DRAMA has been started, specific to this run of the script. So if you want particular programs started after starting DRAMA but before returning to the shell, you an use this environment variable to set the name of the script which does this. DRAMA_USERSTART will NOT be defined during the run of the script or the DRAMA environment in question, but _DRAMA_USERSTART will contain its value.

DRAMA_USER_VERFILE If the user does not specify a version file with the -v option, then this environment variable can be set to name the version file. IT must be the full path to the version file.

Click here for the DRAMA home page and here for the AAO home page.

For more information, contact tony.farrell@mq.edu.au