xcall XOKEY, mode, msgname, msgdata
xcall XUSER, mode, msgname, msgdata
XOKEY is a variation of COMMON, used for passing data between programs in memory, supporting up to 400 packets of fifteen bytes each. XUSER is a disk-based version of XOKEY; the packets are stored in the file SYS:XUSER.SYS which will be created automatically if not present.
Parameters
mode (String,1) [in]
Operation to perform: "P" to put (write), "R" to read (destructive), "G" to get (non-destructive read), "Z" to clear all packets
msgname (String,10) [in]
Name of message packet
msgdata (String,15) [in/out]
Data to read or write
Comments
The Put ("P") operation scans the file from the start, using the first empty slot, or re-using the first slot matching msgname, whichever comes first. This could result in multiple entries with the same msgname. To eliminate that possibility, use the destructive Read ("R") first. Likewise, the Read and Get operations stop at the first matching msgname.
History
2025 February: These routines have existed in A-Shell for many years, but was only documented at this time.
