You can filter messages from IBM i job logs and forward them to your chosen targets. To do that, Hub must receive the Job End message (CPF1164) at first, then request collection of the associated job log from the agent. You can choose the jobs from which you wish to collect the logs and the messages from these logs, by LPAR, using the Configuration Tool.
These are the prerequisites that are needed before job logs can be collected and forwarded to a chosen target:
- The jog logs must be going to the system QEZJOBLOG in the QUSRSYS Library.
- QHST must be collected from the LPAR.
- The CPF1164 message must be included in the QHST message filter list.
- Any changes to the QHST collection need to be distributed to the LPARs.
- Any changes to the Job Log Forwarding Filters need to be distributed to the LPARs.
See Phase 3: Add, Modify, and Distribute Message Queues and Message IDs for details on how to configure the QHST collection.
Once Hub receives a CPF1164 message for a job that is listed in a Job Log Forwarding filter associated with an LPAR, it will request the log from the agent, giving it these parameters:
- Job Name
- Job ID
- Job User
The agent sends records that meet the message filtering constraints to Hub which processes the raw records, creates JSON formatted records and sends them to the target.