Ссылка команды CCL
В этой главе описываются команды CCL, интерпретируемые OS X. Команды представлены в алфавитном порядке. Каждый раздел команды содержит описание команды; синтаксис команды, включая любые параметры; и пример, в подходящих случаях.
Комментарии
Для вставки комментария или пустой строки в сценарии запустите строку с восклицательного знака.
- Синтаксис:
! comment
- Примеры:
! Turn echo off
!
Метки и разделы
@ANSWER
@ANSWER разделите метки метки точка входа сценария, когда сценарий будет выполняться в режиме ответа.
- Синтаксис:
@ANSWER
@CCLSCRIPT
Доступный только в OS X.
@CCLSCRIPT разделите метки метки запуск сценария CCL. Метка является дополнительной и не имеет никакой функциональной цели..
- Синтаксис:
@CCLSCRIPT
@HANGUP
@HANGUP разделите метки метки точка входа сценария, когда сценарий будет выполняться в режиме зависания.
- Синтаксис:
@HANGUP
@LABEL
@LABEL наборы команд числовая метка в сценарии, на который можно тогда сослаться от других команд сценария, такой как JUMP, JSR, и IFTRIES. Сценарий может включать до 128 меток, пронумерованных 1 - 128. Для создания отладки проще присвойте метки в возрастающей последовательности. Они не должны быть последовательными.
- Синтаксис:
@LABEL labelnum
- Параметр:
labelnumЗначение от 1–128, который указывает номер метки.
- Пример:
@LABEL 30
@ORIGINATE
@ORIGINATE разделите метки метки точка входа сценария, когда сценарий будет играть в режиме исходящих звонков (т.е. при инициировании вызова).
- Синтаксис
@ORIGINATE
Команды CCL
ASK
ASK команда заставляет диалоговое окно быть выведенным на экран для получения информации от пользователя. Диалоговое окно содержит подсказку, поле записи дополнительных данных, Кнопку отмены и кнопку OK. Если Ваша телефонная система использует специальное телекоммуникационное оборудование, Вам, возможно, понадобится команда ASK. Эта команда обычно используется в режиме исходящих звонков только.
«Форматы строки» в Главе 1 показывают, как использовать ASK представьте в виде строки как часть другой строки. Если пользователь нажимает или кнопку OK или Кнопку отмены, строка ASK установлена.
- Синтаксис
ASK maskflag "message" [jumpLabel]
- Параметры
maskflag- 0
Повторите ввод пользователя /
- 1
Замаскируйте ввод пользователя с маркерами (••••).
- 2
Не позволяйте ввод данных пользователем.
messageСтрока для отображения в диалоговом окне как подсказка для пользователя.
jumpLabelЕсли предоставлено, метка для перехода к, где выполнение продолжается, когда нажимается Кнопка отмены; если не предоставленный, или если кнопка OK нажимается, то выполнение продолжается в следующей строке CCL.
- Пример
ASK 1 "Enter your password to access the network."
ASK 2 "When the remote modem answers, click OK, otherwise click Cancel to stop Manual Dialing."
CHRDELAY
CHRDELAY команда позволяет Вам указывать время задержки между символами для всех последующих WRITE команды. Это полезно для телекоммуникационного оборудования, требующего данных на скорости медленнее, чем интерфейсная скорость.
Синтаксис
CHRDELAY delay |
- Параметр
delayВремя задержки, за десятые части секунды.
- Пример
CHRDELAY 8
COMMUNICATINGAT
Для устройств V.32bis, поддерживающих аппаратное управление потоками RTS/CTS (включая модемы с надлежащим кабелем, как описано в Спецификациях кабеля), использование COMMUNICATINGAT команда для указания скорости модемного соединения, если скорость модема отличается от скорости последовательного порта. Это необходимо, потому что внутренние таймеры OS X основываются на скорости соединения.
- Синтаксис
COMMUNICATINGAT baud
- Параметр
baudСкорость модема, в битах в секунду.
- Пример
COMMUNICATINGAT 4800
DECTRIES
DECTRIES команда уменьшает переменную tryCounter одним. Интерпретатор CCL поддерживает tryCounter, который можно установить в значение и увеличить или уменьшить одним. См. также команды IFTRIES, INCTRIES, и SETTRIES.
- Синтаксис
DECTRIES
DTRCLEAR
DTRCLEAR команда очищает (т.е. deasserts) сигнал Data Terminal Ready (DTR) в интерфейсе RS-232.
- Синтаксис
DTRCLEAR
DTRSET
DTRSET наборы команд (т.е. утверждает), сигнал Data Terminal Ready (DTR) в интерфейсе RS-232.
- Синтаксис
DTRSET
ВЫХОД
EXIT завершает выполнение сценария и возвращает код результата вместе с дополнительной строкой.
Если сценарий выполняется успешно, имейте его, возвращают код результата
0.Если сценарий перестал работать по какой-либо причине, он должен возвратить надлежащий ошибочный код результата, как перечислено в Кодах Результата
Чтобы дать пользователю нестандартное сообщение об ошибке, используйте результат, кодируют-6002 и используют строковый параметр для передачи нестандартного сообщения об ошибке.
- Синтаксис
EXIT result ["string"]
- Параметры
result-
Один из CCL приводит коды, перечисленные к Приложению A, «Коды Результата».
stringКогда попытка подключения перестала работать, сообщение вывело на экран пользователю; при включении строки для одного из стандартных кодов результата он переопределяет сообщение, что OS X обычно выводил бы на экран.
- Примеры
EXIT -6022
EXIT -6002 "unable to communicate with PBX"
СБРОС
FLUSH порожняя тара все символы от входного буфера последовательного драйвера.
- Синтаксис
FLUSH
HSRESET
HSRESET наборы команд опции управления потоком последовательного порта. При использовании стандартного модемного кабеля Вы выключите управление потоком и оставите его. Если Вы используете устройство, поддерживающее квитирование RTS/CTS, Вам нужно только outputCTS параметр. Выключите все опции в зависании.
- Синтаксис
HSRESET outputXON/XOFF outputCTS XON XOFF
inputXON/XOFF inputDTR
- Параметры
outputXON/XOFFКСОН/КСОФФ, квитирующий для вывода. Для OS X это должно быть выключено.
outputCTSАппаратное квитирование CTS для вывода. Для модема при использовании кабеля, поддерживающего квитирование RTS/CTS, оно должно идти для, происходят и режимы ответа и прочь для режима зависания.
XONУказывает символ XON. (НЕ ИСПОЛЬЗУЙТЕ с OS X.)
XOFFУказывает символ XOFF. (НЕ ИСПОЛЬЗУЙТЕ для Удаленного доступа Apple.)
inputXON/XOFFКСОН/КСОФФ, квитирующий для ввода. Для Удаленного доступа Apple это должно быть выключено.
inputDTRАппаратное квитирование DTR для ввода. Для Удаленного доступа Apple это должно быть выключено. Для получения дополнительной информации не посмотрите Инсайда Макинтоша, объем 4 (больше в печати) или Инсайда Макинтоша: Устройства, доступные через Каталог Разработчика Apple.
- Пример
HSRESET 0 1 0 0 0 0
IFANSWER
Если сценарий выполняется в режиме ответа, IFANSWER команда заставляет выполнение продолжаться в указанной метке.
- Синтаксис
IFANSWER jumpLabel
- Параметр
jumpLabelМетка, к которой должно условно перейти выполнение.
- Пример
IFANSWER 30
IFORIGINATE
Если сценарий выполняется в режиме исходящих звонков, IFORIGINATE команда заставляет выполнение продолжаться в указанной метке.
- Синтаксис
IFORIGINATE jumpLabel
- Параметр
jumpLabelМетка, к которой должно условно перейти выполнение.
- Пример
IFORIGINATE 7
IFSTR
IFSTR команда сравнивает две строки: одна из переменных строк (описанный в Переменных строках (varStrings)) и литеральная строка, которую Вы указываете в сценарии. Если строки равны, сценарий продолжает выполнение в указанной метке.
- Синтаксис
IFSTR varStringIndex jumpLabel
"compareString"
- Параметры
varStringIndexЧисло переменной строки для сравнения.
jumpLabelМетка, к которой должно условно перейти выполнение.
compareStringСтрока, с которой сравнена переменная строка.
В следующем примере, если модемный флаг динамика (varString2) идет (1), выполнение переходит для маркировки 55. Иначе, следующая команда выполняется.
- Пример
IFSTR 2 55 "1"
IFTRIES
IFTRIES команда сравнивает параметр с переменной tryCounter. Если значение tryCounter больше, чем или равен параметру, сценарий продолжает выполнение в указанной метке. См. также командыDECTRIES, INCTRIES, и SETTRIES.
- Синтаксис
IFTRIES numTries jumpLabel
- Параметры
numTriesПараметр для сравнения переменной
tryCounter.jumpLabelМетка, к которой должно условно перейти выполнение.
Следующие проверки в качестве примера, чтобы видеть, если значение tryCounter больше, чем или равен 3. Если так, выполнение переходит для маркировки 62 и продолжается. В противном случае следующая инструкция выполняется.
- Пример
IFTRIES 3 62
INCTRIES
INCTRIES команда увеличивает переменную tryCounter одним. См. также команды DECTRIES, IFTRIES, и SETTRIES.
- Синтаксис
INCTRIES
JSR
JSR команда заставляет выполнение сценария переходить к подпрограмме, расположенной в определенной метке, сохраняя адрес строки после JSR команда. Когда a RETURN с командой встречаются, резюме выполнения в строке после JSR команда. JSR команды могут быть вложены до 16 глубоко.
- Синтаксис
JSR jumpLabel
- Параметр
jumpLabelМетка, где выполнение должно продолжаться после перехода.
- Пример
JSR 50
ПЕРЕХОД
JUMP команда заставляет выполнение сценария продолжаться в указанной метке.
- Синтаксис
JUMP jumpLabel
- Параметр
jumpLabelМетка, где выполнение должно продолжаться после перехода.
- Пример
JUMP 59
LBREAK
LBREAK команда генерирует длинное повреждение (3,5 секунды) на линии передачи.
- Синтаксис
LBREAK
MATCHCLR
Интерпретатор CCL имеет буфер, содержащий до 32 строк, загруженных MATCHSTR команда. MATCHCLR команда стирает все строки в буфере. Используйте MATCHCLR команда прежде, чем загрузить каждую новую группу строк. См. также MATCHREAD и MATCHSTR команды.
- Синтаксис
MATCHCLR
MATCHREAD
Интерпретатор CCL имеет буфер, содержащий до 32 строк, загруженных MATCHSTR команда. MATCHREAD ввод чтений команды от последовательного драйвера и сравнивает ввод со строками в настоящее время в буфере. Если соответствие найдено в указанном MATCHREAD время, выполнение продолжается в метке, связанной с той строкой совпадения (как определено MATCHSTR команда, загрузившая строку). См. также MATCHCLR и MATCHSTR команды.
- Синтаксис
MATCHREAD time
- Параметр
timeВремя допускало соответствие за десятые части секунды.
Следующий пример ищет соответствие в течение 3 секунд.
- Пример
MATCHREAD 30
MATCHSTR
Интерпретатор CCL имеет буфер, содержащий до 32 строк. MATCHSTR команда загружает строку в буфер, так, чтобы входящие строки могли быть соответствующими против него a MATCHREAD команда. Если входящая строка соответствует сохраненную строку, выполнение сценария продолжается в метке, указанной в MATCHSTR команда. См. также команды MATCHCLR и MATCHREAD.
- Синтаксис
MATCHSTR matchNum matchLabel "matchStr"
- Параметры
matchNumЗначение от указания 1–32, которые представляют в виде строки в буфере для замены.
matchLabelМетка, где выполнение должно продолжаться когда a
MATCHREADкоманда обнаруживает соответствующую строку.matchStrСтрока (1–255 символов в длине) для сравнения с.
Следующий пример загружает строку "OK\13\10" в буфер как строка 1. Если последующий MATCHREAD читает строку, соответствующую этому, то переходы выполнения к метке 8.
- Пример
MATCHSTR 1 8 "OK\13\10"
MONITORLINE
Доступный только в OS X.
Включает или отключает Data Carrier Detect (DCD).
- Синтаксис
MONITORLINE monitor
- Параметры
monitor0Отключите DCD (мягкий режим поставщика услуг).
1Включите DCD (твердый режим поставщика услуг).
Следующий пример включает носитель данных, обнаруживают.
- Пример
MONITORLINE 1
Примечание:
NOTE команда выводит на экран состояние и информацию о журнале, передавая строку сообщения в качестве параметра. Дополнительно, можно установить уровень сообщения для указания, где должно появиться сообщение.
- Синтаксис
NOTE msgStr [msgLevel]
- Параметры
msgStrСообщение для отображения.
msgLevelУровень сообщения (уровень по умолчанию равняется 3).
- 1
Отправьте сообщение в журнал операций только.
- 2
Отправьте сообщение в интернет-окно состояния Connect только.
- 3
Отправьте сообщение и в журнал операций и в интернет-окно состояния Connect.
Следующие примеры показывают важные места, в которых необходимо использовать NOTE команда. В первом примере сценарий регистрирует исходящие вызовы путем отображения набранного телефонного номера в интернет-окне состояния Connect и журнале операций. Во втором примере сценарий выводит на экран скорость соединения в интернет-окне состояния Connect.
- Примеры
NOTE "DIALING ^1" 3
NOTE "Communicating at 9600 bps." 2
ПАУЗА
PAUSE выполнение сценария причин для остановки в течение установленного периода времени.
- Синтаксис
PAUSE time
- Параметр
timeВремя для приостановки, за десятые части секунды.
Следующий пример заставляет выполнение сценария приостанавливаться в течение 2 секунд.
- Пример
PAUSE 20
ВОЗВРАТИТЬСЯ
RETURN команда завершает подпрограмму. Выполнение сценария продолжает строку после JSR команда.
- Синтаксис
RETURN
SBREAK
SBREAK команда генерирует короткий перерыв (.5 секунд) на линии передачи.
- Синтаксис
SBREAK
SERRESET
SERRESET команда конфигурирует последовательный порт путем передачи значений для скорости в бодах, четности, битов данных и стоповых битов к последовательному драйверу. Указание значения кроме значений упомянуло ниже, заставляет значение по умолчанию использоваться. Значения по умолчанию для каждого параметра упоминаются ниже.
- Синтаксис
SERRESET baudRate, parity, dataBits,
stopBits
- Параметры
baudRate300,1200,2400(значение по умолчанию),4800,9600,14400,19200,28800,38400,57600, и т.д.parity1 для отрицательной четности 2 для даже четности 0 или 3 ни для какой четности (значение по умолчанию)
dataBits5, 6, 7, или 8 (значение по умолчанию)
stopBits1 для 1 стопового бита (значение по умолчанию) 2 для 2 стоповых битов 3 для 1,5 стоповых битов
- Пример
SERRESET 9600, 0, 8, 1
SETSPEED
SETSPEED наборы команд скорость асинхронного последовательного интерфейса к указанной скорости. Использовать SETSPEED к заданным скоростям кроме тех, которым позволяют войти SERRESET.
- Синтаксис
SETSPEED interfacespeed
- Параметр
interfacespeedСкорость последовательного интерфейса.
- Пример
SETSPEED 24000
SETTRIES
SETTRIES инициализирует tryCounter переменную к указанному значению. См. также команды DECTRIES, IFTRIES, и INCTRIES.
- Синтаксис
SETTRIES tries
- Параметр
triesЗначение для присвоения к
tryCounterпеременная.
- Пример
SETTRIES 0
USERHOOK
USERHOOK передает информацию о состоянии модема к OS X.
- Синтаксис
USERHOOK opcode
- Параметр
opcodeПользовательский рычаг для выполнения.
1Указывает, что сценарий отвечает на вызов и что кольцо обозначено модемом. Это препятствует тому, чтобы другие приложения использовали последовательный порт, пока не завершился вызов.
2Отчеты, что модем делает коррекцию ошибок (кроме MNP10, обозначенного кодом операции 4).
3Запросы, что OS X выключает свое встроенное сжатие данных.
4Отчеты, что модем делает коррекцию ошибок MNP10.
- Пример
USERHOOK 1
ЗАПИСАТЬ
WRITE пишет указанная строка в последовательный драйвер.
- Синтаксис
WRITE message
- Параметр
messageСообщение, записанное в устройство.
Следующий пример отправляет в последовательный драйвер модемную команду ATDT сопровождаемый переменной строкой № 1 и возврат каретки. (Для получения дополнительной информации посмотрите Переменные строки (varStrings).)
- Пример
WRITE "ATDT^1\13"