User Messages Configuration File

The User Messages Configuration file, also known as the messages.conf file, allows staff to define system messages for various system functions. If the CUSTOM_MESSAGES Web option is set to "true", WebPAC uses this file to define system messages instead of the system defaults.

The messages.conf file does not exist by default. To create a messages.conf file, complete the following steps:

  1. Create a messages.conf file using a text editor (such as Notepad).
  2. Using the Web Master function, upload the messages.conf file to your Live Web Server Configuration (Live Web Server Configuration - live (liveconfig)) directory.
    Login Access

    If you are unable to access the Live Web Server Configuration directory, verify your login has access in the Web Master Tab in Login Manager.

  3. Edit the messages.conf file in the Web Master function, if necessary.
  4. Set the CUSTOM_MESSAGES Web option to "true" to use the messages.conf file.

Each line contains an equals-sign delimited entry with the following fields:

[SYSKEY]=[MSG]

To comment out an entire line, insert a pound ('#') sign before the first field in a line.

Field Description
[SYSKEY] This is the system message key the system uses to identify the specific renewal error condition. Valid values are:
HOLDINGS_EMPTY_BIB_AVAIL
MG_ARTICLE_REQ_MUST_FILL
MG_COPY_CNCL
MG_COPY_PROC
MG_COPIES_PROC
MG_COPY_ORDER
MG_COPIES_ORDER
MG_COPY_STAT1
MG_COPIES_STAT1
MG_NEW_PIN
MSG_CONFIRM_BOOKING
MSG_CONFIRM_CANCEL_HOLD
MSG_CONFIRM_RENEW
MSG_NOREMOTEUSER
MYLIST_NONE_REMOVED
MYLIST_REMOVED
MYLIST_REC_NOT_AVAILABLE
MYLIST_REC_SAVED
OP_STR_FINE
OP_UP_TO_NOW
OP_YOUR_LIST_MARKED
PIN_REQ_NOEMAIL
PIN_REQ_SUCCESS
PIN_RESET_EXPIRED
PIN_RESET_FAILED
PIN_RESET_SUCCESS
PT_INVALID_PIN_LENGTH
PT_PATRONPROBLEM
PT_PIN_IS_TRIVIAL
PT_PIN_MUST_BE_MIXED
PT_PIN_MUST_BE_NUM_ONLY
PT_RENEWFAIL
REN_IS_OVERDUE
REN_IR_RECALL_DENY_RENEW
REN_MESG1
REN_NON_CIRC
REN_NOT_ALLOWED
REN_NOT_CHECKOUT
REN_OK
REN_ON_HOLD
REN_TOO_SOON
REN_TOO_MANY
REQ_DENIED_PICKUP
REQ_EXTSYSERR
REQ_EXTVERERR
REQ_INVALID_INFORMATION
REQ_LIBRARY_LOGIN_MSG
REQ_NCIP_BLOCKED
REQ_NCIP_SYSTEM_ERROR
REQ_PATRON_EXPIRED
REQ_PIN_INSERT_FAILED
REQ_PINS_DONT_MATCH
REQ_RQ_PIN_NEEDED
SMS_STATUS_OPTED_IN
SMS_STATUS_OPTED_OUT
SMS_STATUS_PENDING_OPTIN
SMS_STATUS_PENDING_OPTOUT
SMS_STATUS_REJECTED
SMS_STATUS_REJECTED_IN_USE
USER_NAME_CHARS
USER_NAME_DUP
USER_NAME_LENGTH
The system ignores any spaces between the system message key and the equals sign.
[MSG] The message that displays in WebPAC. This field accepts HTML as well as plain text.

The system uses the system message key ([SYSKEY]) values as follows:

[SYSKEY] Value Message Description
HOLDINGS_EMPTY_BIB_AVAIL

This message indicates the bibliographic record has no attached items or orders. This message is normally used for libraries that attach links to electronic resources in bibliographic records with no attached items or orders. This message accepts a %l placeholder. The system replaces %l with the location.

If this message is not defined, the system uses the following default:

1 copy available at %l

MG_ARTICLE_REQ_MUST_FILL

This message indicates the user has not entered information for an article request. If this message is not defined, the system uses the following default:

