Guardian Procedure Calls Reference Manual

The form of template is:
template={ subcommand // ... }template = { subcommand // ... }
subcommand =
{ Rreplacement string } ! replace subcommand
{ Iinsertion string } ! insert subcommand
{ D } ! delete subcommand
{ replacement string } ! implicit replacement
template-len
input
INT:value
is the length, in bytes, of the template string.
data
input, output
STRING:ref:*
on input, is a string to be modified. The resulting string returns in this parameter.
data-len
input, output
INT:ref:1
on input, contains the length, in bytes, of the string input in data. On return, contains the
length, in bytes, of the modified data string in data.
maximum-data-len
input
INT:value
contains the maximum length, in bytes, to which data can expand during the call to FIXSTRING.
If omitted, 132 is used for this value.
modification-status
output
INT:ref:1
returns an integer value as follows:
No change was made to data.0
A replacement, insertion, or deletion was performed on data (see Considerations).1
Condition Code Settings
indicates that one or more of the required parameters is missing.< (CCL)
indicates that the operation completed successfully.= (CCE)
indicates that an insert or replace would have caused the data string to exceed the
maximum-data-len.
> (CCG)
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.
FIXSTRING Procedure 611