OS/2 Professional/OS2PRO194.ISO/os2/sysutils/snapdump/snpnl001.hlp

OS/2 Help File | 1994-02-04 | 18.8 KB | 562 lines

ΓòÉΓòÉΓòÉ 1. Help for Exit Box ΓòÉΓòÉΓòÉ

Select Yes to exit the program.  Exiting this program may result in loss of
data.

Select No to continue running the program.


ΓòÉΓòÉΓòÉ 2. Help for Help Menu ΓòÉΓòÉΓòÉ

Select the Help Menu for information on how to use the help facilties, the
types of help available, and the function of certain keyboard keys in help
mode.

 Help for help
     Select Help for help for detailed information on the kinds of help
     available and how to use the help facilities.

 Extended help
     Select Extended help for detailed help on a specific option in your
     current application.

 Keys help
     Select Keys help information on the keyboard keys used to  perform
     operations in help mode.  When this item is selected, a list of key
     groups will be displayed.  Below each key group, the keys applicable to
     that  group and a brief description of each key in the group will be
     listed.

 Help index
     Select Help index to display the help index for the current application.
     This index contains a list of help topics available for selection.  Double
     click on a topic to view the help for that particular area.

 About
     Select About to display copyright information. Select OK in the About Box
     when you have finished viewing the information and wish to return to the
     application.


ΓòÉΓòÉΓòÉ 2.1. Help for Help ΓòÉΓòÉΓòÉ

Select Help for Help on the Help pull-down for detailed information on how to
use help and the types of help available to you.

In addition to providing general information about using help, Help for Help
provides specific information and examples concerning the types of help
available.  For example, information concerning Extended Help, the Help Index,
and Keys Help  is provided.


ΓòÉΓòÉΓòÉ 2.2. Help for Extended Help ΓòÉΓòÉΓòÉ

Select Extended help on the Help pull-down for detailed help on your current
application.


ΓòÉΓòÉΓòÉ 2.3. Help for Keys Help ΓòÉΓòÉΓòÉ

Select Keys help on the Help pull-down for help on the keyboard  keys used to
perform a specific task within Help.

When this item is selected, a list of key groups will be displayed.  Below each
group, the keys applicable to that group and a brief description of each key in
the group will be displayed.

Hit the Esc key to return from Keys help to the current application.


ΓòÉΓòÉΓòÉ 2.4. Help for Help Index ΓòÉΓòÉΓòÉ

Select Help index to view the help index for your current application. This
index contains a list of help topics available for selection.

Double click on a topic to view the help for that particular topic.


ΓòÉΓòÉΓòÉ 2.5. Help for About ΓòÉΓòÉΓòÉ

Select About to display copyright information.

Select OK  in the About Box  when have finished viewing the information and
wish to return to the current application.


ΓòÉΓòÉΓòÉ 3. Help for File Menu ΓòÉΓòÉΓòÉ

Select the File menu choice to provide a menu of file-related activities that
can be performed within the current application.

If you are using a mouse, single click on the sub-menu choice that you wish to
perform.  If you are using a keyboard, press the Up Arrow or Down Arrow keys to
select your choice, and press Enter to perform that choice.


ΓòÉΓòÉΓòÉ 3.1. Help for Open ΓòÉΓòÉΓòÉ

Select Open menu choice to open an existing file for use within the current
application.

When you select Open, the Open Dialog appears.

You may use the Open Dialog to select the file you want to work with.

You may select the file you wish to open in one of several ways. First, you may
click on the file (highlight it) and then press the Open button at the bottom
of the dialog.

You may also open the file of your choice by double clicking on the file name
in the file list.

If the file you wish to open is not in the current directory you can change the
file search directory by either entering a directory in the DIRECTORY IS: field
or by clicking on the directory or disk in the DIRECTORY: list box.

You may cancel the Open request by selecting the Cancel button at the bottom of
the Open dialog.


ΓòÉΓòÉΓòÉ 3.2. Help for Exit ΓòÉΓòÉΓòÉ

Select Exit on the File pull-down or press F3 to exit the current application.

The data you examine in many SnapDump/2 applications (such as dump data, error
data, and message data) might be updated or replaced by other applications
running in a multitasking environment.  The data you are currently working with
might not be available if you exit the current application without saving it.
Therefore, you are prompted with the "Are you sure you want to exit?" prompt
when you select Exit.

At this point, you will be given the option to return to the application
without exiting in order to save the currently viewed data.


ΓòÉΓòÉΓòÉ 4. Help for Options Menu ΓòÉΓòÉΓòÉ

Select the Options menu choice to display a sub-menu of Options available to
you in the current application.

