Library /sys$common/syshlp/LSE$CLIHELP.HLB  —  GOTO  FILE
    Moves the cursor to the buffer containing the specified file. If
    no buffer contains the specified file, LSE reads the file into a
    new buffer.

    Format

      GOTO FILE   file-spec

1  –  Qualifiers

1.1    /CREATE

       /CREATE
       /NOCREATE (D)

    Specifies whether the GOTO FILE command should succeed if the
    specified file does not exist. This qualifier has no effect if you
    are going to an existing buffer.

1.2    /MODIFY

       /MODIFY
       /NOMODIFY

    Specifies whether the buffer you create is modifiable or
    unmodifiable. If you specify the /MODIFY qualifier, the GOTO
    FILE command creates a modifiable buffer. If you specify the
    /NOMODIFY qualifier, the GOTO FILE command creates an unmodifiable
    buffer. If you do not specify either qualifier, LSE determines the
    buffer's modifiable status from the read-only/write setting. By
    default, a read-only buffer is unmodifiable and a write buffer is
    modifiable.

1.3    /NEW

    Specifies that you want to create a new file. If the specified
    file already exists, LSE reports an error and aborts the command.
    The file-spec parameter may not contain wildcards if you specify
    this qualifier. You cannot use this qualifier with the /[NO]CREATE
    or /[NO]MODIFY qualifiers.

1.4    /READ_ONLY

       /READ_ONLY
       /NOREAD_ONLY

    Specifies whether or not the buffer you create is read-only and
    therefore unmodifiable. This qualifier and the /WRITE qualifier
    override any setting established by the SET DIRECTORY command. The
    /WRITE qualifier is equivalent to the /NOREAD_ONLY qualifier.

    If you specify neither the /READ_ONLY nor the /WRITE qualifier,
    LSE uses the default established by the most recent SET DIRECTORY
    command for the directory that contains the file. If during your
    current editing session you have not issued a SET DIRECTORY
    command nor defined the logical LSE$READ_ONLY_DIRECTORY, then
    the buffer is writeable by default.

1.5    /WRITE

       /WRITE
       /NOWRITE

    Specifies whether or not the buffer you create is writeable and
    therefore modifiable. This qualifier and the /READ_ONLY qualifier
    override any setting established by the SET DIRECTORY command. The
    /NOREAD_ONLY qualifier is equivalent to the /WRITE qualifier.

    If you specify neither the /WRITE nor the /READ_ONLY qualifier,
    LSE uses the default established by the most recent SET DIRECTORY
    command for the directory that contains the file. If during your
    current editing session you have not issued a SET DIRECTORY
    command nor defined the logical LSE$READ_ONLY_DIRECTORY, then
    the buffer is writeable by default.

2  –  Parameter

 file-spec
    Specifies the name of the file to be edited. LSE uses the
    directories specified in the SET SOURCE_DIRECTORY command to
    resolve the file specification. If the file cannot be found in
    one of those directories (or the list of directories is empty)
    and you used the /CREATE qualifier, LSE creates the file in your
    default directory.
Close Help