Remote Procedure Call from TSO to the SA NetView Agent

Any REXX program that runs under TSO can use the function INGRCRPC to send a NetView command or an MVS command to the local SA NetView Agent and to wait for the command execution. The response of the command will be returned into a REXX stem.

The TSO address space and the SA NetView Agent must reside on the same z/OS system. Before you use the function INGRCRPC, it's required that the command receiver is started on the SA NetView Agent, for example, via the following command:

INGRCRCV START PPI=ppi_rcv_id OPF=AOFCMDOPER

In this command, the PPI parameter specifies the PPI receiver ID, which must be equal to the ppi_rcv_id parameter of INGRCRPC. The SA command receiver runs in the SA NetView Agent and uses a PPI receiver ID to receive incoming remote procedure call (RPC) requests. Any RPC request sent by INGRCRPC will be scheduled on a NetView task for command execution. The OPF parameter specifies the name of the SA operator function, which is either a single task or a group of tasks, for example, AOFCMDOPER. For a detailed description of the command receiver, see Command Receiver.

Note:

If you start multiple command receivers, then for each command receiver, you need a unique pair of a PPI receiver ID and corresponding SA operator function.

Sending multiple requests via INGRCRPC concurrently is not supported from the same TSO address space. Requests must be sent one after another.