Inside Macintosh: Networking With Open Transport / Part 1 - Open Transport Essentials

Chapter 18 - Printer Access Protocol (PAP)

This chapter describes the programming interface to Open Transport's implementation of the Printer Access Protocol (PAP) PAP offers a connection-oriented transactionless service that has been traditionally restricted to AppleTalk printing. This chapter explains how you can use PAP to set up a printer server endpoint that awaits connection requests from active PAP endpoints. It also also explains how to set up an active PAP client endpoint, how to send data directly from it to the printer server, and how the client endpoint receives messages back from the server.

You should read this chapter if you want to write an application that uses PAP to print directly to AppleTalk printers or that implements a PAP server, such as a print spooler. This chapter explains how you

• create and use an active PAP client endpoint

• create and use a passive PAP server endpoint

• send and receive data with PAP

• divide a PAP data stream into discrete logical units

• set a PAP server to respond to a client's SendStatus call

This chapter begins with a description of PAP and the services that it provides under Open Transport. The section "Using General Open Transport Functions With PAP" then gives detailed information about how PAP client applications use the endpoint functions that Open Transport provides for connection-oriented transactionless protocols. For a more detailed explanation of endpoints and their functions, read the chapter "Endpoints".

For reference information about PAP options, see "PAP Reference". For an overview of PAP and how it fits within the AppleTalk protocol stack, read the chapter "Introduction to AppleTalk", which also introduces and defines some of the terminology used in this chapter. PAP under Open Transport conforms to the detailed specifications in Inside AppleTalk, second edition. See that book for further information about the features mentioned here.

---

Chapter Contents

About PAP

Using PAP

Binding PAP Endpoints

Specifying PAP Options

The End-of-Message Option

The Open Retry Option

The Server Status Option

The Reply Count Option

Disconnecting

Using General Open Transport Functions With PAP

OTBind

OTConnect

OTRcvConnect

OTListen

OTAccept

OTSnd

OTRcv

OTSndDisconnect

OTRcvDisconnect