Search Top Index
HELP SYSCREATE Steven Hardy, March 1982 syscreate(<file>, <access mode>, <organization>) -> device or false; This procedure creates a disc file and returns a device record for the file. The <filename> should be a string. The permissible access modes are: 0 - Read only 1 - Write only 2 - Read and Write Permissible values for <organization> are (a) FALSE: For disk files and pipes, this value will optimise the device for single character input or output, otherwise there is no difference between <false> and <true>. For terminals this gives normal interactive line mode (i.e. only whole lines can be read). (b) The word "line" (or "record"): For all kinds of device, this value will mean that *SYSREAD will read from the device only up to the next newline character. (c) TRUE: implies that the file is block-oriented; the precise meaning of this varies from device to device. For a terminal it means that all characters will be treated as break characters and that no echoing will be done. This is the organization used by VED. The device is initially set up for 'rare' mode (i.e. cbreak, -echo, -nl, -tabs) and no prompt is output for read operations. Essentially then, use <false> for character stream I/O on text files, "line" for line input on text files, and <true> for block I/O on disk files or pipes and rare or raw mode on terminals. If for any reason the file cannot be created, SYSCREATE returns FALSE. For more information on Input/Output procedures see REF *SYSIO. See also HELP *SYSOPEN - returns a device record for an existing disc file *SYSCLOSE - closes the device which is its argument *SYSDELETE - deletes a specified disc file *SYSREAD - reads from a specified device *SYSWRITE - writes to a specified device