Managing Applications

When managing applications on your server using NetWare Remote Manager, use the following links in the navigation frame to help you accomplish the following tasks:

Managing NLM Programs

To view a list of NLM programs and manage them, access the NetWare Loadable Module Information page by clicking the List Modules link in the navigation frame.

From the NetWare Loadable Module Information page, you can do the following:

• View a list of all the NLM programs that are loaded on the server or in an address space

  The list of all NLM programs that are loaded on the server is the default view on this page.

  You can sort the list by module name, code/data size, or memory usage. To do this, click the column heading you want to sort by.

  The column totals of this list show how much memory is being used by all of the NLM programs collectively on the system. This information can help you better plan for future memory upgrades to the server.

  To access detailed information about a module (flags, resources, memory use details, module dependency list, etc.), as well as an option to unload the NLM program if there are no module dependencies, click the module's name link. If an Unload button is on the detailed information page, you can click it to unload the NLM.

  To view the allocated memory summary for an individual NLM program, click the value link in the Alloc Memory column.This summary indicates how much memory a NetWare Loadable Module has requested from the system and how much it is currently using. This information is valuable in determining whether the module is using too much system memory.

• Load an NLM program on the server

  To do this, enter the name of the module you want to load in the Load Module field and then click the Load Module button. If you want to display the System Console while the NLM program is loading, check the Display System Console for Module Load check box.

• View the search path for loading modules or .NCF file

  To do this, click the Module Load Search Path link. If the module cannot be found, you can change the search path as follows:

  • To add another search path to the bottom of the search stack, enter the following command at the server console:

    Search Add complete_path

    For example: Search Add SYS:\SYSTEM\EXTRAS

  • To insert a search path into the middle of the search stack, such as to make a search path the second place that NetWare looks for its files, enter the following command at the server console:

    Search Add number complete_path

    For example: Search Add 2 SYS:\SYSTEM\EXTRAS

  • To find out more about using the Search command, click Console Commands and then click the Info icon next to Search.

Viewing and Managing Programs in Protected Memory and Protected Address Spaces

To view and manage programs in protected memory and protected address spaces, access the Address Space Information page by clicking the Protected Memory link in the navigation frame.

From the Address Space Information page, you can do the following:

• Execute an NCF to load several modules into the same protected address space

  To do this, enter the NCF filename in the field provided and click the Load NCF File Protected button.

• Load an individual module into the protected address space

  To do this, enter the module name in the field provided and click the Load Modules Protected button.

• View information about an address, such as its name, address space, time since last fault, restart count, and the status for Restartable, Unload, Remove, and Restart

  If there is a button rather than n/a status in these columns, you can do the following:

  • Restartable allows you to change the restart state of that address space.

  • Unload unloads all modules from the address space.

  • Remove removes the address space from the server without running the termination code of modules in that address space.

  • Restart allows you to reload that address space.

• View information about modules running in protected address spaces on the server

  To view a listing of all NLM programs loaded in the protected address space, click the name link for that address space.

• View or change the current memory protection SET parameter settings

  To view the settings, click the Memory Protection Set Parameter link to display the Memory page.

  To change a setting, access the Memory page, click the value link for the setting, enter a new value within the specified range, and then click OK.

Viewing System Resources

Resource tags are used to track things like allocated memory, screens, and packet receive buffers. When an NLM program wants to check out or allocate a resource from the system, it passes in a resource tag to the system and the resource tag is updated to show how much of the resource is in use. When the resource is returned to the system, the resource tag is again updated to reflect the change. When an NLM program is unloaded, the resource tags are also used to ensure that the NLM program returned all of the system resources that it was using.

To view the resource tags used by the system, access the System Resource page by clicking the System Resources link in the navigation frame.

From the System Resource page, you can do the following:

• View a list of all the Resource tags in use at any given time
• Access the details of a resource

  To view the details of a resource, click the resource name.

  A list is displayed that is sorted by NetWare Loadable Module (NLM) and then by number in use. The items displayed are a short name for the NLM, the NLM description, the resource tag description, and the amount of the resource that is checked out to that resource tag.

Viewing NetWare Registry Information

The NetWare registry is a database of setup and configuration information that determines how the NetWare server and applications on this server will run.

