z/OS MVS Programming: Writing Transaction Programs for APPC/MVS
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Rules for Calling Error_Extract

z/OS MVS Programming: Writing Transaction Programs for APPC/MVS
SA23-1397-00

Your TP can call Error_Extract only:
  • For LU 6.2 TP conversation services and CPI Communications TP conversation calls (for a list of supported services, see Overview of Error_Extract Service)
  • For the most recently completed call to a conversation service (Error_Extract cannot return information for previous calls)
  • For a conversation that was accepted or allocated by a TP that shares the same home address space as the caller.
When an error return code is returned to an APPC callable service, APPC/MVS retains the information that Error_Extract returns until one of the following occurs:
  • Your TP calls the Error_Extract service
  • The conversation is deallocated normally (the TP receives deallocated_normal return code)
  • Your TP calls another APPC/MVS TP conversation service for the same conversation
  • The APPC address space is cancelled or restarted.

You should design your TP so APPC/MVS retains the information that Error_Extract returns for as long as it is required.

Recommendation: Do not call another APPC/MVS service after receiving an error return code without first calling Error_Extract.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014