CALL action will execute the call of the
RPC (RPCX) procedure with the name
ProcName. The procedure name is followed by a list of comma-separated parameters.
The number of parameters (and their types) must be equal to the number of parameters of the called procedure (if the number is not equal, the _ERR_INV_NUM_PARAMS* exception is generated).
If some parameter is specified as an input-output one in the procedure declaration, the corresponding parameter, during the procedure call, must not be a constant (if an error occurs, there will be generated the exception _ERR_SET_CONST).
procIdent is a reference to an object of Process type, where the object procIdent is opened. For the object of Event type, it is the D2000 EventHandler process, which is its parent or process on which the called Event is opened (the OPENEVENT action). For an object of Picture type, it is the D2000 HI process, where is this picture opened in.
If the required object is not opened in the given process, the script generates the_ERR_OBJECT_NOT_FOUND* error.
The INSTANCE parameter determines the instance number of the object (picture or event).
If a local variable of RefId type is used for the objIdent identifier, the INSTANCE and ON parameters are not admissible (their value are given by the calling context).
If RPC procedure is called between Local and Remote part of "Client and Server Event" configuration (HIS Server), objIdent is not used.
CALL [] ProcName [(paramIdent1 [,paramIdent2]...)] ...
The errors signed by the symbol * are generated in the called script. Called script (CALL action) can detect this error only during synchronous call and during the notation of action with an assignment. If an error occurs, its code will be assigned to the variable _ret that must be of INT type.
For possible types of parameters, see the action PROCEDURE.
The call of the BROADCAST type is always asynchronous. The process name (the procIdent parameter) is a keyword ALL. By performing this call, the system distributes automatically a request to execute the procedure to all running processes of D2000 HI or D2000 Event Handler. These processes search all instances (or basic objects) of the scripts that are identified by the objIdent parameter and generate the requests to execute the ProcName procedure with the specified parameters.
The keyword INSTANCE is disabled in this type of call.
Since the D2000 V8.00.008 R9, the CALL action contains a new feature - optimization of the formal parameter transmission. This feature ensures the formal parameter of RPC procedure is a "link" to the real parameter. This causes the increasing of the speed of RPC procedure call.
The conditions are:
- The call is realized in the same process *.EVH,
- the call of the procedure is synchronous,
- the parameter must be of Record type,
- the parameter must be IN/OUT.
The keyword
PRTY enables setting the priority of executing the RPC procedure. The priority is defined by the
prtyIdent parameter after
PRTY keyword.
RPC procedures are also support transfer of
data containers and handles to
database connections.
When calling JAPI process procedures, these rules apply:
- objIdent is an empty object (see the example),
- the INSTANCE keyword cannot be used,
- RPC procedure, which is an implementation of ESL interface, cannot be called,
- the process identifier (procIdent) must be of IC_HOBJ_EXPR (expression of HOBJ type) type,
- the receiving of calls in a JAPI process must be implemented as listener, which is registered by a D2Session::setRPCListener method.
0 komentárov