The key definitions of OneKey are listed in Tables 8-1 and 8-2. The remaining sections of this chapter discuss the use of these keys in detail.

GOLD is PF1 key on the keypad. The LK201 keyboard is the keyboard most commonly found on VT200 and higher series terminals.

Table 8-1 Notes Mode Key Definitions

In Notes mode (you can see the Notes> prompt):
Keystroke	Function
ENTER	Next Unseen (OneKey Reading)
F20	Next Unseen (OneKey Reading) - LK201 Keyboard
M3DOWN	Next Unseen (OneKey Reading) - VAXstation Mouse
GOLD-F10	Get Out of VAX Notes (``Fast Exit'') - LK201 Keyboard
GOLD-E	Get Out of VAX Notes (``Fast Exit'')
GOLD-D	Return to Directory Listing
GOLD-N	Re-scan Your Notebook
GOLD-O	Write Section File
GOLD-P	Print Note(s) to Attached Printer
GOLD-U	Update All Classes Immediately
GOLD-W	What Conference am I in?
GOLD-Z	Show Version of OneKey and VAX Notes
GOLD-~	Show Version of OneKey and VAX Notes
KP4	Open the NEXT Conference with Unseen Notes
KP8	Search Next
KP6	Goto OneKey Search Menu
KP9	Mark this Note
GOLD-KP4	Open PREVIOUS Conference, Display Last Note Read
GOLD-KP9	Go to Marked Note
KP6	Display OneKey Search Screen, to Search Note Titles

Table 8-2 Editor Mode Key Definitions

In editor mode (you are writing a note and cannot see the Notes> prompt):
Keystroke	Function
GOLD-F10	Get Out of VAX Notes (``Fast Exit'')
GOLD-I	DCL Command
GOLD-J	Grammar Check (if available)
GOLD-Q	Quote Selected Region (or Current Line)
GOLD-S	Spell Check (if available)
GOLD-W	Write File
GOLD-Z	Show Information about Buffers
GOLD-;	Global Replace
GOLD-$	Spawn (if available)
GOLD-@	Signature (Insert sys$login:onekey_signature.dat)
GOLD-PREV SCREEN	Top
GOLD-NEXT SCREEN	Bottom
F7	Quote (Insert next typed character without translation)
GOLD-F7	Insert Escape Character - LK201 Keyboard
F8	Capitalize Word - LK201 Keyboard
GOLD-F8	Uppercase Word - LK201 Keyboard
F17	One Window - LK201 Keyboard
F18	Two Windows - LK201 Keyboard
GOLD-F18	Get File - LK201 Keyboard
F19	Other Window (Other Buffer) - LK201 Keyboard
GOLD-F19	Buffer - LK201 Keyboard
F20	Delete to End of Line - LK201 Keyboard
GOLD-(	Insert :-( (smiling face)
GOLD-}	Insert :-} (smirking face)
GOLD-)	Insert :-) (frowning face)
CTRL/F	Return to Editing (from show, etc.)
In OneKey Search mode (while viewing a list of titles):
KP7 or SELECT	Display Note Selected By Cursor Position
KP6 or GOLD-KP6	Go to Search Directory
WPS Key extensions only:
KP9	Mark this Place in Text
GOLD-KP9	Go to Text Marker
GOLD-INSERT HERE	Paste - LK201 Keyboard
GOLD-REMOVE	Copy (Gold Cut) - LK201 Keyboard

8.2 How to Enable OneKey

OneKey is enabled for your account as follows:

1. Edit your LOGIN.COM file.
2. Insert a line: $ DEFINE NOTES$SECTION ONEKEY
   
   If you are a new subscriber, this may have been done automatically if you requested it during your first login.
3. Make sure that you do NOT have a file named NOTES$COMMAND.TPU in any of your directories.
4. OneKey will be used the next time you log in. If you wish to use it immediately, type this command at the prompt: $ DEFINE NOTES$SECTION ONEKEY
   
   The next time you type $ NOTES, you will have the OneKey interface.

The only changes made to the basic VAX Notes interface are extensions of the functions of the ENTER and keypad comma keys. All other OneKey functions are additions rather than changes to existing functions.

8.3 Modes

OneKey operates in one of two modes: Notes mode and editor mode. Notes mode is active when you are reading notes, getting directories of notes or searching notes. Editor mode is active when you are using an editor to compose a new note.

8.4 The ENTER Key

In Notes mode, the keys defined as one key reading (``1K-Note'') are the ENTER key and the F20 function key. If you're using a VAXstation, MOUSE BUTTON 3 DOWN is also defined this way.

Pressing any one of the keys defined as ``1K-Note'' does the following:

1. If you don't have a conference open, open one and show an unseen note.
2. If the note you're reading has unread lines, move down one page.
3. If you've seen all pages of the current note, show the next unseen note.
4. If there are no more unseen notes in this conference, open the next conference.
5. If there are no more conferences with unseen notes, recheck the Notebook.
6. If there's something new in one of the conferences, go read it.
7. Otherwise, ask if you want to update your Notebook.

