Map name (mapName)

Because IMS Connect uses IMS OTMA to access IMS, MFS online formatting is bypassed. The mapName field is used by the IMS TM resource adapter to process requests from Java™ applications whose input and output messages are formatted based on MFS message definitions. The mapName field is not for use directly by Java applications. For reference purposes, the following is a brief description of how the mapName field is used by the IMS TM resource adapter.

For input messages, the value of the mapName property is the name of an MFS message output descriptor, or MOD. The MOD name is provided to the IMS application program in the I/O PCB as the default MODNAME. You can overwrite this default value in your IMS application program. The IMS application program can either use this default MODNAME from the I/O PCB or override that value and use a different MODNAME of its choice.

In general, for output messages, the value of the mapName property is the name of an MFS message output descriptor (MOD). Depending on how the IMS application is programmed, this MOD name can be set in different ways. The IMS application program can specify a different MODNAME when it inserts the transaction output message to the I/O PCB. If the IMS application program does not specify a different MOD name for use in the output message, the value of the mapName property from the input message will be used as the value of the mapName property in the output message. If a mapName value was not provided in the input message and the IMS application does not set a value in the MODNAME field in the I/O PCB for use in the output message, IMS placse the default IMS MOD name in the mapName field of the output message.