Network Working Group W. Parrish
Request for Comments: 525 J. Pickens
NIC: 17161 Computer Systems Laboratory -- UCSB
 1 June 1973
 MIT-MATHLAB MEETS UCSB-OLS:
 An Example of Resource Sharing
I. Introduction
 A. Resource Sharing, A Comment
 Non-trivial resource sharing among dissimilar system is a much
 discussed concept which, to date, has seen only a few real
 applications. [See NIC 13538, "1972 Summary of Research
 Activities (UTAH) for description of Tony Hearn's TENEX-CCN
 Programming Link.] The first attempts have utilized the most
 easily accessible communication paths, (TELNET and RJS) and the
 most universal representations of numbers (byte-oriented numeric
 characters in scientific notation). Future schemes will probably
 be more efficient through standardized data and control protocols,
 but even with the existing approaches users are gaining experience
 with combinations of resources previously not available.
 B. The MATHLAB/UCSB-OLS Experiment
 MATHLAB [1] and OLS are powerful mathematics systems which cover
 essentially non-intersecting areas of mathematical endeavor.
 MATHLAB (or MACSYMA) contains a high-powered symbolic manipulation
 system. OLS is a highly interactive numeric and graphics system
 which, through user programs, allows rapid formulation and
 evaluation of problem solutions. Prior to this experiment, users
 have dealt with problems symbolically on MATHLAB or numerically
 and graphically on OLS. Lacking an interconnecting data path,
 users have been left to pencil and paper translation between the
 two systems.
 The goal of the MATHLAB-OLS experiment is to provide an automated
 path whereby expressions at MATHLAB may be translated into User
 Programs at UCSB. Thus the user is able to experiment freely with
 the numeric, graphic, and symbolic aspects of mathematic problems.
II. THE RESOURCES
 To understand this particular case of resource sharing, it is first
 necessary to understand, to some degree, the resources being shared.
 This paper does not attempt to deal with all of the resources
 available at both sites (UCSB and MIT). Only the applicable shared
 resources are discussed briefly. In the section discussing
 possibilities for additions (Section V) some available unshared
 resources are presented, along with their possible shared
 applications. The current implementation is limited to evaluation of
 real functions. A description of the capabilities at the two sites
 follows.
 A. Graphical and Numeric Computation Capabilities at UCSB
 To get a graph of a function on the OLS, it is necessary only to
 specify the function with a series of button-pushes. For example,
 to get a plot on sin(x), the "program"
 II REAL SIN x DISPLAY RETURN
 will display a plot of sin(x) versus X, provided that X has been
 defined as a vector containing values over the range which it is
 desired to plot. For a more complete description of OLS see NIC
 5748, "The OLS User's Manual". Programs in OLS, or sequences of
 button-pushes can be stored under USER level keys, i.e. the above
 program could be defined as USER LI (+) [2], and the user could
 display, modify, and look at various values of the SIN function
 over different ranges by simply setting up the desired value of
 the the vector X, and then typing USER LI (+). The number of
 elements in such a vector is variable, up to a maximum of 873
 (default value is 51). The vector containing the result can be
 stored under a letter key, i.e. Y, and can be looked at by typing
 DISPLAY Y.
 Scaling of plots on the OLS is automatic for best fit, or can be
 controlled. Upon default, however, it is often desirable to look
 at plots of several functions on a common scale. This can be done
 on the OLS, and the graphs will be overlayed. OLS graphical
 capabilities are available to users at UCSB on the Culler-Fried
 terminals, and to Network users using a special graphics socket at
 UCSB. See NIC 15747, RFC 503 "Socket Number List". For Network
 users without Culler-Fried keyboards, see NIC 7546, RFC 216
 "TELNET Access to UCSB's On-Line System".
 B. Symbolic Manipulations Available at MATHLAB
 MATHLAB'S MACSYMA provides the capability to do many symbolic
 manipulations in a very straightforward and easy-to-learn manner.
 Included in these manipulations are:
 1) Symbolic integration and differentiation of certain
 functions.
 2) Solutions to equations and systems of equations.
 3) Laplace and inverse-Laplace transforms of certain functions
 4) Certain series expansions.
 5) Rational simplification of rational functions.
 For a more complete description, see "The MACSYMA User's Manual" by
 the MATHLAB Group at Project MAC-MIT.
