Polls for data from the CICS® server.
Ccl::Bool poll()
For deferred synchronous transmissions (that is, if a deferred synchronous CclSession object was used on a previous send call) the poll method is called by the application when it wants to receive data from the CICS server. If a reply from CICS is ready, the CclTerminal object updates the CclScreen object with the contents of the 3270 data stream received from CICS, the handleReply virtual function on the CclSession object is called, and the poll method returns Ccl::yes. If no reply has been received from CICS, the poll method returns Ccl::no.
The poll method is used only for deferred synchronous transmissions; a syncType exception is raised if the poll method is called when a synchronous or asynchronous session is in use. An invalidState exception is raised if the poll method is called when there was no previous send call. The CclTerminal object must be in server state for poll to be called.
A CICS server transaction can send more than one reply in response to a CclTerminal send call. More than one CclTerminal poll call can therefore be needed to collect all the replies. Use the CclTerminal state method to find out whether further replies are expected. If there are, the value returned will be server. See EPI call synchronization types.