1 10/07/88 delete, dl
 2 
 3 Syntax as a command:
 4 dl arguments {-control_args}
 5 
 6 
 7 Function:
 8 The  delete request lets you delete a file on a remote host.
 9 
10 
11 Arguments:
12 file
13   file is the  name of the  file  to be  deleted  and must  be
14   specified  in  a form  acceptable  to the  host on  which it
15   resides.  It must be preceded by -name (or -nm)  if the file
16   name  begins  with  a  "-";  it  must  be  followed  by "-at
17   CORRESPONDENT"  where CORRESPONDENT must be  the  name given
18   in the NIT (Network Information Table)  to  the  remote  UFT
19   application.   It must be enclosed  in quotes if it contains
20   spaces  or  special   characters.     If  the  CORRESPONDENT
21   is  running  on   a  Multics  system,   then file  can be  a
22   "star"  name,  and all  of the  files which match the "star"
23   name will be deleted.
24 
25 
26 Control arguments:
27 -at CORRESPONDENT
28   CORRESPONDENT  must be  the  name given  in the NIT (Network
29   Information Table) to the remote UFT application.    The NIT
30   associates  to  the  UFT correspondent name  its DSA network
31   address (session_id and mailbox).
32 -billing STR
33   specifies the  accounting identification used by  the remote
34   host (not Multics); there is no default.
35 
36 
37 -catalogue <file_name>, -cat <file_name>
38   for a non-Multics system,  <file_name> specifies a catalogue
39   file.  The -catalogue control argument is required only when
40   the  catalogue   file  for  the  file   description  is  not
41   implicitly known.  <file_name> must be specified in a syntax
42   acceptable to  the host on  which the file  will resides; it
43   must be enclosed  in quotes if it contain  spaces or special
44   characters.
45 -no_password, -npw
46   if  the -no_password  control argument  is present  the user
47   will  not  be  prompted  for  a  password  with a mask.  The
48   password will not be used by the remote host to authenticate
49   the submitter.
50 
51 
52 -password, -pw
53   if the  -password control argument is present  the user will
54   be prompted for a password with a mask.  The password may be
55   used by the remote host  to authenticate the submitter.  For
56   a remote  Multics system, the -password  control argument is
57   mandatory.  (Default)
58 -person STR, -user STR
59   STR  specifies the  remote user  identification used  by the
60   remote host  on whose behalf  the delete is  to be executed.
61   This may  be used by  the remote host  for authentication of
62   the job  submitter.  The default  is the Multics  user_id of
63   the user who submitted the request.
64 -project STR, -pj STR
65   STR specifies the project  identification used by the remote
66   host on whose behalf the delete is to be executed.
67 
68 
69 Examples:
70   The following example illustrates the procedure for deleting
71   a segment, cr_1, on a remote Multics host.
72      dl uft_dest>cr_1 -at dsa.MUL1.FILETRAN