Configuration Files
Nexus requires a MMServer.ini to function. Some systems also require a database.ini file to activate all functionality. Please contact your Music Scheduling Consultant to see if there are pre-built files available for the system you are using. The third-party system may also have pre-built files available for your use.
MMServer.ini
This file is located in the same directory where MMServer.exe is located. Not all settings are used by all third-party systems. Please refer to application-specific instructions for more details.
| KEY | DESCRIPTION |
|---|---|
|
[Settings] |
This is the header listing |
| ByteOrder=1 | This indicates if the byte order mark is included. (Default=1 yes, 0 to disable) * |
| Encoding=UTF-8 | Used to control the encoding of the XML reply messages (Default=blank for Windows 1252) * |
| ExitPrompt=1 | This is used to disable the confirmation prompt when shutting down the Server {Default=2, Prompt, 0=No prompt |
| LogFilename= | This indicates the filename formatting for Nexus log files. {Default=0 Nexus_yyyy-mm-dd.log, 1=yyymmdd Nexus.log |
|
Port= |
This is the TCP/IP port that the server will operate on. The default is 80. |
| XMLHeader=1 | This indicates if the XML header is included (Default=1) * |
| XMLIndent=1 | This indicates if XML indenting is used (Default=1) * |
| * Requires MusicMaster 5.0sr11 or later | |
| [Interface01] | This is the header listing. Multiple database connections may be defined. Each has its own section named InterfaceXX where XX is a sequential two digit number. Up to 99 databases may be serviced. This is the maximum number, however, computer resources may not support more than a few databases per server computer |
| ID= | Required. ID is a short unique text string to identify each database. This is the data that is used in the station attribute when sending requests to the server. It is listed with the path and filename. |
| Data= | Required. This is the database path and file name as seen from where the server is installed.; It is highly recommended that you install the server on the same physical computer as the database files. If you are connecting to a SQL database, this line would be something like Data=sql//:/(IP address)/DatabaseName. |
| CutID= | This is an alternative to looking up songs by the MusicMaster SongID Field |
| ISODateFormat=0 | This formats song field dates using regional settings. {Default is ISO format as of 6.0sr3.} |
| LogDesign= | If you wish to have logs exported, indicate the name of the export design to use. This name must match exactly how the name appears in MusicMaster |
| LogFileSpec= | This is the export path and filename, which can override the design settings. |
| NormalizeTimes=1 | This resets elements that exceed the length of an hour to show a start time of :59:59. {Default=0-no} |
| Password= | This is for the credentials when a SQL Server database is in use |
|
PublishMetaData=[interval] |
Where [interval] is specified as the number of seconds (S,nm), minutes (M,n) or hours (H,n) between calls to this command. For instance PublishMetaData=S,15 (call this command every 15 seconds). This command may have a vendor specific override available and when that is the case, this command may be automated to push changes to your automation system by adding this command. See for more information. |
| PublishMetaDataFields= | This option allows the ability to specify additional fields for the automated version of publishMetadata. By default, only the songID and cutID (if defined) are sent. You can now send additional fields; for example: PublishMetadataFields=101,Artist,Title |
| PublishMetaDataURL= | This option indicates where the changes are published |
| PublishSchedule= | This options allows the setting of how the schedule is published; for example: PublishSchedule=S,15 indicates to check for schedule changes every 15 seconds |
| PublishScheduleURL= | This option indicates the URL where the schedule is published |
| PublishScheduleFields= | This options the ability to specify additional fields for schedule publishing. By default, only the songID and cutID (if defined) are sent. You can now send additional field; for example: PublishScheduleFields=101,Artist,Title. The data sent by this command matches the format you would get if you used getSchedule. |
| PublishScheduleHourly=1 | This option indicates to check each hour instead of each day for the watched time period. It will publish only the individual hours changed. |
| PublishScheduleMaxDays= | Indicates the number of days to check starting with today (1-3, default=1). By default, this only sends changes in the log for today. |
| PublishScheduleStartup=0 | This disables publishing the current schedules at startup. When Nexus is started, the hours/days for the defined watch period (today and up to two additional days) are always sent as Nexus does not know for sure if the changes have been published while it was not running. If you wish to disable this function, set this setting to 1. |
| ReadOnly= | If you wish to enable access to a station in a read only manner, add this property and set it to one. This will restrict access to any functions that can modify the database. |
| ReconDef= | This is the reconciliation.def file for |
| System= | System indicates the automation system interface to use. Generic provides no special functionality. Logs are exported exactly as they would be from within MusicMaster Valid values are "wideorbit" and "enco" |
| UserName= | This is for the credentials when a SQL Server database is in use |
Here is an example of the file:
[Settings]
Port=8080
[Interface01]
ID=WXYZ-FM
System=Generic
Data=C:\MMWin\WXYZ-FM.mmd
LogDesign=Automation Export
Database.ini
This is only required for systems that support the command and this file not exist for systems that do not support this command.
This INI file is named after MusicMaster data. For instance, data called Sample.mmd requires a fie called Sample.ini This file is located in the same folder as the data.
| KEY | DESCRIPTION |
|---|---|
| [Server] | This is the header listing |
| Address= |
This is the address of the server, name or IP address and port. (Default = 80). |
| DataID= | This needs to match the ID string in MMServer.INI for the matching database. |
| LocalHost=1.1.1.1 | This would only be used when you want to force Nexus to NOT listen on all network adapters when there are more than one. By default it listens to all. |
| PublishHour= | This option modifies how the log is published. By default, the entire day is published. With this setting, just the current hour is published. The current hour is the one where the pointer is located. If you would still like to publish the entire day, you can do so by holding down the SHIFT key and clicking on the Publish button |
[Server]
Address=localhost:8080
DataID=WXYZ-FM