Installation Instructions for the WMKONSPEC Package The WMKONSPEC package (version 2001-Apr-16) contains IRAF tasks useful in the reduction of NIRSPEC images: These instructions describe how to install WMKONSPEC either as a user package or as a layered (external) package to IRAF. A user package can be installed by any user, and is only available to users if their "loginuser.cl" files contain the necessary additions. A layered package is layered on as part of IRAF and is available to all IRAF users without any changes to their "loginuser.cl" file. A layered package can only be installed by the IRAF user. Documentation on layered software is found in the Site Manager's Guide that accompanied your IRAF distribution. [1] The package is distributed as a tar archive; IRAF is distributed with a tar reader. The tar archive may be obtained by anonymous ftp. To obtain the package via ftp (assuming a UNIX computer): % ftp ftp.keck.hawaii.edu login: anonymous password: [your e-mail address] ftp> cd outgoing/nirspec ftp> get README.wmkonspec ftp> binary The package is available as a GNU compressed tar file. Thus, do the following: ftp> get wmkonspec.tar.gz ftp> quit % gunzip wmkonspec.tar.gz [2] Create a directory to contain the WMKONSPEC external package files. This directory should be outside the IRAF directory tree. If WMKONSPEC is being installed as a layered package, then the directory must be owned by the IRAF account. In the following examples, this root directory is named /local/wmkonspec/ (UNIX). Make the appropriate file name substitutions for your site. [3] If WMKONSPEC is being installed as a user package, then this step can be skipped. If WMKONSPEC is being installed as a layered package, then the IRAF system must be made aware of its existence by adding it to the list of external packages. Log in as IRAF and edit the extern.pkg file in the hlib directory to define the package to the CL. From the IRAF account, outside the CL, you can move to this directory with the commands: % cd $hlib Define the environment variable wmkonspec to be the pathname to the wmkonspec root directory. The '$' character must be escaped in the VMS pathname; UNIX pathnames must be terminated with a '/'. Edit extern.pkg to include: reset wmkonspec = /local/wmkonspec/ task $wmkonspec.pkg = wmkonspec$wmkonspec.cl Near the end of the hlib$extern.pkg file, update the definition of helpdb so it includes the wmkonspec help database, copying the syntax already used in the string. Add this line before the line containing a closing quote: ,wmkonspec$helpdb.mip\ [4] Log into the CL from the IRAF account (if WMKONSPEC is being installed as a layered package) or from the user's account (if WMKONSPEC is being installed as a user's package), and unpack the archive file. Change directories to the WMKONSPEC root directory created above and use 'rtar': cl> cd wmkonspec cl> softools cl> rtar -xrf ../wmkonspec.tar [5] If WMKONSPEC was installed as a layered package then this step can be skipped. If it was installed as a users package, then each user wanting access to the package needs to put the following lines into his/her "loginuser.cl" file, somewhere before the "keep" command. reset wmkonspec = /local/wmkonspec/ task $wmkonspec.pkg = wmkonspec$wmkonspec.cl reset helpdb = (envget("helpdb") //",wmkonspec$helpdb.mip") Note that this last line may well fail if the helpdb string exceeds 160 characters in length.