found in IBM® Toolbox for Java™:
PCML Process
This image illustrates how Java applications
can interact with the PCML classes.
Description
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 non-Java part of the process (lower portion) includes two
shapes labeled "PCML Source," and "PCML Serialize," and an image of
an IBM i server,
labeled "System i® 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 IBM i 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 IBM Toolbox
for Java classes, which in this example use the IBM i distributed program
call server to retrieve information from the server.
These actions
and interactions enable information to pass between the Java application and IBM i programs.