Running the WebSphere MQ on TPF configuration monitoring extension
Controlling the WebSphere MQ on TPF configuration monitoring extension
- Open a command prompt and change to the directory containing the distributed files.
- Enter the monitoring extension command qptpfwmq followed by the required command parameter.
To list all available command parameters, enter:
qptpfwmq --help
For example, qptpfwmq --start starts the monitoring extension.
Specifying TPF host profiles
Before you can monitor a TPF host or hosts, specify the TPF host profiles.
Three methods exist for specifying TPF profiles. These are:
In the command prompt:
Enter qptpfwmq --addhost [TimeOut-millisecs] [Connections-num_conns] [EncodingCharset-charset] [ScrollDisplayTerminator-hex_char]
From a file:
- Create and save a test file that includes all the TPF hosts to be added. Each host must have a unique port number.
- To run the file, enter:
qptpfwmq --addhost -f filename
where:
filename is the file containing the TPF host definitions
In the configuration file:
- On the Windows system open the configuration file in a text editor.
Specify each of the TPF hosts you want to monitor by using the values described in the table below. Each TPF host profile must begin with the [TpfHost] stanza (see below). The host name and port number are required, all other parameters are optional.
The host profile is described in the TPFHost stanza as shown below.
TPF host stanza sample
[TpfHost]
Description - TPF host emulation on LONDON
Host - 10.49.3.44
Port - 12345
EncodingCharset - IBM500
Connections - 5
TimeOut - 10000
Key | Value |
---|---|
Connections | Number of parallel connections the monitoring extension uses when retrieving values from the TPF host. Connection number relates to the configuration setting of the IPBridge set up on the TPF Host. If no connection number is stated, the default is 1. |
Description | Description of the TPF Host |
EncodingCharset | Character set the monitoring extension uses for ASCII/EBCDIC conversion when communicating with the TPF host. If no encoding character set is stated, the monitoring extension uses an internal default translation table. |
Host (required) | Name or IP address of the TPF host |
Port (required) | TCP/IP port number that the TPF Host/IPBridge receives requests through. This is not the same as the WebSphere MQ listener port |
PutLevel | Put Level of the TPF system. For PutLevel 17, 18, 19, or 20 set the value to 17. For PutLevel 21 or 22 set the value to 21. |
ScrollDisplayTerminator | Character the TPF system uses to terminate its scroll display output in two-character hex notation as defined by the local character set. This parameter is optional. The default is a vertical bar not the number one [1] or the lowercase L [l].) NOTE: Use the character as encoded due to the character set on the system running the TPF monitoring extension. Do not use the character set used by the TPF system. For instance, ScrollDisplayTerminator-7C denotes the scroll display terminator to be a vertical bar '|' in the character set ISO-8859-1. ScrollDisplayTerminator-29 denotes the scroll display terminator to be a closing bracket ')' in the character set ISO-8859-1. |
TimeOut | Timeout in milliseconds. After this period has passed, the monitoring extension stops waiting for a response to a request sent to the TPF host. If the value is set to -1 or omitted, the monitoring extension waits forever for a response. |
Removing TPF host profiles
- To remove a TPF host definition from the command prompt, enter:
qtpfwmq --removehost host -host port -port
where:
host is the name of the host you wish to remove.
port is the number of the port the host exists on.
- To remove a TPF host definition using a file, enter:
qptpfwmq --removehost -f filename
where:
filename is the file containing the TPF host definition