Loads a named workspace. The workspace is loaded into memory and overwrites any workspace already associated with the current APL task. If the workspace has a password, it must be given. Otherwise the message WS LOCKED appears and the workspace is not loaded.
)LOAD MYWS SAVED 2002-09-11 10.32.16
There are two different ways in which you can specify where APLX should look for the saved workspace:
The rules which APLX applies when interpreting a name and/or library specification in a system command are as follows:
In each case, the name is normally assumed to end at the first blank character. If you want to include blanks in the name, you can enclose the whole file name in single quotes.
If you use full pathnames under AIX, Windows or Linux, you should normally supply the .aws file extension when saving workspaces, otherwise the workspace
will not show up in the )LIB listing. This is not true under MacOS, which keeps a file type separate from any file extension.
Some system commands (including )LOAD) can take an optional colon and password. Under MacOS, this might be confused with a full pathname, so you must include a space before the colon to terminate the name.
Suppose the first three rows of your ŚMOUNT
table are set up as follows:
3 40†ŚMOUNT '' c:\temp G:\apl\historic\aplx
Note that the second row, library 1, is blank, so will correspond to the user's home
directory. This might be something
like: C:\Documents and Settings\Jim\My Documents.
Library of directory 0:
)LIB 0 IF JIM PICTUREDEMO PLUSFNS SC TESTDISPLAY
Library of directory 0, implicit library number:
)LIB IF JIM PICTUREDEMO PLUSFNS SC TESTDISPLAY
Library of the same directory, specifying a full library path:
)LIB c:\temp IF JIM PICTUREDEMO PLUSFNS SC TESTDISPLAY
Library of directory 1. Because ŚMOUNT table entry is blank, this is the user's home directory:
)LIB 1 ANOTHER BERT FRED
Load a workspace from library 0 (the 0 could be omitted). Full path is c:\temp\PICTUREDEMO.aws
)LOAD 0 PICTUREDEMO SAVED 2002-07-05 15.51.31
Load a workspace from library 1. Full path is ANOTHER.aws in user's home directory:
)LOAD 1 ANOTHER SAVED 2003-11-18 10.49.51
Load a workspace using full explicit path, including file extension (Note
that Windows file names are not case-sensitive):
)LOAD C:\TEMP\PICTUREDEMO.AWS SAVED 2002-07-05 15.51.31 )WSID C:\TEMP\PICTUREDEMO.AWS
Save under a name containing spaces - we need to enclose the name in quotes:
)SAVE 'A nice name with spaces' 2003-12-10 13.44.16 )LIB A nice name with spaces IF JIM PICTUREDEMO PLUSFNS SC TESTDISPLAY
Re-load using a full pathname - again we need to enclose the name in quotes, and supply the file extension because we are using a full path:
)LOAD 'c:\temp\A nice name with spaces.aws' SAVED 2003-12-10 13.44.16
Under MacOS X, you can enter file paths either using in traditional Macintosh style, using colon as a directory separator (MacHD::workspaces:Budget03), or in a Unix style, with slash as the separator (/Volumes/MacHD/workspaces/Budget03).
In Client-Server implementations of APLX, the front-end which implements the user-interface (the "Client") runs on one machine, and the APLX interpreter itself (the "Server") can run on a different machine. The two parts of the application communicate via a TCP/IP network. Typically, the Client will be the APLX front-end built as a 32-bit Windows application running on a desktop PC, and the Server will be a 64-bit APLX64 interpreter running on a 64-bit Linux or Windows server.
In such systems, you can specify whether the file should be accessed on the Client or the Server machine. You do this by preceding the file name with either an Up Arrow † to indicate that the file should be accessed on the Client, or a Down Arrow ‡ to indicate that it should be accessed on the Server. If you do not specify, the default is that the access takes place on the Client. This is true either if you specify the full path name in the system command, or via the ŚMOUNT table.
In this example, we load a workspace from the Client machine (under Windows), and save it on the Server machine (in this case, a Linux system):
)LOAD †C:\workspaces\mailfilter.aws SAVED 2006-08-15 8.50.04 )SAVE ‡/usr/local/wsrelease/mailfilter.aws 2006-08-24 15.50.10