OS/2 Shareware BBS: 8 Other/08-Other.zip/e52os2m.exe/procmgr.hlp

OS/2 Help File | 1998-05-27 | 14KB | 431 lines

ΓòÉΓòÉΓòÉ 1. Process Menu ΓòÉΓòÉΓòÉ

Select the Process pulldown menu to use Process Manager's process handling
functions.  These functions include:

   o  Run Command...

   o  Process Alerts...

   o  Send Ctrl-C (OS/2 systems only)

   o  Send Ctrl-Break (OS/2 systems only)

   o  Kill Process (OS/2 systems only)

   o  Close Application (Windows systems only)

   o  Unload Module (NetWare systems only)


ΓòÉΓòÉΓòÉ 2. Run Command... ΓòÉΓòÉΓòÉ

Select Run Command... to open the Run Command Window.  This window enables you
to run a single command on the system that is currently being accessed by the
Process Manager service.


ΓòÉΓòÉΓòÉ 3. Run Command Window ΓòÉΓòÉΓòÉ

Type in the Enter command line to be executed field the command that you want
to execute on this system.  Then, select Run to execute the command.

Select Cancel to close this window without executing a command.


ΓòÉΓòÉΓòÉ 4. Enter command line to be executed ΓòÉΓòÉΓòÉ

Type in the Enter command line to be executed field the command line that you
want to execute on this system.  Then, select Run to execute the command.

Select Cancel to close this window without executing the command.


ΓòÉΓòÉΓòÉ 5. Run ΓòÉΓòÉΓòÉ

Select Run to execute the command that has been typed into the Enter command
line to be executed field.


ΓòÉΓòÉΓòÉ 6. Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close this window without executing a command.


ΓòÉΓòÉΓòÉ 7. Send Ctrl-C ΓòÉΓòÉΓòÉ

Select Send Ctrl-C to send a Ctrl-C command to the selected process.  If the
selected process is designed to receive and handle Ctrl-C program interrupts,
this can enable the process to gracefully shut down. However, if the process is
not designed to receive and handle Ctrl-C program interrupts, this instruction
might be ignored.


ΓòÉΓòÉΓòÉ 8. Send Ctrl-Break ΓòÉΓòÉΓòÉ

Select Send Ctrl-Break to send a Ctrl-Break command to the selected process.
If the selected process is designed to receive and handle Ctrl-Break program
interrupts, this can enable the process to gracefully shut down. However, if
the process is not designed to receive and handle Ctrl-Break program
interrupts, this instruction might be ignored.


ΓòÉΓòÉΓòÉ 9. Kill Process ΓòÉΓòÉΓòÉ

Select Kill Process to end the selected process.

Warning:  The Kill Process command is very powerful, and can damage the system
on which it is used if it is used improperly.  If a process that is necessary
for the operation of the system is killed while in use, it can halt (or even
damage) the operating system.  Use the Kill Process command cautiously.


ΓòÉΓòÉΓòÉ 10. Close Application ΓòÉΓòÉΓòÉ

Select Close Application to close an application running on a Windows system.


ΓòÉΓòÉΓòÉ 11. System Menu ΓòÉΓòÉΓòÉ

Select the System pulldown menu to access information about this system.
Available information includes:

   o  Operating System Information


ΓòÉΓòÉΓòÉ 12. Operating System Information ΓòÉΓòÉΓòÉ

Select Operating System Information to view information about this system's
operating system. Available information includes:

   o  Operating System Name

   o  Operating System Version


ΓòÉΓòÉΓòÉ 13. OK ΓòÉΓòÉΓòÉ

Select OK to close the Operating System Information window.


ΓòÉΓòÉΓòÉ 14. Process Window ΓòÉΓòÉΓòÉ

The Process Window contains a list of all detected processes currently running
on the system.  The type of process that is running is represented by a small
icon to the left of the process's name.  Additional information regarding the
process is dependant on the operating system in use by the system that is being
accessed.  Additional information available might include:

   o  Program Name

   o  Process ID

   o  Parent Process ID

   o  Session ID

   o  Number of Threads

 To perform one of Process Manager's process handling functions on a process
 that appears in the Process Window, select the process, and then:

   o  Right-click on the process, and select a process handling function from
      the pop-up menu

      or

   o  Select the Process pulldown menu, and then select a process handling
      function.


ΓòÉΓòÉΓòÉ 15. Program Name ΓòÉΓòÉΓòÉ

This is the name of this process, as well as the fully qualified path showing
where the program resides on the system.


ΓòÉΓòÉΓòÉ 16. Process ID ΓòÉΓòÉΓòÉ

This is the operating system's internal identification value for this process.


ΓòÉΓòÉΓòÉ 17. Parent Process ID ΓòÉΓòÉΓòÉ

This is the operating system's internal identification value for the process or
program that spawned this process.


ΓòÉΓòÉΓòÉ 18. Session ID ΓòÉΓòÉΓòÉ

This is the operating system's internal identification value for the session
that is supporting this process.


ΓòÉΓòÉΓòÉ 19. Number of Threads ΓòÉΓòÉΓòÉ

This is the number of program threads that this process is using.


ΓòÉΓòÉΓòÉ 20. Help Menu ΓòÉΓòÉΓòÉ

Use the choices on the Help pulldown menu to display:

   o  An index of references to the help topics for the Process Manager

   o  General information about the Process Manager service

   o  General information about the help facility

   o  A list of key commands you can use


ΓòÉΓòÉΓòÉ 21. Process Manager ΓòÉΓòÉΓòÉ

You can use the Netfinity Process Manager service to view detailed information
about all processes that are currently active on a system.  Process Manager
enables you to execute commands on the system and to close individual processes
by initiating a Ctrl-C, Ctrl-Break, or Kill Process command.  Finally, Process
Manager will keep an eye on any process that you've specified, and can generate
a Netfinity Process Alert if that is started, stops, or fails to start within a
specified amount of time from startup.


ΓòÉΓòÉΓòÉ 22. Keys Help ΓòÉΓòÉΓòÉ

When two key names are joined by a plus sign (+), use these two keys together.
Hold down the first key and press the second.

 Alt+Esc
    Switch to the next open window, full-screen session, or icon that is
    minimized on the desktop.

 Alt+Shift+Tab
    Make the desktop window active.

 Alt+F4
    Close the local window.

 Alt+F7
    Enable you to move the active window to a different location.

 Alt+F9
    Remove from the screen the active window and all windows associated with
    it. The windows are hidden or minimized, depending on how the program was
    written.

 Ctrl+Alt+Del
    Restart the operating system on the local system.

 Ctrl+Esc
    Display the Window List on the local system.

 Print Screen
    Print the contents of the remote window to the default local printer.


ΓòÉΓòÉΓòÉ 23. Process Alerts... ΓòÉΓòÉΓòÉ

Select Process Alerts... to configure the Process Manager to generate a
Netfinity Alert when a specified program:

   o  Starts running

   o  Stops running

   o  Fails to start running within a specified time


ΓòÉΓòÉΓòÉ 24. Add Process Alert... ΓòÉΓòÉΓòÉ

Select Add Process Alert... to configure the Process Manager to generate a
Netfinity Alert when the selected program:

   o  Starts running

   o  Stops running

   o  Fails to start running within a specified time


ΓòÉΓòÉΓòÉ 25. Process Alerts ΓòÉΓòÉΓòÉ

The Process Alerts window contains in the Alert conditions field a list of all
currently configured Process Manager Alert conditions.  Each Alert condition
includes the name of the program that will trigger a Netfinity Process Alert,
and the conditions under which the alert will be generated.

From the Process Alerts window, you can:

   o  Add a Process Alert

   o  Edit a Process Alert

   o  Delete a Process Alert

   o  Get online help

   o  Exit the Process Alerts window


ΓòÉΓòÉΓòÉ 26. Alert conditions ΓòÉΓòÉΓòÉ

This field contains a list of all currently configured Process Manager alert
conditions.  Each entry includes the name of the program that Process Manager
is monitoring and a brief description of the conditions under which a Netfinity
Alert will be generated.


ΓòÉΓòÉΓòÉ 27. Add ΓòÉΓòÉΓòÉ

Select Add to open the Add Process Alert window.  This window enables you to
configure a Process Alert for a specific program that will generate a Netfinity
Alert whenever the program:

   o  Starts running

   o  Stops running

   o  Fails to start running within a specified time

 To add a new Process Alert:

   1. Type in the Program Name

   2. Type in the Alert Severity field a severity value for the Netfinity Alert
      that will be generated by Process Manager.

   3. Select one (or more) Generate alert checkboxes.

   4. Set an Execution time-out value (optional)

   5. Select the Notify checkbox to cause the generated alerts to be sent to
      your system's alert manager.

   6. Select OK.

 Select Cancel at any time to close the Add Process Alert window without saving
 any changes.


