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. Under UNIX, you are given a new shell and 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, you will need to source either the file $DRAMA/drama.csh if you are using a csh compatible shell or the file $DRAMA/drama.sh if you are using a sh compatible shell.

If using a csh compatible shell, I suggest lines like these be put in your .cshrc file to cause an automatic load or drama.ch when drama is started.

      if ( ${?DRAMA} != 0 ) then
          source $DRAMA/drama.csh
      endif
For borne compatible shells, the following should do the trick.
      if [ "$DRAMA" != "" ]; then
          \. $DRAMA/drama.sh
      fi

Under unix, the above commands source equivalent files from $DRAMA/local if they exist to provide site wide commands for local applications. They also source 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 execute, the bourne shell versions of the above scripts are used.

On MacOsX, the architecture to be used 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 ealier, 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.7 or later, the only option is a 64 bit build. 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.

If the architecture chosen above does not exist, then, unless the IGNORE_NOTTHERE environment variable is set, we attempt to find another mac os x build which will work and use that.

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 returnning 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 tjf@aao.gov.au