Skip to main content
ExLibris
  • Subscribe by RSS
  • Ex Libris Knowledge Center

    SELFCHK: How to activate on-screen messages displayed in Self-Check

    • Product: Voyager
    • Product Version: Voyager 9.0 and later

    Question

    How do I activate on-screen messages displayed through self-check devices connected via SIP?

    Answer

    The AF Message reports on any success/failure.

    If Voyager is not sending on-screen messages to self-check devices in the 'AF' field, the selfchk.cfg file is most likely missing the [Screen Messages] stanza. To fix this, follow these steps:

    1. On your Voyager server, open /m1/voyager/xxxdb/ini/selfchk.cfg, where 'xxxdb' is your database directory.
    2. Check to see if this file contains a stanza with the heading '[Screen Messages].'
    3. If it does not contain this stanza, copy the text below into the file. You may also find this stanza in the /m1/voyager/xxxdb/ini/selfchk.cfg.tml file.
    4. Edit any messages you wish to customize. Save the file.
    5. Restart any self check machines that have active connections to Voyager. When you open a new SIP connection, you should see on-screen messages transmitted in the 'AF' field.

    [Screen Messages]
    BibCreateError=An error occurred while attempting to create the bib record.
    BibCreateErrorMARC=Failed to create MARC bibliographic record.  Unable to continue.
    BibCreateErrorReadOnly=The catalog is in read-only mode.  Unable to add any bibliographic records at this time.
    BibCreateSuccess=Create Bib successful.
    BibDeleteBarcode=Bib is not linked to the item barcode specified.
    BibDeleteError=An error occurred while attempting to delete bib record.
    BibDeleteErrorHoldings=Unable to delete bib record.  Other holdings records are attached.
    BibDeleteErrorReadOnly=The catalog is in read-only mode.  Unable to delete bib record.
    BibDeleteSuccess=Bib Delete Successful.
    BibErrorNotFound=Bib record not found.  Please consult library personnel for assistance.
    BibHideSuccess=Hide Bib Successful.
    BibHoldingsDeleteErrorItems=Unable to delete bib and holdings records.  Other items are attached.
    BibHoldingsDeleteErrorPO=Unable to delete bib and holdings records.  PO line items are attached.
    BibHoldingsDeleteErrorReadOnly=The catalog is in read-only mode.  Bib and holdings records not deleted.
    BibIdError=Failed to retrieve new bib id.  Unable to continue.
    ChargeItemPolicyLimit=Patron has reached the charged items limit for the item's policy group.
    ChargeItemPolicyLimitHolds=Patron has reached the charged items limit (including pending holds) for the item's policy group.
    ChargeItemPolicyTypeLimit=Patron has reached the charged items limit for the policy group for the item's type.
    ChargeItemPolicyTypeLimitHolds=Patron has reached the charged items limit (including pending holds) for the policy group for the item's type.
    ChargeItemTypeLimit=Patron has reached the charged items limit for the item's type.
    ChargeItemTypeLimitHolds=Patron has reached the charged items limit (including pending holds) for the item's type.
    CheckinErrorCheckout=ERROR -- a database or system error occurred while attempting to cancel last checkout.
    CheckinSuccess=Checkin successful.
    CheckinSuccessAlert=Checkin successful. There is an alert. Item is discharged.
    CheckoutBlockedPatron=Unable to checkout item to patron.  Patron submitted for checkout is different from last patron submitted for status request and validation.
    CheckoutSuccess=Checkout Successful.
    HoldBlockedNoItems=HOLD BLOCKED.  The selected bib has no items.
    HoldBlockedAllItemsLostOrMissing=HOLD BLOCKED.  All items for the selected bib are marked 'Lost' or 'Missing'.
    HoldingsCreateError=An error occurred while attempting to create the holdings record.
    HoldingsCreateErrorCallNumber=The call number is invalid.  Unable to create holdings record.
    HoldingsCreateErrorLocation=The location code is invalid.  Unable to create holdings record.
    HoldingsCreateErrorMARC=Failed to create MARC holdings record.  Unable to continue.
    HoldingsCreateErrorReadOnly=The catalog is in read-only mode.  Unable to add any holdings records at this time.
    HoldingsDeleteError=An error occurred while attempting to delete holdings record.
    HoldingsDeleteErrorLocNotAuth=Holdings location is not one for which authorization for deletion is granted.  Unable to delete bib and holdings records.
    HoldingsDeleteErrorLocNotFound=Holdings location not found.  Unable to delete bib and holdings records.
    HoldingsIdError=Failed to retrieve new holdings id.  Unable to continue.
    ItemBarcodeNotFound=Item barcode not found.
    ItemBarcodeNotFoundConsult=Item barcode not found.  Please consult library personnel for assistance.
    ItemBarcodeSearchError=An error occurred while searching for item barcode.
    ItemBlockedBarcodeInactive=BLOCKED -- Item barcode is inactive.
    ItemBlockedBarcodeMultiple=BLOCKED -- Multiple item records matched to this barcode.
    ItemBlockedBarcodes=Multiple items found matching this barcode.  Please consult library personnel for assistance.
    ItemBlockedCalendar=BLOCKED -- Inadequate circulation calendar.
    ItemBlockedCallSlip=BLOCKED -- Item has call slip request for another patron.
    ItemBlockedDamaged=BLOCKED -- Item is damaged.
    ItemBlockedForeignLocCharged=BLOCKED -- Item not allowed to circulate from this location.
    ItemBlockedMisroutedUB=BLOCKED -- Item is misrouted.  Please consult library personnel for assistance.
    ItemBlockedNoCourtesyDischarge=BLOCKED -- Item not authorized for discharge at this location.
    ItemBlockedNoDueDate=Item has a term loan period, but a term due date has not been set.
    ItemBlockedNoPeriod=Item does not have an assigned loan period.
    ItemBlockedNoSelfService=BLOCKED -- Self service not permitted for this item.
    ItemBlockedNonCirculating=Item is non-circulating.
    ItemBlockedOnHold=Item on hold for another patron.
    ItemBlockedOutphaseTermRenew=BLOCKED -- TERM renewal precedes permitted renewal period.
    ItemBlockedScheduled=Item has been scheduled and cannot be charged or renewed.
    ItemBlockedShortloanScheduled=BLOCKED -- Item scheduled for a short loan request.
    ItemBlockedWithdrawn=BLOCKED -- Item has been withdrawn.
    ItemCreateError=An error occurred while attempting to create the item record.
    ItemDeleteBlockedTransactions=Item has outstanding transactions.  Unable to delete.
    ItemDeleteError=An error occurred while attempting to delete item.
    ItemDischargeBlockedAlert=There is an alert. Item is not discharged.
    ItemRenewBlocked=Item is not renewable.
    ItemRenewBlockedOverdue=Item is not renewable -- Overdue.
    ItemRenewBlockedRecalled=Item is not renewable -- recalled by another patron.
    ItemRenewBlockedRequested=Item is not renewable -- requested by another patron.
    ItemRetrieveError=An error occurred while retrieving item information.  Please consult library personnel for assistance.
    ItemRetrieveSuccess=Item Info retrieved successfully.
    PatronBarcodeSelectGroup=Patron has duplicate active barcodes/patron groups.  Please specify which patron group to reference.
    PatronBarcodeValid=Patron barcode valid (active)
    PatronBlockError=Unable to block.  Patron submitted for block is different from last patron submitted for status request.
    PatronBlockErrorBarcode=Patron Not Blocked.  Error occurred while attempting to disable patron barcode.
    PatronBlockNoteError=Patron Blocked.  However, an error occurred while attempting to add patron block note to patron's record.
    PatronBlockSuccess=Patron sucessfully blocked.
    PatronBlocked=Patron is blocked.
    PatronBlockedAddressExpired=Patron address is expired
    PatronBlockedAddressInvalid=Patron address is invalid
    PatronBlockedBarcodeNotActive=Patron barcode not valid (not active)
    PatronBlockedBarcodeNotFound=Patron barcode not found
    PatronBlockedBarcodeNotValid=Patron barcode not valid
    PatronBlockedBarcodes=Multiple patrons found with this barcode
    PatronBlockedChargedItemLimit=Patron has reached the charged item limit.
    PatronBlockedChargedItemLimitHolds=Patron has reached the charged item limit (including pending holds).
    PatronBlockedCircDesk=Patron is blocked - see Circulation Desk
    PatronBlockedClaimedReturnLimit=Patron has reached the claimed returned item limit
    PatronBlockedExpired=Patron record has expired
    PatronBlockedFineFeeLimit=Patron has reached the fine/fee limit.
    PatronBlockedFineLimit=Patron has reached the fine limit
    PatronBlockedLostItemLimit=Patron has reached the lost item limit
    PatronBlockedNotValidated=Patron not validated.
    PatronBlockedOverdueItemLimit=Patron has reached the overdue item limit
    PatronBlockedOverdueRecallLimit=Patron has reached the overdue recalled item limit
    PatronBlockedRecallItemLimit=Patron has reached the recall item limit
    PatronBlockedRenewLimit=Patron has reached the renewal limit for this item.
    PatronBlockedSelfShelveLimit=Patron has reached the self-shelve limit
    PatronValidationErrorGroup=Failed to locate designated patron group for validation.
    PatronValidationSuccess=Patron validated successfully.
    RecallBlockedAllItemsLostOrMissing=RECALL BLOCKED.  All items for the selected bib are marked 'Lost' or 'Missing'.
    RecallBlockedBindery=RECALL BLOCKED.  Item is marked 'At Bindery'.
    RecallBlockedDuplicate=REQUEST BLOCKED.  Patron already has a title-level request for the selected bib.
    RecallBlockedLostLibrary=RECALL BLOCKED.  Item is marked 'Lost Library Applied'.
    RecallBlockedLostOr=RECALL BLOCKED.  All items for the selected bib are marked 'Lost', 'Missing', or 'At Bindery'.
    RecallBlockedLostSystem=RECALL BLOCKED.  Item is marked 'Lost System Applied'.
    RecallBlockedMissing=RECALL BLOCKED.  Item is marked 'Missing'.
    RecallBlockedNoItems=RECALL BLOCKED.  The selected bib has no items.
    RecallBlockedNotAuthorized=RECALL BLOCKED.  Patron not authorized to place a recall for the selected item.
    RecallBlockedNotCharged=RECALL BLOCKED.  None of the selected bib's items are charged out to patrons.
    RecallBlockedOnOrder=RECALL BLOCKED.  The selected bib currently has no items, but they are on order.
    RenewBlockedDueDateCurrent=The renewal due date calculated precedes the item's current due date.
    RenewBlockedDueDatePast=The renewal due date calculated is in the past.
    RenewSuccess=Renew Successful.
    RequestAddError=An error occurred while attempting to add request.  Please consult library personnel for assistance.
    RequestBlockedCalendar=Voyager circulation system calendar not configured.  Please consult library personnel for assistance.
    RequestBlockedInvalidCircDesk=Pickup location code not a valid circ desk.  Please consult library personnel for assistance.
    RequestBlockedModify=Unable to modify a hold or recall request.  This function is not supported.  Please consult library personnel for assistance.
    RequestBlockedOperator=Invalid operator id.  Please consult library personnel for assistance.
    RequestCancelError=An error occurred while attempting to cancel request.  Please consult library personnel for assistance.
    RequestCancelSuccess=Request cancelled.
    RequestHoldBlocked=HOLD BLOCKED.  Patron not authorized to place a hold for the selected item.
    RequestPlaced=Request placed.
    SystemError=ERROR -- a database or system error occurred.
    SystemErrorOutOfPaper=Out of Paper
    SystemErrorVersions=Self check unit and server protocol versions are not compatible.
    SystemGoingOffline=Going Offline

    Additional Information

    On-screen messages are returned as ‘AF’ field in various SIP2 messages.

    Example of Success with AF message:

    BEGIN Stanza Loop
    SENDING: 6300120071019 121515 AO|AA7654321|AC|AD|BP|
    RECEIVING: 64 00020210513 131510000000000000000500000001AO|AA7654321|AELalla Ann Guy|CA0001|CB0001|PB19850302|BLY|BHUSD|BV0.00|CQN|BElauraannguy@gmail.com|BD5459 Indian Su|
    SENDING: 2300120211110 131858AO|AA7654321|AC|AD|
    RECEIVING: 24 00020210513 131510AO|AA7654321|AELalla Ann Guy|BLY|BHUSD|BV0.00|AFPatron validated successfully.|
    SENDING: 11YY20210708 16070820210808 160708AO|AA7654321|AB19755|AC|
    RECEIVING: 121NNY20210513 131510AO|AA7654321|AB19755|AJChicago on foot; an architectural walking tour, by Ira J. Bach. Photos. by Philip A. Turner.|AH20210610 235900|CK|AFCheckout S|
    END Stanza Loop

     

    Example of Fail:Blocked request with AF message:

    SENDING: 2300120211110 131858AO|AA7654321|AC|AD|
    RECEIVING: 24 00020210513 100426AO|AA7654321|AELalla Ann Guy|BLY|BDObscured for Privacy|BEObscuredForPrivacy|MLFAC|BHUSD|BV0.00|AFPatron validated successfully.|
    SENDING: 15+20210708 160708BW20210810 160708|AO|AA7654321|AF|ME10772|MA38402|MFdemo|
    RECEIVING: 160N20210513 100426BW20210810 160708|AO|AA7654321|AB|AJ|AFREQUEST BLOCKED. Patron already has a title-level request for the selected bib.|MA38402|MB|MC|

     

     


    • Article last edited: 17-Oct-2021