z/OS Communications Server: IP Programmer's Guide and Reference
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Guidelines for POLL results

z/OS Communications Server: IP Programmer's Guide and Reference
SC27-3659-02

  • If FCAI-Result contains FCAI-Result-Status, additional processing is required by the user program:
    • If the FCAI-Status field is FCAI-Status-InProgress, a prior SCMD request issued in no-wait mode or one that exceeded the FCAI-ReqTimer value is still in-progress. Obtain the final results with another POLL request.
    • If the FCAI-Status field is FCAI-Status-PromptPass, the prior request has now completed but the next SCMD request must be a PASS subcommand. This status is applicable for the USER subcommand.
    • If the FCAI-Status field is FCAI-Status-PromptAcct, the prior request has now completed but the next SCMD request must be an ACCT subcommand. This status is applicable for the USER, PASS, and CD subcommands.
    • If FCAI-Status contains FCAI-Status-TraceFailed or higher, the interface trace function failed on this request. Subtract FCAI-Status-TraceFailed from FCAI-Status to obtain the remaining value for FCAI-Status. See FCAI_Status_TraceFailed and FCAI_TraceStatus: Reporting failures in the interface trace function for information about FCAI-Status-TraceFailed.
  • Aside from interface errors, POLL itself returns only FCAI-Status-InProgess. All other results are those of the prior SCMD request.
  • If the application issues POLL until FCAI-IE-NotInProgress is returned, the results from the prior subcommand are lost. Issue POLL only until FCAI-Status-InProgress is no longer returned.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014