Initialize the Java Server

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 that is located in $CAIGLBL0000/browser/scripts. This script launches the Event Management Java server; it can 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. Run it as a started task in production. w2startup also starts process CaemRts and processes CAEMRTA. 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

hostname: The name or IP address of the host running the web server, and
port: The port number that 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 improves 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 (five 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 return codes for evidence of successful completion. To shut down CaemRts and the CAEMRTA processes, run CNSMPROC member NSMSHRTS.