Associating a Master File With an XML Document

How to:

There are two ways to associate a Master File with an XML document. The Master File can specify a DATASET attribute that points to the XML document or you can explicitly issue a FILEDEF command to associate a Master File with an XML document.

In order to properly code a FILEDEF command, you need to determine how the XML documents are organized. If the documents are in one file and are described by the same DTD, the organization is called a COLUMN. If there are various documents in one directory and all are described by the same DTD, then the organization is called a COLLECTION.

Source

Collection Organization

Column Organization

disk

supported

supported

http

not supported

supported

https

not supported

supported

Syntax: How to Associate a Master File With an XML Document Using FILEDEF

FILEDEF ddname source filename

where:

ddname

Is the logical reference name matching the desired Master File.

source

Is the location of the XML document. Possible values are http, https, and disk.

filename

For an XML Column, is the full path to the source file.

For an XML Collection, is the full path to the source directory. The directory name must be followed by the wildcard characters '*.*'.

The file name must start with 'http://' or 'https://' if the XML documents are to be read using an HTTP or HTTPS session.

Example: Issuing a FILEDEF Command for an XML Column

Note: If you are working on the Web Console or Data Management Console Create Synonym panes, see Synonym Creation Parameters for XML for details about how FILEDEFs are created.

For Windows, when you have the ordercol.xml document under C:\, use the following FILEDEF in your profile:

FILEDEF ordercol disk C:\ordercol.xml

For UNIX, when you have the ordercol.xml document under /usera/xml/, use the following FILEDEF in your profile:

FILEDEF ordercol DISK /usera/xml/ordercol.xml

For z/OS, when you have the ordercol.xml document in TEST.XML.DOC, use the following FILEDEF in your profile:

FILEDEF ordercol DISK //'TEST.XML.DOC'

For HTTP and HTTPS, when you have the ordercol.xml document under http://www.test.com/xmltest/ (or https://www.test.com/xmltest/), use the following FILEDEF in your profile:

FILEDEF order http http://www.test.com/xmltest/ordercol.xml

or

FILEDEF order http https://www.test.com/xmltest/ordercol.xml

Example: Issuing a FILEDEF Command for an XML Collection

Note: If you are working on the Web Console or Data Management Console Create Synonym panes, see Synonym Creation Parameters for XML for details about how FILEDEFs are created.

For Windows, when you have the order1.xml and order2.xml documents under C:\ORDERS, use the following FILEDEF in your profile:

FILEDEF order disk C:\orders\*.*

For UNIX, when you have the ordercol.xml document under /usera/orders, use the following FILEDEF in your profile:

FILEDEF ordercol DISK //'TEST.XML.DOC(dtd)'

For z/OS, when you have the order document in TEST.XML.DOC (DTD), use the following FILEDEF in your profile:

FILEDEF order DISK /usera/orders/*.*

WebFOCUS

Feedback