5.32.6 SET

The SET command is used for two distinct operations. Use the DIR keyword to set the current working directory or alternatively use the LIST or FRAGMENT keywords to populate the outbound document object.

Once you have completed your SET commands your next command would invariably be the WRITE command.

Syntax:

Command Keyword Value Developer notes SET LIST value Conditional. Bind list name. FRAGMENT value Conditional. Bind fragment name. INSTRUCTION value Optional. XML processing instruction. DATA value Conditional. Processing instruction data. SUBSET   Optional. See SUBSET. DIR value Conditional. This keyword is used to nominate a relative or absolute path to be set as the current directory. It does not have any relationship with the other keywords for the SET command.

Example

SET LIST(ORDERS) #WRKLST

 

SET FRAGMENT(DETAIL) SERVICE_EXCHANGE(*FIELD)

 

Note: List and Fragment keywords

There are two possible ways to add a list of data when creating an XML document.

1.  The most obvious way is to use the SET command described here with the LIST keyword, then specifying the array in a working list. With this approach the section of XML would need to be defined as a list in the XML Binding Wizard.

2.  Alternatively, the same could be achieved by using the FRAGMENT keyword inside some looping code. Each loop would add a new row to the list. XML documents and readers will automatically pick up this repeating sequence as a list. With this approach the section of XML would need to be defined as a fragment in the XML Binding Wizard.

Whichever way you choose, you will need to carefully decide whether the relevant section of XML is defined as a List or a Fragment.

Note: Instruction keyword

If you wanted to add an XML processing instruction as follows:

<?xml version="1.0" encoding="utf-8"?>

<?xml-stylesheet type="text/css" href="mystyles.css"?>

 

then you could use the following command:

SET INSTRUCTION(xml-stylesheet) DATA(type="text/css" href="mystyles.css")