Avaya PeriProducer User Guide

PeriProducer User’s Guide

Software Release 3.0

Avaya Business Communications Manager

Release 6.0

Document Status: Standard Document Number: P0995131 Document Version: 05.02 Date: June 2010

Notices

While reasonable efforts have been made to ensure that the information in this document is complete and accurate at the time of printing, Avaya assumes no liability for any errors. Avaya reserves the right to make changes and corrections to the information in this document without the obligation to notify any person or organization of such changes.

Documentation disclaimer

Avaya shall not be responsible for any modifications, additions, or deletions to the original published version of this documentation unless such modifications, additions, or deletions were performed by Avaya. End User agree to indemnify and hold harmless Avaya, Avaya’s agents, servants and employees against all claims, lawsuits, demands and judgments arising out of, or in connection with, subsequent modifications, additions or deletions to this documentation, to the extent made by End User.

Link disclaimer

Avaya is not responsible for the contents or reliability of any linked Web sites referenced within this site or documentation(s) provided by Avaya. Avaya is not responsible for the accuracy of any information, statement or content provided on these sites and does not necessarily endorse the products, services, or information described or offered within them. Avaya does not guarantee that these links will work all the time and has no control over the availability of the linked pages.

Warranty

Avaya provides a limited warranty on this product. Refer to your sales agreement to establish the terms of the limited warranty. In addition, Avaya’s standard warranty language, as well as information regarding support for this product, while under warranty, is available to Avaya customers and other parties through the Avaya Support Web site: http://www.avaya.com/support

Please note that if you acquired the product from an authorized reseller, the warranty is provided to you by said reseller and not by Avaya.

Licenses

THE SOFTWARE LICENSE TERMS AVAILABLE ON THE AVAYA WEBSITE, HTTP://SUPPORT.AVAYA.COM/LICENSEINFO/ ARE APPLICABLE TO ANYONE WHO DOWNLOADS, USES AND/OR INSTALLS AVAYA SOFTWARE, PURCHASED FROM AVAYA INC., ANY AVAYA AFFILIATE, OR AN AUTHORIZED AVAYA RESELLER (AS APPLICABLE) UNDER A COMMERCIAL AGREEMENT WITH AVAYA OR AN AUTHORIZED AVAYA RESELLER. UNLESS OTHERWISE AGREED TO BY AVAYA IN WRITING, AVAYA DOES NOT EXTEND THIS LICENSE IF THE SOFTWARE WAS OBTAINED FROM ANYONE OTHER THAN AVAYA, AN AVAYA AFFILIATE OR AN AVAYA AUTHORIZED RESELLER, AND AVAYA RESERVES THE RIGHT TO T AKE LEGAL ACTION AGAINST YOU AND ANYONE ELSE USING OR SELLING THE SOFTWARE WITHOUT A LICENSE. BY INSTALLING, DOWNLOADING OR USING THE SOFTWARE, OR AUTHORIZING OTHERS TO DO SO, YOU, ON BEHALF OF YOURSELF AND THE ENTITY FOR WHOM YOU ARE INSTALLING, DOWNLOADING OR USING THE SOFTWARE (HEREINAFTER REFERRED TO INTERCHANGEABLY AS "YOU" AND "END USER"), AGREE TO THESE TERMS AND CONDITIONS AND CREATE A BINDING CONTRACT BETWEEN YOU AND AVAYA INC. OR THE APPLICABLE AVAYA AFFILIATE ("AVAYA").

Except where expressly stated otherwise, no use should be made of the Documentation(s) and Pr oduct( s) p rovided by Avaya. All content in this documentation(s) and the product(s) pr ov id ed by Avaya including the selection, arrangement and design of the content is owned either by Avaya or its licensors and is protected b y copyright and other intellectual property laws including the sui generis rights relating to the protection of databases. You may not modify, copy, reproduce, republish, upload, post, transmit or distribute in any way any content, in whole or in part, including any code and software. Unauthorized reproduction, transmission, dissemination, storage, and or use without the express written consent of Avaya can be a criminal, as well as a civil offense under the applicable law.

Third Party Components

Certain software programs or portions thereof included in the Product may contain software distributed under third party agreements ("Third Party Components"), which may contain terms that expand or limit rights to use certain portions of the Product ("Third Party Terms" ). Information regarding distributed Linux OS source code (for those Products that have distributed the Linux OS source code), and identifying the copyright holders of the Third Party Components and the Third Party Terms that apply to them is available on the Avaya Support Web site: http://support.avaya.com/Copyright.

Trademarks

The trademarks, logos and service marks ("Marks") displayed in this site, the documentation(s) and product(s) pr ovided by Avaya are the registered or unregistered Marks of Avaya, its affiliates, or other third parties. Users are not permitted to use such Marks without prior written consent from A vaya or such third party which may own the Mark. Nothing contained in this site, the documentation(s) and product(s) should be construed as granting, by implication, estoppel, or otherwise, any license or right in and to the Marks without the express written permission of Avaya or the applicable third party. Avaya is a registered trademark of Avaya Inc. All non-Avaya

trademarks are the property of their respective owners.

Downloading documents

For the most current versions of documentation, see the Avaya Support. Web site: http://www.avaya.c om/support

Contact Avaya Support

Avaya provides a telephone number for you to use to report problems or to ask questions about your product. The support telephone number is 1-800-242-2121 in the United States. For additional support telephone numbers, see the Avaya Web site: http://

www.avaya.com/support

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

How to Use This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Organization of This Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Conventions Used in This Manual . . . . . . . . . . . . . . . . . . . . . . . . 26

Solaris and Windows 2000 Conventions . . . . . . . . . . . . . . . . . . . 27

Two-Button (Windows 2000) vs. Three-Button (Solaris)

Mouse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Trademark Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

HylaFAX Facsimile Software. . . . . . . . . . . . . . . . . . . . . . . . 28

Chapter 1 — Overview of PeriProducer Features . . . . . . . 31

PeriProducer Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Voice Response Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

Application Execution and Diagnostic Facilities . . . . . . . . . . . . . 33

Chapter 2 — PeriProducer Basics . . . . . . . . . . . . . . . . . . . . 35

Starting PeriProducer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36

Checking the PeriProducer Version . . . . . . . . . . . . . . . . . . . 36

Default Startup Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37

Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

Loading an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39

Loading an Autosave File . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Loading an Errorsave (Recovery) File . . . . . . . . . . . . . . . . . 42

Loading an Earlier Version of an Application . . . . . . . . . . . 42

Loading a Backup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43

Adding a Title to the Main Container. . . . . . . . . . . . . . . . . . 43

Saving Applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Saving an Application. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46

Saving an Application to a Different Name/Location . . . . . 46

Understanding the Backup (.pBK) File . . . . . . . . . . . . . . . . 47

Automatic Error Saving . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Saving a New Version of an Application . . . . . . . . . . . . . . . 48

