Notes for IBM i users

To receive a Reference Message using the sample message exit, specify a file in the root file system of IFS or any subdirectory so that a stream file can be created.

The sample message exit on IBM i creates the file, converts the data to EBCDIC, and sets the code page to the system code page. We can then copy this file to the QSYS.LIB file system using the CPYFRMSTMF command. For example:

CPYFRMSTMF FROMSTMF('JANEP/TEST.TXT')
TOMBR('qsys.lib.janep.lib/test.fie/test.mbr') MBROPT(*REPLACE)
CVTDTA(*NONE)

The CPYFRMSTMF command does not create the file. We must create it before running this command.

If you send a file from QSYS.LIB, no changes are required to the samples. For any other file system ensure that the CCSID specified in the CodedCharSetId field in the MQRMH structure matches the bulk data that we are sending.

When using the integrated file system, create program modules with the SYSIFCOPT(*IFSIO) option set. To move database or fixed-length record files, define your own exit based on the supplied sample AMQSXRM4.

The recommended method of transferring a database file is to convert it to IFS structure, using the CPYTOSTMF command, and then send the Reference Message attaching the IFS file. If you choose to transfer a database file by referring to it from within IFS, but do not convert it to IFS structure, we must specify the member name. Data integrity is not guaranteed if you choose this method.

Parent topic: The Reference Message sample programs