1 11/18/87  pc_bft_
  2 
  3 
  4 This is a collection of subroutines (found in pc_bft_.archive) which
  5 provide a subroutine interface to BFT on the PC.
  6 
  7 
  8 Entry points in pc_bft_:
  9     (List to be generated by the help command)
 10 
 11 
 12 :Entry: bftfetch: 11/18/87  bftfetch
 13 
 14 
 15 Function: Transfers a file from Multics to the local machine (PC).  If
 16 a file already exists with the destination name on the local machine,
 17 it will be overwritten if possible.
 18 
 19 
 20 Syntax:
 21 bftfetch  (source_filename,  destination_filename, priority, flags);
 22    char *source_filename;
 23    char *destination_filename;
 24    int   priority;
 25    long  flags;
 26 
 27 
 28 Arguments:
 29 source_filename
 30    The Multics pathname of the file which is to be transferred from
 31    Multics to the PC.  (Input)
 32 destination_filename
 33    The pathname where the file sent from the remote machine is to be
 34    stored.  (Input)
 35 
 36 
 37 priority
 38    The priority of the queue into which the fetch request is to be
 39    placed.  These range in value from 1..4, with 1 being of highest
 40    priority.  (Default 3)
 41 flags
 42    A collection of bits signifying transfer characteristics.  (Input)
 43    The following definitions should be ORed together to obtain the
 44    appropriate settings (defined in BFT.H)
 45 
 46       BFT_BINARY    - ignore <CR><NL> - <NL> conversions
 47       BFT_NOTIFY    - notify user upon completion
 48 
 49 
 50 Examples:
 51 bftfetch (">udd>multics>bob>wonk", "c:\user\pete\wonk", 0, 4);
 52 bftfetch ("<o>foo", "foo", BFT_BINARY | BFT_NOTIFY, 1);
 53 
 54 
 55 :Entry: bftstore: 11/18/87  bftstore
 56 
 57 
 58 Function: Sends a file from the local machine and stores it on the
 59 remote machine (Multics).  If a file already exists with the
 60 destination name on the remote machine, it will be overwritten if
 61 possible.
 62 
 63 
 64 Syntax:
 65 bftstore  (source_filename,  destination_filename, flags, priority);
 66    char *source_filename;
 67    char *destination_filename;
 68    long  flags;
 69    int   priority;
 70 
 71 
 72 Arguments:
 73 source_filename
 74    The PC pathname of the file which is to be transferred from the PC
 75    to Multics.  (Input)
 76 destination_filename
 77    The pathname where the file is to be sent to on the remote system.
 78    (Input)
 79 
 80 
 81 flags
 82    A collection of bits signifying transfer characteristics.  (Input)
 83    The following definitions should be ORed together to obtain the
 84    appropriate settings (defined in BFT.H)
 85 
 86       BFT_BINARY    - ignore <CR><NL> - <NL> conversions
 87       BFT_NOTIFY    - notify user upon completion
 88 priority
 89    The priority of the queue into which the fetch request is to be
 90    placed.  These range in value from 1..4, with 1 being of highest
 91    priority.  (Default 3)
 92 
 93 
 94 Examples:
 95 bftstore ("c:\user\bob\wonk", ">udd>multics>bob>wonk", 0, 1);
 96 bftstore ("c:joe", ">udd>games>chess", BFT_BINARY, 4);
 97 
 98 
 99 :Entry: bftcan: 11/18/87  bftcan
100 
101 
102 Function: Remove the specified entry from the containing transfer
103 queue, causing the transfer request not to be found and ultimately
104 terminating the request.
105 
106 
107 Syntax:
108 bftcan (id_type, entry_id);
109    int   id_type;
110    char *entry_id;
111 
112 
113 Arguments:
114 id_type
115    is the type of the request identifier that has been given.  It must
116    take on one of the values BFT_PATH_ID, BFT_ENTRY_ID, or BFT_TIME_ID
117    defined in the include file bft.incl.pl1. (Input)
118 entry_id
119    is the request identifier of the entry to be removed.  It may be
120    one of relative pathname, entry name, or request ID.  (Input)
121 
122 
123 Examples:
124 bft_$cancel (BFT_ENTRY_ID, "foo");
125 bft_$cancel (BFT_PATH_ID,  ">udd>m>bob>foo");
126 bft_$cancel (BFT_PATH_ID,  "C:\TMP\BAR");
127 bft_$cancel (BFT_TIME_ID,  "173611.1");
128 
129 
130 :Entry: bftrecfe: 11/18/87  bftrecfe
131 
132 
133 Function: Continues receiving a file from the remote system (Multics)
134 after the interruption of a previous fetch command.  The length of the
135 destination file is checked on the local machine, and the remainder of
136 the file is transferred.
137 
138 
139 Syntax:
140 bftrecfe ();
141 
142 
143 :Entry: bftrecst: 11/18/87  bftrecst
144 
145 
146 Function: Continues sending a file to the remote system (Multics)
147 after the interruption of a previous store command.  The length of the
148 destination file is checked on the remote system, and the remainder of
149 the file is sent.
150 
151 
152 Syntax:
153 bftrecst ();
154 
155 
156 :Entry: bftunld: 11/18/87  bftunld
157 
158 
159 Function: This unloads the BFT server modules from both the PC and
160 Multics.  All transfers in progress will be interrupted and the queues
161 will remain intact with the current entries.
162 
163 
164 Syntax:
165 bftunld ()