RMRE gate, APPEND function

This function writes data to the system log. The data written is associated with the current unit of work of the currently executing transaction if either FORWARD_DATA(YES) or BACKWARD_DATA(YES) is specified.

Input Parameters

BACKWARD_DATA
A parameter specifying whether the data is used for backward recovery purposes.
Values for the parameter are:
  • NO
  • YES
CLIENT_NAME
Name of the communications protocol used on the link.
Values for the parameter are:
  • APAL
  • APIC
  • APRD
  • APSP
  • APUS
  • BAM
  • BR
  • DH
  • EJ
  • FC
  • FCCF
  • IND
  • IRC
  • IRCO
  • LGGL
  • LT
  • LU61
  • LU62
  • NQ
  • OT
  • OTDM
  • PIRS
  • RMI
  • RMIO
  • RUNT
  • RZ
  • SH
  • TDTR
  • TS
  • XFFR
DATA

Address of an extended Iliffe vector. An extended Iliffe vector consists of a linked list of at least one element. Each element of the linked list consists of a variable length array of address length pairs. Each address and length field is four bytes long. The top bit of each address is off except for the last which may be on.

If an address is binary zero, then this terminates the element and the linked list.

If an address has the top bit on, then it terminates the element and points to the next element in the linked list.

An extended Iliffe vector represents the block of data formed by concatenating all the blocks which are pointed to by address length pairs in the vector which have the address top bit off. The order is from front to back of the linked list and from low to high index within each array.

FORCE_DATA
A parameter specifying whether the data is forced out on to the non-volatile log or can merely be written to the volatile log buffer.
Values for the parameter are:
  • NO
  • YES
FORWARD_DATA
A parameter specifying whether the data is used for forward recovery purposes.
Values for the parameter are:
  • NO
  • YES
LOG_BUFFER_SUSPEND
Optional Parameter
A binary value specifying whether the caller can tolerate the task suspending to wait for space in a log buffer.
Values for the parameter are:
  • NO
  • YES
RAISE_INV_DATA_LENGTH
Optional Parameter
An optional parameter specifying whether the caller wants to be informed of there being to much data to be logged.
Values for the parameter are:
  • NO
  • YES
REMARK
Optional Parameter
An optional parameter for the benefit of trace to describe the data being logged.
RESOURCE_ID
Optional Parameter
A parameter specifying the name of the resource with which the data to be logged is associated.

Output Parameters

REASON
The values for the parameter are:
  • INSUFFICIENT_BUFFER_SPACE
  • INVALID_CLIENT_NAME
  • INVALID_DATA_LENGTH
  • INVALID_RESOURCE_ID
  • NO_DATA
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
FORCE_TOKEN
Optional Parameter
A token that can be used to force the data on to the non-volatile log with the FORCE function of the RMRE gate.


dfhs3_RMREappend.html | Timestamp icon Last updated: Monday, 5 June 2017