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.