Команда
CONFIG конфигурирует различные параметры службы
NDemia CashMatic Kiosk без необходимости перезапуска службы.
Следует заметить, что практически все параметры, которые вообще имеет смысл менять, могут управляться через Панель управления
NDemia CashMatic. Команда
CONFIG предназначена главным образом для пакетного применения и обращений к службе из других программ.
Программа
CONFIG.EXE представляет собой безоконный (не консольный и не скрыто-оконный) процесс операционной системы, результат выполнения в текущей версии никак не индицируется и не возвращается.
Служба
NDemia CashMatic Kiosk должна работать на момент вызова
CONFIG.
- Основной синтаксис командной строки при вызове:
- CONFIG <ИмяПараметра>=<Значение>
- Верхний/нижний регистр букв в имени параметра не различается.
- Успешно переданные значения сразу же заносятся в реестр, поэтому запускать CONFIG нужно только для изменения настройки.
- CONFIG BillValidatorBadStatusMask=<mask>
- <mask> - комбинация флагов нештатного ("плохого") состояния купюроприёмника, 16-ричное число (см. Флаги состояния).
- Данное значение используется для мониторинга состояния оборудования (купюроприёмника) при вводе купюр (см. описание команды GETCASH, см. также описание объекта CashMaticCashSession). Если на момент запуска ожидания ввода купюры установлен какой-либо из флагов комбинации BillValidatorBadStatusMask, то ожидание немедленно завершается:
- команда GETCASH завершается с результатом 5 INTERRUPT;
- активный сеанс купюроприёмника (см. объект CashMaticCashSession) завершается событием OnCancel.
- Маской BillValidatorBadStatusMask проверяются только флаги, уже установленные на момент запуска ожидания ввода купюры, на события, происходящие во время ожидания, эта маска не распространяется (может быть изменено в будущих версиях).
- По умолчанию (при установке NDemia CashMatic) устанавливается значение 0xB008 (FAILURE | DISPOSED | FULL | STOP). Рекомендуется не изменять это значение без существенных причин.
- Если в момент вызова CONFIG BillValidatorBadStatusMask уже происходит ожидание ввода купюры (выполняется GETCASH или активирован объект CashMaticCashSession), и текущее состояние купюроприёмника по новой маске становится нештатным ("плохим"), то текущее ожидание купюры прерывается, аналогично нештатному состоянию в момент начала ожидания:
- CONFIG BillValidatorLogDir=<path>
- <path> - полный путь директории, куда записывать лог купюроприёмника (путь требуется указывать именно полный, поскольку текущие диск/директория в этом случае не определены)
- Имена файлов лога купюроприёмника формируются как ГГГГ-ММ-ДД.txt
- CONFIG BillValidatorPort=<port>
- <port> - порт купюроприёмника, например COM1
- CONFIG BillSecurityMask=<mask>
- <mask> - маска повышенных требований ("BILL SECURITY MASK", только CCNET), 16-ричная, единичные биты соответствуют типам купюр, к которым должны применяться повышенные требования.
Обычное соответствие типов купюр номиналам для российских рублей:
| Тип купюры | Номинал, рублей | Бит маски повышенных требований |
| 1 (•) | 5 | 02 |
| 2 | 10 | 04 |
| 3 | 50 | 08 |
| 4 | 100 | 10 |
| 5 | 500 | 20 |
| 6 | 1000 | 40 |
| 7 | 5000 | 80 |
(•) обычно 5 рублей купюроприёмники не принимают, тем не менее код для такого типа купюр зарезервирован.
- CONFIG PrinterBaud=<value>
- <value> - скорость порта принтера, бит/с.
- CONFIG PrinterCommands=<filepath>
- <filepath> - полный путь файла описания команд принтера (подробности см. комментарии входящих в комплект программного продукта файлов PrinterCommands*.txt) (путь требуется указывать именно полный, поскольку текущие диск/директория в этом случае не определены)
- CONFIG PrinterConvertOem=<value>
- <value> - если ненулевое десятичное число, то включается функция преобразования кодировки текста при печати "CP1251(Windows)->CP866(DOS)" - требуется для некоторых моделей принтеров.
- По умолчанию преобразование кодировки выключено.
- Преобразование выполняется как при печати, так и в режиме вывода в файл (см. CONFIG PrinterFile).
- CONFIG PrinterFile=<filepath>
- <filepath> - полный путь файла вывода принтера (путь требуется указывать именно полный, поскольку текущие диск/директория в этом случае не определены)
- Вывод печати в файл может использоваться, например, в целях отладки клиентских приложений (без физического подключения принтера)
- Если задан файл вывода принтера, то чек не печатается, а дописывается в конец этого файла. Статус принтера при этом не проверяется (исключение: см. CONFIG PrinterSimulateNoPaper), все коды управления и форматирования записываются в соответствии текущими настройками (см. CONFIG PrinterFormat и CONFIG PrinterCommands)
- Если в качестве <filepath> задана пустая строка, то задаётся режим "принтер не подключен" (любой вызов PRINTOUT завершается с результатом 2 OFFLINE).
- CONFIG PrinterFormat=<value>
- <value> - если ненулевое десятичное число, то включается форматирование шрифта при печати (обработка %-кодов, см. команду PRINTOUT)
- По умолчанию форматирование включено.
- Если форматирование выключено, то все %-коды в шаблоне чека пропускаются без обработки (не удаляются)
- CONFIG PrinterPort=<port>
- <port> - порт принтера, например COM2
- Если в качестве <port> задана пустая строка, то задаётся режим "принтер не подключен" (любой вызов PRINTOUT завершается с результатом 2 OFFLINE).
- CONFIG PrinterSimulateNoPaper=<value>
- <value> - если ненулевое десятичное число, то включается симуляция отсутствия бумаги в принтере (для отладки клиентских приложений).
- По умолчанию симуляция отсутствия бумаги отключена.
- Симуляция отсутствия бумаги может выполняться в режиме вывода в файл (см. CONFIG PrinterFile)
- Симуляция отсутствия бумаги не выполняется в следующих случаях:
- если отключена проверка статуса принтера (см. CONFIG PrinterStatusCheck);
- если задан режим "принтер не подключен" (см. CONFIG PrinterPort, CONFIG PrinterFile).
- CONFIG PrinterStatusCheck=<value>
- <value> - если ненулевое десятичное число, то включается проверка статуса принтера перед печатью.
- По умолчанию проверка статуса принтера включена.
- В режиме вывода в файл (см. CONFIG PrinterFile) статус принтера не проверяется при любом значении PrinterStatusCheck (за исключением симуляции отсутствия бумаги - см. CONFIG PrinterSimulateNoPaper).
- CONFIG ResponseDir=<path>
- <path> - полный путь директории, куда записывать файлы ответов (путь требуется указывать именно полный, поскольку текущие диск/директория в этом случае не определены).
- Имена файлов ответов задаются в параметрах запросов (см. команды BVSTATMON, CUT, GETCASH, PRINTOUT, TICKET).
- По умолчанию используется путь
"\Documents and Settings\All Users\Application Data\NDemia\CashMatic\ResponseDir" (Windows 2000, Windows XP);
или
"\ProgramData\NDemia\CashMatic\ResponseDir" (Windows Vista, Windows 7).
