HCL Workload Automation, Version 9.4

The MAgent configuration file

About this task

The MAgent configuration file is named <TWShome>/MAgent.conf. Use it to configure the agent on each workstation. Its contents are described below.
# comment
A comment line.
OPTIONS=MASTER|OFF
If set to MASTER, the agent on this workstation sends the job scheduling events read from the MAGENT.P file as SNMP traps. If set to OFF , no job scheduling traps are generated by this workstation. If omitted, it defaults to MASTER on the master, and OFF on other workstations.

This variable is required only if the master will not be used to generate job scheduling traps for the network. For example, if the master is not a managed node (no agent is installed), you should set this variable to MASTER on a backup master that has an agent installed.

EVENT= n [ n ...]
The list of events to be sent as SNMP traps. With the exception of events 1, 52, and 53, traps will not be generated unless the corresponding events are turned on in the BmEvents configuration file. Event numbers must be separated by at least one space. If omitted, the events sent as traps by default are: 
1 52 53 54 101 102 105 151 152 155 201 202 203 204 252

Event 1 (magent restarted) cannot be turned off.

If this parameter is included, it completely overrides the defaults. To remove only event 102 from the list, for example, you must enter the following: 
EVENT=1 52 53 54 101 105 151 152 155 201 202 203 204 252

See Table 1 for a description of events.

+name [pidfilename]
By default, the list of processes monitored by the IBM Workload Scheduler/NetView agent contains the following processes: magent, netman, mailman, batchman, jobman, all mailman servers, all writers, and all extended agent connections. Use this syntax to add processes to the list. If it is not a HCL Workload Automation process, you must include its PID file name. Some examples are: 
+SENDMAIL /etc/sendmail.pid
+SYSLOG /etc/syslogd.pid
-name
Use this syntax to remove processes from the list of monitored processes. To remove writer processes, use this form: 
- cpuid :writer
For example, to remove the writers for all workstations with ids starting with SYS, enter: 
 -SYS@:WRITER
To remove all writers, enter: 
 -@:WRITER
To remove mailman servers 5 and A, enter: 
 -SERVER5
 -SERVERA
To remove all mailman servers, enter: 
-SERVER@
An MAgent configuration file is included with the IBM Workload Scheduler/NetView software. It contains only comment lines with no parameters set. This causes SNMP traps to be generated as follows:
  • If installed on the master, traps are generated for job scheduling events (101-252) on all workstations in the network. If installed on any other workstation, no job scheduling traps are generated.
  • The following events result in SNMP traps: 
    1 52 53 54 101 102 105 151 152 155 201 202 203 204 252
  • The following processes are monitored: magent, netman, mailman, batchman, jobman, all mailman servers, all writers, and all extended agent connections.