Set Clause for the Expand Businessobject Command

When you have a list of related objects, you can simply search for a particular object and might not need to reference the output object again. In other cases, you might want to capture the output business objects and save them for another time. That is the purpose of the Set clause of the Expand Businessobject command.

When the Set clause is included within the Expand Businessobject command, the related objects are placed within a set and assigned a set name. This set might already contain values or it might be a new set created to store the output.

When it is an existing set, the previous values are either replaced or appended, depending on the keyword you use. If the Set clause begins with the keyword INTO, the existing set contents are discarded and only the current output is saved. If the Set clause begins with the keyword ONTO, the new output is added onto the existing set contents.

The Set clause is optional. It can be used with the other Expand Businessobject clauses according to the following guidelines:

  • You can specify a set (with the Set clause) OR select properties for output (with the Select clause) but not both in the same command.
  • You can specify that the results are saved in a set OR request that output be saved in a file (with dump/output clauses), but not both in the same command.