Updated Feburary 2020; see History

The src parameter specifies the source text to be edited, and is interpreted in conjunction with the TXC.DOCFMT'SRC field of the txtctl parameter, in one of the following ways:

•   File: To specify a file to edit, set src to the filename, and set the TXFF_FILE flag in the txc.docfmt'src field of txtctl. In the ATE environment (i.e. when running under UNIX with an ATE client), if the filename does not contain a drive letter or backslash, then it is interpreted as being resident on the server and is automatically transferred to the %ATECACHEDIR% directory on the client workstation for editing.

•   String Buffer: To specify a string buffer, map src as a string variable of suitable size, load the initial text into it, and do not set the TXFF_FILE flag in TXC.DOCFMT'SRC field.

•   Current Control Contents: To reedit the current contents of an existing control, src is not required. Instead, set opcode to TXOP_REEDIT, TXC.CTLNO to the text control number.

•   Format: Independent of whether the document source is supplied as a file or in memory, the low three bits of TXC.docfmt'src should be used to specify the format.

History

2020 February, A-Shell 6.5.1676:  When either XTEXT or AUI_IMAGE needs to transfer a file between the server and client via {S}FTP, they now use FTP2 rather than the older—and now deprecated—FTPDLX routine. Among other advantages of FTP2 is that it doesn't require registering a DLL on he Windows side.