Long description of Figure 1: Making program calls to the server using PCML (rzahh503.gif)
found in IBM Toolbox for Java: PCML Process
This image illustrates how Java applications can interact with the PCML classes.
The image is divided into two areas: an upper portion that represents the Java environment and a lower portion that represents the nonJava part of the PCML process.
- The Java environment (upper portion) includes four shapes labeled "Application," "PCML Classes," "IBM Toolbox for Java Access Classes," and "XML Parser."
- The nonJava part of the process (lower portion) includes two shapes labeled "PCML Source," and "PCML Serialize," and an image of an iSeries server labeled "iSeries DPC Server."
- Arrows that point one or both directions connect the shapes. An arrow that points to both shapes means that the two shapes interact with one another. An arrow that points in only one direction means that the shape pointed to uses the other shape in some way.
The Java application interacts with the PCML classes. In this example, the application creates a ProgramCallDocument object.
When the ProgramCallDocument is constructed, one of two things happens:
- The XML parser parses the PCML source files and passes the information to
the PCML classes. The PCML source files describe the interfaces to the iSeries
programs called by your Java application.
- Serialized PCML information is passed to the PCML classes. Using serialized
PCML improves run-time performance because the PCML has already been parsed.
If you choose to serialize your PCML source, you must do so when you build
your application.
The PCML classes also interact with the Toolbox for Java classes, which in this example use the iSeries distributed program call server to retrieve information from the server.
These actions and interactions enable information to pass between the Java application and iSeries programs.