You must submit some information in order to request an article from this journal.

MG_COPY_CNCL This message indicates that an order for a title was cancelled. This message accepts a %l placeholder. The system replaces %l with the location.
MG_COPY_ORDER This message indicates a copy is on order. This message accepts two placeholders: %l and %d. The system replaces %l with the location and %d with the date the item was ordered.
MG_COPY_PROC This message indicates a single copy of the item is being processed. This message accepts a %l placeholder. The system replaces %l with the location.
MG_COPIES_PROC This message indicates multiple copies of the item are being processed. This message accepts two placeholders: %n and %l. The system replaces %n with the number of copies and %l with the location.
MG_COPY_STAT1 This message indicates an item is under consideration. This message accepts a %l placeholder. The system replaces %l with the location.
MG_COPIES_STAT1 This message indicates a number of items are under consideration. This message accepts two placeholders: %n and %l. The system replaces %n with the number of copies and %l with the location.
MG_NEW_PIN

Status message indicating user must enter a new PIN for Innovative Integrated Login. If this message is not defined, the system uses the following default:

Please enter a new pin

MSG_CONFIRM_BOOKING

Status message indicating the confirmation message for a booking cancellation. If this message is not defined, the system uses the following default:

The following item(s) will be cancelled. Would you like to proceed?

MSG_CONFIRM_CANCEL_HOLD

Status message indicating the cancellation or update of a hold. If this message is not defined, the system uses the following default:

The following hold(s) will be updated. Would you like to proceed?

MSG_CONFIRM_RENEW

Status message indicating the renewal of an item. If this message is not defined, the system uses the following default:

The following item(s) will be renewed. Would you like to proceed?

MSG_NOREMOTEUSER

This message indicates the user has a single sign-on account but does not appear in the patron database. If this message is not defined, the system uses the following default:

There are 0 users with supplied remote information. You must log in.

MYLISTS_NONE_REMOVED This message indicates no records matched records in the patron's reading history.
MYLISTS_REMOVED This message indicates the number of records removed from the user's list. This message replaces the %d placeholder with the number of records removed from the user's list.
MYLIST_REC_NOT_AVAILABLE

This message indicates a bibliographic record listed in a patron's list has been removed from the catalog. This message uses a %s placeholder to represent the bibliographic record number. If this message is not defined, the system uses the following default:

Record %s is no longer available

MYLISTS_REC_SAVED This message indicates the system saved a single record to the user's list. This message replaces the %d placeholder with the number of records saved to the user's list.
MYLISTS_RECS_SAVED This message indicates the system saved multiple record to the user's list. This message replaces the %d placeholder with the number of records saved to the user's list.
OP_STR_FINE This message reflects any fines on record.
OP_UP_TO_NOW The "Up to now" message.
OP_YOUR_LIST_MARKED The "Your List of Saved Records" message
PIN_REQ_NOEMAIL The message indicates that the user must enter a valid email address for PIN reset requests.
PIN_REQ_SUCCESS This message indicates a successfully submitted PIN reset request.
PIN_RESET_EXPIRED This message indicates a PIN reset request has expired.
PIN_RESET_FAILED Error message indicating a PIN reset request has failed.
PIN_RESET_SUCCESS This message indicates the user has successfully reset a PIN.
PT_INVALID_PIN_LENGTH

Status message indicating the user's PIN either exceeds the maximum PIN length specified by the MAX_PIN_LENGTH Web option or is less than the minimum PIN length specified by the MIN_PIN_LENGTH Web option. This message accepts a %d placeholder. The system replaces the first %d with the value of the MIN_PIN_LENGTH Web option and second %d with the value of the MAX_PIN_LENGTH Web option. If this message is not defined, the system uses the following default:

Your pin must be %d to %d characters long

Where %d is the value of the MIN_PIN_LENGTH or MAX_PIN_LENGTH Web options, respectively.

PT_PATRONPROBLEM

Status message indicating there is a problem with the patron record. If this message is not defined, the system uses the following default:

There is a problem with your record. Please see a librarian.

PT_PIN_IS_TRIVIAL

Status message indicating the user has entered a trivial PIN. If this message is not defined, the system uses the following default:

Your pin is not complex enough to be secure. Please select another one.

