Initializing help system before first use

dmpinitwebservice

dmpinitwebservice


Purpose
Initialize a dmpresource to access a DMP webservice.
Synopsis
procedure dmpinitwebservice(res:dmpresource, functionid:text)
procedure dmpinitwebservice(res:dmpresource, id:text, functionid:text, env:text)
Arguments
res 
The dmpresource value to initialize.
id 
The ID of the solution service you want to access (or empty string)
functionid 
The ID of the function you want to access, ie the function name (or an empty string)
env 
The lifecycle stage of the service you want to access (or empty string), one of:
DMP_ENV_DESIGN 
Design or Root
DMP_ENV_STAGING 
Staging
DMP_ENV_PRODUCTION 
Production
Example
declarations
  res: dmpresource
end-declarations
dmpinitwebservice(res,"getBestPolicy")
if res.status<>DMP_OK then
  writeln('ERROR: ',res.lasterror)
end-if
Further information
1. This procedure will initialize a dmpresource to access a DMP function deployed as a SERVERLESS_REST type solution service.
2. You can pass an empty string if you don't want to specify any of the arguments, but you must specify at least one of id and functionid.
3. The functionid value is usually the function name.
4. If you don't specify a lifecycle environment, the lifecycle of the component executing the model will be used.
5. You should check the status attribute of the dmpresource after calling this procedure.