When you see the message:

No more unseen conferences...Do you want to update all conferences? [Y])

Type Y (or the ENTER key) to perform the update;
Type N to NOT perform the update;
Type X or E or Q to exit Notes and return to DCL.

Type only one letter or the ENTER key at the update prompt. Typing a RETURN is not necessary.

All standard Notes and EVE key definitions remain present.

8.5 Exiting OneKey

OneKey makes exiting simple and fast. From almost any point (including replying to a note), you can use the fast exit. Press GOLD-F10 (the PF1 key, followed by F10). The screen is cleared, and the DCL prompt appears. You don't have to look at slowly-displayed intermediate screens. [F10 is marked ``Exit'' on most LK201 keyboards.]

If you don't have an F10 key, GOLD-E is also ``fast exit''. However, GOLD-E is only available if you have a Notes> prompt, not when you're replying or writing.

8.6 Information Keys

In Notes mode, these keys are used for information:

GOLD-W	``What conference is this?'' displays the name of the current conference entry.
GOLD-Z	displays the version of OneKey and the version of VAX Notes.
GOLD-~	same as GOLD-Z.

8.7 Directory

In Notes mode, the GOLD-D command is called ``Return to Directory''.

This command has a fairly complicated effect, but won't hurt anything. The best way to learn what the command really does is to try it.

Here is a short description:

• GOLD-D toggles between a directory listing and a note you are reading.
• When you do a Notes DIR command, you can use the Notes KP2 and KP5 keys to move through the listing, and the Notes KP7 (or E4 or SELECT) key to select a note to read. After reading the note, you may want to return to the listing to select another note. Pressing GOLD-D returns you to the directory listing.
• While viewing the directory listing, pressing GOLD-D again returns you to the last note you saw.
• If you have not yet issued a DIR command, pressing GOLD-D does it for you. If you have an open conference, the generated command is DIR. If you are viewing the top-level VAX Notes display, the generated command is DIR/CLASS=*.

OneKey provides both title search and full text search capabilities.

8.8.1 OneKey Title Search

OneKey provides a title search capability to help you locate notes on a particular subject independently of the conference in which they appear. You can search through the titles of all notes (*.*) or just the topic (*.0) notes. From the search menu, you can directly read the note(s) of interest.

Activate the OneKey title search subsystem by pressing KP6.

The search menu may seem complex at first, but actually is easier to use than it is to explain. Instructions are included within the menu.

Use the top section of the screen to control the search (words for which to search, etc.). Press any find or search key to initiate the search.

The results of the search are displayed in the bottom section of the screen. You can use the arrow keys or your editor's find capability to position the cursor to a note of interest. Then press a Notes select key (KP7, E4, or SELECT) to begin reading the note.

At any place outside of the search menu, press KP6 to return to search. Within the search menu, KP6 moves between the top and bottom sections of the screen.

To exit from the search menu without selecting a note, press F10 or CTRL/Z or GOLD-F. (GOLD-F is also known as the ALL-IN-1 ``file document'' sequence).

8.8.2 Special Notes On OneKey Title Search

1. OneKey search uses files created by a periodic batch process. On DECUServe, this process runs at 4:30 AM. Notes written after that time do not appear in the search file until the following day.
2. In the top section of the search window, you can select which file to search, and the match criterion, by using the left or right arrow keys. The options available are controlled by the site. You have the choice of searching the following:
   1. All titles (topics + replies),
   2. Only topic titles (*.0)
   Multiple search elements may be combined using AND, OR, NAND, or NOR match criteria.
3. Enter the string-to-find using the syntax for the VMS SEARCH command. That is, enter a comma separated list of quoted strings. For simple (single phrase) searches OneKey supplies quotes to handle a multi-word phrase.

While you are reading a conference in Notes mode you may wish to search all notes in that conference for a particular text string. Type any search command at the Notes prompt. For example:

Notes> search onekey

After the first occurrence is found, press KP8 to search for the next note in which the string appears.

8.9 Printing

In Notes mode, you may want to print a note (or notes) on a printer attached to your terminal. GOLD-P first asks what notes you want to print (the default is to print only the current note). The notes are automatically printed. You can print only notes from the conference you are currently reading.

8.10 Marking Notes

In Notes mode, you can mark a note for future reference. A marker is any single word or string of alphanumeric characters. KP9 is used to mark a note. You are asked two questions:

Marker Name: (enter your choide of a marker name) Note: (enter number or press Return to mark current note)

After a note is marked, the Notes command SHOW MARKERS locates all marked notes in the conference. If you remember the marker name, use GOLD-KP9 to go directly to the marked note.

The GOLD-KP9 key sequence works across conferences. That is, it might close the current conference, open another conference, and go directly to a note.

Markers are your personal notations. Other subscribers cannot see them.

8.11 Update & Refresh

In Notes mode, under some circumstances, you may want to refresh your Notes environment. You can do this at any time.

8.11.1 Update

