SOS Main Commands

The Main Commands Screen

The Main Commands screen in SOS contains a list of single-key shortcut commands that can be entered from any SOS display screen.

To access the Main Commands screen from any SOS display screen, type ? at the command prompt.

Figure 5.1 SOS Main Commands screen

To return to the SOS program from the Main Commands screen, press the Esc key.

To invoke a specific command displayed on the Main Commands screen, type the corresponding command key(s) from any SOS display screen.

NOTE All command keys are case-sensitive.

Main Commands

Each of the SOS commands is listed and explained in the following tables.

Navigation Keys

Table 5.1 SOS navigation command keys


Key	Command	Description
g	Go to screen	Type g from any SOS display screen to go to another screen of your choice. At the secondary command prompt, enter the screen option code or press the ? key for a list of valid options. For instance, type c to display the CPU Summary screen.
s	Screen menu	Type s from any SOS display screen to view the Screen Selection Menu.

Detail Screen Quick Keys

Table 5.2 SOS Detail screen command keys


Key	Command	Description
P	Process detail	Type P (upper case) from any SOS display screen to view the Process Detail screen for a specific process. At the secondary command prompt, specify the process’s identification number (shown in the PID column of the PROCESS SUMMARY section in the Global Summary screen) or press the Enter key to accept the default (shown in brackets).
F	Process file usage	Type F (upper case) from any SOS display screen to view the Process File Usage screen for a specific process. At the secondary command prompt, specify the process’s identification number (shown in the PID column of the PROCESS SUMMARY section in the Global Summary screen) or press the Enter key to accept the default (shown in brackets).
M	Process memory usage	Type M (upper case) from any SOS display screen to view the Process Memory Regions screen for a specific process. Select the specific process at the secondary prompt.
W	Workload detail	Type W (upper case) from any SOS display screen to view the Workload Detail screen. Select the workload from the choices displayed in the dialog box (for example, INTERACT, BATCH, SYS, or DEFAULT).
V	Volume group detail	Type V (upper case) from any SOS display screen to view the Volume Detail screen for a specific volume. Select the volume from the choices displayed in the dialog box.
D	Disk detail	Type D (upper case) from any SOS display screen to view the Disk I/O Detail screen for a specified disk device. Select the physical disk ID from the choices displayed in the dialog box.
Z	Hog process zoom	Type Z (upper case) from any SOS display screen to view the "hog" process (the process that consumes the most CPU during the current interval) in the Process Detail screen.

Action Keys

Table 5.3 SOS action command keys


Key	Command	Description
u	Update interval data	Type u from any SOS display screen to start a new screen refresh and sample interval and update all performance indicator values. For an example, see "Updating Interval Data".
r	Reset totals to zero	Type r from any SOS display screen to (1) reset all cumulative values (shown in brackets), (2) reset the elapsed time to zero, and (3) update the interval data. For an example, see "Resetting Cumulative Statistics".
p	Print screen	Type p from any SOS display screen to send the current screen display to a specified printer or a default printer, or to print the screen display to a specified file.
f	Toggle update intervals on/off	Type f from any SOS display screen to postpone (freeze) data updates for all SOS screens until the f key is pressed again (to un-freeze).
R	Add a new Oracle instance	Type R (upper case) from any screen to add a new Oracle instance. SOS will prompt for instance name (a connect string). Enter a net service name (listed in tsnames.ora) or a full connect string in the form host:port:SID (oracle's listener port is usually 1521). If no instance name is entered, the default database instance on the local machine will be used. Next, SOS will prompt for a user name. This user should have select rights on v$ performance views, ts$, and file$. The user must also have rights to create, select, delete, and insert tables (for SOS temporary data). Finally, SOS will ask for the user's password. If more than one instance is configured, SOS will prompt you to select an instance each time you go to an oracle detail screen.
T	Delete an Oracle instance	Type T (upper case) to delete an Oracle instance.

Configuration Keys

Table 5.4 SOS configuration command keys


Key	Command	Description
o	Main option menu	Type o from any SOS display screen to display the SOS Main Option Menu.

Other Keys

Table 5.5 SOS (other) command keys


Key(s)	Command	Description
H	Main on-line help	Type H (upper case) from any SOS display screen to display the main online help facility for SOS. Follow the instructions provided on the Welcome to the SOS/9000 Help Facility screen to navigate throughout the help system.
h	Context-sensitive on-line help	Type h (lower case) from any SOS display screen to display the context-sensitive online help for the current screen or menu.
o	Main option menu	Type o from any SOS display screen to display the SOS Main Option Menu.
?	Command help	Type ? (a question mark) from any SOS display screen to display a list of main command keys in the Main Commands screen.
!	UNIX shell	Suspends execution of SOS and executes a UNIX shell. To return to the SOS application, type exit.
Ctrl+l	Refresh screen	Press the Ctrl+l shortcut keys from any SOS display screen to refresh the screen.
e	Exit program	Type e from any SOS display screen to exit the SOS program.

Screen-Specific Commands

A second screen of commands, the Additional Commands screen, can be viewed by pressing any key from the Main Commands screen when additional commands are available for the active SOS display screen.

Figure 5.2 SOS Additional Commands screen (example)

To return to the Main Commands screen from the Additional Commands screen, press any key. To return to the SOS program, press the Esc key.

To invoke a specific command displayed on the Additional Commands screen, type the corresponding command key(s) from any SOS display screen.

Screen-Specific Navigation Commands

Table 5.6 SOS screen-specific navigation command keys


Key(s)	Command	Description
-	Move up in scrollable area	Type the hyphen character (-) from any SOS display screen to scroll back to the previous line in the screen display, if additional lines are available. The Up Arrow key can be used on terminals that support navigation keyboard keys.
+	Move down in scrollable area	Type the plus character (+) from any SOS display screen to scroll to the next line in the screen display, if additional lines are available. The Down Arrow key can be used on terminals that support navigation keyboard keys.
Ctrl+b	Page up in scrollable area	Press the Ctrl+b shortcut keys from any SOS display screen to scroll back through the screen display one "page" at a time, when pages are available. The Page Up key can be used on terminals that support navigation keyboard keys.
Ctrl+f	Page down in scrollable area	Press the Ctrl+f shortcut keys from any SOS display screen to scroll ahead in the screen display one "page" at a time when pages are available. The Page Down key can be used on terminals that support navigation keyboard keys.

Screen-Specific Action Commands

Table 5.7 SOS screen-specific action command keys


Key	Command	Description
t	Toggle graphic/tabular display	Type t from most SOS display screens to display screen information in either a graphical or tabular format (if the alternative format is available).
y	Toggle extended process display	Type y from the Global or the Workload Detail screen to turn the Extended Process line display on or off.
n	Select new...	Type n from the Process Detail screen to select a new process. Type n from the Workload Detail screen to select a new workgroup. Type n from the Disk Detail screen to select a new disk. Type n from the Volume Detail screen to select a new volume.