Using System Information views

You use the views in the System Information perspective for these tasks:

To: Use this view:
Control your system information session Target Navigator
Examine your target system's attributes System Summary
Manage processes on the device Process Information
Examine process signals Signal Information
Get channel information System Blocking Graph
Track file descriptors Connection Information
Track resource usage System Resources

You can also track heap usage and examine target system memory by using the System Information perspective. For more information, see Minimizing memory usage.

Some of the views that are associated with the System Information perspective can add a significant processing load to your computer. You can improve its performance by:

  • Closing the System Information perspective when you're not using it
  • Closing or minimizing unneeded views in the perspective (you can reopen closed views by selecting Reset Perspective on the Window menu)
  • Reducing the refresh rate

Control your system information session

The selections that you make in the Target Navigator view control the information that you see in the System Information perspective. You can customize the Target Navigator view to:

  • Sort processes by process ID (PID) or by name
  • Group processes by PID family
  • Control the refresh rate

To access the Target Navigator view's customization menu, click The Menu dropdown icon in the Target Navigator view's title bar.

You can reverse a selected sort order by clicking The Reverse sort icon in the view's title bar. You can enable or disable the automatic refresh by clicking The Automatic Refresh icon in the view's title bar.

Screen showing the Target Navigator view, which shows the system information.

Entries in the Target Navigator view are gray when their data is stale and needs refreshing. If you've disabled automatic refresh, you can refresh the Target Navigator view by right-clicking in the view and clicking Refresh in the context menu.

The Target Navigator view also lets you control the information that is shown in the following views:

  • Connection Information
  • Malloc Information
  • Memory Information
  • Process Information
  • Signal Information

To control what's shown in the Information views, in the Target Navigator view, expand a target and select a process. The Information view that's currently displayed is updated to show information about the selected process.

Screen showing a selected process in the Target Navigator view.

Update the views

To update the views in the System Information perspective, in the Target Navigator view, expand a target and select a process. You can also select groups of processes by using Ctrl or Shift. The views reflect your selection.

The data shown in the System Information perspective is updated automatically whenever new data is available.

Add views

By default, some views don't appear in the System Information perspective. To add a view to the perspective:

  1. On the Window menu, click Show View and then select a view. The view appears in your perspective.
  2. To save a customized set of views as a new perspective, on the Window menu, click Save Perspective As.

Examine your target system's attributes

The System Summary view shows a listing of your target's system attributes, including your target's processors, memory, active servers, and processes:

Screen showing the System Summary view, which shows the attributes for the target.

In addition to the System Summary view, the other views include the following:

System Specifications pane
The System Specifications pane shows your target's host name, board type, OS version, boot date, and CPU information. If your target is a multicore system, the pane lists CPU information for each core or processor.
System Memory pane
The System Memory pane shows your target's total memory and free memory in numerical and graphical form.
Processes panes
The Processes panes show the process name, code and data size, data usage delta, total CPU usage since starting, CPU usage delta, and start date and time for the processes running on your selected target. The panes let you see application processes, server processes, or both. Server processes have a session ID of 1, and application processes have a session ID greater than 1.

Click The Highlight button in the view's toolbar to highlight changes to the information since the last update.

You can change the highlight color in the Colors and Fonts preferences (on the Window menu, click Window > Preferences > General > Appearance > Colors and Fonts).

Manage processes on the device

The Process Information view shows information about the processes that you select in the Target Navigator view. The view shows the name of the process, its arguments, environment variables, and so on. The view also shows the threads in the process and the state of each thread:

Screen showing the Process Information view, which shows process-specific information.

The Process Information view includes the following panes:

Click The Highlight button in the view's toolbar to highlight changes to the each pane since the last update.

You can change the highlight color in the Colors and Fonts preferences (on the Window menu, clickPreferences > General > Appearance > Colors and Fonts).

Thread Details pane

The Thread Details pane shows information about your selected process's threads, including the thread's ID, priority, scheduling policy, state, and stack usage.

The Thread Details pane shows a substantial amount of information about your threads, but some of the column entries aren't shown by default.

To configure the information that is shown in the Thread Details pane:

  1. In the Process Information view, click The Menu icon.
  2. Click Configure. The Configure dialog box appears:

    Screen showing the Configure dialog box in the Process Information view.

  3. Do one of the following:
    • To add entries to the pane, select items from the Available Items list and clicking Add.
    • To remove entries from the pane, select items in the New Items list and clicking Remove.
    • To adjust the order of the entries, select items in the New Items list and clicking Shift Up or Shift Down.
  4. Click OK. The pane shows the entries that you specified in the New Items list.

If you right-click a thread in the Thread Details pane, the menu includes items that let you specify the thread's priority and scheduling algorithm, name, CPU affinity, and inherited CPU affinity:

