Previous Topic: Format of DataNext Topic: Macros for Input Modules


Parameters Passed to Input Modules

Runtime mapping loads the specified user-written edit module from the CA IDMS/DC. load library. The address words placed in the parameter list summarized in the following table are referenced from CA IDMS/DC off the address passed in register 1.

Address words 9 and 10 are passed in the parameter list for online maps only. They are not passed for file maps.

Address word 9 points to the first byte of input data for the field in the work area. If the user module is used in conjunction with automatic editing, this is the work area that must be referenced.

If automatic editing is not used, the user edit module can access data for the field using either address word 4, which references the data in the data stream, or address word 9, which references the data after it is moved to the work area. (IBH DSECT)

Address Word

Data Element

1

Data field in target data record (output)

2

Header for the next input buffer in the buffer chain (IBH DSECT)

3

End of current input buffer

4

Start of data for the field in the input buffer (data stream)

5

Map Request Element for the field (MRE DSECT)

6

Map Control Element for the field (MCE DSECT)

7

Physical Terminal Element (PTE DSECT)

8

Map Request Block (MRB DSECT)

9

Start of data in the field, in the work area (start of input)

10

Last byte of data for the field, in the work area (end of input)

Note: Address words 9 and 10 are passed in the parameter list of online maps only.

Input data can be placed in a single input buffer or can overflow in a chain of noncontiguous input buffers. The length, in bytes, of the unedited input data is stored in the MREINLEN field in the Map Request Element (address word 5). The fourth address word points to the first byte of the input data in the current input buffer.