Install guide

Appendix 5: Background on the Devkit Shells
Introduction
The ‘WebApps’ products WOW, Corporate Data Archiver and Project Administrator all run
Tcl/Tk shells, extended with OpenWorks devkit functions. This provides a powerful yet
simple mechanism for extracting information from these project data sources for display in
a table, graphical user interface or Web page.
The main devkit shell lmksh integrates the OpenWorks, SeisWorks, Z-MAPPlus and ZGF
devkits with other api’s providing coverage of e.g. GeoProbe, SEG-Y and LAS files.
Other than as documented in the main body of these Release Notes, command-line
usage of lmksh is not formally supported. This appendix is provided as an unofficial start
point to those interested in scripting their own command line utilities. Please note that no
support will be provided on either Tcl/Tk or on lmksh.
For more information on Tcl/Tk, try one of these books:
• Tcl and the Tk Toolkit, by John Ousterhout, published by Addison-Wesley 1994,
ISBN 020163337X
• Practical Programming in Tcl and Tk (4
th
Edition), by Brent Welch, Jeffrey Hobbs &
Ken Jones, published by Prentice-Hall 2003, ISBN 0130385603
• Tcl/Tk in a Nutshell, by Paul Raines & Jeff Tranter, O’Reilly 1999, ISBN 1565924339.
• Tcl/Tk: A Developer’s Guide (2
nd
Edition), by Clif Flynt, published by Morgan
Kaufmann 2003, ISBN 1558608028.
Some useful web sites:
• Main Tcl/Tk site: http://www.tcl.tk
• ActiveState (Tcl distribution): http://www.activestate.com/Products/ActiveTcl
• Tcl Wiki (getting started guide): http://wiki.tcl.tk
• Newsgroup: news:comp.lang.tcl or http://groups.google.com/groups?group=comp.lang.tcl
Running lmksh
To run lmksh you require a .lmkrc file in your home directory and to have sourced the
required environment:
prompt> cp $OWHOME/WebApps/templates/wow.lmkrc ~/.lmkrc (1-off)
prompt> source $OWHOME/WebApps/templates/wow.login
*
(C-shell)
prompt> . $OWHOME/WebApps/templates/wow.profile (Bourne shell)
prompt> lmksh
lmksh{1}% OWSetup (configures OpenWorks environment)
lmksh{2}% info commands (lists all available commands)
lmksh{3}% info commands sdl* (lists commands beginning with sdl)
lmksh{4}% info procs (lists all available procedures)
lmksh{5}% info args hrzinfo (lists arguments for specified proc)
Alternatively, a wrapper script is provided and linked to $OWHOME/bin during installation:
prompt> rlmksh
WOW 5000.0.1.11 Release Notes Page 89 of 104 March 2014