Managing operator message routing

WebSphere Application Server for z/OS provides improved message routing capabilities. You can route many of the BBO prefixed error messages to specific datasets instead of having them go to SYSLOG, which can create a lot of traffic. This is implemented with the use of two new environment variables, ras_default_msg_dd and ras_hardcopy_msg_dd, and then specifying the appropriate DD statement in your JCL start procedure.

The two new environment variables are documented in Appendix A of the WebSphere Diagnosis book. The following explains how messages get routed in WebSphere Application Server Version 5 in more detail:

To use these message routing variables, you must do two things:

  1. Add these parameters to the server definitions using the administrative console under Environment -> Manage WebSphere Variables:
    • ras_default_msg_dd =DEFALTDD
    • ras_hardcopy_msg_dd =HRDCPYDD
    You can set these variables for individual control and servant processes, but it is easier to set them in the Environment variables for the entire cell. For the Daemon, you must prefix them with "DAEMON_" and set them at the cell level:
    • DAEMON_ras_default_msg_dd =DEFALTDD
    • DAEMON_ras_hardcopy_msg_dd =HRDCPYDD
  2. Update the included &Z members in PROCLIB to add these new DD statements:
    //* Output DDs
    //CEEDUMP DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //SYSOUT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //SYSPRINT DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //DEFALTDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    //HRDCPYDD DD SYSOUT=*,SPIN=UNALLOC,FREE=CLOSE
    

Note:

For example, these DD files are used to segregate the messages and keep almost all of them off the hardcopy console (SYSLOG):
  1. JESMSGLG - a few start-up and shut-down messages
  2. JESYSMSG - MVS allocation and deallocation messages
  3. SYSOUT - a few start-up and shut-down messages
  4. SYSPRINT - a few start-up and shut-down messages
  5. HRDCPYDD - audit messages that would normally go to SYSLOG
  6. DEFALTDD - informational messages that would normally go to SYSLOG



Searchable topic ID:   rtrb_msgrouting
Last updated: Jun 21, 2007 9:56:50 PM CDT    WebSphere Application Server for z/OS, Version 5.0.2
http://publib.boulder.ibm.com/infocenter/wasinfo/index.jsp?topic=/com.ibm.websphere.zseries.doc/info/zseries/ae/rtrb_msgrouting.html

Library | Support | Terms of Use | Feedback