Automatically Saving Applications (Autosave) . . . . . . . . . . 49

Saving a Container Block . . . . . . . . . . . . . . . . . . . . . . . . . . . 51

Leaving References Unresolved . . . . . . . . . . . . . . . . . . . 52

PeriProducer Application File Types . . . . . . . . . . . . . . . . . . 53

Printing an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54

Printing Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56

Printing in Batch Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

# P0995131 Page 3

PeriProducer User’s Guide

Quitting PeriProducer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66

Working With Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67

Changing the Default Print Settings . . . . . . . . . . . . . . . . 58

Selecting the Printer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Setting the PPROPOSTPRINTER Environment

Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59

Viewing the PostScript Output . . . . . . . . . . . . . . . . . . . . . . . 59

Version Control. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Version Renaming Process . . . . . . . . . . . . . . . . . . . . . . . . . . 60

Enabling Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . 61

Assigning a Version Identifying Number to an Application 62

Comparing Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63

Excluding Building Blocks from Generation . . . . . . . . . . . . 64

Clearing a Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Standard Action Window Items . . . . . . . . . . . . . . . . . . . . . . 66

Adding a Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

Customizing the Function of a Block . . . . . . . . . . . . . . . . . . 71

Changes to the Action Window . . . . . . . . . . . . . . . . . . . 72

Naming a Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

Locating Blocks within an Application . . . . . . . . . . . . . . . . 74

Using the Tool Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

Using the Blocks Menu . . . . . . . . . . . . . . . . . . . . . . . . . . 75

Using the Search Function . . . . . . . . . . . . . . . . . . . . . . . 76

Performing Operations on Grouped Blocks . . . . . . . . . . . . . 77

The Block Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

Adding Notes to a Block. . . . . . . . . . . . . . . . . . . . . . . . . . . . 82

Editing Block Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83

Copying a Block or Grouped Blocks . . . . . . . . . . . . . . . . . . 84

Moving a Block or Grouped Blocks . . . . . . . . . . . . . . . . . . . 85

Moving in a Single Construction Area . . . . . . . . . . . . . . 85

Moving Between Construction Areas . . . . . . . . . . . . . . . 85

Deleting a Block or Grouped Blocks . . . . . . . . . . . . . . . . . . 86

Restoring a Deleted Block or Grouped Blocks. . . . . . . . . . . 86

Reference Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87

Creating a Reference Block . . . . . . . . . . . . . . . . . . . . . . 88

Working With Reference Blocks . . . . . . . . . . . . . . . . . . 89

References to Parameterized Containers . . . . . . . . . . . . 90

