1 10/07/88 create, cr
  2 
  3 Syntax as a command:
  4 cr arguments {-control_args}
  5 
  6 
  7 Function:
  8 The  create request  lets you  create a file  on a remote host
  9 and  set the appropriate file attributes.   The create request
 10 is a file management convenience tool.
 11 
 12 
 13 Arguments:
 14 file
 15   is  the  name of  the file  you  want to create.  It must be
 16   specified  in a  syntax acceptable to  the host on which the
 17   file is to reside.  file must be preceded by "-name" ("-nm")
 18   if the file name begins with a "-".  It must be followed  by
 19   "-at CORRESPONDENT" where CORRESPONDENT  is a  correspondent
 20   name given  in  the  NIT (Network Information Table)  to the
 21   remote UFT  application.    It must be enclosed in quotes if
 22   it contains spaces or special characters.
 23 
 24 
 25 Control arguments:
 26 -at CORRESPONDENT
 27   CORRESPONDENT  must be  the  name given  in the NIT (Network
 28   Information Table) to the remote UFT application.    The NIT
 29   associates  to  the  UFT correspondent name  its DSA network
 30   address (session_id and mailbox).
 31 -billing STR
 32   specifies the  accounting identification used by  the remote
 33   host (not Multics); there is no default.
 34 
 35 
 36 -catalogue <file_name>, -cat <file_name>
 37   for a non-Multics system,  <file_name> specifies a catalogue
 38   file.  The -catalogue control argument is required only when
 39   the  catalogue   file  for  the  file   description  is  not
 40   implicitly known.  <file_name> must be specified in a syntax
 41   acceptable to  the host on  which the file  will resides; it
 42   must be enclosed  in quotes if it contain  spaces or special
 43   characters.
 44 -control_interval_format STR, -cif STR
 45   STR  specifies  the  control  interval  format.  The control
 46   interval      format      can      be     blocked_unspanned,
 47   unblocked_unspanned, blocked_spanned,  or unblocked_spanned.
 48   For Multics, there is no control interval format.
 49 
 50 
 51 -control_interval_size N, -cis N
 52   indicates the control interval size to be used.  The maximum
 53   control interval size is 65535.
 54 -data_type <data_type>, -dt <data_type>
 55   <data_type> can be either ascii, binary, ebcdic, gbcd, hbcd,
 56   jis or undefined.  It specifies the data code of the data to
 57   be contained in the file.  The default is "undefined".
 58 -file_format STR, -ff STR
 59   STR  specifies the  specific format  of the  file.  The file
 60   format    can     be    disk_ufas_6_66,    disk_36_bit_ufas,
 61   disk_64_ufas, disk_68,  disk_66_gfrc, disk_64_bfas, disk_62,
 62   disk_6_no_ufas,       disk_ibm_no_vsdm,       disk_ibm_vsam,
 63   tape_ufas_ans_ascii,     tape_ufas_ebcdic,     tape_66_gfrc,
 64   tape_foreign,     diskette_basic_iso,    diskette_basic_ibm,
 65   cassette_standard_iso, or cassette_foreign.
 66 
 67 
 68 -format_version N, -fv N
 69   N specifies  the specific version  of the file  format.  The
 70   format version can  be 0, 1, or 3.  The  format version is 1
 71   or 3 for tape_ufas_ans_ascii (the  default is 1).  For other
 72   formats, the default value is correct.
 73 -max_record_length N, -mrl N
 74   specifies  the maximum  record length   for the  file to  be
 75   created.  The maximum record length that can be specified is
 76   65535.
 77 -no_password, -npw
 78   if  the -no_password  control argument  is present  the user
 79   will  not  be  prompted  for  a  password  with a mask.  The
 80   password will not be used by the remote host to authenticate
 81   the submitter.
 82 
 83 
 84 -options <options>, -opt <options> -status <options>,
 85 -st <options>
 86   <options> can be either keep, new, or replace.  The -options
 87   control argument  indicates what should be done  if the file
 88   to be created  already exists.  If "new" then  an error will
 89   be  returned  (default);  if  "keep  or  truncate (tc)", the
 90   existing  file  will  be  kept  but  the  creation  will  be
 91   considered successful; if "replace  (rp)", then the existing
 92   file will be deleted and a new file created as specified.
 93 
 94 
 95 -organization <file_organization>, -org <file_organization>
 96   <file_organization>  can be  sequential, relative,  indexed,
 97   extended_indexed,  general_indexed,  random,  queued, l6_r2,
 98   l6_r5, byte_stream, or unstructured.   It specifies the file
 99   organization  of the file  to be created.   Multics supports
100   unstructured, sequential, relative, and general_indexed file
101   organizations.  The default is sequential.
102 -password, -pw
103   if the  -password control argument is present  the user will
104   be prompted for a password with a mask.  The password may be
105   used by the remote host  to authenticate the submitter.  For
106   a remote  Multics system, the -password  control argument is
107   mandatory.  (Default)
108 
109 
110 -person STR, -user STR
111   STR  specifies the  remote user  identification used  by the
112   remote host  on whose behalf  the delete is  to be executed.
113   This may  be used by  the remote host  for authentication of
114   the job  submitter.  The default  is the Multics  user_id of
115   the user who submitted the request.
116 -project STR, -pj STR
117   STR specifies the project  identification used by the remote
118   host on whose behalf the delete is to be executed.
119 -record_format STR, -rf STR
120   STR  is the  record format  to be  used for  the file.   The
121   format can  be fixed, variable, or  undefined.  For Multics,
122   the record format is always variable.
123 
124 
125 Examples:
126   The  following example illustrates  the procedure for  creating a
127   segment, cr_1, on a remote Multics host.
128      cr uft_dest>cr_1 -at dsa.MUL1.FILETRAN
129