Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (F)
Guardian Procedure Calls Reference Manual—522629-013
5-222
FIXSTRING Procedure
modification-status output
INT:ref:1
returns an integer value as follows:
0 No change was made to
data.
1 A replacement, insertion, or deletion was performed on
data (see
“Considerations”).
Condition Code Settings
< (CCL) indicates that one or more of the required parameters is missing.
= (CCE) indicates that the operation completed successfully.
> (CCG) indicates that an insert or replace would have caused the
data string to
exceed the
maximum-data-len.
Considerations
•
template considerations
A character in
template is recognized as the beginning of a subcommand if it is
the first nonblank character in
template, the first nonblank character following “//,”
or the first nonblank character following a “D” subcommand. Otherwise, it is
considered part of a previous subcommand.
Note that a subcommand may immediately follow “D” without being preceded by
“//.”
If a subcommand begins with “R,” “I,” or “D,” it is recognized as an explicit
command. Otherwise, it is recognized as an implied replacement.
The action of the subcommands is as follows:
•
R (or r) for “replace”
This subcommand replaces characters in
data with replacement-string
on a one-for-one basis. Replacement begins with the character corresponding
to R. The
replacement-string is terminated by the end of template or
by a “//” sequence in
template. Trailing blanks are considered part of the
replacement string (that is, blanks are not ignored).
•
Implied replacement
A subcommand that does not begin with “R,” “I,” or “D” is recognized as a
replacement-string. Characters in replacement-string replace the
corresponding characters in
data on a one-for-one basis.
•
D (or d) for “delete”
This subcommand deletes the corresponding character in
data.
•
I (or i) for “insert”