Screen showing thread options.

You can set the priority and scheduling algorithm:

Screen showing priority and scheduling.

For more information about the available priorities and scheduling algorithms, see Thread scheduling.

You can give the thread a name:

Screen showing setting the thread name.

You can also set the runmask that the thread's children will inherit and its own runmask:

Screen showing inherited CPU affinity. Screen showing CPU affinity.

For more information, see Multicore Processing

If you right-click a process in the Target Navigator view or the Thread Details pane, you get similar options, except for setting the thread name. The Thread Details pane allows you to modify thread and process information for individual threads.

Environment Variables pane

The Environment Variables pane provides the values of the environment variables that are set for your selected process.

Process Properties pane

The Process Properties pane shows the process's start-up arguments and the values of the process's IDs: real user, effective user, real group, and effective group.

The process arguments are the arguments that were used to start your selected process as they were passed to your process, but not necessarily as you typed them. For example, if you type ws *.c, the pane might show ws cursor.c io.c my.c phditto.c swaprelay.c, because the shell expands the *.c before launching the process.

The process ID values determine which permissions are used for your process. For example, if you start a process as root, but you use the seteuid() and setegid() functions to run the process as the user jsmith, the process runs with jsmith's permissions. By default, all processes that are launched from the Momentics IDE for BlackBerry run as root.

Examine process signals

The Signal Information view shows the signals for the processes that are selected in the Target Navigator view.

Screen showing the Signal Information view

The view shows signals that are:

  • Blocked (applies to individual threads)
  • Ignored (applies to the entire process)
  • Pending

The Target Navigator view lets you send signals to any process on your target. For example, you can terminate a process by sending it a SIGTERM signal.

To send a signal to a process:

  1. Screen showing the Deliver Signal dialog box in the Target Navigator view.In the Target Navigator view, right-click a process and click Deliver Signal.
  2. Select a signal from the drop-down list.
  3. Click OK. The Momentics IDE delivers the signal to your selected process.

Delivering a signal to a process usually causes that process to terminate.

Get channel information

The System Blocking Graph view presents a color-coded representation of all of the active channels in the target and illustrates the interaction of threads with those channels.

Interactions with resource objects are such that a thread can be blocked waiting for access to the resource or waiting for servicing (that is, the thread is SEND-blocked on a channel).

The thread could also be blocked waiting for a resource to be released back to the thread or waiting for servicing to terminate (that is, the thread is REPLY-blocked).

Client apps in such conditions are shown on the left side of the graph, and the resource under examination is in the middle. Threads that are waiting to service a request or are active owners of a resource, or are actively servicing a request, are shown on the right side of the graph:

Screen showing a system blocking graph.

Legend item Thread state
Servicing request Not RECEIVE-blocked (for example, RUNNING, blocked on a mutex, and so on)
Waiting for request RECEIVE-blocked
Waiting for reply REPLY-blocked
Waiting for service SEND-blocked

Track file descriptors

The Connection Information view shows the file descriptors, server, and connection flags related to your selected process's connections. This view also shows (where applicable) the path name of the resource that the process accesses through the connection:

Screen showing the Connection Information view.

The information in this view comes from the individual resource manager servers that are providing the connection. Certain resource managers may not be able to return all of the requested information, so some fields are left blank.

The IOFlags column describes the read (r) and write (w) status of the file. A double dash (--) indicates no read or write permission, and a blank indicates that the information isn't available.

The Seek Offset column indicates the connector's offset from the start of the file.

Note that for some file descriptors (FDs), an s appears beside the number. This means that the FD in question was created using a side channel. The connection ID is returned from a different space than file descriptors, so the ID is actually greater than any valid file descriptor. For more information on side channels, see the ConnectAttach() function.

To see the full side channel number:

  1. In the Connection Information view, click The Menu icon.
  2. Click Full Side Channels.

Track resource usage

The System Resources view shows various pieces of information about your target's processes.

To select which display you want to see, click The Menu icon in the System Resources view.

Click The Highlight button in the view's toolbar to highlight changes to the display since the last update.

You can change the highlight color in the Colors and Fonts preferences (on the Window menu, click Preferences > General > Appearance > Colors and Fonts).

System Uptime display

The System Uptime display provides information about the start time, CPU usage time, and usage as a percent of the total uptime for each process that is running on your selected target.

Screen showing the System Uptime in the System Resources view.

General Resources display

The General Resources display provides information about CPU usage, heap size, and the number of open file descriptors for each process that is running on your selected target.

Screen showing the General resources in the System Resources view.

Memory Resources display

The Memory Resources display provides information about the heap, program, library, and stack usage for each process that is running on your selected target.

Screen showing the Memory resources in the System Resources view.

Last modified: 2014-11-17



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus