This IEB call replaces the current segment and must be preceded by
a GETIMS function call with the USING_VIEW parameter.
Figure 1. Syntax
Notes:
1 To use field_ref or field_name, you must have
already loaded a view by preceding this function call with a call to VIEWIMS.
2 Specification of a field_ref without qualification of a
layout_ref results in the field_ref being associated
with the current layout for the repsegm segment.
3 To fully qualify a field name, the layout name must be the first
qualifier specified. If the layout name is not specified,
ZDT/IMS searches the current the layout for the repsegm segment
being replaced. If the group qualifiers and field name are not
found, ZDT/IMS searches all the layouts for the repsegm segment
in relative order until the group qualifiers and field name are
found. If not found, an error message is displayed and processing
terminates.
field_name
A field name.
field_ref
A field reference number of the field within the layout.
This can be obtained by printing the view/template using the
VIEWIMS DESCRIBE clause or browsing the view/template online.
field_value
The value of the field specified by field_ref
or field_name.
layout_ref
The relative number of layout within a segment. This can be obtained
by printing the view/template using the VIEWIMS DESCRIBE clause.
qualifier
One or more qualifiers that identify the field name (field_name).
The first qualifier is the segment layout name. Subsequent qualifiers
(if any) are the group fields used to identify the specified field name.
Omitting the layout name or group fields causes ZDT/IMS to search the
current repsegm segment layout for the specified qualifiers and field
name. If not found, then all repsegm segment layouts are searched
for the specified qualifiers and field name.
Note: The layout names and group fields can be obtained by printing
the view/template using the VIEWIMS DESCRIBE clause or browsing the
view/template online.
repsegm
The name of the segment you want to replace.
Returns zero if successful, otherwise nonzero.
If ZDT/IMS encounters an unavailable HALDB partition or DEDB area, the
DELIMS function receives a return code of 8 and the ISPF variable FMSTATUS
indicates an IMS status code of:
FH
Unavailable DEDB area
BA
Unavailable HALDB partition
To replace the current contents of the segment with the contents of the
OUTREC variable, omit the SET clause. If you are replacing a variable-
length segment, then the first two bytes of OUTREC must specify the length
of the segment. Otherwise, use the SET clause to specify replacement field
values for the segment.
When you use OUTREC, you replace the entire contents of the segment. When
you use the SET clause, you can replace only the field values that you
specify; other field values remain unchanged.