Initializing help system before first use

insightrenamescenattach

insightrenamescenattach


Purpose
Renames an existing scenario attachment.
Synopsis
procedure insightrenamescenattach(oldname:text, newname:text)
Arguments
oldname 
The existing filename of the attachment to be renamed
newname 
The new filename of the attachment. Must not already be used for a scenario attachment.
Example
insightrenamescenattach('myattach.dat','myattach-2015.dat')
if insightattachstatus=INSIGHT_ATTACH_OK then
  writeln("Attachment renamed ok")
else
  writeln("Error renaming attachment")
end-if
Example of renaming an existing attachment of the current scenario from myattach.dat to myattach-2015.dat.
Further information
1. Check the attachment status code using insightattachstatus to determine whether the new attachment name was accepted.
2. The attachment will not be renamed on the Insight server until the scenario completes.
3. 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