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 routineReturn 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.