GOLD-U performs a Notes UPDATE operation. This re-reads all of the conference files, and posts any changes to your notebook (making OneKey aware of them). For example, you are then aware of new notes posted by others since you started reading.

8.11.2 Refresh

GOLD-N instructs OneKey to rescan your Notebook. This is useful only if some external process (such as a spawned $ NOTES UPDATE command) has changed your Notebook. In that case, GOLD-N causes OneKey to become aware of the changes.

It is not necessary to use both UPDATE and REFRESH in sequence; the UPDATE command includes the equivalent of REFRESH.

8.12 Editor Mode Extensions

This section describes the OneKey extensions to key definitions in editor mode (writing replies and topics). Remember that the basic Notes system provides other helpful keys (such as KP1, KP2, KP3, KP5, KP0, KP., KP,). Remember also that there is online help. Press the HELP key, PF2, or GOLD-H to use it. Table 8-3 descibes the various OneKey extensions. Most of the extensions are also briefly described in the online help.

OneKey provides a few extensions when you are editing (that is, replying to or writing a note). The extensions are available only if you're using one of the native Notes editors (EVE, EDT, or WPS). Use of OneKey in regular Notes mode doesn't depend on your choice of editors. You may use any of the spawned or called editors you just won't have the OneKey editor mode extensions. Some of these additions extend the EDT or EVE editors to have some of the features of WPS.

Many of the editor mode extension require use of the GOLD (PF1) key. In most EVE environments, you have a GOLD key; you always have a GOLD key in EDT and WPS.

Some subscribers don't have a VT2xx or VT3xx keyboard. These subscribers cannot use the function key extensions but there are usually EVE command equivalents. To issue the command equivalent, press the DO key and type the command. The DO key is: PF4 in the EVE editor, GOLD-KP7 in EDT, and GOLD-[ in WPS.

Table 8-3 Editor Mode Extension Key Definitions

Keystroke	Function
In all Notes Editors, the following extensions are available
GOLD-I	issues one DCL command and shows the results in a buffer.
GOLD-Q	is used to quote sections of text in VAX Notes fashion. By default, the > character is used to as the quoting character. If you establish a select region (by pressing a ``select'' key and moving the cursor), the entire region is quoted. Otherwise just the current line receives the quote.
GOLD-S	activates the Spelling Checker if it is available on the system. The Spelling Checker is easy to use. Normally, you type the first initial of the option you want. If you choose the Edit option, use the DO key to continue checking spelling.
GOLD-J	activates the Grammar Checker if it is available on the system. Grammar checking includes spelling checking. The user interface is similar to the one for Spell. At the conclusion of the grammar check, use an editor exit (e.g., F10 or CTRL/Z) to return to VAX Notes. (Note: The other OneKey extensions are not carried into the spelling and grammar editors.)
GOLD-;	replaces one string with another. You are prompted for the search and replacement strings.
GOLD-$	Spawns to DCL (if permitted on the system). Type LOGOUT at the DCL prompt to return to Notes.
GOLD-@	Inserts the contents of SYS$LOGIN:ONEKEY_SIGNATURE.DAT (if it exists) into the buffer. For example, this file could contain your personal signature. Most VAX Notes systems discourage use of lengthy signatures.
Two of the mini-keypad keys on the LK201 keyboard have extended definitions:
GOLD-E5	(usually labeled PREV SCREEN) moves to top of buffer.
GOLD-E6	(usually labeled NEXT SCREEN) moves to bottom of buffer.
These function keys are provided in the OneKey editors:
GOLD-F10	``Fast Exit'', discussed previously.
F7	Quote (Insert next typed character without translation). This is used to insert special characters.
F8	Capitalize Word.
GOLD-F8	Uppercase Word.
F17	One Window. Current window expands to fill screen.
F18	Two Windows. Splits the current window into two windows.
GOLD-F18	Get File. Creates a new buffer, if necessary, and fills it with the contents of the file specified. In two-window mode, you could import a file to use in writing a note.
F19	Other Window (Other Buffer). In two-window mode, puts your cursor in the other window. Very useful for jumping to the NOTES$SCRATCH buffer to pick up material to quote.
GOLD-F19	Select Buffer. Puts a different buffer in your current window. Useful, for example, if you've messed up and can't see the Notes editing buffer. Press GOLD-F19 and type the name NOTES$EDIT or type the name NOTES$SCRATCH which contains the note to which you are replying.
F20	Delete to the end of line.
CTRL/L	Although it is technically not a OneKey extension, CTRL/L inserts a formfeed character. This is used for special effects in Notes. When the note is read by someone, any material below the formfeed is not displayed until the RETURN or ENTER key is pressed.
Some keys insert facial expressions
GOLD-)	inserts a smiling face: :-)
GOLD-(	inserts a frowning face :-(
GOLD-}	inserts a smirking face :-}
In the WPS editor only, the following keys are defined
KP9	Mark the current text location, and give it a name. You can have many named markers.
GOLD-KP9	Return to a previously named marker. Works even if the marker is in another buffer.