Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Language Reference Manual

STRINGRANGE condition

Status
STRINGRANGE is disabled throughout the program, except within the scope of the STRINGRANGE condition prefix.
Result
The value of the specified SUBSTR is altered.
Cause and syntax
The STRINGRANGE program-checkout condition is raised whenever the values of the arguments to a SUBSTR reference fail to comply with the rules described for the SUBSTR built-in function. It is raised for each reference to an invalid argument.
Read syntax diagramSkip visual syntax diagram>>-STRINGRANGE-------------------------------------------------><
 
Abbreviation
STRG
Implicit action
A message is printed and processing continues as described for normal return.
Normal return
Execution continues with a revised SUBSTR reference for which the value is defined as follows:

Assuming that the length of the source string (after execution of the ON-unit, if specified) is k, the starting point is i, and the length of the substring is j:

This means that the new arguments are forced within the limits.

The values of i and j are established before entry to the ON-unit. They are not reevaluated on return from the ON-unit.

The value of k might change in the ON-unit if the first argument of SUBSTR is a varying-length string. The value n is computed on return from the ON-unit using any new value of k.

Condition code
350

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)