LSE$CLIHELP.HLB  —  GOTO
    Moves the cursor to the item specified by the option word.

    Format

      GOTO   option

1  –  BOTTOM

    Moves the cursor to the bottom of the current buffer.

    Format

      GOTO BOTTOM

2  –  BUFFER

    Moves the cursor to the specified buffer.

    Format

      GOTO BUFFER   buffer-name

2.1  –  Qualifiers

2.1.1    /CREATE

       /CREATE
       /NOCREATE (D)

    Specifies whether or not the buffer should be created if it does
    not exist.

2.1.2    /READ_ONLY

       /READ_ONLY (D)
       /NOREAD_ONLY

    Specifies whether or not the indicated buffer should have the
    read-only attribute. If the buffer has this attribute, then LSE
    does not write the contents to a file when you exit from LSE or
    when you issue a COMPILE command. This qualifier has an effect
    only if the GOTO BUFFER command is creating a buffer. If you are
    going to an already existing buffer, the read-write status of that
    buffer is not changed. The /WRITE qualifier is equivalent to the
    /NOREAD_ONLY qualifier.

2.1.3    /WRITE

       /WRITE
       /NOWRITE (D)

    Specifies whether or not the indicated buffer should have the
    write attribute. If the buffer has this attribute, then LSE writes
    the contents of the buffer to a file when you exit from LSE or
    when you issue a COMPILE command. This qualifier has an effect
    only if the GOTO BUFFER command is creating a buffer. If you are
    going to an already existing buffer, the read-write status of the
    buffer is not changed. The /NOREAD_ONLY qualifier is equivalent to
    the /WRITE qualifier.

2.2  –  Parameter

 buffer-name
    Specifies the name of the buffer. You may use abbreviations.

    You can specify a buffer name with a character string value of up
    to 255 alphanumeric or special characters. If you begin the buffer
    name with special characters, such as those accessed on the top
    row of your keyboard by pressing the shift key, you must enclose
    the buffer name in quotation marks. Similarly, to specify a name
    that contains embedded blanks (spaces), or quotation marks and
    spaces, enclose the entire string in quotation marks.

3  –  CHARACTER

    Moves the cursor to the next character.

    Format

      GOTO CHARACTER

3.1  –  Qualifiers

3.1.1    /CURRENT

       /CURRENT (D)

    Instructs LSE to use the current direction of the buffer.

3.1.2    /FORWARD

    Instructs LSE to move the cursor down or to the right.

3.1.3    /HORIZONTALLY

       /HORIZONTALLY (D)

    Instructs LSE to move the cursor horizontally.

3.1.4    /REVERSE

    Instructs LSE to move the cursor up or to the left.

3.1.5    /VERTICALLY

    Instructs LSE to move the cursor vertically.

4  –  COMMAND

    Produces the LSE Command> prompt at which you can enter LSE or SCA
    commands.

    Format

      GOTO COMMAND

5  –  DECLARATION

    [SCA Required] Displays the declaration of the symbol indicated.
    LSE displays the source code containing the symbol declaration in
    another window and positions the cursor on the symbol declaration.

    Format

      GOTO DECLARATION   [symbol-name]

5.1  –  Qualifiers

5.1.1    /ASSOCIATED

    Indicates that you want to see the associated declaration for
    the symbol. An associated declaration is a related declaration
    that accompanies the primary declaration (such as an EXTERNAL
    declaration).

5.1.2    /CONTEXT_DEPENDENT

    If you specify both the /CONTEXT_DEPENDENT and the /INDICATED
    qualifiers, then SCA determines which declaration to display by
    using the following criteria:

    o  If the indicated occurrence of the symbol is a reference, LSE
       displays the declaration specified by the compiler as bound to
       that occurrence of the symbol.

    o  If the indicated occurrence of the symbol is an associated
       declaration, LSE displays the primary declaration.

    o  If the indicated occurrence of the symbol is a primary
       declaration, LSE displays the associated declaration.

    You cannot use the /CONTEXT_DEPENDENT qualifier without the
    /INDICATED qualifier.

5.1.3    /INDICATED

    Instructs LSE to use the symbol name at the current cursor
    position, or the text within the currently active selected
    range, as the symbol name. To help SCA identify exactly which
    occurrence of the symbol name the cursor is positioned on, LSE
    passes both the current cursor position in the buffer and the file
    specification for the current buffer to SCA.

    If SCA has no information for the symbol name at the current
    cursor position (for example, if the line containing the symbol is
    a new line and the file has not been recompiled), then SCA uses
    whatever general information it has about that symbol as if you
    issued a GOTO DECLARATION command for the symbol name without the
    /INDICATED qualifier.

    If you specify the /INDICATED qualifier, you must not specify the
    symbol-name parameter.

    You cannot use the /INDICATED qualifier without the /CONTEXT_
    DEPENDENT qualifier.

5.1.4    /PRIMARY

       /PRIMARY (D)

    Indicates that you want to see the primary declaration for
    the symbol. A primary declaration is the declaration that SCA
    interprets as most significant for a symbol (such as a FUNCTION
    declaration). For example, the primary declaration of a routine
    describes the body of the routine.

