01 Block patron
- Request
- 01
- Response
- 24
- Set
- optional
- Position in BX
- 3
This command is reserved for the emergency brake. A device sends it when it detects an attempt at misuse, or when a patron leaves their card behind and the device retains it.
It is the only command with which a device permanently changes patron data. A library system should allow it only if it has explicitly permitted this in the system status under "status update".
Request 01#
01<card retained><timestamp><AO...><AL...><AA...><AC...>
| Field | Length | Required | Content |
|---|---|---|---|
| card retained | 1 | yes | Y the device has retained the card |
| timestamp | 18 | yes | date and time on the device |
| Identifier | Required | Content |
|---|---|---|
AO |
yes | institution identifier |
AL |
yes | reason for the block, in plain text |
AA |
yes | patron identifier |
AC |
yes | terminal password |
The reason from AL is stored as a block note on the patron account. It should
be phrased usefully: Staff will read it later at the desk when the patron asks
why their card no longer works.
Response 24#
The library system answers with a patron status – the same structure as for request 23, now with the block reasons set.
24<patron status><language><timestamp><AO...><AA...><AE...>
If AA holds an identifier the library system does not know, AE remains empty
and AF gives the reason. Nothing is blocked in that case.
Example#
01Y20260728 143012AOBVS|ALCard retained by the unit|AA1140360000042|ACsecret|AY3AZE76D<CR>
24YYYYYYYYYYYYYY00320260728 143012AOBVS|AA1140360000042|AESmith, Jane|AY3AZEB30<CR>