29 Renew
- Request
- 29
- Response
- 30
- Set
- optional
- Position in BX
- 14
Renewal sets a new due date for an item the patron already has. The item stays with the patron; nothing is returned and nothing charged anew.
Whether renewal is allowed at all is decided by the library system alone – holds, the maximum number of renewals, outstanding fees and blocks all play a part. The device asks and displays the answer.
Request 29#
29<third party allowed><no block><timestamp><nb due date><AO...><AA...>
<AB...><AJ...><AC...><AD...><CH...><BO...>
| Field | Length | Required | Content |
|---|---|---|---|
| third party allowed | 1 | yes | Y a third party may renew on the patron's behalf |
| no block | 1 | yes | Y transaction filed later from offline operation |
| timestamp | 18 | yes | date and time on the device |
| nb due date | 18 | yes | due date from offline operation; otherwise blank |
| Identifier | Required | Content |
|---|---|---|
AO |
yes | institution identifier |
AA |
yes | patron identifier |
AB |
no | item identifier |
AJ |
no | title of the item |
AC |
no | terminal password |
AD |
no | patron password |
CH |
no | item properties |
BO |
no | Y the patron has acknowledged a fee |
At least one of the fields AB and AJ must be filled, otherwise it is not
apparent which item is meant. In practice it is AB.
Response 30#
30<ok><renewal ok><magnetic media><desensitize><timestamp><AO...><AA...>
<AB...><AJ...><AH...><BT...><CI...><BH...><BV...><CH...><AF...><AG...>
| Field | Length | Required | Content |
|---|---|---|---|
| ok | 1 | yes | 1 renewed, 0 not renewed |
| renewal ok | 1 | yes | Y the item was renewable |
| magnetic media | 1 | yes | Y/N/U |
| desensitize | 1 | yes | Y/N/U; without meaning for a renewal |
| timestamp | 18 | yes | date and time on the library system |
| Identifier | Required | Content |
|---|---|---|
AO |
yes | institution identifier |
AA |
yes | patron identifier |
AB |
yes | item identifier |
AJ |
yes | short title, optionally preceded by the author |
AH |
yes | new due date |
BT |
no | fee type |
CI |
no | N leave the security status of the item unchanged |
BH |
no | currency; only together with BV |
BV |
no | fee for the renewal |
CH |
no | item properties |
AF |
no | message for the screen |
AG |
no | message for the receipt |
If it is refused, the reason appears in plain text in AF – "the item is on
hold", "the maximum number of renewals has been reached", "please see the desk".
AH then still carries the previous, unchanged due date.
Example#
29YN20260728 14301220260728 143012AOBVS|AA1140360000042|AB1140360000123|AY8AZEDF7<CR>
301YUU20260728 143012AOBVS|AA1140360000042|AB1140360000123|AJEnde, Michael: Momo|AH22.09.2026|BT01|CIN|CH000|AFRenewal successful|AG|AY8AZD8B7<CR>