1 08/22/83  l6_ftf
 2 
 3 Syntax:  l6_ftf channel_name {-control_args}
 4 
 5 
 6 Function:  allows a process to handle file transfer requests from a
 7 Level 6 using the L6 File Transfer Facility (FTF) protocol (referred to
 8 as L6 TRAN, see the DPS 6 & Level 6 to Level 66 File Transmission
 9 Facility User's Guide, Order No. CZ60).  This command continues
10 to listen for and carry out Level 6 requests until the user explicitly
11 tells it to stop.  Only sequential ASCII or sequential binary files can
12 be transferred to or from the Level 6.  ASCII files on Multics are
13 assumed to be stream files when sending and are stored as stream files
14 when receiving.  Binary files on Multics have a special format (see
15 "Notes" below).
16 
17 
18 Arguments:
19 channel_name
20    is the name of a polled VIP subchannel over which the file transfers
21    take place.  It must have the "x" prefix (i.e., b.h217.x01).
22 
23 
24 Control arguments:
25 -long, -lg
26    prints a line describing each file transfer as it starts and as it
27    completes.  The default is not to print this information.
28    -target_dir (-td) restricts the pathnames of any files to be
29    transferred to be relative to the target directory.  The root may be
30    specified as ">"; this allows absolute pathnames to be specified.
31    The default is the working directory.
32 
33 
34 Access Required:  The user must have rw access to the Access Control
35 Segment (ACS) of the specified channel name to use the file transfer
36 facility.  The user must have the "dialok" attribute turned on in the
37 Project Master File (PMF).  The polled VIP subchannel must have the
38 slave attribute in the Channel Master File (CMF).
39 
40 
41 Notes:  This command continues to listen for and process file transfer
42 requests from the Level 6 on the specified channel until the user types
43 "quit" ("q") or the channel disconnects.  The quit request can be typed
44 at any time but only takes effect before any file transfer has started
45 or between two file transfers.
46 
47 Interrupting and releasing a file transfer in the middle of the
48 transfer may result in aborting the operation in an inconsistent state,
49 and causing the Level 6 task to hang.
50 
51 The Polled VIP subchannel must be defined with a terminal type that
52 assigns "max_message_len" to a value of 1009 in its additional_info
53 statement.
54 
55 
56 Only sequential ASCII or sequential binary files can be transferred
57 from or created on the Level 6.  On Multics, ASCII files are assumed to
58 be or are created as stream vfiles.  Notice that blank lines in a Level
59 6 file actually have some character on them, usually a space or tab.
60 These characters end up in the Multics file.  The command takes care of
61 sending blank lines from Multics files to the Level 6 by sending a line
62 containing a single-space character.
63 
64 On Multics, binary files are sequential vfiles.  Each record is assumed
65 to have the following format:
66 
67       dcl 1 binary_record aligned based,
68             2 num_sextets fixed bin(35) aligned,
69             2 sextets (0 refer binary_record.num_sextets) fixed bin(6)
70               unsigned unaligned;
71 
72 Each binary record is stored in a vfile_ record of size
73 currentsize(binary_record) * 4.