GitHubContribute in GitHub: Open doc issue|Edit online

DSMLv2 Parser for file endpoint

Use the DSMLv2 Parser to parse and create DSMLv2 request and response messages. Directory Services Markup Language v2.0 (DSMLv2) provides a method for expressing directory queries and updates and the results of these operations as XML documents.

To access the DSMLv2 Parser configuration parameters:

  1. Add a File endpoint.
  2. On the File endpoint configuration page, click Parser and select DSMLv2 Parser from the list.
  3. Expand the Parser section to view the parameters.

Parameters

Mode
Specify whether the parser operates in Server or in Client mode. In Server mode, requests are read and responses are written. In Client mode, requests are written and responses are read.

Comment
Use this field to add your comments. The comment is not considered while parsing data.

Detailed Log
Select this check box to generate detailed log messages with extra information.

You can also configure the following advanced parameters. Under the

Parser section, expand

Advanced to view these parameters.

Character Encoding
Specify the character encoding to use for reading or writing. The default value is UTF-8.

The DSMLv2 Parser extends the Simple XML Parser; therefore, the same character encoding rules apply. For more information, go to the IBM® Security Verify Directory Integrator documentation and search for Character Encoding in the Simple XML Parser.

Binary Attributes
Specify a comma delimited list of attributes that must be treated by the parser as binary attributes. A list of attributes are provided by default, which you can modify.

On Error
Specify how the server responds to failures while processing batch request elements. The valid values are exit and resume. The default value is exit.

Processing
Specify the value of the processing DSML attribute for batch requests. The valid values are sequential and parallel. The default value is sequential.

Response Order
Specify how the server orders individual responses within the batch response. The valid values are sequential and unordered. The default value is sequential. If you select sequential, the server must return a batch response in which the individual responses maintain a positional correspondence with the individual requests.

Omit XML Declaration
Select this check box to indicate that the parser must omit an XML declaration header in the output stream.

Indent Output
Select this check box to indent the output according to the depth of the statement lines. The result is cosmetic only; it has no bearing upon the semantic content of the output file.

Soap Binding
Select this check box to create SOAP DSML message. Otherwise, the DSML messages are not wrapped in SOAP.

For detailed information about the DSMLv2 Parser, its operations, attributes, and examples, go to the IBM® Security Verify Directory Integrator documentation and search for DSMLv2 Parser.