ΓòÉΓòÉΓòÉ 28. Program Name ΓòÉΓòÉΓòÉ

Type in the Program Name field the name of the program that you want the
Process Manager service to monitor.


ΓòÉΓòÉΓòÉ 29. Alert Severity ΓòÉΓòÉΓòÉ

Use the spin buttons to select the Alert Severity value for Process Manager
alerts generated for this program.


ΓòÉΓòÉΓòÉ 30. Generate alert checkboxes ΓòÉΓòÉΓòÉ

The Process Manager service can generate three different Netfinity alerts
regarding the status of the specified program.  These alerts wil notify you
when:

   o  The specified program starts running.

   o  The specified program stops running.

   o  The specified program fails to start running within a specified amount of
      time from startup.

 You can select one or more of these checkboxes.


ΓòÉΓòÉΓòÉ 31. Generate alert when program runs ΓòÉΓòÉΓòÉ

Select the Generate alert when program runs checkbox to configure Process
Manager to generate an alert whenever a process that has the program name that
you typed in the Program Name field is started on the system.


ΓòÉΓòÉΓòÉ 32. Generate alert when program stops ΓòÉΓòÉΓòÉ

Select the Generate alert when program stops checkbox to configure Process
Manager to generate an alert whenever a process that has the program name that
you typed in the Program Name field and that has been running on the system is
stopped.


ΓòÉΓòÉΓòÉ 33. Generate alert if program not started ΓòÉΓòÉΓòÉ

Select the Generate alert if program not started checkbox to configure Process
Manager to generate an alert if the program specified in the Program Name field
does not start within the amount of time specified in the Execution time-out
field.

Note:   The Execution time-out is measured from the time at which the Netfinity
Support Program or Netfinity Network Interface is started or from the time at
which the Execution time-out action is configured.


ΓòÉΓòÉΓòÉ 34. Execution time-out ΓòÉΓòÉΓòÉ

Use the spin buttons beside the Execution time-out field to select the amount
of time that the Process Manager will wait for the program specified in the
Program Name field to start up before an alert is generated.

Note:   The Execution time-out is measured from the time at which the Netfinity
Support Program or Netfinity Network Interface is started.


ΓòÉΓòÉΓòÉ 35. OK ΓòÉΓòÉΓòÉ

Select OK to save the Process Alert configuration and close this window.


ΓòÉΓòÉΓòÉ 36. Cancel ΓòÉΓòÉΓòÉ

Select Cancel to close this window without saving any changes.


ΓòÉΓòÉΓòÉ 37. Edit ΓòÉΓòÉΓòÉ

Select Edit to change the configuration of the currently selected Alert
conditions.

To edit a previously configured Process Alert:

   1. Select the alert that you want to edit from the Alert conditions field.

   2. Select Edit.  This opens the Edit Process Alert window.

   3. Edit the Process Alert as necessary.

   4. Select OK to save the changes and close this window.

 Select Cancel at any time to close this window without saving any changes.


ΓòÉΓòÉΓòÉ 38. Notify ΓòÉΓòÉΓòÉ

Select the Notify checkbox to cause the Netfinity Alerts generated for this
process to be directed to your system's Alert Manager.  If Notify is not
checked, the alerts will not be sent directly to your system.


ΓòÉΓòÉΓòÉ 39. Local Notify ΓòÉΓòÉΓòÉ

Select the Local Notify checkbox to cause the Netfinity Alerts generated for
this process to be directed to the managed system's Alert Manager.  If Local
Notify is not checked, the alerts will not be sent directly to the managed
system's alert manager.


ΓòÉΓòÉΓòÉ 40. Delete ΓòÉΓòÉΓòÉ

Select Delete to delete the currently selected Alert condition.


ΓòÉΓòÉΓòÉ 41. Exit ΓòÉΓòÉΓòÉ

Select Exit to close the Process Alerts window.


ΓòÉΓòÉΓòÉ 42. Unload Module ΓòÉΓòÉΓòÉ

Select Unload Module to unload the NetWare Loadable Module.