More about Service COM rules
|
|
Important: The rule type rule-service-COM is deprecated. As appropriate, migrate to Service dotNET rules.
03-04 C-583 See About Service Package data instances for information on generating a Windows Dynamic Linked Library file from Service COM rules.
On the PRPC server, the prSOAPServlet
servlet implements Service COM rules. This runs as a background requestor with the APP requestor type (Data-Admin-Requestor class).
When you use Service COM, your Windows applications or third-party Windows applications can start PRPC activities with one-line calls. (Though not visible to the caller, messages between the DLL control and PRPC use SOAP over HTTP protocol.)
For each activity of a package, the generated DLL includes a public method that matches the activity's name. Similarly, method arguments match the activity parameters in quantity, order, and data type. In addition to these public methods, the DLL has four exposed public properties (all strings):
sZeusServer
— URL of an available PRPC serversPortNumber
— The TCP/IP port number dedicated to PRPC HTTP requestssLoginName
— PRPC user namesLoginPassword
— PRPC user passwordYou can distribute the generated DLL files to third-party application writers. These DLL files can be used as building blocks in Web-based or stand-alone Windows applications. At runtime, when a third-party application starts a public method with a specific activity and specific argument values, the following sequence of events starts (under the DLL wraps). These events are not visible to the application calling PRPC.
/prweb/PRSOAPServlet
.Some applications require a synchronous request to a Windows executable rather than incoming service requests. See How to call a Windows DLL.
You can trace the operation of a Service COM rule and the service activity it calls. See Tracer tool — Tracing services.
Through changes the prlogging.xml
file, you can obtain performance statistics on the execution of services. See Performance tool — Statistics for services.
![]() |
COM, service |
![]() |
About Requestor type data instances |
![]() |
Atlas — Standard Service COM rules |