PT_PIN_MUST_BE_MIXED

Status message indicating the user has entered only numeric or only alpha characters in the PIN when the system requires a mix of alphanumeric characters as valid. If this message is not defined, the system uses the following default:

Your pin should contain a mix of alpha and numeric characters

PT_PIN_MUST_BE_NUM_ONLY

Status message indicating the user has entered non-numeric characters in the PIN when the system only allows numeric characters as valid. If this message is not defined, the system uses the following default:

Your pin must consist of numeric characters only

PT_RENEWFAIL Error message for failed renewals
REN_IR_RECALL_DENY_RENEW Status message indicating the item has been recalled and cannot be renewed
REN_IS_OVERDUE Status message indicating the item is overdue and cannot be renewed
REN_NON_CIRC Status message indicating the item cannot be renewed because it is no longer in circulation
REN_NOT_ALLOWED "Renewal not allowed" status for renewal messages
REN_NOT_CHECKOUT Error status message indicating the item has not been checked out
REN_OK Confirmation message for a successful renewal
REN_ON_HOLD Status message indicating the item is on hold and cannot be renewed
REN_MESG1 Renewal error message
REN_TOO_MANY Status message indicating there are too many renewals on the item
REN_TOO_SOON Status message indicating it is too soon to renew an item
REQ_DENIED_PICKUP

Status message indicating a request is denied due to a local copy being available. This message accepts two placeholders: %l for the item location and %s for the title. If this message is not defined, the system uses the following default:

No hold required. You may pick up %s from the shelves at %l.

REQ_EXTSYSERR

Status message indicating the system cannot access the campus authentication system in order to validate the user's patron record. If this message is not defined, the system uses the following default:

Currently unable to access campus identification information. Please see a librarian for assistance

REQ_EXTVERERR

Status message indicating the system cannot validate the user's patron record using external patron verification. If this message is not defined, the system uses the following default:

Unable to identify you through your campus identification. Please use your library identification or see a librarian for assistance.

REQ_INVALID_INFORMATION

Status message indicating the user has input invalid information. If this message is not defined, the system uses the following default:

Sorry, the information you submitted was invalid. Please try again.

REQ_LIBRARY_LOGIN_MSG

Status message indicating the system cannot validate the user using the provided login. If this message is not defined, the system uses the following default:

Unable to identify you through your library identification. Please use your campus identification or see a librarian for assistance.

REQ_NCIP_BLOCKED

Status message indicating the patron's ID is blocked from validating through NCIP. If this message is not defined, the system uses the following default:

Your patron id has been blocked

REQ_NCIP_SYSTEM_ERROR

Status message indicating the system cannot validate the user due to an error with NCIP. If this message is not defined, the system uses the following default:

Ncip Internal Error: please see librarian

REQ_PATRON_EXPIRED

Status message indicating the user's patron ID has expired. If this message is not defined, the system uses the following default:

Sorry, your patron id has expired.

REQ_PIN_INSERT_FAILED

Status message used in a 2-PAC WebPAC setup indicating and the system cannot insert the PIN into the patron record. If this message is not defined, the system uses the following default:

PIN insertion failed.

REQ_PINS_DONT_MATCH

Status message indicating that the two values entered during PIN creation do not match. If this message is not defined, the system uses the following default:

PINs do not match. Try again!

REQ_RQ_PIN_NEEDED

Status message indicating the user request requires a PIN. If this message is not defined, the system uses the following default:

Sorry, PIN is needed. Please see librarian

SMS_STATUS_OPTED_IN

Status message indicating the patron has opted in to SMS messaging. If this message is not defined, the system uses the following default:

Your Opt In status is: opted in

SMS_STATUS_OPTED_OUT

Status message indicating the patron has not opted in to or has opted out of SMS messaging. If this message is not defined, the system uses the following default:

Your Opt In status is: not opted in

SMS_STATUS_PENDING_OPTIN

Status message indicating the patron has opted in to SMS messaging but has not completed the optin process by responding to the initial SMS message. If this message is not defined, the system uses the following default:

Your Opt In status is: pending

SMS_STATUS_PENDING_OPTOUT

Status message indicating the patron has opted out of SMS messaging but the system has not completed the opt-out process. If this message is not defined, the system uses the following default:

