Utility for creating conversion-exit code

The commands for creating conversion-exit code are:

i5/OS
CVTMQMDTA (Convert WebSphere MQ Data Type)
Windows systems and UNIX systems
crtmqcvx (Create WebSphere MQ conversion-exit)
z/OS
CSQUCVX

The command for your platform produces a fragment of code that performs data conversion on data type structures, for use in your data-conversion exit program. The command takes a file containing one or more C language structure definitions. On z/OS, it then generates a data set containing assembler code fragments and conversion functions. On other platforms, it generates a file with a C function to convert each structure definition. On z/OS, the utility requires access to the LE/370 run-time library SCEERUN.

Invoking the CSQUCVX utility on z/OS

Figure 13 shows an example of the JCL used to invoke the CSQUCVX utility.

Figure 13. Sample JCL used to invoke the CSQUCVX utility
//CVX    EXEC PGM=CSQUCVX
//STEPLIB  DD DISP=SHR,DSN=thlqual.SCSQANLE
//         DD DISP=SHR,DSN=thlqual.SCSQLOAD
//         DD DISP=SHR,DSN=le370qual.SCEERUN
//SYSPRINT DD SYSOUT=*
//CSQUINP  DD DISP=SHR,DSN=MY.MQSERIES.FORMATS(MSG1)
//CSQUOUT  DD DISP=OLD,DSN=MY.MQSERIES.EXITS(MSG1)

z/OS data definition statements

The CSQUCVX utility requires DD statements with the following DDnames:

SYSPRINT This specifies a data set or print spool class for reports and error messages.
CSQUINP This specifies the sequential data set containing the definitions of the data structures to be converted.
CSQUOUT This specifies the sequential data set where the conversion code fragments are to be written. The logical record length (LRECL) must be 80 and the record format (RECFM) must be FB.

Error messages in Windows systems, and UNIX(R) systems

The crtmqcvx command returns messages in the range AMQ7953 through AMQ7970. These are listed in WebSphere MQ Messages.

There are two main types of error: