Click above to get retro games delivered to your door ever month!

  RECEIVE

  .  Summary

  receive(int <protocol>, str <name>);

  .  Description

  The receive function is used to receive (download) one or more files
  from another system. <protocol> is the letter used to select the ap-
  propriate protocol from the actual download menu in Telix (e.g., 'X'
  for Xmodem), as follows:

            'A'       ASCII
            'K'       Kermit
            'M'       Modem7
            'S'       SEAlink
            'T'       Telink
            'X'       Xmodem
            '1'       Xmodem-1k
            'G'       Xmodem-1k-g
            'Y'       Ymodem
            'E'       YmodEm-g
            'Z'       Zmodem

  If an external protocol is defined, <protocol> may also be the key
  used to select it. <name> is the name the file should take. For pro-
  tocols which pass the name, such as SEAlink, Zmodem, Ymodem (batch),
  and others, the name field should be an empty string, "". If a down-
  load directory has been defined in the Configuration Menu, received
  files will go there, unless the <name> string explicitly includes a
  path to another drive/directory.

  .  Return Value

  A value of -1 is returned if the transfer was aborted, except if the
  Carrier (connection) was lost, in which case a value of -2 is re-
  turned.

  .  Example

  int result;
  result = receive('X', "TEST.EXE");
  if (result < 0)
   prints("File transfer failed!");