Help for Servlet Panel

The NetView for z/OS Web XML Editor Utility enables you to edit the web.xml file used by WebSphere and Jetty web servers. Fields that cannot be edited are grayed out and disabled. Fields that can be edited are not grayed out and are enabled. For more information on the servlet fields, download the Java Servlet Specification (http://java.sun.com/products/servlet/download.html).

You must create uniquely named servlet definitions and url-patterns for each NetView for z/OS domain that you want to communicate with. Use the cnm01_ZnvAccessServlet and cnm01_3270Screen servlets provided as templates for your servlets. An asterisk (*) marks the fields that you must update in order to create unique servlets for your NetView for z/OS domains: Servlet Name, the Parameter Value for the Initialization Parameters HOST and ZNV_DOMAIN, and the URL Pattern. It may be necessary to change the Parameter Value fields for the Initialization Parameters PORT, INKEY and OUTKEY to match your NetView for z/OS definitions. Once you change the Servlet Name field you can then create a new servlet by clicking on the Create button. When the new servlet has been created, you will see that servlet name added to the Servlet Tree displayed in the left panel. To remove the old servlets, cnm01_3270Screen and cnm01_ZnvAccessServlet, or any new servlets you have created, right click on the servlet name in the Servlet Tree displayed in the left panel and select Delete Servlet.

If you are running the SNMP Server on a different machine than the Application Server, you will have to modify the MibServiceServlet, SnmpServiceServlet, DmpServiceServlet, and InstanceServiceServlet. For each of these servlets, change the Parameter Value of the SnmpServerHost parameter to the IP address of the machine where the SNMP Server is running.

Servlet Name

The Servlet Name field contains the canonical name of the servlet. This field is required and must be filled in order to create or update a servlet. This field can be edited if you open cnm01_3270Screen, cnm01_ZnvAccessServlet, or any new servlets you have created. If you edit this field the Create button is enabled and the Update button is disabled.

Display Name

The Display Name field contains a short name that is intended to be displayed by GUI tools. The Display Name field can be edited but is not required.

Load on Startup

The Load on Startup field indicates that the selected servlet should be loaded on the startup of the web application. The optional contents of this field must be a positive integer indicating the order in which the servlet should be loaded. Lower integers are loaded before higher integers. If no value is specified, or if the value specified is not a positive integer, the container is free to load it at any time in the startup sequence. The Load on Startup field cannot be edited.

Description

The Description field is used to provide descriptive text about the Servlet. The Description field can be edited but is not required.

Servlet Class or JSP File

If editable, choose either the Servlet Class radio button or the JSP File radio button. Either a servlet class or JSP file is required in order to create or update a servlet.

Initialization Parameters

The initialization parameter is a name/value pair as an initialization parameter of the servlet. You cannot add any initialization parameters to the table; you can only edit the current initialization parameters displayed in the table. Double click on an initialization parameter in the table to edit, and a new panel is displayed. The panel displays the initialization parameter fields of parameter name, parameter value, and description. Click the OK button to close the initialization parameter panel and accept your changes. Click the Cancel button to close the panel and discard your changes. Your changes will then be updated in the Initialization Parameter Table.

URL-Pattern

The URL-Pattern field contains the uniform resource locator (url) pattern of a servlet mapping. The servlet mapping defines a mapping between a servlet and a url pattern. To add a new URL-pattern, click on the combo-box and select <Add New>. A blank URL-Pattern is displayed. To delete a URL-Pattern click on the Delete button.
Note: The URL-pattern combo box is NOT used as a history log. Every URL-pattern displayed in the combo box will have a unique servlet-mapping associated with the servlet.

The following syntax is used to define mappings:

Note: Some characters such as '#', '>', and '%' will cause trouble in any http request. These characters should be avoided. It is recommended to use alphabetic or numeric characters.

For more information see the Java Servlet Specification documentation.

Create Button

Click the Create button to create a new servlet. This button is only enabled if you changed the Servlet Name field. Once you click the Create button, a new servlet is created and that servlet is displayed on the Servlet Tree on the left panel.
Note: The Servlet Name Field and either the Servlet Class or JSP-File field must be filled with a value in order for you to create a new servlet.

Update Button

Click the Update button to accept the changes you made to the current servlet.
Note: The Servlet Name field and either the Servlet Class or JSP-File field must be filled with a value in order for you to update your current servlet.

Reset Button

Click the Reset button to reset the Servlet Fields to the values after the last Create or Update.

Help Button

Click the Help button to display help in editing a servlet.