Rational Developer for System z
Enterprise PL/I for z/OS, Version 3.8, Programming Guide

Parameters to the event functions

All of these functions must return a BYVALUE FIXED BIN(31) value that is a return code to the parser. For the parser to continue normally, this value should be zero.

All of these functions will be passed as the first argument a BYVALUE POINTER that is the token value passed originally as the second argument to the built-in function.

With the following exceptions, all of the functions will also be passed a BYVALUE POINTER and a BYVALUE FIXED BIN(31) that supply the address and length of the text element for the event. The functions/events that are different are:

end_of_document
No argument other than the user token is passed.
attribute_predefined_reference
In addition to the user token, one additional argument is passed: a BYVALUE CHAR(1) or, for a UTF-16 document, a BYVALUE WIDECHAR(1) that holds the value of the predefined character.
content_predefined_reference
In addition to the user token, one additional argument is passed: a BYVALUE CHAR(1) or, for a UTF-16 document, a BYVALUE WIDECHAR(1) that holds the value of the predefined character.
attribute_character_reference
In addition to the user token, one additional argument is passed: a BYVALUE FIXED BIN(31) that holds the value of the numeric reference.
content_character_reference
In addition to the user token, one additional argument is passed: a BYVALUE FIXED BIN(31) that holds the value of the numeric reference.
processing_instruction
In addition to the user token, four additional arguments are passed:
  1. a BYVALUE POINTER that is the address of the target text
  2. a BYVALUE FIXED BIN(31) that is the length of the target text
  3. a BYVALUE POINTER that is the address of the data text
  4. a BYVALUE FIXED BIN(31) that is the length of the data text
exception
In addition to the user token, three additional arguments are passed:
  1. a BYVALUE POINTER that is the address of the offending text
  2. a BYVALUE FIXED BIN(31) that is the byte offset of the offending text within the document
  3. a BYVALUE FIXED BIN(31) that is the value of the exception code

Terms of use | Feedback

This information center is powered by Eclipse technology. (http://www.eclipse.org)