Controlling the TMTM Extensible Agent on i5/OS platforms

Before you begin

Install the TMTM Extensible Agent.

To start the TMTM Extensible Agent on an i5/OS platform

To start qpea, qpcfg, and qpmon, enter the following i5/OS commands:

SBMJOB CMD(CALL PGM(QPASA/QPEA) PARM('--start'))

If the TMTM Extensible Agent does not start, ensure that MAXJOB is set to *NOMAX. The command is: CHGSBSD QBATCH MAXJOBS(*NOMAX)

To stop the TMTM Extensible Agent on an i5/OS platform

The TMTM Extensible Agents continue to run until proactively stopped. Only the user that started a TMTM Extensible Agent can stop it.

Enter the following commands: SBMJOB CMD(CALL PGM(QPASA/QPEA) PARM('--stop'))

You can also use the ENDJOB command to end the executable files in a controlled manner instead of the SBMJOB with the --stop option. If, on the other hand, you use the ENDJOB IMMED, remove the .lock files (qpea.lock, *qpmon.lock, and qpcfg.lock) manually from the root directory of the Integrated File System. If necessary, see your operating system's documentation for details.

To set the default library name

You can run the TMTM Extensible Agent on the i5/OS from a library other than QPASA. You need to properly configure the system environment variable on the target i5/OS to use this feature. If the environment variable QPASALIB is not set, then the default library name is QPASA.

1. Log into the i5/OS system that runs the TMTM Extensible Agents.
2. Enter the following command:
   
   ADDENVVAR ENVVAR(QPASALIB) VALUE(MYQPASA) LEVEL(*SYS) REPLACE(*YES)
   
   where:
   QPASALIB is the name of the environment variable. You cannot change this name.
   MYQPASA is your new library name.
   *SYS identifies this environment variable as a system environment variable.
3. Start the TMTM Extensible Agents.

Use the correct library name when qualifying a called program.

To start a job in a subsystem

To start a job in a subsystem other than the default, use the JOBQ() parameter to the SBMJOB command.

• To start the agent in a subsystem named MYSBS in a library MYLIB, enter the following command: SBMJOB CMD(CALL PGM(QPASA/QPEA) PARM('–start')) JOBQ(MYLIB/MYSBS)

• To create a new subsystem named YOURSBS in a library MYLIB, use the commands:
  
  CRTCLS CLS(MYLIB/YOURSBS) CRTJOBQ
JOBQ(MYLIB/YOURSBS) CRTSBSD SBSD(MYLIB/YOURSBS)
POOLS((1 *BASE)) ADDJOBQE SBSD(MYLIB/YOURSBS)
JOBQ(MYLIB/YOURSBS) MAXACT(10) QSYS/ADDRTGE
SBSD(MYLIB/YOURSBS) SEQNBR(1) CMPVAL(*ANY)
PGM(QCMD) STRSBS MYLIB/YOURSBS

• Ensure that you have sufficient authority on the computer to issue the commands.
• These commands create a subsystem capable of running up to ten jobs simultaneously, which would normally allow you to monitor up to seven different queue managers.
• There are three main jobs (QPEA, QPMON and QPCFG) that must run, and there is an additional job (QPMONSUB) which runs one instance for each queue manager to be monitored.

• If you wish to monitor more than seven queue managers, you would need to increase MAXACT(10) to a suitable number (for example, MAXACT(13) should let you monitor ten queue managers.

  Command parameter	Use to...
  --console	Run the extension program in the foreground, displaying log messages as they are generated. It is useful when trying to locate or troubleshoot problems.
  --help	List the available command prompt options (this list) and short descriptions.
  --start	Start the extension.
  --stop	Stop the extension.
  --version	List the version of the extension.

  Stream file commands

  Command	Description
  WRKLNK	Display all the stream files and directories on the current directory. In IFS, the directory name in the library file system path name is qualified with a .xxx extension. For example, /qsys.lib/qpasa.lib/qpasa.file.
  DSPCURDIR	Display the current default directory. The default can be changed. Usually, the default directory is the root directory /.
  CHGCURDIR	Enter this command to change the current directory. Alternatively, use cd or chdir.
  WRKACTJOB	Enter this command to display the running jobs and to verify that a job started. It also verifies that the agents are running.
  WRKMQM	Enter this command to display the message queue managers currently existing on the i5/OS.
  QMQM (strsb qmqm/qmqm)	This subsystem, QMQM, is available on MQSeries 5.1 and later. It must be running for WebSphere MQ to work. Make sure this is running by typing WRKACTJOB and look for this subsystem name. If it is not running, enter the command, strsbs qmqm/qmqm to start it.
  ENDJOB	ENDJOB *IMMED does not perform a graceful termination of the TMTM Extensible Agent and extensions. If you do use ENDJOB *IMMED, delete the locked files using WRKLNK. ENDJOB *CNTRLD normally performs a graceful shutdown unless the specified delay time is too short. Then you have to manually remove the .lock files from the Integrated File System root directory. The more WebSphere MQ objects being monitored, the longer your delay time should be. The simplest way to stop an agent or extension is to use the --stop command.