Using the DMP Solution Revision Bucket

When using a DMP component such as Xpress Insight or Xpress Executor, in a DMS 3.12+ environment, you can read from the S3 folder for a previously committed solution revision. (A solution revision is created by committing the solution, and a location in S3 will be created to store assets of this revision. This mechanism is frequently used by non-Xpress components to share DMP function implementations and other resources. There is no way to write to a solution revision bucket from an Xpress component.) To use this, call s3init with the return value from calling the function s3solutionrevision with the ID of the solution revision you want to access, e.g.:

model DmpInitExample
  uses "s3"
  parameters
    REVISION_ID="7djfgs9287"
  end-parameters
  declarations
    mybucket: s3bucket
  end-declarations

  ! Initialize mybucket using the 'solutionRevision' set of credentials for revision
  s3init(mybucket, s3solutionrevision(REVISION_ID))
  if s3status(mybucket)<>S3_OK then
    writeln("Bucket initialization error: ", s3getlasterror(mybucket))
    exit(1)
  end-if
  ! mybucket now initialized and can be used
end-model

Please note that the solution revision buckets cannot be accessed from Xpress Workbench.