With Application Server, the display name is supplemented during import when the DD is omitted. Also, the J2EE server checks the validity of the display name. This subsection describes the supplemental rules for the display names during import and the checking of the validity of the display names.
If the <display-name> tag of the DD for the J2EE components EJB-JAR, WAR, RAR, or EAR is not specified, the J2EE server sets the display name. The display name is determined on the basis of the file name and directory name of the J2EE components. Even when the DD is omitted, the J2EE server sets the display name. The characters that can be used as the file name and directory name in this case are one-byte alphanumeric characters (0 to 9, A to Z, and a to z) and underscore (_). When you want to specify the display name for EJB-JAR, WAR, RAR, or EAR, we recommend that you specify the <display-name> tag.
The characters that can be used in the display name of the lang attribute en of the J2EE applications, EJB-JARs, WARs, RARs, and the components (Enterprise Beans, Servlets, JSPs, Filters) are alphanumeric characters (0 to 9, A to Z, and a to z) and underscore (_). If characters other than one-byte alphanumeric characters are included in the display name, the J2EE server converts the characters to underscore (_). The J2EE server checks the validity of the display name when the J2EE applications, EJB-JARs, WARs, and RARs are imported and issues a warning message KDJE42374-W if characters that cannot be used are used in the display name.
However, if the display name is TP1/Message Queue - Access, a warning message is not issued.
The following is a description on the server management commands used for checking the validity of the display names:
The following table lists the display names for which the validity is checked.
Table 11-13 List of display names for which the validity is checked
No. | DD elements indicating the display name | Definition types |
---|---|---|
1 | <application><display-name> | application.xml definition |
2 | <ejb-jar><display-name> | ejb-jar.xml definition |
3 | <ejb-jar><enterprise-beans><session><display-name> | ejb-jar.xml definition |
4 | <ejb-jar><enterprise-beans><entity><display-name> | ejb-jar.xml definition |
5 | <ejb-jar><enterprise-beans><message-driven><display-name> | ejb-jar.xml definition |
6 | <web-app><display-name> | web.xml definition |
7 | <web-app><filter><display-name> | web.xml definition |
8 | <web-app><servlet><display-name> | web.xml definition |
9 | <connector><display-name> | ra.xml definition |