2Fh FL$OPEN open a file
Input X = address of file name (leading count byte)
Output A = if file found : record type of data records
Description

Opens a previously existing file whose name is at X.

The filename at X is a leading byte count string of the form D:Name where D is the device 'A' to 'D' (optional). The filename may be between one and eight characters in length, excluding the D:, but including any final '$' or '%'. If the device name is not specified, the current device in FLB_CPAK is assumed. Filenames may contain any of the characters 'a'..'z', 'A'..'Z', '0'..'9' and the last character may also be a '$' or '%'. The first character must be 'A' .. 'Z' or 'a' .. 'z'. Upper and lower case are treated as equivalent.

If the file does not exist the error file not found is returned.

Example To open the file "A:ALSTON"
        LDX     #FILE_NAME
        OS      FL$OPEN
        BCS     ERROR

        STAA    RECORD_TYPE
        ...

FILE_NAME:
        ASCIC   "A:ALSTON"
Errors 194 - battery too low
200 - read pack err
234 - file not found
236 - bad file name
240 - unknown pack
241 - pack not blank
243 - bad device name
245 - write pack err
246 - no pack