/Users/socfiles/info/programs_in_bin.txt


There are relevant tools (shell and perl scripts) in two directories ---
/Users/socfiles/bin and /Users/dsn/bin. The tools are listed and explained
below.

There is also a (sub)directory /Users/socfiles/bin/archive. This directory
contains tools, which are no longer needed, but have been archived for
legacy reasons.


/Users/socfiles/bin:

CVS - the Concurrent Versioning System (CVS) bookkeeping and database
      directory for the /Users/socfiles/bin directory. Most of the tools in
      the /Users/socfiles/bin directory are kept under CVS. The repository
      location is /Users/socfiles/cvsroot --- this info can also be found
      in one of the files inside the CVS directory.

addbackuptimetag - copies a file and adds a date-and-time suffix to it to
                   indicate when a backup copy has been made

arch_d_minutes - copy the daily minutes from socfiles/minutes/*.fot to
                 /service/soho-archive/SOT/

arch_w_minutes - copy the weekly minutes from socfiles/minutes/weekly to
                 /service/soho-archive/SOTweekly/

archmaillogbook - opens editor for you to type in logbook then appends to
 		  end of logbook then emails entry to soc@esa

caledit - calendar editing program, calling caledite uses emacs, etc, locks
          calendar while editing

chk_edit_ins_status - edit socfiles/ins.status, put on web at
                      socweb/soc/info_files/, print hardcopy

copy2sohoweb - Was previously used as a generic mcsoc-to-web server copying
               tool. Has not been used after the direct copying via the NFS
               mount was enabled.

copy_d_minutes - copy socfiles/minutes/*.fot to socweb/daily

copy_w_minutes - copy socfiles/minutes/weekly to socweb/weekly

cvsmaneuverdir - bring maneuver directory under CVS

getsend_nrt - done hourly; filters Near Real-Time command and MDI
              transition information from activity plan files provided by
              the Flight Ops Team, reformats the information, e-mails it to
              select stakeholders and places the information onto the SOHO
              web site (to
              http://sohowww.nascom.nasa.gov/soc/nighttime_nrt.txt).

infofiles2socweb - sync socfiles/info with web server for /soc and
                   /info_files and /phone and /limits and /scripts

m2u - "Mac-to-unix"; changes Mac-style line endings to unix-style line
      endings

mkmaneuverdir - make maneuver directory, use templates

now - gives date and time (un UT)

print - print text files to the SOC office printer by converting them to
        Postscript with enscript.

pur - purges backup files created by emacs for instance from the directory
      the command is given. Non-recursive.

socwebaccess - tests, whether the web directory structure (mounted via NFS)
               is accessible (NFS connection may have goon stale etc.)

sohoemaildistrib - email distribution program used by different programs
                   with different email lists (see info file:
                   email_lists.html)

sohoevent2web - copies events files from your directory to
                socweb/soho_events/

sohomkshortdsn - makes DSN schedule for web and sends out on email and
                 makes CDS KAPs and MDI's email

todoedit - edit todo list and email changes


/Users/dsn/bin:

The tools (shell or perl scripts) here are almost invariably related to the
cron jobs running under this account. Some of the tools are just symbolic
links to tools, who actually are located in /Users/socfiles/bin.

Cronjobs on dsn account on mcsoc are:

get_dsn_all - done hourly; retrieves DSN schedule information from JPL's
              servers and processes the information to formats used by
              SOHO's ground systems. Joe Hourcle is the most knowledgeable
              person.

make_dsn_plots - done hourly; processes the DSN information with IDL and
                 creates the DSN schedule plots (in for instance
                 http://sohowww.nascom.nasa.gov/soc/dsn/current.html). Uses
                 IDL tools located in /Users/dsn/idl.

getsend_nrt - symbolic link to a file in /Users/socfiles/bin. For
              description, see above.

sohomkshortdsn - done daily; symbolic link to a file in
              /Users/socfiles/bin. For description, see above.


init files in /Users/socfiles/init

.bashrc - primary shared bash initialization file. File should be sourced
          from the corresponding .bashrc file in the user's home directory
          with source ${SOCFILES}/.bashrc. The environmental variable
          SOCFILES needs to be defined before the command is given.

.bash_profile - the other shared bash initialization file. File should be
                sourced from the corresponding .bash_profile file in the
                user's home directory with source ${SOCFILES}/.bashrc. The
                environmental variable SOCFILES needs to be defined before
                the command is given.


On the soc computer (now turned off; files retrievable from backups), the
manual Command History Report (mkchr) tool can be found in the ${HOME}/util
directory of account ecs. This reads in DATE and DOY, searches for the
DATE/DOY in all .CHR files and pulls out the data for that DATE/DOY. Since
compiling of the Command History Reports has been discontinued, this tool
is probably no longer needed.