VIEWPOSN CALL (Position on an IMS segment)
This IEB call positions on an IMS segment so that the next GETIMS (with USING_VIEW) retrieves
segments starting at this point.
- 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.
- posseg
- The name of the segment you want to position on.
- 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 FM/IMS to search
the segment layouts 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.
- segname
- The name of a segment in the hierarchical path of the segment you want to position on.
Returns zero if successful, otherwise nonzero.
If FM/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 inserting a variable- length segment, then the first two bytes of OUTREC must specify the length of the segment.