III. A DESCRIPTION OF THE CURRENT IMPLEMENTATION
 A variety of programs are used to make up a system to effect this
 transfer of data.
 1) Two functions are defined in Lisp-like language which are
 loaded into MACSYMA after login in order to facilitate saving a
 list of expressions to retrieve later to UCSB, and to write
 this list out to a disk file at MATHLAB for later retrieval.
 2) A set of OLS user programs create the batch job which actually
 performs the retrieval, translation, and storage of these
 expressions on a specified file on some OLS user directory.
 3) The program which actually performs the connection to MATHLAB
 retrieves the expressions, translates and stores into the OLS
 is written in PL/1 and exists as a load module on disk at UCSB.
 The sequence of operations required in order to retrieve expressions
 using these various programs is outlined below:
 1) The user makes a connection to MIT-MATHLAB in the conventional
 manner. This can be done either through UCSB-OLS, or through
 other TELNET programs, or from a TIP.
 2) The user logs in at MATHLAB, calls up MACSYMA, and loads the
 file into the MACSYMA system which facilitates retrieval.
 (Contains ADDLIST and SAVE functions.)
 3) The user performs the desired manipulations at MATHLAB, and
 saves up a list of line numbers as he goes along using the
 ADDLIST function. These line numbers represent those
 expressions he wishes to retrieve. The format for ADDLIST is
 ADDLIST('<LINE NUMBER>).
 4) When the user has completed all the manipulations he wishes to
 do he saves them on the MIT-MATHLAB disk. (Using SAVE
 function.) The format for SAVE function is SAVE(<filename 1>).
 This function writes out, in horizontal form, the list of line
 numbers in the order the ADDLIST function was invoked to the
 MIT disk. The filename will be <filename 1>BATCH. SAVE also
 appends a question mark on the end of the file as an end-of-
 file indicator.
 5) USER disconnect from MATHLAB.
 6) User connects to and logs into OLS, and loads a file containing
 the user programs which produce a virtual job deck for the
 batch system. A sequence of questions are given to the user by
 these programs regarding accounting information, and the source
 file at MIT, and the destination file at at UCSB. The batch
 job gets submitted automatically, and the transfer and
 translation is done.
 7) After the transfer is completed, the destination file may be
 loaded into OLS, and the results may be displayed and numerical
 manipulations can take place.
 The form of these user programs, as they are returned is as follows:
 LII REAL LOAD ( function )
 Therefore in order to look at a graph of one of these functions, it
 is necessary to set up values of various constants, as well as a
 range of values of the independent variable. It is also necessary to
 request a display of the function. This can be done by typing
 DISPLAY RETURN. It should be noted that the function does exist at
 the time directly after the user program is called and may be stored
 under any of the alphabetical keys on the OLS. Storing several of
 these functions under alphabetical keys will allow them to be called
 up for plotting on a common scale. For example, if the functions
 were stored under the keys A, B, and C, they could be displayed on a
 common scale by typing DISPLAY ABC RETURN.
IV. LIMITATIONS
 A. The program as it stands can only transfer expressions.
 Equations or functions are not implemented.
 B. Variable and constant names at MIT can contain more than one
 letter, but the current implementation recognizes only one-
 letter variable names.
 C. The program as it stands does not handle complex numbers.
 D. The user is subject to failures of three independent systems in
 order to complete the transfer: the UCSB 360/75, the Network,
 and the PDP-10 at MIT. This has not proven to be a serious
 constraint.
 E. Software changes at either site can cause difficulties since
 the programs are written assuming that things won't change.
 Anyone who has ever had a program that works knows what system
 changes or intermittent glitches can do to foul things up.
 With two systems and a Network things are at least four times
 as difficult. Thanks are due to Jeffrey Golden at PROJECT MAC
 for helping with ironing things out at MATHLAB, and the UCSB
 Computer Center for their patience with many I/O bound jobs.
V. POSSIBILITIES FOR ADDITIONS
 A. Recognition of complex numbers, possibly for use with LII
 COMPLEX on the OLS.
 B. Addition to translation tables of WMPTALK for recognition of
 SUM, COSH, SINH, INTEGRATE, DIFF, etc. (Often MATHLAB will not
 be able to perform an integral or derivative, in which case it
 will come back with INTEGRATE (Expression) as its answer.)
 C. An OLS Utilities package for allowing users to more easily
 manipulate the numerical vectors describing the
 expressions,i.e., setting up linear and logarithmic sweeps for
 the various plots, describing the scale of the plots on the OLS
 screens.
 D. The ability to have an OLS program written from a MATHLAB
 function, including IF, THEN, ELSE, DO,etc. This would most
 likely require a more sophisticated parse than is done in the
 current implementation.
