Creates a Transfer File in the library specified. If no individual objects are named then the Transfer File will include all functions, operators and variables in the workspace as well as ŒCT, ŒFC, ŒIO, ŒLX, ŒPP, ŒPR and ŒRL. Alternatively, specified objects may be written to the Transfer File together with an optional selection of system variables.
)WSID (Sample workspace) TEST )VARS A B C D )FNS FRED JOE )OUT TESTWS (Export everything, including standard system variables) )OUT PARTWS A C FRED ŒPP ŒPW (Partial export only)
The Transfer File is written in a format which can be read using the system command )IN by APLX or by another APL interpreter such as IBM's APL2. Before it is written, the data is translated to the form similar to that used by APL2/PC. Not all APLX characters can be represented in this form, and variables containing control codes should not be transferred.
There are two different ways in which you can specify where APLX should save the transfer file:
See the description of the )LOAD system command for more detail on libraries and path names.
The Transfer File format is based on an ancient layout known as punched card layout and is a series of length 80 character records. Each record is delimited by an 'end of record' character (Hex F8) and a Carriage Return - Line Feed pair - making 83 characters in all. The first character of each record is reserved for format information, which will be:
Character Meaning
* Timestamp for the function or operator X Last record for the object (or only record) (blank) All other records
Remaining columns of the record are occupied by the Transfer Form of the objects selected. The Transfer Form is described under ŒTF Thus for the sample workspace shown above:
XNŒPP 0 10 X XNŒIO 0 1 X XNŒCT 0 1E¯13 X XCŒFC 1 6 .,*0- X XNŒRL 0 16807 X XCŒPR 1 1 X XCŒLX 1 0 X XNA 0 1 X XNB 0 2 X XNC 0 3 X XND 0 4 X XFFRED ŒFX 'FRED' '2' X XFJOE ŒFX 'JOE' '4' 'L:''SAMPLE FN''' '80' X
and for the partial export:
XNA 0 1 X XNC 0 3 X XFFRED ŒFX 'FRED' '2' X XNŒPP 0 10 X XNŒPW 0 80 X