Agents › DevTest LPAR Agent › LPAR Agent Operation

LPAR Agent Operation

Starting the DevTest LPAR Agent

In a typical operation, the LPAR Agent is set up as a started task and is started when the LPAR IPLs. The standard MVS START operator command (‘S’) can be used to start the LPAR Agent explicitly.

Stopping the DevTest LPAR Agent

The LPAR Agent responds to the standard MVS STOP operator command (‘P’). You can also stop the agent by issuing the “SHUTDOWN” message through the management socket connection or through the MVS MODIFY operator command (‘F’). The LPAR Agent terminates identically for each technique.

Monitoring and managing the LPAR Agent

The LPAR Agent can be monitored and managed to a limited extent through standard MVS operator commands.

To use standard MVS operator commands, issue the requests to the LPAR Agent using the MODIFY command (‘F’). The response is written to the console log. The supported LPAR Agent commands are:

?

Displays a list of available commands.

Usage: F LPARAGNT,?

L

Lists the current connections and the associated connection IDs.

Usage: F LPARAGNT,L

T

Toggles packet tracing.

Usage: F LPARAGNT,T <id> <state>

<id>

Defines the connection ID found in the "L" command.

<state>

(Optional) Specifies the state of the packet trace for a connection.

Issuing the T command without the state returns the tracing state for that connection.

Values: "ON" and "OFF"

SHUTDOWN

Shuts down the LPAR Agent.

Usage: F LPARAGNT,SHUTDOWN

The following output is an example of the L command:

F LPARAGNT,L

+ITKO9003 - Command accepted

+ID    Type IP              Port         In       Out  Connected

+3     AT   192.168.0.100   6891          1         0  12/15/11 09:38:44

+4     A    192.168.0.100   6892          1         0  12/15/11 09:38:45

The Type is A for "agent connection" or C for "client connection". If a T follows the A or C, it means that packet tracing is enabled for that connection. The IP address and Port number identify the source of the connection. In and Out show the number of packets that were received from and sent to the peer, respectively. The Connected date and time shows when the connection was created. The Connected date and time use the time zone value that is specified on the PARM of the proc EXEC statement.

The following output is an example of the T command:

F LPARAGNT,T 3

+ITKO9003 - Command accepted

+Tracing for ID 3 is ON

F LPARAGNT,T 3 OFF

+ITKO9003 - Command accepted

+Tracing for ID 3 is now OFF