If you are using a mouse, single click on the sub-menu choice that you wish to
perform.  If you are using a keyboard, press the Up Arrow or Down Arrow keys to
select your choice, and press Enter to perform that choice.


ΓòÉΓòÉΓòÉ 5. Extended Help ΓòÉΓòÉΓòÉ

Help is available any time you press the F1  key from anywhere within the
program.  Help is context sensitive. The information displayed will depend on
where in the program F1 was pressed.

Press Esc at any time to return to the previous help window. If there are no
other help windows, Esc will return you to the application.

Select Help for Help on the Help pull-down for detailed information on how to
use help and the types of help available.


ΓòÉΓòÉΓòÉ 6. Help for Key Assignments ΓòÉΓòÉΓòÉ

ACCELERATOR KEYS

The list of keys is arranged into groups of related keys.

HELP KEYS

 F1
      Invoke Help

 F2
      Invoke extended Help (from within a help window)

 Alt+F4
      End Help

 F9
      Display a list of Help keys and their functions (from within a help
      window)

 F11
      Display the Help index for the application (from within a help window)

 Esc
      Return to the previous Help panel, or end Help if at outer most panel

 Alt+F6
      Toggle between Help and the application

 Shift+F10
      Invoke Help for Help

 SYSTEM KEYS

 Alt+F6
      Switch to the next windowed program

 Alt+Esc
      Switch to the next program, including full-screen programs

 Ctrl+Esc
      Switch to the Task List

 WINDOW KEYS

 F3
      Close the window

 F10
      Toggle between the action bar and the application

 Arrow keys
      Move among choices

 End
      Go to the last choice in a pull-down

 Esc
      Cancel a pull-down or the system menu

 Home
      Go to the first choice in a pull-down

 PgUp
      Scroll the contents of the window up one page

 PgDn
      Scroll the contents of the window down one page

 Underlined letter
      Move among the choices on the action bar and pull-downs

 Alt+F4
      Close the window

 Alt+F5
      Restore the window

 Alt+F7
      Move the window

 Alt+F8
      Size the window

 Alt+F9
      Minimize the window

 Alt+F10
      Maximize the window

 Shift+Esc or Alt+Spacebar
      Toggle between the system menu and the application

 Shift+Esc or Alt
      Toggle between the system menu and the text window


ΓòÉΓòÉΓòÉ 6.1. Help for Dump Append Selection ΓòÉΓòÉΓòÉ

This prompted entry field contains a list of Dump Append Titles of the dumps
contained within the currently selected dump file. If the dump file has not
been appended to, this entry field will contain only a single entry.

For IBM system software, default dump titles are of the form 'XXXmmmmm
nnnnnnnn', where:

 o 'XXXmmmmm' is the Problem Identifier, which is used to correlate this dump
   with other incident data collected by SnapDump/2.

 o 'nnnnnnnn' is the hexadecimal representation of the Software Probe
   Identifier

 Use the Up Arrow and Down Arrow keys to scroll through the list of Dump Append
 Titles. You may use the F4 key or click on the Drop Button of the prompted
 entry field to display the drop down list box.

 To select an entry, Hit Enter in either the entry field or list box once the
 desired entry has been highlighted with the arrow keys.

 To select an entry with the mouse, click on the entry in the list box and then
 double-click on the entry field to verify the selection.


ΓòÉΓòÉΓòÉ 6.2. Help for Dump Entry Selection ΓòÉΓòÉΓòÉ

This prompted entry field contains a list of Dump Entry Titles within the
currently selected Dump Append that may be viewed in the Dump Data Display
Window.

Use the Up Arrow and Down Arrow keys to scroll through the list of Dump Append
Titles. You may use the F4 key or click on the Drop Button of the prompted
entry field to display the drop down list box.

To select an entry, Hit Enter in either the entry field or list box once the
desired entry has been highlighted with the arrow keys.

To select an entry with the mouse, click on the entry in the list box and then
double-click on the entry field to verify the selection.


ΓòÉΓòÉΓòÉ 6.3. Help for the Dump Data Display Window ΓòÉΓòÉΓòÉ

The Dump Data Display Window contains a formatted display of the currently
selected Dump Entry within the currently selected Dump Append.  The formatting
applied to the data depends on the data type.  Hexadecimal display is the
standard type of dump data formatting.

The Dump Data Display Window functions much like the SYSTEM EDITOR, except that
you are not allowed to alter the displayed data. You may copy selected data to
the CLIPBOARD in order to PASTE it into another application.  Refer to
documentation for the SYSTEM EDITOR for more details.


ΓòÉΓòÉΓòÉ 6.4. Help for Help Button ΓòÉΓòÉΓòÉ

