Ссылка команды 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
Параметры
monitor
0

Отключите 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
Параметры
baudRate

300, 1200, 2400 (значение по умолчанию), 4800, 9600, 14400, 19200, 28800, 38400, 57600, и т.д.

parity

1 для отрицательной четности 2 для даже четности 0 или 3 ни для какой четности (значение по умолчанию)

dataBits

5, 6, 7, или 8 (значение по умолчанию)

stopBits

1 для 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"