Configuring and Starting an Environment Management Agent on z/OS

To run an agent on z/OS, you must have installed JRE delivered with PeopleTools on the z/OS machine.

To configure and start the agent on z/OS:

  1. Edit the configuration.properties file (PS_HOME/PSEMAgent/envmetadata/config).

  2. Edit hubURL and define the hub machine name and hub port.

  3. Edit unixdrivestocrawl and set it to the set of directories that need to be crawled.

  4. Edit StartAgent.sh.

    On the first line, replace PS_HOME with your PS_HOME location.

    Edit the last line to point to your JRE location.

  5. Edit StopAgent.sh.

    On the first line, replace PS_HOME with your PS_HOME location.

    Edit the last line to point to your JRE location.

The default charset on z/OS is EBCDIC. If you wish to view the content of PS_HOME/PSEMAgent/envmetadata/data/search-results.xml, you need to run the following commands: 

cd PS_HOME/PSEMAgent/envmetatda/data
. PS_HOME/psconfig.sh
PS_HOME/bin/psuniconv utf-8 search-results.xml ccsid1047 result.txt

Note:

To change the newline characters, use one of transformations - NewLine LF, NewLine CR, or NewLine CRLF at the end of the command. This utility is available to use in the bin directory.

This comment is also true for PS_HOME/PSEMAgent/envmetadata/data/matchers.xml.

You can find a viewable version of the results in result.txt. You can also FTP (binary) these files to a different machine running a different operating system and view them in any editor.