Help is available any time you press the Help button. Because this is context
sensitive help, the help information that is displayed depends on where in the
program the Help button  was pressed.  To get help for a specific field or list
box, tab into or select that field and hit either F1  or the Help  button.

Press Esc at any time to view the previous help window or to return to the main
window if there are no other help windows.

Remember that selecting the F1 key is equivalent to pressing the Help button.


ΓòÉΓòÉΓòÉ 6.5. Help for Cancel Button ΓòÉΓòÉΓòÉ

If you do not wish to save the information you have entered, select the Cancel
button to exit.  You are asked if you really want to exit without saving
because this information is necessary.


ΓòÉΓòÉΓòÉ 6.6. Help for Ok Button ΓòÉΓòÉΓòÉ

When you have completed entering all the requested information about your
computer, select OK button to save this information and exit.


ΓòÉΓòÉΓòÉ 6.7. Help for Reset Button ΓòÉΓòÉΓòÉ

Select the Reset button

If you do not wish to save the information you have entered and want to start
over with the default values, select the Reset button. The Reset button will
erase the values you have entered, and replace them with the default values.


ΓòÉΓòÉΓòÉ 7. Help for Configuration Menu ΓòÉΓòÉΓòÉ

Select the Configuration menu to view or edit the SnapDump/2 configuration
parameters. You can change default path names, default filenames, types of
services performed, and other program parameters.


ΓòÉΓòÉΓòÉ 7.1. Help for File Name Entry Field ΓòÉΓòÉΓòÉ

The File Name entry in the Open dialog should contain the name of the file you
would like to work with.

If you don't specify a specific file name, the default File Name  entry, "*.*",
will remain in the field.  "*.*" searches the specified path for all relevant
files and lists those files in the Files  list box.  Clicking on a file name in
the Files  list box will cause that file name to be displayed in the File Name
entry field.

When a file is specified in the File Name  entry field, you can open that file
by either hitting the Open  button at the bottom of the Open dialog or by
double clicking on the file name in the Files  list box.


ΓòÉΓòÉΓòÉ 7.2. Help for Directory Is Entry Field ΓòÉΓòÉΓòÉ

The Directory is text field reflects the drive and path specified in the Open
dialog. The Directory is text field reflects changes specified in the
Directories list box.

You can highlight the Directory is text field but you aren't allowed to edit
this field. The sole purpose of this text field is to display your drive and
directory choices, and to allow you to scroll long directory path names.


ΓòÉΓòÉΓòÉ 7.3. Help for Files List Box ΓòÉΓòÉΓòÉ

The Files list box contains any releveant files found in the specified drive
and path, and specified in the File Name entry field.

If "*.*" is specified in the File Name  entry field, the Files  list box will
contain all the files found in the specified drive and directory that are
meaningful for this application.

If a specific file name is entered in the File Name field,  the Files list box
will contain the file name if it exists in the specified drive and path.

To Select a file, click on it in the Files list box. You can then open the
selected file by hitting the Open button at the bottom of the Open dialog.

Double clicking on a file name in the Files list box opens that file.


ΓòÉΓòÉΓòÉ 7.4. Help for Directories List Box ΓòÉΓòÉΓòÉ

The Directories list box contains the available drives and, if applicable,
subdirectories of your specified directory.

Clicking on a subdirectory or drive highlights that choice in the list box.

Double clicking on a subdirectory or drive makes that path current. Your
specified directory is always listed in the Directory is text field.

To back up one level in the directory tree, select the ".." choice in the
Directories list box.


ΓòÉΓòÉΓòÉ 7.5. Help for Open Button ΓòÉΓòÉΓòÉ

Pressing the Open button at the bottom of the Open dialog will open the file
specified in the File Name entry field. If the file specified in the File Name
entry field does not exist in the directory specified, an error message will be
displayed.

Pressing the Open button when no file is specified causes no action to be
taken.


ΓòÉΓòÉΓòÉ 7.6. Help for Cancel Button ΓòÉΓòÉΓòÉ

Pressing the Cancel button returns you from this dialog to your previous
application. None of the actions performed on the dialog are saved.


ΓòÉΓòÉΓòÉ 7.7. Help for Help Button ΓòÉΓòÉΓòÉ

Help is available any time you press the Help button. Because this is context
sensitive help, the help information that is displayed depends on where in the
program the Help button  was pressed.  To get help for a specific field or list
box, tab to or select that field and hit either F1  or the Help  button.

Press Esc at any time to view the previous help window or to return to the main
window if there are no other help windows.

Remember that selecting the F1 key is equivalent to pressing the Help button.


ΓòÉΓòÉΓòÉ 8. Help for Ok Button ΓòÉΓòÉΓòÉ

Select OK to confirm your selection(s). Once OK is pressed, your selections are
implemented and you are returned to the application.


