Event Management Configuration › How to Configure Event Management GUI Tasks › Initialize the Java Server

Initialize the Java Server

The CA Common Services for z/OS Event Management Java server is run using the w2startup script located in $CAIGLBL0000/browser/scripts. This script launches the Event Management Java server; it may need configuration, depending on the directory names you select when installing Java.

• $CAIGLBL0000/browser/classes must be added to your Java CLASSPATH.
• Event Management and Java executable programs must be included in your PATH.
• Event Management and Java Library (DLL) directories must be included in your LIBPATH.

These variables are set in the file $CAIGLBL0000/browser/httpd.envvars.

The w2startup script can be run as a UNIX command or as a batch job using BPXBATCH syntax. The sample member NSMJSERV in CNSMPROC can be run as a batch job or started task. You should run it as a started task in production. Process CaemRts and processes CAEMRTA are also started by w2startup. Check the status of this job by referring to STDOUT and STDERR zFS files for the job. Do not rely on the job return codes for evidence of successful completion.

Once the server is started, you can access the Event Management GUI by starting a web browser session with a URL of this form:

http://hostname:port

where hostname is the name or IP address of the host running the web server, and port is the port number you assigned in the httpd.conf file. It is highly recommended to use a hostname rather than a hardcoded IP address. If you accept the default port of 80, you can omit the port number.

To limit the nodes reported on by the GUI, copy the file $CAIGLBL0000/emsrvc/data/nodelist.sample to $CAIGLBL0000/emsrvc/data/nodelist, and edit that file to include only the node names on which you intend to report. This will improve performance when viewing the GUI.

To terminate the Java server, you can run CNSMPROC member NSMJSTOP; or from USS, run the w2kill script found in $CAIGLBL0000/browser/scripts. The script leaves processes CaemRtS and CAEMRTA (5 instances) running, allowing any remote CA NSM machines to access the Event Management GUI on z/OS.

Check the status of this job by referring to STDOUT and STDERR zFS files for the job. Do not rely on the job's return codes for evidence of successful completion. If you wish to shut down CaemRts and the CAEMRTA processes, run CNSMPROC member NSMSHRTS.