gtpd2m15 | Data Communications Services Reference |
The user functions supplied by this package are to facilitate access to the
application recovery table (AR0RT). This table is to enable the user to
control the messages or data that will be recoverable via the timeout
function.
The following fields are available to the user via a slot in the
ART. A slot, once obtained is unique and saved for the life of the
entry. This will be until the user has returned the slot to the
available list via a delete request. The user must issue a GLMOD macro
prior to modifying a field within the ART slot. This table resides in
protected core. Upon completion of the change, a KEYRC macro is issued
to reset the protection key. The fields available for user modification
are:
- AR0FAW
- This will contain the file address of the message or data handled by the
user application. This file address may be user supplied or supplied by
the AR package. This file address cannot reference a block greater than
1055 bytes in size.
- AR0TIM
- A numeric value (maximum = 255) input by the user to activate and control
the timeout function. The timeout program, on each activation,
decrements this value by 1. A zero result causes the message to be
routed back to the origin as timeout has occurred.
- AR0SY1,AR0SY2
- Indicators available for user modification. Bits 0-3 of
AR0SY1 are defined as follows:
- AR0SY1=AR0USE
- to indicate slot in use. This is set by the AR package on an obtain
request.
- AR0SY1=AR0KYPT
- keypoint request indicator set by the user. Data will be written
back to file (keypointed) on the next time-initiated activation.
- AR0SY1=AR0RLSE
- release file indicator for message file address contained in
AR0FAW. This is set by the user and results in a release file by the AR
package on the next delete ART slot request. This is valid only when
the data on file is an input or output message block. If not set, it is
the user's responsibility to release any file addresses on completion of
processing.
- AR0SY1=AR0INPT
- set by the user and used by the AR package when the release file indicator
(AR0SY1=AR0RLSE) is set.
- AR0RPL
- This contains the 16 byte user RCPL (RC0PL). At the time of a
request to obtain a slot, the AR package stores the RCPL in this field prior
to returning to the user. The first 3-bytes of the RCPL are used by the
AR package as a key to identifying the slot requested by the user.
- AR0DTA
- This field is strictly for user convenience. If not necessary, it
will have zero length. The maximum may coincide with the maximum data
area associated with the RCPL (82 bytes). The number of bytes in this
field is defined by the user in the PILOT load data.
Field available for user reference:
- AR0SZE
- One byte field which defines the system generated length of the user data
field, AR0DTA. This field is variable. The initialization
program stores the system generated size for user use when writing to that
area (input via PILOT).