ΓòÉΓòÉΓòÉ 9. Help for Cancel Button ΓòÉΓòÉΓòÉ

Pressing the Cancel button exits you from this dialog. No action is taken, no
changes are implemented, and you are returned to the application.


ΓòÉΓòÉΓòÉ 10. Help for Entry Field ΓòÉΓòÉΓòÉ

You may enter selection text in this string and then hit ENTER or click on the
"OK" Button.


ΓòÉΓòÉΓòÉ 10.1. Help for Copy ΓòÉΓòÉΓòÉ

Select COPY to copy the currently selected data into memory. Once the data in
memory it may be copied into this or other applications thus saving you the
task of re-entering it. Since COPY was selected, and not CUT, the original data
will not be removed from the application but will remain intact.


ΓòÉΓòÉΓòÉ 10.2. Help for Paste ΓòÉΓòÉΓòÉ

Select PASTE insert the data previously copied or cut into the clipboard into
the file. PASTE may be performed as many times as desired and each time a new
copy of the saved data will be inserted into the file. You may use the UNDO
command to remove the last PASTE performed.


ΓòÉΓòÉΓòÉ 10.3. Help for Print ΓòÉΓòÉΓòÉ

Select PRINT on the File pull-down to print out the currently viewed entry. You
may use print repeatedly if you wish to print multiple copies of the data.
Using PRINT in no way alters or affects the data you are working on. It's only
use is to provide you with a hard-copy of the file or data.

If the file is fairly large, a dialog with a "Cancel" Option will be displayed.
To abort prematurely from printing, press either the <escape> key or click on
the "Cancel" button.


ΓòÉΓòÉΓòÉ 10.4. Help for Find ΓòÉΓòÉΓòÉ

Select FIND to search for data.  You will be prompted for the data you want to
search for. The data last entered in the search field will be displayed as a
default search value. This data may be used again, or may be altered to reflect
the data you want to search for.  To change the search data, enter the new data
in the field and press the [Enter] key to begin searching.


ΓòÉΓòÉΓòÉ 10.5. Help for Save As ΓòÉΓòÉΓòÉ

Select SAVE AS to access a dialog allowing you to save the file to any name you
wish. This function is useful if you are creating a new file and wish to save
the file under a specific name. It can also be used when you have made changes
to an existing file and want to save an additional copy under a new name.

If the file is fairly large, a dialog with a "Cancel" Option will be displayed.
To abort prematurely from saving the file, press either the <escape> key or
click on the "Cancel" button.


ΓòÉΓòÉΓòÉ 10.6. Help for New ΓòÉΓòÉΓòÉ

Select New to erase the old file from the screen, and start editing a new file.
If you are currently editing a file and then select New to remove this file
from memory and start working on another file, you will be prompted to save or
cancel the changes made to existing file. If you are starting the application
and are not currently working on a file, selecting New will allow you to begin
working on a New file.


ΓòÉΓòÉΓòÉ 10.7. Help for Save ΓòÉΓòÉΓòÉ

Select SAVE on the File pull-down to save your data to a file. The file will be
saved under its current name. If you wish to save the file under another name,
you must use the SAVE AS option on the File pull-down.

If the file is fairly large, a dialog with a "Cancel" Option will be displayed.
To abort prematurely from saving the file, press either the <escape> key or
click on the "Cancel" button.


ΓòÉΓòÉΓòÉ 10.8. Help for Word Wrap ΓòÉΓòÉΓòÉ

Select WORD WRAP to toggle word wrapping on and off. Word wrapping splits lines
that are wider than the current window width into multiple lines.


ΓòÉΓòÉΓòÉ 11. Help for Save As ΓòÉΓòÉΓòÉ

Select SAVE AS to access a dialog allowing you to save the file to any name you
wish. This function is useful if you are creating a new file and wish to save
the file under a specific name. It can also be used when you have made changes
to an existing file and want to save an additional copy under a new name.

The file can be saved under either the "Raw" or "Formatted" options.  The "Raw"
option saves the file in binary format. The "Formatted" option saves the file
the way it is currently being displayed on the screen (as readable text).

If the file is fairly large, a dialog with a "Cancel" Option will be displayed.
To abort prematurely from saving the file, press either the <escape> key or
click on the "Cancel" button.


ΓòÉΓòÉΓòÉ 12. Help for Dump Formatter Specific Functions ΓòÉΓòÉΓòÉ

The help entries under this heading pertain specifically to DF.


ΓòÉΓòÉΓòÉ 13. Help for Open File Selection Dialog ΓòÉΓòÉΓòÉ

 The help entries under this heading pertain to the the Open File Selection
Dialog.