Your Opt Out status is: pending

SMS_STATUS_REJECTED

Status message indicating the patron's carrier or gateway service has rejected the patron's SMS opt-in request. If this message is not defined, the system uses the following default:

Your Opt In status is: rejected

SMS_STATUS_REJECTED_IN_USE

Status message indicating the patron's carrier or gateway service has rejected the patron's SMS opt-in request because the mobile number is already in use. If this message is not defined, the system uses the following default:

Your Opt In status is: rejected because this number is already in use.

USER_NAME_CHARS Status message indicating an input alternate ID contains invalid characters
USER_NAME_DUP Status message indicating an input alternate ID already exists on the system. This message replaces the %s placeholder with the input string for the alternate ID.
USER_NAME_LENGTH Status message indicating an input alternate ID is too short or too long.

You can create separate renewal messages configuration files for each combination of scope and language by using the following naming convention:

messages_s#_lang.conf

s# The number of the scope (for example, s1, s2, s3).
lang The language code (for example, spi for Spanish, frc for French).

Example

The following is an example messages.conf file:

# Renew messages
REN_RECALLED     =  RECALLED
REN_OVERDUE      =  OVERDUE
REN_NOT_ALLOWED=  RENEW NOT ALLOWED
REN_TOO_SOON     =  TOO SOON TO RENEW
REN_NOT_CHECKOUT =  ERROR NCO
REN_IR_RECALL_DENY_RENEW=  ITEM RECALLED
REN_TOO_MANY     =  TOO MANY RENEWALS
REN_ON_HOLD      =  ON HOLD
REN_NON_CIRC     =  DOESN'T CIRCULATE
REN_IS_OVERDUE   =  ITEM IS OVERDUE
REN_OK           =  RENEWED
REN_MESG1        =<h2>More than 300 items renewed. To renew more items, please 
quit and then retrieve patron record again and then renew additional items.<h2>
OP_STR_FINE      =FINE
OP_UP_TO_NOW     =up to now
PT_RENEWFAIL     =Not all renewals were successful. See details below

# PIN Reset Request Messages
PIN_REQ_NOEMAIL  =A valid email address is required to complete this 
request. Please contact your librarian for assistance.
PIN_REQ_SUCCESS  =A message has been sent to the email address we have on record for you. 
Please follow the instructions in that message to reset your PIN. If you do not receive 
an email, please contact your librarian for assistance.
PIN_RESET_EXPIRED=This request has expired. Please try logging in again or place a new 
request to reset your PIN.  
PIN_RESET_FAILED =Unable to process request. Please contact your librarian for 
assistance.
PIN_RESET_SUCCESS=Your PIN has been changed.

# Order Messages
MG_COPY_PROC=1 copy being processed for %l.
MG_COPIES_PROC=%n copies being processed for %l.
MG_COPY_CNCL=Order cancelled for %l.
MG_COPY_STAT1=1 copy under consideration for %l.
MG_COPIES_STAT1=%n copies under consideration for %l.
MG_COPY_ORDER=1 copy ordered for %l on %d.
MG_COPIES_ORDER=%n copies ordered for %l on %d.

# My Lists Messages
OP_YOUR_LIST_MARKED = Your list of Saved Records
MYLISTS_NONE_REMOVED=No matching records found in Reading History.
MYLISTS_REMOVED=%d records removed from your list.
MYLISTS_REC_SAVED=%d record saved to your list for later.
MYLISTS_RECS_SAVED=%d records saved to your list for later.

#Alternate ID Messages
USER_NAME_CHARS=The user name may only contain letters and numbers.  Please try 
another name.
USER_NAME_DUP=Your user name %s is already taken. Select another.
USER_NAME_LENGTH=The User Name should be between 6 and 25 characters.  Try again.

#SMS Messages
SMS_STATUS_OPTED_IN=Your Opt In status is: opted in
SMS_STATUS_OPTED_OUT=Your Opt In status is: not opted in
SMS_STATUS_PENDING_OPTIN=Your Opt In status is: pending
SMS_STATUS_PENDING_OPTOUT=Your Opt Out status is: pending
SMS_STATUS_REJECTED=Your Opt In status is: rejected