Now that the environment should be setup, the next step is to open the sample solution file in Visual Studio, build it, and execute the sample job stream.
- Start Enterprise Developer and open the
mqsdemo.sln sample solution file. By default, this is located at
%PUBLIC%\Documents\Micro Focus\Enterprise Developer\Samples\OPEN-PLI\MQSDemo\.
Note: The PL/I
-bigendian compiler option is required for compatibility with the MQ APIs. This is because the MQ API return codes, lengths, etc. are in bigendian format. In the Visual Studio IDE PL/I Compiler options are set as directives and the
Endianness directive is set to
-bigendian for the applicable PL/I projects in the MQSDEMO solution. To view set compiler directives at the project level, double-click the
Properties node in the Solution Explorer for a project, then in the
Properties pane that appears, select the PL/I tab to view the directives and their values.
- To build the project, right-click on the
mqsdemo project it in the Solution Explorer and choose
Rebuild.
- Verify that each of the programs were built successfully. Note that the build option
bigendian is needed for proper compatibility with the MQ APIs. As the MQ API return codes, lengths, etc. are in bigendian format, this build option is needed for proper operation with PLI programs.
- Execute the PLI sample application by submitting the JCL stream
mqonly.jcl from the mqsdemo project in the Solution Explorer. Verify that all the RESULTS DDs for each step of the job execution say "TEST SUCCEEDED". Detailed execution log data can be found in the corresponding LOGFILE DD for each step as well.
Note: Comments in the project
.pli file,
mqplidrv.pli, provide useful information on how MQ functions can be used from PL/I.