insightgetscenattach
insightgetscenattach |
Purpose
Retrieves an attachment from the Insight server either for a given scenario, placing it in the Mosel working directory where it can be read by the model.
Synopsis
procedure insightgetscenattach(filename:text)
procedure insightgetscenattach(filename:text, scenariopath:text)
Arguments
|
filename
|
The filename of the attachment to be retrieved.
|
|
scenariopath
|
The path of a scenario. A scenario path is the full path to a scenario name starting from the repository root and including the app name. E.g. /myapp/FolderA/FolderB/myscenario If the scenario path is not specified, the attachment is retrieved for the current scenario.
|
Example
Example of copying a scenario attachment called
myattach.dat to the working directory.
insightgetscenattach('myattach.dat')
if insightattachstatus=INSIGHT_ATTACH_OK then
initializations from 'myattach.dat'
MY_ARRAY
end-initializations
else
writeln("Error retrieving attachment")
end-if
Getting an attachment for the current scenario.
insightgetscenattach('myattach.dat', '/myapp/FolderA/FolderB/myscenario')
if insightattachstatus=INSIGHT_ATTACH_OK then
initializations from 'myattach.dat'
MY_ARRAY
end-initializations
else
writeln("Error retrieving attachment")
end-if
Getting an attachment for a scenario with path /myapp/FolderA/FolderB/myscenario.
Further information
1. Check the attachment status code using
insightattachstatus to determine whether the attachment was successfully fetched.
2. Attempting to access attachments when the model is not being run through Xpress Insight will cause the model to abort with an error.
Related topics