gtpd2m15Data Communications Services Reference

ART User Fields

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).