Ensuring a Complete Log

When the programmable operator facility routes a message to the logical operator, the message contains the user ID of the sender. The operator, in responding to the message, may choose to send a message directly to the user without going through the programmable operator facility. However, if this is done, the message is not logged in the log file. To ensure that these messages are logged, the operator should send the message to the user through the programmable operator facility by using the programmable operator facility CMD command. For information about the programmable operator facility CMD command, see CMD.

Whether the message was sent through the programmable operator or not has little significance to the user. However, so that the messages received by the user always have the same ID (the programmable operator facility ID), the message should always be sent from the logical operator through the programmable operator facility.

In a Single System: To route a message through the programmable operator facility where the operator and user are on the same physical system, use the MSG command:

MSG operator CMD MSG user1 - RESPONDING TO YOUR REQUEST

operator
is the user ID of the programmable operator facility virtual machine.
CMD
is the programmable operator facility CMD command.
MSG
is the z/VM® command that the programmable operator facility will execute.
user1
is the user ID of the user who will receive the message.
RESPONDING TO YOUR REQUEST
is the message text sent to the user.

In z/VM Distributed Systems: To route a message through the programmable operator facility where the operator and user are not on the same physical z/VM system, use the SMSG command:

SMSG net1 MSG node1 operator CMD MSG user1 - RESPONDING TO YOUR REQUEST

net1
is the user ID of the network machine at the user's node.
MSG
(first appearance) is the RSCS message command.
node1
is the node ID of the programmable operator facility virtual machine.
operator
is the user ID of the programmable operator facility virtual machine.
CMD
is the programmable operator facility CMD command.
MSG
(second appearance) is the z/VM command that the programmable operator facility executes.
user1
is the user ID of the user to receive the message.
RESPONDING TO YOUR REQUEST
is the message text sent to the user.

In a Mixed Environment: To route a message through the programmable operator facility from the logical operator who is an NCCF or NetView operator to the user on a z/VM system, use PROP, an NCCF and NetView command as follows:

PROP CMD MSG user1 - RESPONDING TO YOUR REQUEST

PROP
is the NCCF or NetView command that sends the message from an NCCF or NetView operator to the programmable operator facility.
CMD
is the programmable operator CMD command.
MSG
is the z/VM command that the programmable operator facility will execute.
user1
is the user ID of the z/VM user who will receive the message.
RESPONDING TO YOUR REQUEST
is the message text sent to the user.
Note: See Helpful Hints for ways to reduce typing of long text strings.