To view key information from the NetWare registry for this server, view operational information, run the consistency checker, and flush the registry, access the Registry page by clicking the NetWare Registry link in the navigation frame.

Key information shows keys and values for your server, performance, and other dynamic data.

Operational information shows the overall details about the NetWare registry for your server.

If any problems are noted when you run the consistency checker, contact a Novell support provider for actions to take.

Flushing the registry lets you make changes and save them to disk immediately rather than waiting 30 seconds for them to be copied to disk.

Viewing Winsock 2.0 Statistics

Viewing Winsock information can help you understand how the applications on your server are interacting with the Winsock APIs provided in NetWare. Error status conditions are distinguished with yellow and red for quick identification.

To view Winsock resource information, diagnostic and debug information for sockets, information for transport providers and active name space providers, and a small set of general statistics, access the NetWare Winsock 2 Communication Framework page by clicking the Winsock 2.0 link in the navigation frame.

The main content on this page shows the transport providers and active name space providers, and a small set of general statistics as well as the following links:

• Winsock 2 Resources link

  Opens the Winsock 2 Resources page. From this page you can view all the Winsock resources that are currently in use, open sockets, Winsock 2 events, sockets that are used by a particular application, and protocol objects within an active session and the number that are active.

  To view a list of Winsock 2 sockets in use, click the Winsock 2 Socket List link.

  • If an error condition exists (indicated by the status being highlighted yellow or red), you might want to view the details of that socket. To view the details of a socket and socket status, click the link for the socket number you want to view on the Winsock 2 Socket list page.
  • To view the details of the error, click the Last Error link in the Detailed Information for Socket Number x page.
  • To close an individual socket, click the Close Socket button at the bottom of the socket detail page.

  To view a list of all the events used by Winsock 2, click the Winsock 2 Event List link.

  • This list shows the socket number used by the event, the event handle, the wait count, the wait status, the owning thread, and the application that the event is used by.
  • If a socket number is listed, a link to the details page for that socket is provided.
  • The Owning Thread link disassembles the code stack of the thread that created the event.

  To view a list of sockets opened by a specific application, click the link for the application in the Winsock Applications list.

  To view a list of all the session objects created within this protocol object, click the General WSP Protocol Object link to open the General WSP Protocol Object Session Map page. On this page, you can access links to the upper sessions and lower sessions as well as a link to the socket details page.

  To view a list of all the session objects created within the IP protocol, click the IP Protocol Object link to open the IP Protocol Object Session Map page. On this page, you can link to the current session and upper session. Using these links to the sessions, you can map a sockets course throughout all the Winsock layers.

  To view a list of all the session objects created within the SSL protocol, click the SSL Layered Protocol Object link to open the SSL Layered Protocol Object Session Map page. On this page, you can link to the current session, upper session, and lower session. Using these links to the sessions, you can map a sockets course throughout all the Winsock layers.

• Diagnostics and Debug link

  Opens the Diagnostics and Debug page that shows five resource lists to identify, diagnose, and debug Winsock communication problems: 1) Socket Warning, 2) Session Warning, 3) Socket Waiting, 4) Event Waiting, 5) Session Linger.

  From these lists you can follow active links to error or warning conditions on your server.

• Toggle Counters ON/OFF button

  Lets you turn on or off the viewing of global counter information gathered in the system and view the number of successes and failures.

  IMPORTANT:  Toggling counters ON adds significant activity to the server operating system.

  For optimal performance, toggle the Winsock diagnostic counts off after you have gathered the information you need.

  Turning the counters on adds the following information to the general statistics and adds the Global API Counter link to the page:

  • Bytes Received Successfully
  • Bytes Transmitted Successfully
  • Bytes Not Received Due to Error
  • Bytes Not Transmitted Due to Error
  • Packet Receive Buffers In Use 0

• Global API Counters link

  Opens the Global API Counters page that lists all of the global counter information gathered in the operating system.

Viewing Information about Each Protocol Running on the Server

From the Protocol information page, you can view general and specific information about each protocol running on the server. To access specific information for a protocol, click the link for the protocol. From the specific NCP page, you can enable and disable tracking counters for NCP (NetWare Core Protocol).