method ApiDaemonIsRunning

Description

This method can be used to check whether a daemon is running on the central server. It internally makes sure the daemon updates its own status to reflect the real processes running on the system, before it checks the status. It returns the number of instances active for the daemon in an output paramter.

Parameters

oiNumberOfInstances	output	integer	Number or running instances (processes) for the daemon.
oiReturnStatus	output	integer	Return status of the method.

Internal usage

BLF

method BReportRequest.ValidateComponent

program code (program3/bbasedaemon.p)

<M-1 run ApiValidateStatus  (output viFcReturnSuper (oiReturnStatus)) in BBaseDaemon>
if viFcReturnSuper <> 0
then oiReturnStatus = viFcReturnSuper.
if viFcReturnSuper < 0
then return.

<Q-2 run DaemonInfoLimited (all) (Read) (NoCache)
   (input 0, (DaemonId)
    input vcFcDaemonName, (DaemonName)
    input '', (DaemonStatus)
    input '', (DaemonStatusDiffersFrom)
    output dataset tqDaemonInfoLimited) in BBaseDaemon >
find first tqDaemonInfoLimited no-error.
if not available tqDaemonInfoLimited
then do :
    <M-3 run SetMessage
          (input  substitute(#T-1'Unable to find the daemon based on its name (&1).':255(33)T-1#,vcfcdaemonName) (icMessage), 
           input  '' (icArguments), 
           input  '' (icFieldName), 
           input  '' (icFieldValue), 
           input  'E':U (icType), 
           input  1 (iiSeverity), 
           input  '' (icRowid), 
           input  'BLF-5':U (icFcMsgNumber), 
           input  'In the flow of the program, it seems that information of the daemon cannot be retrieved based on the name of the daemon.  The name of the daemon needs to be checked.':U (icFcExplanation), 
           input  '' (icFcIdentification), 
           input  '' (icFcContext), 
           output viFcReturnSuper (oiReturnStatus)) in BBaseDaemon>
    assign oiReturnStatus = -3.
    return.
end.

assign oiNumberOfInstances = tqDaemonInfoLimited.tiDaemonRunningProcesses.

Sample code: how to call this method through RPCRequestService (QXtend Inbound)

define temp-table ttContext no-undo
    field propertyQualifier as character
    field propertyName as character
    field propertyValue as character
    index entityContext is primary unique
        propertyQualifier
        propertyName
    index propertyQualifier
        propertyQualifier.

define dataset dsContext for ttContext.

define variable vhContextDS as handle no-undo.
define variable vhExceptionDS as handle no-undo.
define variable vhServer as handle no-undo.
define variable vhInputDS as handle no-undo.
define variable vhInputOutputDS as handle no-undo.
define variable vhOutputDS as handle no-undo.
define variable vhParameter as handle no-undo.

/* Create context */
create ttContext.
assign ttContext.propertyName = "programName"
       ttContext.propertyValue = "BBaseDaemon".
create ttContext.
assign ttContext.propertyName = "methodName"
       ttContext.propertyValue = "ApiDaemonIsRunning".
create ttContext.
assign ttContext.propertyName = "applicationId"
       ttContext.propertyValue = "fin".
create ttContext.
assign ttContext.propertyName = "entity"
       ttContext.propertyValue = "1000".
create ttContext.
assign ttContext.propertyName = "userName"
       ttContext.propertyValue = "mfg".
create ttContext.
assign ttContext.propertyName = "password"
       ttContext.propertyValue = "".

/* Connect the AppServer */
create server vhServer.
vhServer:connect("-URL <appserver-url>").

if not vhServer:connected()
then do:
    message "Could not connect AppServer" view-as alert-box error title "Error".
    return.
end.

/* Run */
assign vhContextDS = dataset dsContext:handle.

run program/rpcrequestservice.p on vhServer
    (input-output dataset-handle vhContextDS by-reference,
           output dataset-handle vhExceptionDS,
     input        dataset-handle vhInputDS by-reference,
     input-output dataset-handle vhInputOutputDS by-reference,
           output dataset-handle vhOutputDS).

/* Handle output however you want, in this example, we dump it to xml */
if valid-handle(vhExceptionDS)
then vhExceptionDS:write-xml("file", "Exceptions.xml", true).

if valid-handle(vhOutputDS)
then vhOutputDS:write-xml("file", "Output.xml", true).

/* Cleanup */
vhServer:disconnect().
assign vhServer = ?.

if valid-handle(vhInputDS)
then delete object vhInputDS.

if valid-handle(vhOutputDS)
then delete object vhOutputDS.

if valid-handle(vhExceptionDS)
then delete object vhExceptionDS.