---
title: Introduction to CCL Modem Scripting Guide
framework: hardwaredrivers
role: article
path: apple-archive/documentation/HardwareDrivers/Reference/CCLScriptingRef/Introduction
---

# Introduction to CCL Modem Scripting Guide

Provides instructions for using the Communication Command Language (CCL) to write modem scripts.

## Organization of This Document

The guide is divided into two chapters and two appendixes:

- [Writing a CCL Script](../ScriptBasics/ScriptBasics.html#//apple_ref/doc/uid/TP40005464-CH3-SW1) describes the basic elements and structure of a CCL file and the basic tasks a script must perform. - [CCL Command Reference](../CCLCommands/CCLCommands.html#//apple_ref/doc/uid/TP40005464-CH4-SW1) lists the CCL commands, providing for each a definition, syntax, and an example, if appropriate. - [Result Codes](../ReturnValues/ReturnValues.html#//apple_ref/doc/uid/TP40005464-CH8-SW1) lists result codes returned by the CCL, with a description of the error and the accompanying message, if any. - [Cable Specifications](../CableSpecifications/CableSpecifications.html#//apple_ref/doc/uid/TP40005464-CH6-SW1) discusses requirements for a CTS/RTS handshaking cable, desirable when using OS X with a 9600 bps or faster modem.

## What You Need to Get Started

To write a CCL script for OS X, your computer should be running OS X v10.5. For ease of writing scripts, you should also have the latest version of the OS X Developer Tools installed. These provide the iSync Plug-in Maker tool, which makes it easier to create and edit scripts.

**Important:** You will also need the documentation that came with your modem; many commands vary from one modem to another.

For information about the iSync Plug-in Maker, see the *[iSync Plug-in Maker User Guide](../../../../Syncing/Conceptual/TramontanePluginBuilderUserGuide/Introduction/Introduction.html#//apple_ref/doc/uid/TP40003921)*.

You may also find it useful to consult a reference manual on telecommunications and modems, such as *The Complete Modem Reference *by Gilbert Held, published by John Wiley & Sons, Inc.

## Available Modem Scripts

A number of modem scripts have already been written for use with OS X. These can be found in the Modem Scripts folder within the user, system, and global Library folders (`/Library/Modem Scripts`, for example). If you have one of the modems for which a script has been provided, you don't need to write a script. You can display a list of the provided scripts from within the iSync Plug-in Maker tool, as described in the *[iSync Plug-in Maker User Guide](../../../../Syncing/Conceptual/TramontanePluginBuilderUserGuide/Introduction/Introduction.html#//apple_ref/doc/uid/TP40003921)*.

If you need to write a script, you may be able to use an existing script as a template. Be sure to use the Save As command to make a copy of the script you're modifying, so that you don't overwrite the original script.

[Next](../ScriptBasics/ScriptBasics.html)

Copyright © 2007 Apple Inc. All Rights Reserved. [Terms of Use](http://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](http://www.apple.com/privacy/) | Updated: 2007-06-28