EXAMPLE
 An example is included in which a UCSB user:
 A. Logs into MATHLAB,
 B. Initializes the "SAVE" function,
 C. Generates a polynomial function and its derivative and
 integral,
 D. Logs out of MATHLAB,
 E. Creates the retrieval job,
 F. Waits and then displays the resultant user programs,
 G. and, finally, creates the X variable and plots the functions.
 Although the sample OLS manipulations are very simple ones it should
 be noted that the user could compare the retrieved functions with
 numerical models or even use the functions as subroutines in higher
 level algorithms. Usage of this combined numeric-symbolic system is
 limited to the imagination of the user.
 The example follows:
 USER TELNET Connection to MATHLAB from UCSB
 LOGIN TO MIT-ML "II LOG MIT-ML RETURN"
 MIT MATHLAB PDP-10
 ML ITS.796. DDT.514.
 9. USERS
 :LOGIN WMP Login to MIT-MATHLAB.
 :MACSYMA Call up MACSYMA
 THIS IS MACSYMA 212
 USE " INSTEAD OF ?
 SEE UPDATE > MACSYM;
 FIX 212 DSK MACSYM BEING LOADED
 LOADING DONE
 (C1) BATCH(BATCH,UTILS); Load BATCH UTILS file.
 (UREAD BATCH UTILS DSK WMP) FILE NOT FOUND
 (C2) BATCH(BATCH,UTILS,DSK,UCSB);
 (C2) LISTX:();
 (D2) ()
 (C3) ADDLIST(X):=LISTX:CONS(X,LISTX);
 (D3) ADDLIST(X) := (LISTX : CONS(X, LISTX))
 (C4) SAVE(FILENAME):=APPLY(STRINGOUT,APPEND(
 CONS((FILENAME,BATCH,DSK,UCSB),REVERSE(LISTX)),("?")));
 (D4) SAVE(FILENAME) :=
 APPLY(STRINGOUT,APPEND(CONS((FILENAME, BATCH, DSK, UCSB),
 REVERSE(LISTX)),(?)))
 (D5) BATCH DONE
 (C6) (X**2+3)/(X+1);
 2
 X + 3
 (D6) -------
 X + 1
 (C7) INTEGRATE(%,X);
 SIN FASL DSK MACSYM BEING LOADED
 LOADING DONE 2
 X - 2 X
 (D7) ---------- + 4 LOG(X + 1)
 2
 (C8) ADDLIST('D6);
 (D8) (D6)
 (C9) ADDLIST('D7);
 (D9) (D7, D6) Use ADDLIST function
 to save line numbers D6 and D7.
 (C10) DIFF(D6,X);
 2
 2 X X + 3
 (D10) ---- - ------
 X+1 2
 (X+1)
 (C11) ADDLIST('D10);
 (D11) (D10, D7, D6) Use ADDLIST function to
 save line number D10.
 (C12) SAVE(MYFILE);
 (D12) (D6, D7, D10, ?) Write list of lines out
 to a disk file using
 (C13) *********Z Leave MACSYMA SAVE function.
 25156) .IOT 1,1
 :LISTF UCSB
 DSK UCSB
 FREE BLCCKS UO #1 241 U1 #3 345 U2 #5 379
 3 ATTN BATCH 1 5/23/73 13:53:11
 1 BATCH UTILS 1 5/23/73 13:11:43
 3 DEMO WMP 1 5/26/73 15:29:26
 5 DEMO1 BATCH 1 4/29/73 22:41:17
 1 DEMO99 BATCH 1 5/25/73 00:07:15
 5 MYFILE BATCH 1 5/31/73 12:41:50 <-- file is in directory
 1 _MSGS_ UCSB 0 5/26/73 21:13:53 at MATHLAB
 :LOGOUT
 Logout and disconnect.
 -------------------------------------------------------------------
 ML ITS 796 CONSOLE 24 FREE. 12:42:35
 DISCONNECTION COMPLETE
 WORK AREAS UPDATED Load Retrieval program
 LOAD MATHLAB "SYST LOAD MATHLAB RETURN"
 FILE LOADED
 "USER LO (+)"
 RETRIEVE EXPRESSIONS
 --------------------
 MATHLAB FILE? (EXP)
 -->MYFILE-->MYFILE. "MYFILE ENTER"
 OLS FILE? (MYFILE)
 -->demo11-->demo11 "demo11 ENTER"
 OLS FILE
 PROTECT CODE? () "demo11 ENTER"
 -->DEMO-->demo11
 BATCH JOBNAME? (MYFILE) "PARSET ENTER"
 -->PARSET-->PARSET.
 PRESS ENTER TO SUBMIT JOB "ENTER"
 VOLUME NEEDED=
 JOB SUBMITTED
 JOB TO RETRIEVE MATHLAB
 EXPRESSIONS IS NOW IN
 UCSB-MOD75 BATCH QUEUE. Some time elapses and batch job is run.
 Load the retrieved program.
 WORK AREAS UPDATED "SYST LOAD demo11 RETURN"
 LOAD demo11
 FILE LOADED
 Display the returned expressions.
 (USER LI (+)) "USER I DISPLAY (+)"
 ------------------------------------------------------------------
 LII REAL LOAD ((X**2 (+) 3)/(X (+) 1)):
 (USER LI (-)) "USER I DISPLAY (-)"
 LII REAL LOAD ((X**2 (-) 2*X)/2 + 4* LOG (X (+) 1)):
 ------------------------------------------------------------------
 (USER L1 (*)) "USER I DISPLAY (*)"
 LII REAL LOAD (2*X/(X (+) 1) <> (X**2 (+) 3)/(X (+) 1)**2):
 USER LI SQ UNDEFINED "USER DISPLAY SQ"
 [The following figure is available in the .ps and .pdf version of
 this document:]
 Sample OLS Curves Generated for -.5 < x < 4.5
 - -
Endnotes
 [1] Supported on a PDP-10 System at MIT and available for the use at
 UCSB by the way of APRA Network.
 [2] [In this memo, the notation "(+)", "(-)", and "(*)" has been
 substituted for a circle enclosing a +, -, and * symbol,
 respectively.]
 [This RFC was put into machine readable form for entry]
 [into the online RFC archives by Helene Morin, Via Genie 12/1999]