z/OS TSO/E Programming Services
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Return codes from verify exit routines

z/OS TSO/E Programming Services
SA32-0973-00

Your verify exit routines must return a code in general register 15 to the Parse Service Routine. This code informs the Parse Service Routine of the results of the check and determines the action that parse should take. Table 1 shows the return codes, their meaning, and the action taken by the Parse Service Routine.

Table 1. Return codes from a verify exit routine
Return code dec(Hex) Meaning
0(0) The operand is valid. No additional processing is performed on this operand by the Parse Service Routine.
4(4) The operand is not valid. Parse prompts the user to reenter the operand and takes the insert for the first-level message from the VEPLMSG1 field in the VEPL. Parse takes the second-level message from the VEPLMSG2 field in the VEPL.
8(8) The operand is not valid. The verify exit routine has issued a message indicating that the operand is not valid; parse prompts the user to reenter the operand. This return code is not valid for cleanup calls.
12(C) The operand is not valid. Parse performs normal processing for a not valid keyword operand by either:
  • Issuing a message indicating that a not valid keyword operand has been entered and prompting the user to reenter the operand. In this case, parse takes the inserts for the first-level message from the VEPLMSG1 field in the VEPL. It takes the second-level message from the VEPLMSG2 field in the VEPL.
  • Issuing a message indicating that extraneous information has been entered. In this case, parse does not prompt the user.

This return code is not valid for cleanup calls.

16(10) The operand is not valid, and the verify exit routine requests that parse terminate. Parse does not issue a message or prompt the user; it sets a return code of 32, and returns to its caller. This return code is not valid for cleanup calls.
20(14) The operand is not valid. Parse issues a message indicating that the operand is extraneous and is ignored. If parse is currently processing a subfield, it skips to the end of the subfield and continues processing. This return code is not valid for cleanup calls.

If the Parse Service Routine receives a return code of 4 or 8, it processes new data entered in response to the prompt as though it were the original data, and passes control again to the verify exit routine. This cycle continues until a valid operand is obtained. After an operand is successfully processed, parse again calls the verify exit for notification of cleanup. Return codes other than 0 or 4 are ignored by parse for cleanup processing.

Prior to issuing a return code of 16, your verify exit routine should issue a message indicating that it has requested that parse terminate.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014