5.2  –  Parameter

 symbol-name
    Specifies that the declaration associated with the named symbol is
    to be displayed. You must not specify a symbol name if you specify
    the /INDICATED qualifier.

6  –  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

6.1  –  Qualifiers

6.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.

6.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.

6.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.

6.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.

6.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.

6.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.

7  –  LINE

    Moves the cursor to the end of the line, or the next line if the
    cursor is already at the end of a line.

    Format

      GOTO LINE

7.1  –  Qualifiers

7.1.1    /BEGINNING

       /BEGINNING (D)

    Indicates that the cursor should be moved to the beginning of
    the line. The /BEGINNING, /BREAK, /BOUND, and /END qualifiers are
    mutually exclusive.

7.1.2    /BOUND

    Moves the cursor to the beginning or the end of the current
    line depending on whether the direction specified is FORWARD or
    REVERSE. If the cursor is already at the specified destination,
    LSE issues a message to that effect and the cursor does not move.
    The /BEGINNING, /BREAK, /BOUND, and /END qualifiers are mutually
    exclusive.

7.1.3    /BREAK

    Moves the cursor either to the beginning or end of a line
    depending on whether the direction currently specified is FORWARD
    or REVERSE. If the cursor is already at the specified destination,
    LSE moves it to the corresponding break on the next line in
    the current direction. The /BEGINNING, /BREAK, /BOUND, and /END
    qualifiers are mutually exclusive.

7.1.4    /CURRENT

       /CURRENT (D)

    Instructs LSE to use the current direction of the buffer.

7.1.5    /END

    Indicates that the cursor should be moved to the end of the line.
    The /BEGINNING, /BREAK, /BOUND, and /END qualifiers are mutually
    exclusive.

7.1.6    /FORWARD

    Instructs LSE to move the cursor down or to the right.

7.1.7    /REVERSE

    Instructs LSE to move the cursor up or to the left.

8  –  MARK

    Moves the cursor to a marker name defined by a SET MARK command.

    Format

      GOTO MARK   marker-name

8.1  –  Parameter

 marker-name
    Specifies the name of a marker created with a SET MARK command.

9  –  PAGE

    Moves the cursor to the next page where a page boundary is a form
    feed or the beginning or end of a buffer.

    Format

      GOTO PAGE

9.1  –  Qualifiers

9.1.1    /CURRENT

       /CURRENT (D)

    Instructs LSE to use the current direction of the buffer.

9.1.2    /FORWARD

    Instructs LSE to move the cursor down.

9.1.3    /REVERSE

    Instructs LSE to move the cursor up.

10  –  PLACEHOLDER

    Moves the cursor to a placeholder.

    Format

      GOTO PLACEHOLDER

10.1  –  Qualifiers

10.1.1    /ALL

       /ALL (D)

    Instructs the GOTO PLACEHOLDER command to recognize all
    placeholders, including pseudocode placeholders and overview
    records.

10.1.2    /CURRENT

       /CURRENT (D)

    Instructs LSE to use the current direction of the buffer.

10.1.3    /FORWARD

    Instructs LSE to move the cursor down or to the right.

10.1.4    /NOPSEUDOCODE

    Instructs the GOTO PLACEHOLDER command to ignore pseudocode
    placeholders.

10.1.5    /REVERSE

    Instructs LSE to move the cursor up or to the left.

11  –  QUERY

    [SCA Command] Moves the cursor to the specified SCA query session.

    Format

      GOTO QUERY   [query-name]

11.1  –  Parameter

 query-name
    Specifies the name of the query session.

12  –  REVIEW

    Moves the cursor to the currently active review session.

    Format

      GOTO REVIEW

13  –  SCREEN

    Moves the cursor in the indicated direction two lines less than
    the number of lines in the current window.

    Format

      GOTO SCREEN

13.1  –  Qualifiers

13.1.1    /CURRENT

       /CURRENT (D)

    Instructs LSE to use the current direction of the buffer.

13.1.2    /FORWARD

    Instructs LSE to move the cursor down.

13.1.3    /REVERSE

    Instructs LSE to move the cursor up.

14  –  SOURCE

    Displays the source corresponding to the current diagnostic or
    query item. To display a query item, you must be using SCA.

    Format

      GOTO SOURCE

14.1  –  Qualifiers

14.1.1    /READ_ONLY

    Specifies that the buffer containing the source be set read-only
    and therefore unmodifiable. Using this qualifier overrides any
    setting established by the SET DIRECTORY command.

14.1.2    /WRITE

    Specifies that the buffer containing the source be set writeable
    and therefore modifiable. Using this qualifier overrides any
    setting established by the SET DIRECTORY command.

15  –  TOP

    Moves the cursor to the top of the current buffer.

    Format

      GOTO TOP

16  –  WORD

    Moves the cursor to the beginning of the current, next, or
    previous word in the current buffer, depending on the direction
    specified.

    Format

      GOTO WORD

16.1  –  Qualifiers

16.1.1    /CURRENT

       /CURRENT (D)

    Instructs LSE to use the current direction of the buffer.

16.1.2    /FORWARD

    Instructs LSE to move the cursor down or to the right.

16.1.3    /REVERSE

    Instructs LSE to move the cursor up or to the left.
Close Help