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:
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.