Gathering Application Statistics (Block Execution

Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91

Determining Blocks Associated With a Counter . . . . . . 92

Passing Statistics Folders to a Linked Application . . . . . 93

Working With Block Connections and Connectors . . . . . . . 94

Understanding Block Connections . . . . . . . . . . . . . . . . . 94

Automatic Connections . . . . . . . . . . . . . . . . . . . . . . . . . . 94

Creating and Erasing Connections . . . . . . . . . . . . . . . . . 95

Using Connector Blocks . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

Page 4 # P0995131

Adding a Connector Block . . . . . . . . . . . . . . . . . . . . . . . 97

Chapter 3 — Understanding PeriProducer’s Primary Windows 99

The Main Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100

The Main Container Menu Bar. . . . . . . . . . . . . . . . . . . . . . 101

The Main Container File Menu . . . . . . . . . . . . . . . . . . 102

The Main Container Blocks Menu . . . . . . . . . . . . . . . . 103

The Main Container Execute Menu . . . . . . . . . . . . . . . 104

The Main Container Properties Menu . . . . . . . . . . . . . 106

The Tool Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

The Accessory Tool Kit . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Additional Tool Kits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110

Adding a Header to the Tool Kit . . . . . . . . . . . . . . . . . . . . 111

Using the Locator to Move Around an Application . . . . . . 111

Chapter 4 — Application Support Functions . . . . . . . . . . 113

Overview of Application Support Functions . . . . . . . . . . . . . . . 114

Executing Applications With PeriGEM . . . . . . . . . . . . . . . . . . 114

Using VEMUL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

Understanding Condition Handling . . . . . . . . . . . . . . . . . . 121

Simulating Success and Failure Conditions . . . . . . . . . . . . 121

Entering Commands in the PeriGEM Window . . . . . . . . . 122

Vemul Options on the Command Line . . . . . . . . . . . . . 124

VEMUL Response Table . . . . . . . . . . . . . . . . . . . . . . . 124

PeriGEM Script Commands . . . . . . . . . . . . . . . . . . . . . . . . 127

Creating and Saving a Script . . . . . . . . . . . . . . . . . . . . . . . 128

Executing the Script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130

Condition Data Window . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

Entering Data for a Get Input Response . . . . . . . . . . . . . . . 133

Understanding Local/Remote Connections . . . . . . . . . . . . 133

Generating the Application. . . . . . . . . . . . . . . . . . . . . . . . . 135

Batch Generating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136

Testing and Running the Application . . . . . . . . . . . . . . . . . 136

Stepping Through the Application . . . . . . . . . . . . . . . . 137

Interacting With Applications in Real Mode . . . . . . . . 138

Interacting With Applications in Simulated Mode . . . . 139

Pausing the Execution . . . . . . . . . . . . . . . . . . . . . . . . . . 141

Using the Watch Mode . . . . . . . . . . . . . . . . . . . . . . . . . 142

Attaching to an Executing Application. . . . . . . . . . . . . . . . 143

Tracing the Execution. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144

Evaluating Application Development with Complexity

Metrics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

# P0995131 Page 5

PeriProducer User’s Guide

Chapter 5 — Managing Vocabularies . . . . . . . . . . . . . . . . 149

Overview of Vocabulary Management . . . . . . . . . . . . . . . . . . . 150

Using PeriStudio to Edit Vocabularies . . . . . . . . . . . . . . . . . . . 152

Understanding the Prompt Editor Window . . . . . . . . . . . . . . . . 153

Using Vocabularies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157

Understanding the Vocabulary Management Window . . . . . . . 159

Using Data Cards as Vocabulary Phrases . . . . . . . . . . . . . . . . . 163

Prompting the Caller When Requesting Data . . . . . . . . . . . . . . 169

Building Blocks Using Speech Output . . . . . . . . . . . . . . . . . . . 174

Vocabulary Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

Referencing Vocabulary Elements . . . . . . . . . . . . . . . . . . . 150

Preparing Applications That Use Vocabularies . . . . . . . . . 150

Manipulating the Phrases List. . . . . . . . . . . . . . . . . . . . . . . 155

Marking Errors in the Phrases to Be Spoken in Order

List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156

The Vocabulary List Menu . . . . . . . . . . . . . . . . . . . . . . . . . 157

The Vocabulary Prefix List Menu . . . . . . . . . . . . . . . . . . . 158

To Be Defined Vocabulary Elements . . . . . . . . . . . . . . . . . 158

Vocabulary Files Used in the Current Application. . . . . . . 162

Elements in the Current Vocabulary. . . . . . . . . . . . . . . . . . 162

Selecting Data Cards to Speak . . . . . . . . . . . . . . . . . . . . . . 163

Speech Formats for Data Cards . . . . . . . . . . . . . . . . . . . . . 163

Speaking Numeric Data Cards Containing Decimal Points 168

Implementing Voice Menus . . . . . . . . . . . . . . . . . . . . . . . . 171

Voice Menu Example . . . . . . . . . . . . . . . . . . . . . . . . . . 171

SPEAK to the Caller (Speak Block) . . . . . . . . . . . . . . . . . . 174

SELECT from a Menu (Select Block) . . . . . . . . . . . . . . . . 175

READ Data Entered by the Caller (Read Block) . . . . . . . . 177

Chapter 6 — Receiving Caller Data . . . . . . . . . . . . . . . . . . 181

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Receiving Touch Tone Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Caller Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182

Input Timers and Partial Data. . . . . . . . . . . . . . . . . . . . . . . 183

READ Data Entered by the Caller (Read Block) . . . . . . . . 184

Editing Caller Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189

User Edit Sequences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190

Manage Touch Tone Edit Sequences (Edit Sequences

Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191

Voice Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

SELECT from a Menu (Select Block) . . . . . . . . . . . . . . . . 193

Receiving Speech Recognition . . . . . . . . . . . . . . . . . . . . . . . . . 196

Receiving Data from Multiple Sources . . . . . . . . . . . . . . . . . . . 198

Page 6 # P0995131

Chapter 7 — Managing Application Data . . . . . . . . . . . . . 199

Overview of Data Management . . . . . . . . . . . . . . . . . . . . . . . . . 200

Understanding Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

Scope. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Local Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Shared Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201

Persistent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Include File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Shared Constant . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202

Public . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

Container Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

Understanding Data Cards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204

Selecting Folders and Data Cards Within an Application . . . . . 205

Using Data in Multiple Applications (Include Files) . . . . . . . . . 207

Accessing an Include File . . . . . . . . . . . . . . . . . . . . . . . . . . 208

Adding and Opening Include Files at Subfolder Levels. . . 209

Locating Include Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211

Modifying an Include File . . . . . . . . . . . . . . . . . . . . . . . . . 211

Running PeriGEM with Include Files . . . . . . . . . . . . . . . . 212

Composite Data Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Using a Date as a Character and a Number . . . . . . . . . . . . 212

Accessing Individual Year Digits . . . . . . . . . . . . . . . . . . . . 212

Organizing Data With Lower-level Folders . . . . . . . . . . . . 213

Creating Multiple Copies of Data . . . . . . . . . . . . . . . . . . . . . . . 215

Understanding the Manage Data Folders Window . . . . . . . . . . 216

Global Manage Data Folders Window . . . . . . . . . . . . . . . . 216

Local Manage Data Folders Window . . . . . . . . . . . . . . . . . 217

Organizing the Folder List . . . . . . . . . . . . . . . . . . . . . . . . . 218

Data Folders Window Options . . . . . . . . . . . . . . . . . . . . . . 218

Saving a Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218

Folder Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 219

Data Item Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221

Understanding the System Folder . . . . . . . . . . . . . . . . . . . . . . . 223

Using Expressions to Manipulate Data . . . . . . . . . . . . . . . . . . . 227

Numeric Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228

Character Expressions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229

Conditional Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . 230

Conditional Expression with {And} and {Or} . . . . . . . 233

Assignment Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . 235

Assignment Operators for Numeric Expressions . . . . . 236

Assignment Squeeze Operator for String Expressions . 238

Assigning Data Card Values . . . . . . . . . . . . . . . . . . . . . 240

Conversion Operators . . . . . . . . . . . . . . . . . . . . . . . . . . 240

# P0995131 Page 7

PeriProducer User’s Guide

Chapter 8 — PeriProducer RDBMS Support . . . . . . . . . . 251

SQL Access to RDBMS (SQL Block) . . . . . . . . . . . . . . . . . . . . 252

Manipulating an RDBMS With the SQL Block . . . . . . . . . . . . 262

Automatically Generating SQL Commands (PeriSQL) . . . . . . 277

Converting Between Attribute:Value Strings and Data

Folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 241

Subscript Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245

Entering Expressions (the Expression-Entry Panel). . . . . . 245

Selecting From Multiple Occurrences of a Folder or Data

Card . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248

SQL Block Window Options . . . . . . . . . . . . . . . . . . . . . . . 254

Valid Data Types for SQL Parameters . . . . . . . . . . . . . . . . 261

Setting the RDBMS Environment Variables . . . . . . . . . . . 262

Accelerating RDBMS Access With SQLClnt (Oracle,

Sybase, and ODBC only) . . . . . . . . . . . . . . . . . . . . . . . . . . . 263

Logging On and Off the RDBMS. . . . . . . . . . . . . . . . . . . . 264

Logging On the RDBMS . . . . . . . . . . . . . . . . . . . . . . . 264

Logging Off the RDBMS . . . . . . . . . . . . . . . . . . . . . . . 264

Password Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . 264

RDBMS Information Locking . . . . . . . . . . . . . . . . . . . . . . 265

Storing Data From an SQL SELECT . . . . . . . . . . . . . . . . . 265

Storing a Returned NULL Value . . . . . . . . . . . . . . . . . 265

Storing Data in Existing Folders/Data Cards . . . . . . . . 265

Automatically Creating Folders and Data Cards . . . . . 266

Using Data Cards in the SQL Command . . . . . . . . . . . . . . 267

Using SELECT With a Wildcard (*) . . . . . . . . . . . . . . . . . 269

Fetching Multiple Records From a Database . . . . . . . . . . . 270

Setting Up a NEXT RECORD . . . . . . . . . . . . . . . . . . . 272

Accessing Records From a Result Set . . . . . . . . . . . . . . . . 272

Support for Oracle Linked Tables . . . . . . . . . . . . . . . . . . . 274

Support for Sybase/MSSQL Built-In System Functions . . 274

Stored Procedures and Functions . . . . . . . . . . . . . . . . . . . . 274

Handling RAISE Exception Condition . . . . . . . . . . . . . 275

Debugging an SQL Application . . . . . . . . . . . . . . . . . . . . . 276

Debugging SQL Commands . . . . . . . . . . . . . . . . . . . . . 276

Using System Status Messages . . . . . . . . . . . . . . . . . . . 277

Chapter 9 — Controlling Application Flow . . . . . . . . . . . 279

Overview of Application Control . . . . . . . . . . . . . . . . . . . . . . . 280

Understanding Connector Blocks . . . . . . . . . . . . . . . . . . . . . . . 281

Entering a Container (Entry Connector). . . . . . . . . . . . . . . 281

Exiting a Container (Exit Connector) . . . . . . . . . . . . . . . . . 281

Uncluttering the Display (Anonymous Connector) . . . . . . 282

Jumping to a Different Block (Source Connector) . . . . . . . 283

Page 8 # P0995131

Ending a Jump (Destination Connector). . . . . . . . . . . . . . . 284

Ending a Logical Path (Finish Execution Connector) . . . . 285

Resuming Execution After a Status/Exception Condition

(Resume Connector) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285

Resuming After Initiating a Timer . . . . . . . . . . . . . . . . 285

Understanding Resume Failures . . . . . . . . . . . . . . . . . . 286

Handling Shared Memory Locks During a Resume . . . 287 Positioning Blocks Executed by Reference (Anchor

Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287

COMPUTE - Assign/Move/Convert (Compute Block) . . . . . . . 288

Assignments Using a Portion of a Characters Card

(Substring) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292

Substring Syntax and Guidelines . . . . . . . . . . . . . . . . . 292

Substring Assignment Examples . . . . . . . . . . . . . . . . . 293

Manipulating the List of Operations. . . . . . . . . . . . . . . . . . 294

Marking Errors in the List of Operations . . . . . . . . . . . 294

Assignments Using Conditional Expressions . . . . . . . . . . . 295

Specifying the Item Prefix String . . . . . . . . . . . . . . . . . . . . 296

Clearing the Item Prefix . . . . . . . . . . . . . . . . . . . . . . . . 297

Item Prefix in a Linked Program . . . . . . . . . . . . . . . . . 297

SWITCH - Choose the Next Block (Switch Block) . . . . . . . . . 299

Comparisons Using a Portion of a Characters Card

(Substring) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301

Substring Syntax and Guidelines . . . . . . . . . . . . . . . . . 301

Substring Comparison Examples . . . . . . . . . . . . . . . . . 302

CONTAINER Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303

Adding a Container. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304

Grouping Blocks Into Containers . . . . . . . . . . . . . . . . . 304

Containers and Lower-Level Construction Areas . . . . . . . 304

Data Local to a Container . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Parameterized Containers . . . . . . . . . . . . . . . . . . . . . . . . . . 305

Code Sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307

Reference Blocks in a Saved Container . . . . . . . . . . . . 307

Looping a Container . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 308

Calling an External VEX File . . . . . . . . . . . . . . . . . . . . 309

Using an Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 310

Executing a Container For . . . . . . . . . . . . . . . . . . . . . . 310

Executing a Container While . . . . . . . . . . . . . . . . . . . . 310

Executing a Container Until . . . . . . . . . . . . . . . . . . . . . 311

Loop Expressions Using a Portion of a Character Card

(Substring) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311

Substring Syntax and Guidelines . . . . . . . . . . . . . . . . . 312

Substring Comparison Examples . . . . . . . . . . . . . . . . . 312

Vexlinked Applications with Containers . . . . . . . . . . . . . . 313

Creating an External container: . . . . . . . . . . . . . . . . . . 313

Making the Final Vex File . . . . . . . . . . . . . . . . . . . . . . 314

# P0995131 Page 9

PeriProducer User’s Guide

DYNAMIC Menus Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315

Access to CORBA Server Object Block . . . . . . . . . . . . . . . . . . 321

Blocking/Non-blocking Execution . . . . . . . . . . . . . . . . . . . . . . 326

Chapter 10 — Communicating With a Host Computer . . 329

Overview of Host Communication . . . . . . . . . . . . . . . . . . . . . . 330

Screen Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

Monitoring and Debugging Host Interaction . . . . . . . . . . . . . . . 333

Managing Host Timers and Exception Conditions . . . . . . . . . . 336

Verifying Host Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337

The Screen Mapper Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . 338

SEND HOST Information (SendHost Block) . . . . . . . . . . . . . . 348

RECEIVE HOST Information (ReceiveHost Block) . . . . . . . . 351

Initializing Dynamic Menus . . . . . . . . . . . . . . . . . . . . . . . . 315

Creating Selection Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . 317

Adding Menu Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

User Data Entry . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 318

Prompt Phrase Data . . . . . . . . . . . . . . . . . . . . . . . . . . . 319

Sample Application using Dynamic Menus . . . . . . . . . . . . 320

corbaclnt Operation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321

CORBA Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323

Screen Definitions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331

Screen Identification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 332

Message-Based Interaction . . . . . . . . . . . . . . . . . . . . . . . . . 332

Host Simulation (Simulated Mode) . . . . . . . . . . . . . . . . . . 333

Host Simulation (Real Mode) . . . . . . . . . . . . . . . . . . . . . . . 334

Mirroring Host Interaction (Real Mode) . . . . . . . . . . . . . . 335

Customizing the Host Simulation Window . . . . . . . . . . . . 335

Command Line Access to PeriMap . . . . . . . . . . . . . . . . . . 338

Accessing PeriMap From Within PeriProducer . . . . . . . . . 338

Determining the Save Status of the Current Map . . . . . . . . 339

Resizing the PeriMap Window . . . . . . . . . . . . . . . . . . . . . . 339

PeriMap Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Selecting a Map Field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339

Creating a Map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 340

Creating and Defining PeriMap fields . . . . . . . . . . . . . 340

Naming PeriMap Fields . . . . . . . . . . . . . . . . . . . . . . . . 341

Naming Maps in PeriMap . . . . . . . . . . . . . . . . . . . . . . . 341

Transferring Maps to PeriProducer . . . . . . . . . . . . . . . . 341

Grouping and Saving Maps . . . . . . . . . . . . . . . . . . . . . . . . 342

Saving a Map in a File . . . . . . . . . . . . . . . . . . . . . . . . . . . . 342

PeriMap Window Options . . . . . . . . . . . . . . . . . . . . . . . . . 343

Customizing PeriMap Properties . . . . . . . . . . . . . . . . . . . . 346

Page 10 # P0995131

Chapter 11 — Telephone Line Management . . . . . . . . . . . 353

Overview of Telephone Line Management . . . . . . . . . . . . . . . . 354

Phone Line Environment Parameters . . . . . . . . . . . . . . . . . . . . 354

Originating and Transferring (Referring) Calls . . . . . . . . . . . . . 355

Registering for Up/Down Service State Change of the Phone

Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 355

Set ENVIRONMENT Options (Environment Block) . . . . . . . . 357

Working With Environment Options . . . . . . . . . . . . . . . . . 358

Setting Environment Options From Data Cards . . . . . . . . . 359

ANSWER the Phone with a Greeting (Answer Block) . . . . . . . 360

ORIGINATE Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363

Transferring (Referring) a Call . . . . . . . . . . . . . . . . . . . . . . 365

Implementing an Automatic Referral . . . . . . . . . . . . . . 365

Call Progress Detection (Call Progress Detection Block) . . . . . 366

Handling a Call Progress Detection Event . . . . . . . . . . . . . 368

DISCONNECT (Hang Up) the Phone (Disconnect Block) . . . . 369

Detecting a TDD Call . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372

Advanced Telephone Line Functions . . . . . . . . . . . . . . . . . . . . 375

Bridging Calls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375

Implementing a Customized Referral . . . . . . . . . . . . . . 375

Returning to the Original Referral Line . . . . . . . . . . . . 377

BRIDGE Block . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378

Chapter 12 — Using Caller Message Recording (CMR) . 381

Overview of Caller Message Recording. . . . . . . . . . . . . . . . . . 382

CMR Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382

Understanding Media Storage (MS) Tokens . . . . . . . . . . . . . . . 384

Updating Vocabulary Elements with CMR Data . . . . . . . . . . . 385

CMR Watermark Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . 386

Suggested Handle Block Settings for CMR . . . . . . . . . . . . . . . 387

CMR Timeout Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388

RECORD a Message From the Caller (Record Block) . . . . . . . 389

Recording Related Messages . . . . . . . . . . . . . . . . . . . . . . . 393

Indexing the List of Messages . . . . . . . . . . . . . . . . . . . 393

Playing a Message to the Caller . . . . . . . . . . . . . . . . . . . . . . . . . 394

Appending to an existing recording . . . . . . . . . . . . . . . . . . 395

Appending to an existing Vocabulary Item . . . . . . . . . . . . 395

Appending to an existing CMR recording . . . . . . . . . . . . . 395

Appending to an existing WAV file . . . . . . . . . . . . . . . . . . 395

Deleting a CMR Message or Vocabulary Item. . . . . . . . . . 396

Chapter 13 — Using the Fax Resource . . . . . . . . . . . . . . . . 397

Overview of Fax Management . . . . . . . . . . . . . . . . . . . . . . . . . 398

Introduction to Fax Reception . . . . . . . . . . . . . . . . . . . . . . 398

# P0995131 Page 11

PeriProducer User’s Guide

RECEIVE a FAX (Receive Fax Block) . . . . . . . . . . . . . . . . . . . 399

SEND a FAX (Send Fax Block) . . . . . . . . . . . . . . . . . . . . . . . . 401

COMPOSE a FAX (within PeriProducer) . . . . . . . . . . . . . . . . . 404

Chapter 14 — Using Call Conferencing . . . . . . . . . . . . . . 415

Overview of Call Conferencing . . . . . . . . . . . . . . . . . . . . . . . . . 416

Call Conferencing Functions (Call Conferencing Block) . . . . . 417

Creating a Conference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420

Setting Conference Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 421

Joining a Conference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 424

Leaving a Conference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 427

Destroying a Conference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

Introduction to Fax Transmission . . . . . . . . . . . . . . . . . . . . 398

Introduction to Fax Composition . . . . . . . . . . . . . . . . . . . . 398

2FAX Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Synopsis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

2FAX Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405

Sample.ASC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 409

TIFFCP Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 410

EXAMPLES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 412

Conference Size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 421

Connection Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422

Coaching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 423

Local Conference Model . . . . . . . . . . . . . . . . . . . . . . . . . . 424

Global Conference Model. . . . . . . . . . . . . . . . . . . . . . . . . . 425

Conferencing Handle/Exception Conditions . . . . . . . . . . . 426

Chapter 15 — Using Databases and Flat Files . . . . . . . . . 429

Overview of Application File Management . . . . . . . . . . . . . . . 430

Flat files (Queues) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431

Database (Direct Access) Files . . . . . . . . . . . . . . . . . . . . . . . . . 432

Identifying Records to be Read . . . . . . . . . . . . . . . . . . . . . 432

Hashed Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

Indexed Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 433

Exclusive Locks on File Records . . . . . . . . . . . . . . . . . . . . 434

Sequenced Access to Records (Browsing) . . . . . . . . . . . . . 436

Starting a Browse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

Retrieving Records . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

Changing a Browse . . . . . . . . . . . . . . . . . . . . . . . . . . . . 436

Ending a Browse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Browse ID . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Database Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Platform Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Starting a Reader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437

Starting a Writer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 438

Page 12 # P0995131

Database Format Conversion . . . . . . . . . . . . . . . . . . . . . . . 438

Reader/Writer Synchronization . . . . . . . . . . . . . . . . . . . . . 438

The File List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439

DISK I/O To or From a File (DiskIO Block) . . . . . . . . . . . . . . 441

Chapter 16 — Special Purpose Blocks . . . . . . . . . . . . . . . . 447

HANDLE Exception Conditions (Handle Block) . . . . . . . . . . . 448

Condition Message Handling . . . . . . . . . . . . . . . . . . . . . . . 449

Noticing a Condition . . . . . . . . . . . . . . . . . . . . . . . . . . . 450

Handling/Catching/Ignoring Conditions. . . . . . . . . . . . . . . 452

Displaying Instances of a Condition Connector . . . . . . 454

Common Handle Block Settings . . . . . . . . . . . . . . . . . . 454

Handle According to Status . . . . . . . . . . . . . . . . . . . . . 456

Use SYSTEM Services (System Block) . . . . . . . . . . . . . . . . . . 457

Passing Parameters to Linked Applications . . . . . . . . . 464

CONSOLE Map Accept/Display (Console Block) . . . . . . . . . . 468

Console Block Overview . . . . . . . . . . . . . . . . . . . . . . . . . . 468

Customizing the Display Window . . . . . . . . . . . . . . . . . . . 470

Customizing the Size and Location of the Window . . . 470

Specifying the Display Node . . . . . . . . . . . . . . . . . . . . 472

Displaying Maps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472

Accepting Input from Map Displays . . . . . . . . . . . . . . . . . 473

Row and Column Operands . . . . . . . . . . . . . . . . . . . . . . . . 474

Handling Unusual Conditions. . . . . . . . . . . . . . . . . . . . . . . 474

Implementation Notes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474

Access an External RESOURCE (Resource Block) . . . . . . . . . 475

Available Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 477

Perform Media Operations (Media Operations Block) . . . . . . . 479

Line Operations (Line Operations Block) . . . . . . . . . . . . . . . . . 481

Call Control (Call Control Block) . . . . . . . . . . . . . . . . . . . . . . . 484

Abort Outstanding I/O (Abort Block) . . . . . . . . . . . . . . . . . . . . 486

Date Calculations (Datecalc Block) . . . . . . . . . . . . . . . . . . . . . . 487

Converting Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 488

Adding or Subtracting Dates. . . . . . . . . . . . . . . . . . . . . . . . 488

Datecalc Return Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489

Specifying a Conversion or Computation Pattern . . . . . . . 490

Datecalc <source-format> Characters . . . . . . . . . . . . . 490

Datecalc <operation> Characters . . . . . . . . . . . . . . . . . 491

Datecalc <target-format> Characters . . . . . . . . . . . . . . 491

Send E-mail (E-mail Block) . . . . . . . . . . . . . . . . . . . . . . . . . . . 493

Working with Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494

Setting Up a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494

Initializing a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 496

Sorting a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 497

Searching a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 498

# P0995131 Page 13

PeriProducer User’s Guide

Chapter 17 — Customizing PeriProducer . . . . . . . . . . . . . 501

Changing PeriProducer Properties . . . . . . . . . . . . . . . . . . . . . . . 502

Creating Custom Containers . . . . . . . . . . . . . . . . . . . . . . . . . . . 517

Table Sort (Table Sort Block). . . . . . . . . . . . . . . . . . . . . . . 499

Table Search (Table Search Block) . . . . . . . . . . . . . . . . . . 500

Configuring Main Container Properties . . . . . . . . . . . . . . . 502

PeriProducer 2.30 Runtime Behavior . . . . . . . . . . . . . . . . . 503

Handle Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503

Speak with Locked Keyboard . . . . . . . . . . . . . . . . . . . . 504

Configuring Application Properties . . . . . . . . . . . . . . . . . . 504

Configuring Generator Properties. . . . . . . . . . . . . . . . . . . . 510

Changing Colors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 514

Construction Area Grid Size . . . . . . . . . . . . . . . . . . . . . 515

Accessing Vocabulary Options. . . . . . . . . . . . . . . . . . . . . . 516

Adding Custom Containers to the Tool Kit . . . . . . . . . . . . 516

Redisplaying the Tool Kit. . . . . . . . . . . . . . . . . . . . . . . . . . 516

Defining and Modifying Custom Containers . . . . . . . . . . . 517

Undoing Changes to the Tool Kit . . . . . . . . . . . . . . . . . . . . 520

Working With Custom Containers . . . . . . . . . . . . . . . . . . . 521

Defining a Custom Container . . . . . . . . . . . . . . . . . . . . 521

Changing a Custom Container . . . . . . . . . . . . . . . . . . . 521

Removing a Custom Container . . . . . . . . . . . . . . . . . . . 522

Positioning the Custom Containers . . . . . . . . . . . . . . . . 522

Passing Data to or From a Custom Container. . . . . . . . . . . 522

Chapter 18 — Answers to Frequently Asked Questions . 523

Starting PeriProducer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524

Why Won't PeriProducer Start? . . . . . . . . . . . . . . . . . . 524

Why is the Tool Kit Blank When PeriProducer Starts? 524 How Can I Change the Location of the Default

Vocabulary? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 524

Why Won't PeriStudio Start? . . . . . . . . . . . . . . . . . . . . 524

Why Won't the Help Key Work? . . . . . . . . . . . . . . . . . 524

Can I Use SCCS to Maintain PeriProducer Source

Code? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525

Why Did I Get an “attribute not found in current table”

Error? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525

Creating an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526

How Do I Acknowledge a Notice Using the

Keyboard? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526

Why Are Some Block Options Unavailable (Grayed-Out)?

526 Why Doesn't a Break Point That is Set on a Container Cause

a Reference to That Container to Stop? . . . . . . . . . . . . 526

Page 14 # P0995131

What Should I do When the Case Connectors From a Switch

Go Outside the Container? . . . . . . . . . . . . . . . . . . . . . . 526

How Do I Keep From Closing (Unpinning) a Block Too

Soon? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 526

How Are the {And} and {Or} Operators in a Switch block

Evaluated? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527

Why isn't Paste Enabled After Copying a Group of

Blocks? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527

Why Can't I Paste a Container or a Handle Block That has

Source or Destination Connectors? . . . . . . . . . . . . . . . . 528

How Do I Display Several Messages on a Single

Line? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

How Do I Select an Array Element as an Operand in a

Block? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

Why Does My File List Have Files in it That I Didn't Define?

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 528

How Do I Select a Condition That Is Not In the List? . 528 Is the Terminator Character Saved Somewhere After a Read

Phone Block? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

Can I Batch Generate Applications? . . . . . . . . . . . . . . . 529

Can I Customize the Host Simulation Window? . . . . . 529

Can I Customize the Console Block Window? . . . . . . 529

How Do I Pass More Than Six Parameters to a Call

Function? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529

Executing an Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

Why Am I Getting the Output Failure Condition of When I

Execute an Answer Block in Simulated Mode? . . . . . . 530

Why Does PeriProducer Think My Application Has Been Changed When I Open an Empty Container For the First

Time? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

Why Isn't a Breakpoint Set at the Current Block? . . . . 530

Why Does My Application Immediately Stop After

Starting? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

How Are Block Statistics (Application Statistics)

Managed? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

Can You Just Print an Application? . . . . . . . . . . . . . . . 530

How Does PeriProducer Manage Conditions in a Linked

Application? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

Why Does the FAX Send Map Only Put Unprotected Fields

In the FAX? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530

How Are Parameters Passed to a Linked Application? 531 Why Does the Host Environment Option ertimeout Produce

an Error Message When Set to 2 Minutes? . . . . . . . . . . 531

What Does <Message> Mean? . . . . . . . . . . . . . . . . . . . 532

Troubleshooting an Application . . . . . . . . . . . . . . . . . . . . . . . . 533

# P0995131 Page 15

PeriProducer User’s Guide

Speech Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 534

Appendix A — Call Functions

Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537

Using Call Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 538

List of Call Functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541

Call Function Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544

What does it mean when the message, “Please, submit file

<filename> to R&D” is displayed? . . . . . . . . . . . . . . . . 533

How Do I Speak Fractional Values? . . . . . . . . . . . . . . . 534

How Does PeriProducer Speak a Two Digit Year? . . . 535

Alphabetical Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 541

Category Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542

String Manipulations . . . . . . . . . . . . . . . . . . . . . . . . . . . 542

Speak and Telephony . . . . . . . . . . . . . . . . . . . . . . . . . . 542

VMS Message Processing . . . . . . . . . . . . . . . . . . . . . . 542

Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 542

Time and Date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543

Data Manipulations . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543

Binary Data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543

Misc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 543

alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 544

array-qsort. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545

array-read . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546

array-write. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547

ask-date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548

avs-to-fol. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549

Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 549

Case Sensitivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 550

char-to-hex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551

char-to-num. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 553

concat-strings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555

condition-data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556

convert-base . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 559

convert-from-binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561

convert-to-binary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 562

crc16-a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

crc16-b . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563

current-mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 564

data-length . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 565

data-replace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 566

Translation Units and Pattern Processing . . . . . . . . . . . 567

Special Cases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567

date-calc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 568

date-calc Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 569

Page 16 # P0995131

Date Conversions and Computations . . . . . . . . . . . . . . 569

Holiday Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571

day-of-week . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574

double-mod10-check . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575

execute-command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 576

extern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578

fol-to-avs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579

Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 579

fol-to-xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580

Parameters: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580

format-string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 581

get-configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582

get-next-token . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 584

get-parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586

get-random . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 587

get-token-info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 588

hex-to-char . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589

hex-to-decimal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591

host-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 593

item-prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 594

item-prefix in Linked Applications . . . . . . . . . . . . . . . . 596

justify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

last-condition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 599

last-message-addr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 600

lrc8-a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602

lrc8-b. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602

message-queue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603

mod10-check. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604

move-data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 605

pack-pace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 606

prev-para . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607

process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608

command_name = create . . . . . . . . . . . . . . . . . . . . . . . 608

command_name = write-to . . . . . . . . . . . . . . . . . . . . . . 608

command_name = close . . . . . . . . . . . . . . . . . . . . . . . . 609

command_name = read-from . . . . . . . . . . . . . . . . . . . . 609

command_name = wait-for . . . . . . . . . . . . . . . . . . . . . . 609

command_name = detach . . . . . . . . . . . . . . . . . . . . . . . 610

command_name = kill . . . . . . . . . . . . . . . . . . . . . . . . . 610

recordmmf-status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611

reminder-cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612

reminder-message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613

scan-string. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 614

service-status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 617

set-currency. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618

set-date-prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 621

# P0995131 Page 17

PeriProducer User’s Guide

shared-memory-init. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623

speak . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 624

speak-as-fraction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626

speak-cid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 628

speak-conversion-type . . . . . . . . . . . . . . . . . . . . . . . . . . . . 630

Other Methods for Setting Language Rules . . . . . . . . . 631

Implicit Settings Invoked by speak-conversion-type . . 631

Specifying the year spoken form . . . . . . . . . . . . . . . . . 632

Implementing British Language Rules . . . . . . . . . . . . . 633

Using English Tokens . . . . . . . . . . . . . . . . . . . . . . . . . . 633

speak-gender-type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 634

table-search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 635

Defining the Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . 636

table-sort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 637

Defining the Array . . . . . . . . . . . . . . . . . . . . . . . . . . . . 638

throw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 639

time-calc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640

timer-difference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 644

timer-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 645

timestamp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 646

to-lower. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 647

to-upper. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 649

translate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 651

trim-spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 653

unpack-pace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654

web-translate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 655

xml . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656

Node Interface Commands . . . . . . . . . . . . . . . . . . . . . . 658

Node List Interface Commands . . . . . . . . . . . . . . . . . . 661

xml-to-fol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663

Parameters: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663

xtranslate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 665

Appendix B — Environment Options Reference . . . . . . . 667

Environment Options Overview . . . . . . . . . . . . . . . . . . . . . . . . 668

Application and System Environment . . . . . . . . . . . . . . . . . . . . 668

Host Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 671

Generic Environment Options . . . . . . . . . . . . . . . . . . . . . . . . . . 672

VENGINE Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673

Appendix C — Handle Conditions Reference . . . . . . . . . . 677

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 678

Application Management Exception Conditions . . . . . . . . . . . . 678

Phone Line Messages and Events . . . . . . . . . . . . . . . . . . . . . . . 683

Page 18 # P0995131

Phone Line Status/Timeout/Data Conditions . . . . . . . . . . . . . . 686

Resource Management Conditions . . . . . . . . . . . . . . . . . . . . . . 687

Message Recording and Multimedia Conditions . . . . . . . . . . . . 690

Call Conferencing Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . 692

Fax Conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 695

Host Status/Exception Conditions . . . . . . . . . . . . . . . . . . . . . . . 696

File Access Status/Exception Conditions . . . . . . . . . . . . . . . . . 699

RDBMS Exception Conditions . . . . . . . . . . . . . . . . . . . . . . . . . 701

CORBA Server Exceptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703

Miscellaneous Responses (not typically handled) . . . . . . . . . . . 704

Group I . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704

Group II. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706

Group III . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 708

Generic Status Condition Data . . . . . . . . . . . . . . . . . . . . . . . . . 709

Appendix D — Response Folder Reference . . . . . . . . . . . 711

Response Folder Condition Data . . . . . . . . . . . . . . . . . . . . . . . . 712

Enhanced Condition Data . . . . . . . . . . . . . . . . . . . . . . . . . . 712

Appendix E — Sample Printer

Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719

Cover Sheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 720

Flow Diagrams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721

Block Action Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 722

System Folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723

Data Dictionary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724

Vocabulary Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 725

Application Complexity Metrics . . . . . . . . . . . . . . . . . . . . . . . . 726

Container Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727

Block Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 728

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729

# P0995131 Page 19

PeriProducer User’s Guide

This page has been intentionally left blank.

Page 20 # P0995131

List of Tables

Application File Types 53 Print Container Window 56 Standard Fields and Functions 66 Standard PeriProducer Blocks 67 Block Menu 79 Main Container File Menu 102 Main Container Execute Menu 104 Main Container Properties Menu 106 Accessory Tool Kit blocks 108 PeriGEM Window Options 115 Vemul Commands 122 Vemul Options 124 List of Commands Available in a Script during Simulation 127 Prompt window options 154 Vocabulary Management window 160 Speak Block Options 174 Select Block Options 175 Read Block Options 177 Read Block Options 185 Manage Edit Sequences Block 191 Select Block Options 193 Data Card Types 204 Manage Data Folders window 219 Manage Data Folders window 221 System Folder Data Cards/Folders 223 Expression-entry Panel Options 246 SQL block options 254 Data Types for SQL Parameters 261 Compute Block Options 290 Switch Block Options 300 Container Properties Window Options 308 CORBA Block Options 323 PeriMap Options 343 Mapper Properties Window Options 346 SendHost Options 348 ReceiveHost Options 351 Environment Block Options 358 Answer Block Options 361 Originate Block Options 364 Call Progress Detection Block Options 366 Disconnect Block Options 371 Bridge Block Options 379 Record Block Options 389

# P0995131 Page 21

PeriProducer User’s Guide

Receive Fax Options 399 Send Fax Options 402 Call Conferencing Block Options 418 File List Window Options 439 DiskIO Block Options 442 Blocks Which Enable Message Reception 451 System Block Options 457 Console Block Options 468 Resource Block Options 476 Available Resources 477 Media Operations Block Options 479 Line Operations Block 482 Call Contol Block 484 Abort Block 486 Datecalc Return Codes 489 Datecalc block <source-format> Characters 490 E-mail Block Options 493 Table Sort Block Options 499 Table Search Options 500 Application Configuration Options 504 date-calc Source Format Pattern Characters 569 Operations and Operation Target Format 570 Target Format Pattern Characters for Conversion 570 date-calc Return Code 572 Mode Parameter for Gender of Currency Units 618 time-calc Source Format Pattern Characters 641 time-calc Operations and Operation Target Format 642 time-calc Target Format Pattern Characters for Conversion 642 time-calc Return Codes 643 Application and System Environment Options 668 Host Environment Options 671 VENGINE Environment Options 673 Response Folders ( ) 712

Page 22 # P0995131

Preface

PeriProducer User’s Guide

Scope

This manual documents the use and features of PeriProducer on Avaya Media Processing Server (MPS) Series Platforms. However, PeriProducer is designed to stand alone without a manual. Application developers should learn about telephone media application functions and the features of the PeriProducer environment by interacting directly with the software. All PeriProducer features are contained in the blocks and other user-friendly windows.

Intended Audience

Although this is a User’s Guide with How-To procedures and detailed explanations, it also serves as a reference for more experienced programmers.

Avaya recommends that application developers attend an on-site PeriProducer class as well as a system familiarization training program before attempting to create voice applications.

How to Use This Manual

This manual uses many standard terms relating to computer system, software application functions, and the Internet. However, it contains some terminology that can only be explained in the context of the MPS system. Refer to the Glossary of Avaya Media Processing Server (MPS) Terminology for definitions of MPS Series specific terms.

Initially, you should read this manual at least once, from start to finish. Later, you can use the Table of Contents to locate topics of interest for reference and review.

If you are reading this document online, use the cross-reference links (shown in blue) to quickly locate related topics. <L with your cursor over the cross-reference link. Click on any point in a Table of Contents entry to move to that topic. Click on the page number of any Index entry to access that topic page.

To familiarize yourself with various specialized textual references within the manual, see Conventions Used in This Manual on page 26.

Periphonics is now part of Avaya. The name Periphonics, and variations thereof, appear in this manual only where it is referred to in a product. (For examples, a PeriProducer application, the PERImps package, the perirev command, etc.)

EFT> click once with your mouse while positioned

Page 24 # P0995131

Organization of This Manual

• Chapters 1 - 3:

These chapters overview PeriProducer and provide the basics for loading, saving, printing, and constructing applications. Chapter 3 introduces the Main Container and the Tool Kit.

• Chapters 4 - 16:

These chapters detail more application specific activities including vocabulary management, data management, Caller Message Recording, fax management, and Call Conferencing. Each chapter describes PeriProducer blocks designed for these tasks.

• Chapter 17:

This chapter describes how to customize PeriProducer and create and use custom Containers.

• Chapter 18:

This chapter is a PeriProducer FAQ (Frequently Asked Questions) list. Refer to this chapter for tips before you contact technical support.

• Appendix A:

This appendix describes the Call functions available to PeriProducer applications.

• Appendix B:

This appendix details the environment options available in an Environment block.

• Appendix C:

This appendix details the status/exception conditions available from the Handle block.

• Appendix D:

This appendix contains samples of output from the PeriProducer print facility.

# P0995131 Page 25

PeriProducer User’s Guide

Conventions Used in This Manual

This manual uses different fonts and symbols to differentiate between document elements and types of information. These conventions are summarized in the following table.

Conventions Used in This Manual Sheet 1 of 2

Notation Description

Normal text

important term

system command

command, condition

and alarm

file name / directory

on-screen field

Book Reference

Normal text font is used for most of the document.

The Italics font is used to introduce new terms, to highlight meaningful words or phrases, or to distinguish specific terms from nearby text.

This font indicates a system command and/or its arguments. Such keywords are to be entered exactly as shown (i.e., users are not to fill in their own values).

Command, Condition and Alarm references appear on the screen in magenta text and reference the Command Reference Manual, the PeriProducer User’s Guide, or the Alarm Reference Manual, respectively. Refer to these documents for detailed information

Commands, Conditions, and Alarms.

about

This font is used for highlighting the names of disk directories, files, and extensions for file names. It is also used to show displays on text-based screens (e.g., to show the contents of a file.)

This font is used for field labels, on-screen menu buttons, and action buttons.

A term that appears within angled brackets denotes a terminal keyboard key, a telephone keypad button, or a system mouse button.

This font indicates the names of other publications referenced within the document.

cross reference

A cross reference is shown on the screen in blue. Click on the cross reference to access the referenced location. A cross reference that refers to a section name accesses the first page of that section.

The Note icon identifies notes, important facts, and other keys to understanding.

The Caution icon identifies procedures or events that require special attention. The icon indicates a warning that serious problems may arise if the stated instructions are improperly followed.

Page 26 # P0995131

Conventions Used in This Manual Sheet 2 of 2

Notation Description

The flying Window icon identifies procedures or events that apply to the Windows 2000 operating system only.

The Solaris icon identifies procedures or events that apply to the Solaris operating system only.

1. Windows 2000 and the flying Window logo are either trademarks or registered trademarks of the Microsoft Corporation.

2. Solaris® is a registered trademark of The Open Group in the U.S. and other countries.

Solaris and Windows 2000 Conventions

This manual depicts examples (command line syntax, configuration files, and screen shots) in Solaris format. In certain instances Windows 2000 specific commands, procedures, or screen shots are shown where required. The following table lists examples of general operating system conventions to keep in mind when using this manual with either the Solaris or Windows 2000 operating system.

Solaris Windows 2000

Environment $PPROHOME %PPROHOME%

Paths $PPROHOME/bin %PPROHOME%\bin

Command <command> & start /b <command>

Two-Button (Windows 2000) vs. Three-Button (Solaris)

# P0995131 Page 27

PeriProducer User’s Guide

Mouse

<SELECT> Left button

<ADJUST> Left and Right

<MENU> Right button

Trademark Conventions

The following trademark information is presented here and applies throughout for third party products discussed within this manual. Trademarking information is not repeated hereafter.

Solaris other countries.

Solaris, SunOS, OpenWindows, SPARC, and UltraSPARC are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States and other countries.

<SELECT> Left button

<ADJUST> Middle button

together

<MENU> Right button

and Motif® are registered trademarks of The Open Group in the U.S. and

Microsoft, MSSQL, Windows, Windows 2000, Internet Explorer, and the Flying Windows logo are either trademarks or registered trademarks of Microsoft Corporation.

Oracle

Sybase

Informix affiliates.

HylaFAX Facsimile Software

Permission to use, copy, modify, distribute, and sell this software and its

is a registered trademark of Oracle Corporation.

™

and SYBASE™ are trademarks of Sybase, Inc. or its subsidiaries.

and INFORMIX® are registered trademarks of Informix Corporation or its

Page 28 # P0995131

documentation for any purpose is hereby granted without fee, provided that (i) the above copyright notices and this permission notice appear in all copies of the software and related documentation, and (ii) the names of Sam Leffler and Silicon Graphics may not be used in any advertising or publicity relating to the software without the specific, prior written permission of Sam Leffler and Silicon Graphics.

THE SOFTWARE IS PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EXPRESS, IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT SHALL SAM LEFFLER OR SILICON GRAPHICS BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

# P0995131 Page 29

PeriProducer User’s Guide

This page has been intentionally left blank.

Page 30 # P0995131

+ 718 hidden pages

Avaya PeriProducer User Guide

Specifications and Main Features

Frequently Asked Questions

User Manual

Table of Contents

List of Tables

Preface