Data exit program requirements-OPM - assure_mimix - 10.0

Assure MIMIX Promoter User Guide

Product type
Software
Portfolio
Integrate
Product family
Assure
Product
Assure MIMIX™ Software
Version
10.0
Language
English
Product name
Assure MIMIX
Title
Assure MIMIX Promoter User Guide
Topic type
How Do I
Copyright
2021
First publish date
1999
ft:lastEdition
2023-08-01
ft:lastPublication
2023-08-01T14:40:24.932940

Due to the limitations of pointer use in some OPM languages, additional parameters must be passed to an OPM program. The first four parameters are identical and the data area structure pointed to by the fourth parameter is identical to those passed to an ILE program. Additional parameters have been added to the call of an OPM data exit program. These parameters duplicate some of the fields in the data area structure.

The Copy Active File (CPYACTF) process determines if a data exit program is ILE or OPM prior to calling the data exit program. If the data exit program is OPM the CPYACTF process includes the additional parameters on the call to the data exit program.

Use this style of programming when you want to write an externally called exit program. This has the advantage of simplicity and allows OPM languages to be used for the exit program. The disadvantage is runtime processing speed, since an external call will be made at each user exit point.

Table 9 identifies parameters that are passed to the data exit program:

Data exit program parameters - OPM

Parameter

Field

Format and size

1

Data exit point identifier

CHAR(4)

2

Data area structure version string

CHAR(4)

3

Length of the data area structure

INTEGER

4

Data area structure

Pointer to the data area structure

5

Source member name

CHAR(10)

6

Source data buffer

Bytes of the length specified in the Source buffer length field of the data area structure.

7

Source null map

Bytes of the length specified in the Source null map length field of the data area structure.

8

Target member name

CHAR(10)

9

Target data buffer

Bytes of the length specified in the Target buffer length field of the data area structure. (This field must be set by the data exit program)

10

Target null map

Bytes of the length specified in the Target null map length field of the data area structure. (This field must be set by the data exit program)

11

Default target data buffer

Bytes of the length specified in the Target buffer length field of the data area structure.

12

Default target null map

Bytes of the length specified in the Target null map length field of the data area structure.