IEB REXX procedure (Batch Edit)

The REXX Procedure run by Batch Edit calls IEB functions to process the database with or without a view.

Using a view, you have limited control over how FM/IMS can navigate the IMS database. By specifying Selection Criteria in the view, FM/IMS only returns the IMS segments that match the selection criteria specified.

The IEB calls available when using a view are:
DELIMS
Delete the current IMS segment.
GETIMS
Retrieve IMS segments using the view specified.
ISRTIMS
Insert a segment under the current IMS segment.
PRINT
Print an IMS segment in CHAR, HEX, SNGL, or TABL format.
REPLIMS
Replace the current IMS segments data.
SETRC
Set the IEB job step return code.
VIEWIMS
Create and load a view to be used by the REXX procedure to retrieve IMS segments.
VIEWPOSN
Position on an IMS segment prior to invoking the GETIMS call. This allows you to start processing the IMS database from a point within the database.
When not using a view, you can navigate the IMS database using the GETIMS call. This mode is similar to issuing IMS calls within a program. You can:
  • Retrieve segments based on the segments key values.
  • Retrieve a segment's children.
  • Position on a segment's parent or its root segment.
  • Insert or update an IMS segment using criteria specified by means of the WHERE clause.

The IEB calls available when not using a view are:

DELIMS
Delete the current IMS segment or the IMS segment specified by the WHERE clause.
GETIMS
Retrieve IMS segments.
ISRTIMS
Insert a segment either under the current IMS segment, or under the IMS segment specified on the WHERE clause.
PRINT
Print an IMS segment in CHAR, HEX, SNGL, or TABL format.
REPLIMS
Replace the current IMS segment or the IMS segment specified on the WHERE clause.
SAVEIMS
Save the IMS data. Issuing this call causes you to loose the position in the IMS database. GETIMS calls are required to re-establish the position in the database.
SETRC
Set the IEB job step return code.
VIEWIMS
Create and load a view to be used by the REXX procedure. When not processing the database using a view, FM/IMS uses the IMS segment layouts and fields in the view to:
  • Print in SNGL or TABL format.
  • Generate an IMS SSA when retrieving an IMS segment and the WHERE clause specifies fields from the view.

Related topics