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.