Dyrf03en PDF

PowerDynamo Reference
PowerDynamo
Version 3.5
MC00331
Last revised: October 1999
Copyright © 1989-1999 by Sybase, Inc. All rights reserved.
This publication pertains to Sybase database management software and to any subsequent release until otherwise indicated in new
editions or technical notes. Information in this document is subject to change without notice. The software described herein is furnished
under a license agreement, and it may be used or copied only in accordance with the terms of that agreement.
To order additional documents, U.S. and Canadian customers should call Customer Fulfillment at (800) 685-8225, fax (617) 229-9845.
Customers in other countries with a U.S. license agreement may contact Customer Fulfillment via the above fax number. All other
international customers should contact their Sybase subsidiary or local distributor. Upgrades are provided only at regularly scheduled
software release dates. No part of this publication may be reproduced, transmitted, or translated in any form or by any means, electronic,
mechanical, manual, optical, or otherwise, without the prior written permission of Sybase, Inc.
Sybase, the Sybase logo, ADA Workbench, Adaptable Windowing Environment, Adaptive Component Architecture, Adaptive Server,
Adaptive Server Anywhere, Adaptive Server Enterprise, Adaptive Server Enterprise Monitor, Adaptive Server Enterprise Replication,
Adaptive Server Everywhere, Adaptive Server IQ, Adaptive Warehouse, AnswerBase, Anywhere Studio, Application Manager,
AppModeler, APT Workbench, APT-Build, APT-Edit, APT-Execute, APT-FORMS, APT-Translator, APT-Library, Backup Server,
ClearConnect, Client-Library, Client Services, Data Pipeline, Data Workbench, DataArchitect, Database Analyzer, DataExpress,
DataServer, DataWindow, DB-Library, dbQueue, Developers Workbench, Direct Connect Anywhere, DirectConnect, Distribution
Director, E-Anywhere, E-Whatever, Embedded SQL, EMS, Enterprise Application Server, Enterprise Application Studio, Enterprise
Client/Server, Enterprise Connect, Enterprise Data Studio, Enterprise Manager, Enterprise SQL Server Manager, Enterprise Work
Architecture, Enterprise Work Designer, Enterprise Work Modeler, EWA, Gateway Manager, ImpactNow, InfoMaker, Information
Anywhere, Information Everywhere, InformationConnect, InternetBuilder, iScript, Jaguar CTS, jConnect for JDBC, KnowledgeBase,
MainframeConnect, Maintenance Express, MAP, MDI Access Server, MDI Database Gateway, media.splash, MetaWorks, MySupport,
Net-Gateway, Net-Library, NetImpact, ObjectConnect, ObjectCycle, OmniConnect, OmniSQL Access Module, OmniSQL Toolkit,
Open Client, Open ClientConnect, Open Client/Server, Open Client/Server Interfaces, Open Gateway, Open Server, Open
ServerConnect, Open Solutions, Optima++, PB-Gen, PC APT Execute, PC DB-Net, PC Net Library, Power++, power.stop, PowerAMC,
PowerBuilder, PowerBuilder Foundation Class Library, PowerDesigner, PowerDimensions, PowerDynamo, PowerJ, PowerScript,
PowerSite, PowerSocket, Powersoft, PowerStage, PowerStudio, PowerTips, Powersoft Portfolio, Powersoft Professional, PowerWare
Desktop, PowerWare Enterprise, ProcessAnalyst, Report Workbench, Report-Execute, Replication Agent, Replication Driver,
Replication Server, Replication Server Manager, Replication Toolkit, Resource Manager, RW-DisplayLib, RW-Library, S Designor, S-
Designor, SDF, Secure SQL Server, Secure SQL Toolset, Security Guardian, SKILS, smart.partners, smart.parts, smart.script, SQL
Advantage, SQL Anywhere, SQL Anywhere Studio, SQL Code Checker, SQL Debug, SQL Edit, SQL Edit/TPU, SQL Everywhere, SQL
Modeler, SQL Remote, SQL Server, SQL Server Manager, SQL SMART, SQL Toolset, SQL Server/CFT, SQL Server/DBM, SQL
Server SNMP SubAgent, SQL Station, SQLJ, STEP, SupportNow, Sybase Central, Sybase Client/Server Interfaces, Sybase Financial
Server, Sybase Gateways, Sybase MPP, Sybase SQL Desktop, Sybase SQL Lifecycle, Sybase SQL Workgroup, Sybase User Workbench,
SybaseWare, Syber Financial, SyberAssist, SyBooks, System 10, System 11, System XI (logo), SystemTools, Tabular Data Stream,
Transact-SQL, Translation Toolkit, UNIBOM, Unilib, Uninull, Unisep, Unistring, URK Runtime Kit for UniCode, Viewer, Visual
Components, VisualSpeller, VisualWriter, VQL, WarehouseArchitect, Warehouse Control Center, Warehouse Studio, Warehouse
WORKS, Watcom, Watcom SQL, Watcom SQL Server, Web Deployment Kit, Web.PB, Web.SQL, WebSights, WebViewer, WorkGroup
SQL Server, XA-Library, XA-Server and XP Server are trademarks of Sybase, Inc. 9/99
Unicode and the Unicode Logo are registered trademarks of Unicode, Inc.
All other company and product names used herein may be trademarks or registered trademarks of their respective companies.
Use, duplication, or disclosure by the government is subject to the restrictions set forth in subparagraph (c)(1)(ii) of DFARS 52.227-
7013 for the DOD and as set forth in FAR 52.227-19(a)-(d) for civilian agencies.
Sybase, Inc., 6475 Christie Avenue, Emeryville, CA 94608.

Contents
About This Book ........................................................................................................................ xvii
CHAPTER 1 Dynamo Tags................................................................................... 1

Overview .......................................................................................... 1
Dynamo tags versus DynaScript ...................................................... 3
The Dynamo tags ............................................................................. 4
COMPONENT ........................................................................... 4
DATA ......................................................................................... 8
DOCUMENT.............................................................................. 9
ELSE ....................................................................................... 11
ELSEIF .................................................................................... 11
ENDIF...................................................................................... 12
EVALUATE.............................................................................. 12
EXECUTE ............................................................................... 13
FORMATTING......................................................................... 13
IF ............................................................................................. 19
INCLUDE................................................................................. 19
LABEL ..................................................................................... 20
MAILPIECE ............................................................................. 21
SCRIPT ................................................................................... 22
SQL ......................................................................................... 23
SQL_INSERT .......................................................................... 25
SQL condition .......................................................................... 28
SQL_ERROR_CODE .............................................................. 29
SQL_ERROR_INFO................................................................ 30
SQL_STATE............................................................................ 31
CHAPTER 2 The DynaScript Language............................................................ 33

Overview ........................................................................................ 33
SCRIPT tag .................................................................................... 34
Literals............................................................................................ 34
Integers ................................................................................... 35
Floating-point numbers............................................................ 35
iii
Contents
Booleans ................................................................................. 35
Strings ..................................................................................... 35
Variables ........................................................................................ 36
Expressions.................................................................................... 38
Operators ....................................................................................... 39
Arithmetic operators ................................................................ 40
Conditional operator ................................................................ 40
String operators....................................................................... 41
Comparison operators............................................................. 41
Boolean operators ................................................................... 42
Bitwise operators..................................................................... 42
Delete operator........................................................................ 42
Void operator........................................................................... 43
Typeof operator ....................................................................... 43
Statements ..................................................................................... 43
if-else statement ...................................................................... 44
for statement ........................................................................... 44
while statement ....................................................................... 45
do-while statement .................................................................. 45
switch statement...................................................................... 46
break statement....................................................................... 48
continue statement .................................................................. 48
for-in statement ....................................................................... 48
with statement ......................................................................... 49
class statement ....................................................................... 50
this keyword ............................................................................ 51
new operator ........................................................................... 51
var statement........................................................................... 52
function statement ................................................................... 52
return statement ...................................................................... 53
import statement...................................................................... 54
comment statements ............................................................... 55
exit statement .......................................................................... 56
Functions........................................................................................ 56
Functions and the arguments object ....................................... 57
Built-in functions ...................................................................... 58
Dynamo-specific built-in functions........................................... 59
Objects ........................................................................................... 66
Properties and methods .......................................................... 66
Object-oriented concepts ........................................................ 68
Defining base classes ............................................................. 69
Extending existing classes by inheritance............................... 70
Creating instances of classes.................................................. 72
Working with named and indexed members ........................... 72
iv
Contents
Paths ....................................................................................... 73
Wildcards................................................................................. 73
CHAPTER 3 DynaScript Predefined Objects ................................................... 75

Array object .................................................................................... 76
Array properties.............................................................................. 77
length property ........................................................................ 77
Array methods................................................................................ 77
join method .............................................................................. 77
reverse method ....................................................................... 78
sort method ............................................................................. 78
toString method ....................................................................... 79
attachment object........................................................................... 80
attachment properties .................................................................... 80
mimeType property ................................................................. 81
name property ......................................................................... 81
attachment methods....................................................................... 82
GetContents method ............................................................... 82
GetErrorCode method ............................................................. 83
GetErrorInfo method................................................................ 84
SaveAsDocument method....................................................... 84
SaveAsFile method ................................................................. 85
Boolean object ............................................................................... 86
Boolean methods ........................................................................... 86
toString method ....................................................................... 86
valueOf method ....................................................................... 87
connection object ........................................................................... 87
connection properties..................................................................... 90
autoCommit property ............................................................... 90
connected property.................................................................. 90
connectionType property......................................................... 91
connectParameters property ................................................... 91
database property ................................................................... 92
databaseType property ........................................................... 92
dataSource property................................................................ 92
dataSourceList property .......................................................... 93
description property................................................................. 93
isolationLevel property ............................................................ 93
name property ......................................................................... 94
password property................................................................... 95
server property ........................................................................ 95
simulateCursors property ........................................................ 95
userId property ........................................................................ 97
connection methods ....................................................................... 97
Contents
Commit method ....................................................................... 97

Connect method ...................................................................... 98
CreateComponent method ...................................................... 98
CreateQuery method............................................................... 99
Disconnect method................................................................ 100
GetErrorCode method ........................................................... 100
GetErrorInfo method.............................................................. 101
GetState method ................................................................... 102
GetSupportedMoves method ................................................ 103
Rollback method.................................................................... 103
Date object ................................................................................... 104
Date methods............................................................................... 106
getDate method..................................................................... 106
getDay method ...................................................................... 106
getFullYear method ............................................................... 107
getHours method................................................................... 107
getMilliseconds method......................................................... 107
getMinutes method................................................................ 108
getMonth method .................................................................. 108
getSeconds method .............................................................. 108
getTime method .................................................................... 109
getTimezoneOffset method ................................................... 109
getUTCDate method ............................................................. 110
getUTCDay method............................................................... 110
getUTCFullYear method........................................................ 111
getUTCHours method ........................................................... 111
getUTCMilliseconds method ................................................. 111
getUTCMinutes method ........................................................ 112
getUTCMonth method ........................................................... 112
getUTCSeconds method ....................................................... 113
getYear method..................................................................... 113
parse method ........................................................................ 114
setDate method ..................................................................... 114
setFullYear method ............................................................... 115
setHours method ................................................................... 115
setMilliseconds method ......................................................... 116
setMinutes method ................................................................ 116
setMonth method................................................................... 117
setSeconds method............................................................... 118
setTime method..................................................................... 118
setUTCDate method.............................................................. 119
setUTCFullYear method........................................................ 120
setUTCHours method............................................................ 121
setUTCMilliseconds method.................................................. 121
vi
Contents
setUTCMinutes method......................................................... 122

setUTCMonth method ........................................................... 122
setUTCSeconds method ....................................................... 123
setYear method ..................................................................... 123
toGMTString method ............................................................. 124
toLocaleString method .......................................................... 124
toString method ..................................................................... 124
toUTCString method.............................................................. 125
valueOf method ..................................................................... 125
document object........................................................................... 126
document properties .................................................................... 127
cachedOutputTimeOut property ............................................ 127
connectionId property............................................................ 127
connectionName property ..................................................... 128
contentType property ............................................................ 128
description property............................................................... 128
id property ............................................................................. 129
lastModified property ............................................................. 129
location property.................................................................... 130
name property ....................................................................... 130
parent property ...................................................................... 131
redirect property .................................................................... 131
size property.......................................................................... 131
source property ..................................................................... 132
status property....................................................................... 132
type property ......................................................................... 133
value property........................................................................ 133
document methods....................................................................... 136
ExportTo method ................................................................... 137
GetDirectory method ............................................................. 137
GetGenerated method........................................................... 138
GetServerVariable method .................................................... 138
ImportFrom method ............................................................... 140
IncludeGenerated method ..................................................... 140
Write method ......................................................................... 142
WriteLn method ..................................................................... 142
DOMAttribute object ..................................................................... 143
DOMAttribute properties .............................................................. 144
name property ....................................................................... 144
specified property .................................................................. 145
value property........................................................................ 145
DOMAttribute methods................................................................. 146
DOMCDATASection object .......................................................... 146
DOMCharacterData object ........................................................... 146
Contents
DOMCharacterData properties .................................................... 147

data property ......................................................................... 147
length property ...................................................................... 147
DOMCharacterData methods....................................................... 148
appendData method.............................................................. 148
deleteData method ................................................................ 148
insertData method ................................................................. 149
replaceData method .............................................................. 149
substringData method ........................................................... 150
DOMComment object................................................................... 150
DOMDocument object .................................................................. 151
DOMDocument properties ........................................................... 151
doctype property.................................................................... 151
documentElement property ................................................... 152
implementation property........................................................ 152
DOMDocument methods.............................................................. 153
createAttribute method .......................................................... 153
createCDATASection method ............................................... 153
createComment method........................................................ 154
createDocumentFragment method........................................ 154
createElement method .......................................................... 155
createEntityReference method.............................................. 155
createProcessingInstruction method ..................................... 155
createTextNode method........................................................ 156
getElementsByTagName method ......................................... 156
prettyPrint method ................................................................. 157
DOMDocumentFragment object .................................................. 157
DOMDocumentType object .......................................................... 158
DOMDocumentType properties ................................................... 158
entities property..................................................................... 158
name property ....................................................................... 159
notations property.................................................................. 160
DOMElement object ..................................................................... 160
DOMElement property ................................................................. 161
tagName property.................................................................. 161
DOMElement methods................................................................. 161
getAttribute method ............................................................... 161
getAttributeNode method ...................................................... 162
getElementsByTagName method ......................................... 162
normalize method.................................................................. 163
removeAttribute method ........................................................ 164
removeAttributeNode method ............................................... 164
setAttribute method ............................................................... 165
setAttributeNode method....................................................... 165
viii
Contents
DOMEntity object ......................................................................... 166

DOMEntity properties................................................................... 166
notationName property.......................................................... 167
publicId property.................................................................... 167
systemId property.................................................................. 168
DOMEntityReference object......................................................... 168
DOMImplementation object.......................................................... 169
DOMImplementation methods ..................................................... 169
hasFeature method ............................................................... 169
DOMNamedNodeMap object ....................................................... 170
DOMNamedNodeMap property ................................................... 170
length property ...................................................................... 171
DOMNamedNodeMap methods ................................................... 171
getNamedItem method .......................................................... 171
item method........................................................................... 171
removeNamedItem method ................................................... 172
setNamedItem method .......................................................... 172
DOMNode object.......................................................................... 173
DOMNode properties ................................................................... 174
attributes property ................................................................. 174
childNodes property .............................................................. 174
firstChild property .................................................................. 175
lastChild property .................................................................. 176
nextSibling property............................................................... 176
nodeName property............................................................... 176
nodeType property ................................................................ 177
nodeValue property ............................................................... 179
ownerDocument property ...................................................... 179
parentNode property ............................................................. 180
previousSibling property ........................................................ 180
DOMNode methods ..................................................................... 181
appendChild method ............................................................. 181
cloneNode method ................................................................ 181
hasChildNodes method ......................................................... 182
insertBefore method .............................................................. 182
removeChild method ............................................................. 182
replaceChild method ............................................................. 183
DOMNodeList object .................................................................... 183
DOMNodeList property ................................................................ 183
length property ...................................................................... 184
DOMNodeList methods................................................................ 184
item method........................................................................... 184
DOMNotation object ..................................................................... 184
DOMNotation properties .............................................................. 185
Contents
publicId property.................................................................... 185

systemId property.................................................................. 185
DOMNotation methods................................................................. 185
DOMProcessingInstruction object ................................................ 185
DOMProcessingInstruction properties ......................................... 186
data property ......................................................................... 186
target property ....................................................................... 186
DOMProcessingInstruction methods............................................ 187
The DOMText object .................................................................... 187
DOMText properties..................................................................... 188
DOMText methods ....................................................................... 188
splitText method .................................................................... 188
file object ...................................................................................... 188
file properties................................................................................ 189
eof property ........................................................................... 190
errorNumber property............................................................ 190
errorString property ............................................................... 191
name property ....................................................................... 192
mode property ....................................................................... 192
file methods.................................................................................. 193
Close method ........................................................................ 193
Delete method ....................................................................... 193
GetFilePtr method ................................................................. 194
Open method......................................................................... 194
Read method......................................................................... 195
ReadChar method ................................................................. 195
ReadLine method .................................................................. 196
Seek method ......................................................................... 196
Write method ......................................................................... 196
WriteLine method .................................................................. 197
FTP object.................................................................................... 197
FTP methods................................................................................ 198
ChangeCurrentDirectory method .......................................... 198
Connect method .................................................................... 198
CreateDirectory method ........................................................ 199
DeleteFile method ................................................................. 199
PutData method .................................................................... 201
PutDataWithAppend method................................................. 202
PutDocument method............................................................ 203
PutDocumentWithAppend method ........................................ 204
PutFile method ...................................................................... 205
x
Contents
PutFileWithAppend method................................................... 205

RemoveDirectory method...................................................... 206
RetrieveCurrentDirectory method.......................................... 206
RenameFile method .............................................................. 207
RetrieveData method ............................................................ 207
RetrieveDirectoryListing method ........................................... 208
RetrieveDocument method.................................................... 208
RetrieveFile method .............................................................. 209
RetrieveFileWithAppend method........................................... 210
The Function object...................................................................... 210
Function properties ...................................................................... 211
length property ...................................................................... 211
Function methods......................................................................... 212
toString method ..................................................................... 212
java object .................................................................................... 212
java methods................................................................................ 214
CreateComponent method .................................................... 215
CreateObject method ............................................................ 217
CallStaticMethod method ...................................................... 217
GetHomeInterface method .................................................... 218
GetUserTransaction method ................................................. 220
mailList object .............................................................................. 223
mailList properties ........................................................................ 224
count property ....................................................................... 224
mailList methods .......................................................................... 225
mailPiece object (incoming) ......................................................... 227
mail piece properties (incoming) .................................................. 228
attachments property............................................................. 228
body property ........................................................................ 228
from property ......................................................................... 229
headers property ................................................................... 229
recipients property................................................................. 230
replyTo property .................................................................... 230
sender property ..................................................................... 231
size property.......................................................................... 232
subject property..................................................................... 232
mail piece methods (incoming) .................................................... 233
Delete method ....................................................................... 233
Forward method .................................................................... 233
Contents
Redirect method .................................................................... 235

Reply method ........................................................................ 236
Retrieve method .................................................................... 237
mailPiece object (outgoing).......................................................... 238
mailPiece properties (outgoing) ................................................... 239
body property ........................................................................ 239
from property ......................................................................... 240
sender property ..................................................................... 242
smtpHost property ................................................................. 243
body property ........................................................................ 244
mailPiece methods (outgoing)...................................................... 244
AddRecipient method ............................................................ 244
AddReplyTo method.............................................................. 247
AttachData method................................................................ 248
AttachDocument method....................................................... 248
AttachFile method ................................................................. 249
Send method ......................................................................... 251
Math object................................................................................... 252
Math properties ............................................................................ 252
E property.............................................................................. 252
LN2 property.......................................................................... 253
LN10 property........................................................................ 253
LOG2E property .................................................................... 254
LOG10E property .................................................................. 254
PI property............................................................................. 254
SQRT1_2 property ................................................................ 255
SQRT2 property .................................................................... 255
Math methods .............................................................................. 255
abs method............................................................................ 256
acos method.......................................................................... 256
asin method........................................................................... 256
atan method .......................................................................... 256
atan2 method ........................................................................ 257
ceil method ............................................................................ 257
cos method............................................................................ 257
exp method............................................................................ 258
floor method .......................................................................... 258
log method............................................................................. 258
max method........................................................................... 259
min method............................................................................ 259
pow method........................................................................... 260
random method ..................................................................... 260
xii
Contents
round method ........................................................................ 260

sin method ............................................................................. 261
sqrt method ........................................................................... 261
tan method ............................................................................ 261
Number object.............................................................................. 261
Number properties ....................................................................... 262
MAX_VALUE property........................................................... 262
MIN_VALUE property ............................................................ 263
NaN property ......................................................................... 263
NEGATIVE_INFINITY property ............................................. 264
POSITIVE_INFINITY property............................................... 264
Number methods.......................................................................... 264
toString method ..................................................................... 264
valueOf method ..................................................................... 265
Object object ................................................................................ 265
Object methods ............................................................................ 266
toString method ..................................................................... 266
valueOf method ..................................................................... 267
recipient object ............................................................................. 267
recipient properties....................................................................... 268
mode property ....................................................................... 268
name property ....................................................................... 269
query object.................................................................................. 269
query properties ........................................................................... 271
connection property............................................................... 271
cursorType property .............................................................. 272
stripTrailingBlanks property ................................................... 273
query methods ............................................................................. 274
Close method ........................................................................ 274
Execute method .................................................................... 274
GetColumnCount method...................................................... 275
GetColumnIndex method ...................................................... 275
GetColumnLabel method ...................................................... 275
GetEmpty method ................................................................. 276
GetRowCount method ........................................................... 277
GetState method ................................................................... 278
GetValue method .................................................................. 278
Move method......................................................................... 279
MoveFirst method.................................................................. 280
MoveLast method .................................................................. 281
MoveNext method ................................................................. 282
MovePrevious method........................................................... 283
Contents
MoveRelative method............................................................ 284

Opened method..................................................................... 285
Refresh method..................................................................... 285
ResultsToXMLString method ................................................ 286
SetSQL method..................................................................... 287
session object .............................................................................. 288
session property........................................................................... 290
timeOut property.................................................................... 290
site object ..................................................................................... 291
site properties............................................................................... 292
type property ......................................................................... 292
site methods................................................................................. 293
AskQuestion method ............................................................. 293
CopyDocument method......................................................... 293
CreateConnection method .................................................... 294
CreateDocument method ...................................................... 296
CreatePropertySheet method................................................ 297
CreateWizard method ........................................................... 301
DeleteConnection method..................................................... 309
DeleteDocument method....................................................... 309
GetConnection method ......................................................... 310
GetConnectionIdList method................................................. 311
GetConnectionNameList method .......................................... 311
GetDocument method ........................................................... 312
GetEventList method............................................................. 314
GetRootDocument method.................................................... 315
GetState method ................................................................... 315
Include method...................................................................... 316
OnEvent method ................................................................... 316
RenameDocument method ................................................... 318
ShowMessage method.......................................................... 318
String object ................................................................................. 319
String methods ............................................................................. 319
charAt method ....................................................................... 319
indexOf method ..................................................................... 320
lastIndexOf method ............................................................... 320
split method ........................................................................... 320
substring method................................................................... 321
substring method................................................................... 321
toLowerCase method ............................................................ 322
toString method ..................................................................... 322
toUpperCase method ............................................................ 322
xiv
Chapter
valueOf method ..................................................................... 323

system object................................................................................ 323
system properties ......................................................................... 324
errorNumber property ............................................................ 324
errorString property................................................................ 324
system methods ........................................................................... 324
Exec method.......................................................................... 325
GetCWD method ................................................................... 325
GetEnv method...................................................................... 325
SetEnv method ...................................................................... 326
xv
xvi
About This Book
Subject This manual is a reference for the PowerDynamo tags and the DynaScript
scripting language. For general information on using Dynamo tags and
DynaScript, see the PowerDynamo User’s Guide.
Audience This manual is written for people who require reference information;
syntax, returns, examples, and descriptions for PowerDynamo tags and
DynaScript.
Before you begin This manual assumes that you are familiar with HTML, ECMAScript (the
standardized version of JavaScript) and the operations of Web browsers
and servers.
Printed and online documentation

PowerDynamo documentation is available in both printed and online
formats.
There are two online formats, which contain the same content:
• Windows Help, and
• An HTML version, which you can import into a PowerDynamo Web
site, is also available.
Online documentation more complete and timely

Online documentation is more up to date than the printed documentation:
in case of differences between the two, you should follow the online
documentation. The online documentation may also be more complete
than the printed documentation.
Syntax conventions
The following conventions are used in this manual:
xvii
About this book
Type Symbol Syntax Convention

Keywords and SCRIPT SQL keywords and HTML tags are shown in
tags uppercase.
Placeholders name Items that the user must replace with appropriate
identifiers or expressions are shown in italics.
Options | Options are separated by vertical bars. Any one
of the items is allowed.
Continuation ... Lines beginning with ... are a continuation of
the statements from the previous line.
Lists ",..." Lists are shown with a list element followed by
",...". This means that one or more list
elements are allowed and if more than one is
specified, they must be separated by commas.
Optional [ ] Optional portions of a statement are enclosed in
portions square brackets. For example, FORMATTING
[ MAXROWS = num ] indicates that the
MAXROWS = num is optional. Alternative
optional parts of a statement are sometimes listed
within the brackets separated by vertical bars.
For example, [ ASC | DESC ] indicates
that ASC or DESC are optional. Do not type
bracket.
Alternatives { } When one of the options must be chosen, the
alternatives are enclosed in curly braces. For
example [ QUOTES { ON | OFF } ]
indicates that if the QUOTES option is chosen,
one of ON or OFF must be provided. Do not
type the braces.
Conventions used in this book

PowerDynamo Web sites work with either Adaptive Server Enterprise or
Adaptive Server Anywhere databases. In this book, sections that apply to
only one of these databases are marked by [Adaptive Server Anywhere] or
[Adaptive Server Enterprise] at the beginning of the appropriate section.
xviii
About this book
xix
About this book
xx
CH A PTE R 1 Dynamo Tags
About this chapter This chapter is a reference for the PowerDynamo tags, which are used to
provide dynamic content to a document.
For an introduction to Dynamo tags, see “Dynamo Tags Tutorial” in the
PowerDynamo User’s Guide.
Contents
Topic Page
Overview 1
Dynamo tags versus DynaScript 3
The Dynamo tags 4
Overview
Dynamo tags are similar to HTML tags, except Dynamo tags provide
dynamic content whereas HTML tags provide static content.
Dynamo tags are embedded in documents as HTML comments, which are
enclosed in . Dynamo tags begin with an HTML comment
followed by the tag name, for example 
DATA 
DOCUMENT 
ELSE 
ELSEIF 
ENDIF 
EVALUATE 
1
Overview
Dynamo Tag Syntax

EXECUTE 
FORMATTING 

IF 
INCLUDE 
LABEL 
MAILPEICE 
...body of mail piece

SCRIPT 
SQL 
SQL_ERROR_CODE 
SQL_ERROR_INFO 
SQL_INSERT 
SQL_ON_ERROR 

SQL_ON_NO_ERROR 

SQL_ON_ROWS 

SQL_ON_NO_ROWS 

SQL_STATE 
Several Dynamo tags have attributes. Some attributes are optional, while
others must be specified for tags to work properly. These attributes give you
greater control over resulting output by allowing you to be more specific in
your requirements.
2
CHAPTER 1 Dynamo Tags
Server side
Dynamo tags are processed by the server as opposed to HTML tags which are
processed by the browser.
Dynamo tags versus DynaScript

The Dynamo tags described in this chapter provide the functionality that is
normally associated with a programming language such as JavaScript or
DynaScript. If you are more comfortable with HTML and do not require the
flexibility of DynaScript, you can use the Dynamo tags to manipulate your
Web site documents. The following table displays the Dynamo tags with their
DynaScript equivalent.
Dynamo tag DynaScript equivalent
COMPONENT connection/CreateComponent
DATA query/GetValue()
DOCUMENT Select properties of the document object
ELSE else
ELSEIF if-else
ENDIF }
EVALUATE N/A
EXECUTE system.Exec()
FORMATTING N/A
IF if
INCLUDE output=site.Include(scriptName);
document.WriteLn(output);
LABEL query/GetColumnLabel()
MAILPIECE mp = new MailPiece();
SCRIPT N/A
SQL connection/CreateQuery()
SQL_ERROR_CODE query/GetErrorCode()
SQL_ERROR_INFO query/GetErrorInfo()
SQL_INSERT N/A
SQL_ON_ERROR if (SQL.GetErrorCode()!=0) {
...
SQL_ON_NO_ERROR if (SQL.GetErrorCode()==0) {
...
3
The Dynamo tags
Dynamo tag DynaScript equivalent

SQL_ON_ROWS if (!SQL.GetEmpty()) {
...
SQL_ON_NO_ROWS if (SQL.GetEmpty()) {
...
SQL_STATE document.Write(SQL.GetState());
For complete information on DynaScript, see “The DynaScript Language” on

page 33.
The Dynamo tags

This section lists the function, syntax, attributes, and examples for each
Dynamo tag.
COMPONENT
Function Use the COMPONENT tag to embed Jaguar components in HTML documents.
Syntax For SQL access:

For ActiveX access:

For Java access:

4
Attribute Description
ACCESS_METHOD Can be SQL, ACTIVEX, or JAVA. The default is
SQL. Determines the access method to be used for
the component.
PKG Name of the Jaguar package. This attribute is
required.
COMPONENT_NAME Name of the Jaguar component. This attribute is
required.
METHOD Name of the component method that is being
called. This attribute is required.
HOST The host and port name to use for the component
HOST=localhost:9000
This attribute is required when using the ACTIVEX
access method.
MANAGER_URL The URL to the Jaguar manager. This attribute is
optional. If an optional attribute is provided, you
must provide all attributes that proceed it.
USERID The ID for the Jaguar manager. This attribute is
optional. If an optional attribute is provided then
all attributes preceding it must be provided.
PASSWORD The password for the Jaguar manager. This
attribute is optional. If an optional attribute is
provided then all attributes preceding it must be
provided.
NARROW_INTERFACE The name of the component to which you would
like to narrow. This attribute is optional. If an
optional attribute is provided then all attributes
preceding it must be provided.
Description The COMPONENT tag is used to call and manipulate Jaguar components. The
same attributes associated with the SQL tag may be used with the COMPONENT
tag.
The default name of the query object when using the COMPONENT tag is
COMPONENT, in the same way that the default name of the query object is SQL
when the SQL tag is being used.
Example The following example calls the setMessage method of a Jaguar component.
$message is equal to saying document.value.message (passes in a
variable from a form in a previously accessed document):

The following example calls the getMajors method of the SVUMetaData
component which is part of the SVU package included with Jaguar:
<HTML>

<TR>

</HTML>
The following example calls the getMajors method of the SVUEnrollment
component which is part of the SVU package included with Jaguar. The access
method for this example is Java. The GetValue function is used to return the
appropriate datatype for each column. For more information on result sets, see
the Jaguar documentation.


See also “CreateComponent method” on page 215
“Calling Jaguar Component Methods from PowerDynamo” in the
DATA
Function The DATA tag allows an undetermined number of rows to be returned from a
query.
Syntax 
QUERY Allows you to specify the name of a query from
which the data should be extracted. If you do not
provide the QUERY attribute, the QUERY name is
assumed to be “SQL”.

NAME Allows you to specify the name of a column from
which the data should be extracted. This attribute is
optional. If you do not provide a NAME, sequential
DATA tags will correspond to the order of the
columns in the query result set.

Description When you use a query in a template, and the results are to be formatted as a
table or list, you do not know how many rows will be in the result set.
PowerDynamo uses data placeholders, formatted as comment tags, to describe
the formatting of each row of the query result set. The DATA tag is used in
conjunction with the FORMATTING tag.
The data placeholders are marked with comment tags:

8
Only one row of placeholders is included within a FORMATTING statement.

The application server automatically expands the placeholder to as many rows
as required to hold the result set.
DATA tags must be between a FORMATTING start tag and a FORMATTING
end tag.
Example The following template fragment defines a table that holds the results of a
simple query:
<TABLE BORDER>
<TR>
<TH>name</TH>
<TH>color</TH>
</TR>
<TR>
<TD></TD>
</TR>
</TABLE>
</BODY>
</HTML>
See also “FORMATTING” on page 13.
“LABEL” on page 20.
DOCUMENT
Function The DOCUMENT tag allows you to set certain properties of the document,
such as the content type, status, whether or not the request should be redirected
to an alternate URL, and the duration of time, if any, the request output should
be cached.
Syntax 
9
The Dynamo tags
CONTENT_TYPE The MIME type of document being returned to the
browser, for example, image/gif.

This attribute is optional.
REDIRECT The name of the URL to which the current request
should be redirected.
STATUS The status of a document where the first three
characters represent a three-digit status code and the
remaining characters contain a brief explanation of
the status. For example, 204 No Response.
CACHED_OUTPUT_ Duration of time (in minutes) for which the generated
TIMEOUT output of a script or template will be cached. This
attribute is optional. The default is 0.
Example This example caches the document output for five minutes.
<HTML>
<TITLE>doctag.stm</TITLE>
<BODY>
<H1>Customer Phone Numbers</H1>


<TABLE BORDER>
<TR>
<TH>fname</TH>
<TH>lname</TH>
<TH>phone</TH>
</TR>
<TR>
</TR>
</TABLE>
</BODY>
</HTML>
10
ELSE
Function The ELSE tag allows you to manipulate script flow. If none of the preceding
conditions are true, the request associated with the ELSE statement is executed.
Syntax 
Example This example uses the IF tag to check if a condition (YearOfBirth=1970) is true
or false. If the condition is true the text “You are old enough to participate in
this promotion” displays. If the condition is false, the ELSE tag is used and
displays “You are not old enough to participate in this promotion.”
<HTML>


You are old enough to participate in this promotion.

You are not old enough to participate in this promotion.

</HTML>
ELSEIF
Function The ELSEIF tag can be used after an IF tag to check another condition if the
first condition associated with the IF tag was false.
Syntax 
EXPR The expression determines whether the execution of
the tag should continue or be passed over. If the
expression is true, execution will continue.
Example An example of the ELSEIF tag is as follows:

<HTML>



num is greater than 10

11
The Dynamo tags
num is greater than 5 and less than 10


num is 10


</HTML>
ENDIF
Function The ENDIF tag ends the IF block.
Syntax 
Example The following example has two IF blocks that end with the ENDIF tag:
<HTML>



num is greater than 10

num is greater than 5 and less than 10

num is 10


</HTML>
EVALUATE
Function The EVALUATE tag allows you to evaluate a DynaScript expression.
Syntax 
EXPR The expression to be evaluated. This attribute is
required.
Example An example of the EVALUATE tag is as follows:


12
dollars.
If j is equal to 5, the above example would have an output of:
6 dollars
EXECUTE
Function The EXECUTE tag allows you to execute a system command.
Syntax 
COMMAND The name of the command to be executed. This
attribute is required.

Examples This example launches notepad.exe:


FORMATTING
Function Defines the output of a query.
Syntax For HTML formatting:


For XML formatting:


13
The Dynamo tags
BORDER The width of the table border. A value of 0 creates a
table with no border. BORDER applies only if you use
the default formatting, that is, nothing between the
 and  and 


</BODY>
</HTML>
MAXROWS The maximum number of times the content between
the start and end tag is to be repeated. This attribute
is optional.
Normally, the formatting tag causes the content
between the  and the  tag to be repeated for each row
in a query result. The addition of the MAXROWS
attribute causes the content between the start and end
tag to be repeated at most MAXROWS times.
14
NAME The name of the SQL statement to be formatted. If
the NAME attribute is not provided, the name “SQL”
is assumed.
If you have more than one SQL statement in a
template, you can ensure that your formatting
statements refer to the correct SQL statement by
referencing the name of the SQL statement in a
FORMATTING tag attribute. For example, this
statement formats the results of the SQL statement
ProductQuery:

FORMAT_AS May be set to HTML (the default) or XML. If set to
XML, the additional tags RESULTSET_TAG,
ROW_TAG and COLUMN_TAG can be used to generate
XML output. The BORDER and LIST attributes do
not apply.
The attributes NAME, MAXROWS, and STARTROW
apply for both XML and HTML.
RESULTSET_TAG Sets the tag surrounding the result set. If no
RESULTSET_TAG is specified, the default tag
SYBRESULTSET will be used.
This attribute applies only when FORMAT_AS=XML
ROW_TAG Specifies the tags to be used to define a table row. If
no ROW_TAG is specified, the default tag of SYBROW
will be used.
COLUMN_TAG Specifies the tags to be used to define a table
column. If no COLUMN_TAG is specified, the
column's label will be used.
USE_CDATA Instructs Dynamo to encode characters using
CDATA to escape special XML characters. If you do
not specify USE_CDATA, characters are encoded
with the normal ampersand method.
15
The Dynamo tags
STRIP_TRAILING_BL Strips trailing blanks from query data. By default,
ANKS this attribute is not used. This attribute is useful
when used with output generated from Adaptive
Server Enterprise or other databases that have
trailing blank characters.
Description When you use a query in a template, and want the results to be formatted as a
table or list, you do not know ahead of time how many rows are going to be in
the result set.
PowerDynamo uses data placeholders to describe the formatting of each row
of the query result set.
Formatting using scripts

You can also use embedded scripts to format output. The flexibility of scripts
allows more varied formatting than the formatting tags.
For more information, see “The DynaScript Language” on page 33.
The HTML tags for formatting instructions are slightly different from the tags
used for SQL statements. To allow an HTML editor to modify and refine the
actual formatting, the formatting description is not inside a comment. Instead,
comment tags are used for placeholders for the data, which are replaced on
processing by the actual data.
All data placeholders must be between formatting start and end comment tags.
The start tag is:

The end tag is:

There is no restriction on the HTML code that can be included between the
tags. The formatting comment tags have no effect on HTML that occurs
between them; they affect only the embedded instructions.
Examples This example defines a table that holds the results of a simple query:
<TABLE BORDER>
<TR>
<TH>name</TH>
<TH>color</TH>
</TR>
<TR>
16
</TR>
</TABLE>
This example performs a query on a product table with more than 100 product
codes. Using the MAXROWS attribute results in only the first 3 product codes
being returned.


Product code: 

has the output of:
Product code: 111
Product code: 222
Product code: 333
You can nest the FORMATTING tag inside other FORMATTING tags. For
example, this fragment:





Would have an output similar to:
Fred26
Fred32
Fred27
Fred34
Jane26
Jane32
Jane27
Jane34
If you do not specify a QUERY attribute on the DATA tag, the query specified on
the innermost  block is assumed.
Using nested FORMATTING statements on databases that do not support
backward cursor movement causes a performance degradation. Sybase
strongly recommends that you not nest FORMATTING sections unless
absolutely necessary.
17
The Dynamo tags
You may also reference a query that is outside of the formatting block. For
example:



This example uses the FORMAT_AS=XML tag to create the output in XML.



The output would look like this:
<MYRESULTSET>
<MYROW><MYDESCRIPTION>Cloth
Visor</MYDESCRIPTION><MYCOLOR>White</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>Cotton
Cap</MYDESCRIPTION><MYCOLOR>Black</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>Cotton
Shorts</MYDESCRIPTION><MYCOLOR>Black</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>Crew
Neck</MYDESCRIPTION><MYCOLOR>Black</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>Hooded
Sweatshirt</MYDESCRIPTION><MYCOLOR>Green</MYCOLOR></MY
ROW>
<MYROW><MYDESCRIPTION>Plastic
Visor</MYDESCRIPTION><MYCOLOR>Black</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>Tank
Top</MYDESCRIPTION><MYCOLOR>White</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>V-
neck</MYDESCRIPTION><MYCOLOR>Orange</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>Wool
cap</MYDESCRIPTION><MYCOLOR>White</MYCOLOR></MYROW>
<MYROW><MYDESCRIPTION>Zipped
Sweatshirt</MYDESCRIPTION><MYCOLOR>Blue</MYCOLOR></MYR
OW>
</MYRESULTSET>
See also “DATA” on page 8.
18
“LABEL” on page 20.
IF
Function The ID tag allows for manipulation of script flow. If the condition associated
with the tag is true the text associated with the IF tag will be executed.
Syntax 

EXPR The expression that determines whether the execution of
the tag should continue or be passed over. If the
expression is true, execution will continue.
Example This example uses the IF tag to check if a condition (YearOfBirth < 1979) is
true or false. If the condition is true the text “You are old enough to participate
in this promotion” displays. If the condition is false, the else statement is used
and displays “You are not old enough to participate in this promotion.”
<HTML>


You are old enough to participate in this promotion.

You are not old enough to participate in this promotion.

</HTML>
INCLUDE
Function Use the INCLUDE tag to include the generated output of another document.
The specified path may be a relative or an absolute path or the tilde (~)
character may be used.
For information on using the tilde character see “Paths” on page 73.
Syntax 
19
The Dynamo tags
Argument Description
NAME Name of the document that is to have its output included
in the output of the current document.
Example • This template:

<HTML>
<TITLE>sample.stm</TITLE>
<BODY>
<H1>Book Stores</H1>
<P>The following book stores are owned by the Read
Smart Corporation</P>

<P>For detailed information on individual book
stores, dial the store directly. If you
have a question about the corporation, dial Read
Smart’s 1-800 number. </P>
</BODY>
</HTML>
displays this output, when executed:
LABEL
Function The LABEL tag allows you to return the column name or column alias (as
specified in the SQL query) for the colNum column.
Syntax 
20
NAME The name of the query. If you do not specify NAME, the
name “SQL” is assumed.
INDEX The column index. This attribute is optional.
Description You can use the LABEL tag alone or from within a formatting section. When
you use it within a formatting section for a query, each subsequent occurrence
of the LABEL tag increases the value of INDEX by one.
Example The following lines:


: 
: 
: 

produce the following output:
name: Tee Shirt
color: White
size: Small
name: Tee Shirt

color: Orange
size: Medium
name: Tee Shirt

color: Black
size: One size fits all
See also “FORMATTING” on page 13
“DATA” on page 8
MAILPIECE
Function Use the MAILPIECE tag to send mail through a SMTP host.
21
The Dynamo tags
Syntax 
Body of the mail piece

TO The address of the recipient of the mail piece. This
FROM The address of the person sending the mail piece. This
attribute is optional.
SUBJECT The subject of the mail piece. This attribute is optional.
SMTPHOST The SMTP host of the mail piece. This attribute is
optional. If not specified here, the SMTP host must be set
from the Default General Settings folder in Sybase
Central.
INDEX The column index. This attribute is optional.
Description Use the MAILPIECE tag to send mail from PowerDynamo using Dynamo tags
and a SMTP host. Enter the body of the mail piece between the start and end
mail piece tag. If you do not specify an SMTP host within the script, the default
SMTP host specified in Sybase Central is used. If you have not specified an
SMTP host in either of these places, an error occurs.
Example This example sends a mail piece with a subject and body. The SMTP host has
been set in Sybase Central:
<HTML>

</HTML>
SCRIPT
Function Use the SCRIPT tag to embed DynaScript in HTML documents.
Syntax 
22
Description All DynaScript scripts begin and end with a SCRIPT tag ().
All information within a SCRIPT tag is invisible to any Web editing tool–in
other words, it is processed by the Dynamo application server.
Example • This example embeds the DynaScript method document.WriteLn in an
HTML document:
<HTML>
<BODY>
<H1>DynaScript Sample</H1>

For more information, see “The DynaScript Language” on page 33.
SQL
Function Use the SQL tag to embed SQL statements are embedded in HTML
documents.
Syntax 
NAME Name of a query. This attribute is optional. If you do
not use NAME then the name “SQL” is assumed.
23
The Dynamo tags
CONNECTION_NAME Name of the connection that the SQL query is to use.
By default, SQL queries use the connection name
associated with the document in which they are
contained. The CONNECTION_NAME attribute enables
you to explicitly specify the connection name that you
would like a SQL query to use. The SQL
CONNECTION_NAME tag is used as follows:

The Connections folder of Sybase Central contains a
list of PowerDynamo connection names.
CONNECTION_OBJECT Name of the DynaScript connection object that the
SQL query is to use. This attribute is optional:

NO_EXECUTE Allows you to prepare a query without executing it.

To execute the query you would do something like:

DSN, UID, PWD The data source name that you would like a SQL query
to use. Using a data source name to connect to a
database bypasses both connections and connection
objects. No connection names are created or used. The
user ID and password are optional. For example:
<--SQL DSN="PowerDynamo Demo"
UID=dba PWD=sql
-->
24
SERVER, DBN*, UID, The server name on which the SQL query should be
PWD executed. The connection made to the server will be an
Open Client connection.
The SERVER,DBN, UID, PWD attributes are used as
follows:

Using a server name to connect to a database bypasses
both connections and connection objects. No
connection names are created or used.
*DBN is optional. If you do not specify a database
name, the connection uses the user’s default database.
NO_SQL_ERROR Executes a script even if an error is encountered. No
error is displayed in the output. To display any
resulting errors, use the SQL_ON_ERROR tag.
Only one connection

You can use only one of: CONNECTION_NAME, CONNECTION_OBJECT, DSN,
or SERVER.
Description Use SQL queries to access and manipulate data that has been stored in a
database.
Example This example has a SQL query embedded in HTML.
<HTML>
<BODY>

</BODY>
</HTML>
SQL_INSERT
Function Performs an insert operation using the document’s parameters.
25
The Dynamo tags
Syntax 
TABLE Name of the table that the data is to be inserted in. This
NAME Name of a SQL query. This attribute is optional. If no
NAME is provided then the name “SQL” is assumed.
CONNECTION_NAME Name of the connection that the SQL query is to use.
By default, SQL inserts use the connection name
associated with the document in which they are
contained. The CONNECTION_NAME attribute enables
you to explicitly specify the connection name that you
would like a SQL insert to use. For example:

You can find a list of PowerDynamo connection in the
Connections folder of Sybase Central.
CONNECTION_OBJECT Name of the DynaScript connection object that the
SQL query is to use. This attribute is optional.
DSN, UID, PWD The data source name that you would like a SQL query
to use. Using a data source name to connect to a
database bypasses both connections and connection
objects. No connection names are created or used.
The user ID and password are optional. For example:

26
SERVER, DBN*, UID, The server name on which the SQL query should be
PWD executed. Using a server name to connect to a database
bypasses both connections and connection objects. No
connection names are created or used. The connection
made to the server will be an Open Client connection.
The SERVER, DBN, UID, PWD attributes are used
as follows:

*DBN is optional. If you do not specify a database
name, the connection uses the user’s default database.
NO_EXECUTE Allows you to prepare a SQL query without executing
it.

To execute the query you would do something like:

NO_SQL_ERROR Causes a script to execute even if an error is
encountered. No error is displayed in the output. To
display errors, use the SQL_ON_ERROR tag.
Only one connection

You can use only one of: CONNECTION_NAME, CONNECTION_OBJECT, DSN, or
SERVER.
Description Use SQL_INSERT to enter data into a table. For example, lets’s say you have
created a form that asks a user to enter the information to add to the table. If the
names on the form match the names of the table columns, you can insert the
information into the table by calling a simple script that includes:

Example The following template allows a user to add a new product to the database. The
first document (newProduct.stm) collects the information and passes it to the
second document (insert.ssc) for insertion.
<HTML>
<TITLE>newProduct.stm</TITLE>
<BODY>
27
The Dynamo tags
<H1>New Product</H1>
<P>Enter the following information</P>
<FORM METHOD=POST ACTION="insert.ssc">
<OL>
<LI><INPUT TYPE="text" NAME="id" >ID of the product<BR>
<LI><INPUT TYPE="text" NAME="name" >Name of the
product<BR>
<LI><INPUT TYPE="text" NAME="description"
>Description<BR>
<LI><INPUT TYPE="text" NAME="size" >Size<BR>
<LI><INPUT TYPE="text" NAME="color" > Color<BR>
<LI><INPUT TYPE="text" NAME="quantity" > Quantity<BR>
<LI><INPUT TYPE="text" NAME="unit_price" > Price<BR>
</OL>
<P><INPUT TYPE="submit"></p>
<P><INPUT TYPE="RESET" VALUE="Clear Form"></P>
</FORM>
</BODY>
</HTML>
calls:
<HTML>
<TITLE>insert.ssc</TITLE>
<BODY>

</BODY>
</HTML>
The above example would be equivalent to:

SQL condition
Function The SQL condition tags allow you to specify a certain condition that must be
fulfilled for the code between the conditional start and end tags to be executed.
Syntax 

28
Parameters type:
NO_ERROR | ERROR | NO_ROWS | ROWS
NAME Name of a query. This attribute is optional. If you do not
provide a query name, “SQL” is assumed.
Description The following table lists the conditions that are supported by Dynamo. If the
condition is fulfilled, the source between the conditional start and end tag is
included in the output.
Start tag End tag Condition
   Query produced
an error.
  Result set did
not produce any
rows.
  Result set
produced at
least one row.
You can use one or more types of tags (SQL, SCRIPT etc.) between a
conditional start and end tag.
Example This example provides output only if the SQL query does not produce an error.




SQL_ERROR_CODE
Function The SQL_ERROR_CODE tag allows you to return the current error code. If a
SQL instruction is carried out successfully an error code of 0 is returned.
29
The Dynamo tags
Syntax 

Example This example returns 0 as well as the output generated from the SQL query as
long as no errors are encountered during execution.


<TABLE BORDER>
<TR>
<TH>Quantity</TH>
<TH>BookID</TH>
</TR>
</TABLE>
</BODY>
</HTML>
SQL_ERROR_INFO
Function The SQL_ERROR_INFO tag allows you to return a description of the error
information.
Syntax 
Example This example displays error information for a query named myQuery:



SQL_STATE
Function The SQL_STATE tag returns the current SQL state of a query.
Syntax 
<!—-SQL_STATE NAME="myquery"-->
Example This example displays the state of the SQL query:




31
The Dynamo tags
32
CH A PTE R 2 The DynaScript Language
About this chapter The Dynamo script language DynaScript, is compatible with
ECMAScript (the standardized version of JavaScript) and provides most
of the same features. Dynamo adds its own language extensions and
predefined objects for supporting database-driven dynamic content.
This chapter summarizes DynaScript, and describes the Dynamo-specific
language extensions.
Contents
Topic Page
Overview 33
SCRIPT tag 34
Literals 34
Variables 36
Expressions 38
Operators 39
Statements 43
Functions 56
Objects 66
Overview
DynaScripts are built from the following language elements:
• SCRIPT tag
• literals
• variables
• expressions
• operators
• statements
• functions
33
SCRIPT tag
• objects
Each of these elements is described in the following sections.
SCRIPT tag
DynaScripts are embedded in documents as HTML comments. An HTML
comment is marked by a 
A DynaScript is marked by a special tag inside the comment:

Web editing tools interpret this tag as a comment, and ignore the contents that
fall between the start and end tags. This allows the Dynamo application server
to process the script.
JavaScript tags vs. JavaScript SCRIPT tags are very similar to DynaScript SCRIPT tags.
Dynamo tags JavaScript uses SCRIPT tags with this syntax:
<SCRIPT LANGUAGE="JavaScript">
DynaScript uses SCRIPT tags with this syntax:

Literals
Literals are fixed values in your scripts. For example, the following are
literals:
• 123, 0x3F, 0123 (integers)
• 456.789, 3.2e-8 (floating-point numbers)
• true or false (Boolean)
• "The rain in Spain" (string)
34
CHAPTER 2 The DynaScript Language
Integers
Integers can be expressed as:
• decimal (base 10) – a sequence of digits (0-9) without a leading zero.
Example: 189
• octal (base 8) – a sequence of digits (0-7) with a leading zero.
Example: 0123
• hexadecimal (base 16) – a sequence of digits (0-9) and letters (A-F or a-
f), with a leading 0x (or 0X).
Example: 0x3F
Floating-point numbers
A floating-point number can have:
• a decimal integer
• a decimal point (“.”)
• a decimal fraction
• an exponent (“e” or “E” followed by an signed or unsigned integer)
Examples:
• 123.456
• -123E456
• .123e-456
Booleans
The Boolean (logical) type can be true or false.
Strings
A string is zero or more characters enclosed in single (') or double (") quotes.
You must use the same kind of quote (single or double) to start and end a given
string.
35
Variables
Examples:
• 'Dave'
• “HAL”
• “9000”
• “Check out our \n new line of clothes.”
Control characters You can embed the following control characters in strings:
• \b backspace
• \f form feed
• \n new line
• \r carriage return
• \t tab
Escaping characters You can place quotes inside of strings by preceding them with a backslash (an
escape character).
For example:
document.WriteLn("He played \"Stairway To Heaven\" at
78 RPM.")
would yield:
He played "Stairway To Heaven" at 78 RPM.
You can insert a backslash itself by using two backslashes (one as the escape
character, one as the literal backslash).
Variables
You do not have to declare DynaScript variables or assign them to a fixed
datatype. A variable must have a value before you use it in an expression;
otherwise a runtime warning is generated.
Variable names Each variable is identified by a case-sensitive name. Variable names must start
with a lowercase or uppercase letter or an underscore character ( _ ).
Subsequent characters can be letters, underscores, or digits. No other
characters are allowed in variable names.
These are examples of valid variable names:
36
x
_magic
current_product
Product99
These are invalid variable names:
x 1
3magic
current!product
Product-99
R&D
Declaring variables Although you are not required to declare variables in DynaScript, Sybase
recommends that you do so. This is not only good programming style, but can
also avoid scoping problems with other global variables. Declare a variable
using the var keyword. This statement declares a variable named x and assigns
it a value of 35:
var x = 35;
For more information on the var statement, see “Statements” on page 43.
Datatypes Scripts use the following datatypes:
Table 2-1: Datatypes
Datatype Example
Undefined any variable that has not been assigned a value.
Numeric 1.23456 or 3
Boolean(logical) true or false
Strings “this is a string”
Null denotes a null value
Function writeln
Object site
For more information on the operators that work with these datatypes, see
“Operators” on page 39.
Assigning values to Assign a value to a variable using the = operator, just as in many other
variables programming languages. In DynaScripts, however, assigning a value to a
variable also sets the datatype of the variable.
For example, the following statement assigns the value 23 to the variable x:
x = 23 ;
If no variable named x exists in the current scope, one is automatically created.
37
Expressions
You can later assign a different datatype to the variable x, using an assignment
statement like this:
x = "Now I am a string" ;
The following two statements successively assign a Boolean value of true and
then a null (unknown) value to the variable status:
status = true ;
status = null ;
Variable scope Variables have a scope: that is, they exist for part or all of a script or a template.
You can use global variables anywhere in a template, but you can use local
variables only within the current function.
If you do not explicitly declare a variable, it is created as a global variable. For
example, if the first time that the variable x is referred to is in a statement like
this:
x = 35 ;
then x is a global variable, and can be used (and will have the same value)
anywhere in the HTML template.
If you declare a local variable with the same name as an existing global
variable, references to that variable name will use the local variable.
Expressions
Expressions are combinations of variables, literal values, operators, and other
expressions. The right side of an assignment statement is an expression.
The following statements illustrate various kinds of expressions:
surfaceArea = (2 * 3.14159 * radius * height ) ;
surfaceArea = surfaceArea + ( 2 * 3.14159 * radius *
radius ) ;
quote = "Full fathom five" + " thy father lies" ;
address = 10 + " Downing Street" ;
Name = "Moonunit " + 2 ;
Expressions and Every expression has a value and a datatype. The datatype is one of numeric,
datatypes string, Boolean, function, object, or null.
38
In some cases, the value of an expression is obvious; in others, it is not. For

example, (2 * 3) is clearly a numeric expression with value 6, and "To be
or not to be" is a character string. However, it is not quite so obvious what
the result of adding a number and a string is, as in the expression 10 + "
Downing Street".
To make meaningful evaluation of expressions possible, DynaScript has rules

for automatic conversion of datatypes. In the above example, 10 is converted
to a string and concatenated with the other string to give the final value.
Operators and An operator can act on expressions of certain datatypes. For example, the
datatypes multiplication operator (*) can act on numeric expressions, but cannot act on
string expressions:
// valid use of multiplication
( 2 * 3.14159 * radius )
// invalid use of multiplication
"What" * "happens now?"
Some operators can act on more than one datatype. The most common of these
is the addition operator (+). The addition operator can add two numbers
together, or concatenate two strings.
Ternary, binary and Operators are either ternary, binary, or unary. Binary operators act on two
unary operators operands, such as the arithmetic operators:
x + y
45 / 56
Unary operators act on only one expression. For example, the postfix ++
operator adds one to the value of a variable:
x++ ;
The less common ternary operators act on three expressions.
Operators
This section describes the operators available in scripts.
Ternary, binary and Operators act on one or more expressions called operands. Operators can be
unary operators either ternary, binary or unary: ternary operators act on three expressions,
binary operators act on two expressions, and unary operators act on one.
For example, the addition operator is a binary operator, so the following is a
valid expression:
39
Operators
x + y ;
The increment operator (which adds one to a number) is a unary operator, so
the following is a valid expression:
x++ ;
Arithmetic operators
The following arithmetic operators are provided:
Operator Description Binary or unary
+ addition binary
- subtraction binary
* multiplication binary
/ division binary
% modulo binary
++ increment unary
-- decrement unary
- negation unary
Notes • Comparison operators can also operate on numbers, but the result is a
Boolean value.
• The increment and decrement operators can be used either before or after
the operand: both of the following are valid statements:
x++
++x
When the operator precedes the operand, the operand is decremented
before the expression is evaluated; if the operator follows the operand, the
operand is decremented after the expression is evaluated. The following
statements illustrate the difference:
x = 56 ;
y = x-- ; // Sets y to 56 and decrements x to 55
y = --x ; // Decrements x to 55 and sets y to 55
Conditional operator
The following conditional operator is provided:
40
Operator Description
? Conditional
The ? operator is ternary, meaning that it acts on three expressions.

The ? operator evaluates to one of two values, based on a condition. An
example of the ? operator is as follows:
(grade == "pass") ? "Excellent" : "Try again";
String operators
The following string operators are provided:
+ Concatenation
+= Concatenation with assignment
Comparison operators can also operate on strings, but the result is a Boolean
value.
Comparison operators
The following comparison operators are provided:
== Equal to
> Greater than
< Less than
>= Greater than or equal to
<= Less than or equal to
<> Not equal to
!= Not equal to
These operators can act on numbers or strings, and return a Boolean (logical)
value of true or false.
41
Operators
Boolean operators
Boolean operators operate on Boolean (logical) expressions. The following
Boolean operators are provided:
Operator Name Description
&& And Returns true if both expression are true, false
otherwise.
|| Or Returns true if either expression is true.
! Not Returns true if the expression is false, and false if the
expression is true.
Bitwise operators
Bitwise operators treat their operands as a set of bits (zeros and ones), rather
than as decimal, hexadecimal, or octal numbers. Bitwise operators perform
their operations on such binary representations, but they return standard
numerical values.
The following bitwise operators are provided:
Operator Name Description
& AND Returns a one if both operands are ones.
| OR Returns a one if either operand is one.
^ XOR Returns a one if one but not both operands are one.
<< Left shift Shifts the first operand the specified number of
bits to the left. Excess bits shifted off to the left are
discarded. Zero bits are shifted in from the right.
>> Sign- Shifts the first operand the specified number of
propagating bits to the right. Excess bits shifted off to the right
Right shift are discarded. Copies of the leftmost bit are
shifted in from the left.
>>> Zero-fill Shifts the first operand the specified number of
right shift bits to the right. Excess bits shifted off to the right
are discarded. Zero bits are shifted in from the left.
Delete operator
The delete operator may be used to delete a property from an object or to delete
an element from an array. For example
delete x
42
Returns true if deletion is successful, false otherwise.
Void operator
The void operator may be used to prevent an expression from returning a value.
For example
void addVar
The void operator will evaluate its expression and then returned undefined.
Typeof operator
The typeof operator may be used to return the datatype of an expression. For
example
document.writeln( typeof(addVar) );
The typeof operator returns a string that can be one of number, string, Boolean,
object, function or undefined.
Statements
DynaScript includes statements for controlling script flow, manipulating
objects, and general programming. In general, these statements follow standard
C and Java syntax. They include:
• flow-control statements
• if-else
• for
• while, do-while
• switch
• break and continue
• object-manipulation statements
• for-in
• with
43
Statements
• class, this, and new
• miscellaneous statements
• var
• function, return
• import
• comments
• exit
Separating statements In DynamoScripts, you do not have to separate statements with semicolons.
if-else statement
The if-else statement tests a condition, then executes one set of statements
if the condition is true, and (optionally) another set of statements if it's false.
Syntax if ( condition ) {
statements }
[ else {
statements } ]
• condition Any Boolean expression.
• statements Any script statements. Multiple statements must be enclosed
in braces.
Example if ( status == true ) {
document.WriteLn( "Your order succeeded.") ;
document.WriteLn( "Now in stock: " + quantity) ;
} else {
document.WriteLn( "Your order failed.") ;
document.WriteLn( "We only have " + quantity
+ " in stock.") ;
}
for statement
The for statement iterates over values in a loop while a condition is true.
Syntax for ( [ initial-expression ]; [ condition ]; [ increment expression ] ) {
statements } ;
44
First, the initial expression is evaluated (typically, this initializes the loop
counter).
Then, the condition is evaluated. If the condition is true, the statements are
executed, then the increment expression is executed. If the condition is false,
the loop ends.
Example The following loop iterates the variable i from 1 to 3:
for ( i = 1 ; i < 4 ; i++ ) {
document.WriteLn("Price of item #" +
i + " = " + price[ i ] );
}
while statement
The while statement tests a condition, and loops until it is false. The condition
is tested before the first iteration of the loop.
Syntax while ( condition ) {
statements } ;
First, the condition is evaluated. If the condition is true, the statements are
executed, and control passes back to the condition. If the condition is false, the
loop ends without executing the statements again.
var i = 0 ;
while ( i < 3 ) {
i++ ;
i + " = " + price[ i ] );
}
do-while statement
The do-while statement is a DynaScript extension (part of the C language,
not part of the ECMAScript standard). It is similar to the while statement,
except that it tests the condition after the first iteration of the loop.
Syntax do {
statements }
while ( condition ) ;
45
Statements
First, the statements are executed.

Then, the condition is evaluated. If the condition is true, control passes back to
the top of the loop. If the condition is false, the loop ends.
var i = 0 ;
do {
i++ ;
i + " = " + price[ i ] );
} while ( i < 3 ) ;
switch statement
The switch statement is similar to the if statement with an unconditional else
clause. The only difference between the DynaScript switch statement and the
C or Java implementation of the switch statement is that DynaScript does not
require the cases to be unique. In the event that there are multiple matching
cases only the first one will be executed. Break statements must be explicitly
stated within a switch statement to stop statement execution.
Syntax switch(expression) statement
Example The following example uses the switch statement to count the number of
vowels in a given phrase:

47
Statements
break statement
The break statement ends a loop and transfers control to the statement
following the loop. A break can occur in a loop or within a switch statement.
Syntax break ;
Example The following loop iterates from 0 to 5, then outputs 25:
var i = 0 ;
while ( i < 10 ) {
if ( i == 5 ) {
break ;
}
i++ ;
}
document.WriteLn( i * i ) ;
continue statement
The continue statement ends execution of the block of statements in a loop,
and moves on to the next iteration of the loop. In a while loop, continue jumps
back to the condition. In a for loop, it jumps to the increment expression.
Syntax continue ;
Example The following loop iterates from 0 to 10, printing each number except 5:
var i = 0 ;
while ( i < 10 ) {
I++;
if ( i == 5 ) {
continue ;
}
document.WriteLn( i ) ;
}
for-in statement
The for-in statement is a variation of the for statement that iterates over the
properties and methods of an object, executing a block of statements for each
member.
Syntax for ( variable in object ) {
statements }
48
• variable A variable to be used as the loop iterator.

• object Any object.
in braces.
Example You can list the properties, property values, and methods of any object using
the following simple script, where objectName is the name of the particular
object:

with statement
Use the with statement for working with several properties or methods of a
given object. It establishes a default object for a block of statements. Within the
block, any property or methods that do not specify an object are assumed to be
for the default object.
Syntax with ( object ) {
statements }
• object Any object.
in braces.
Example The following script sets the name, title, and managerName of an object
called currentEmployee:
with currentEmployee {
name = "Moe Smithers" ;
title = "Bartender" ;
managerName = "Barney Burns" ;
}
49
Statements
class statement
The class statement is a DynaScript extension that provides a clear way of
explicitly declaring an object type (a class). It also provides an optional way of
deriving the new class from an existing class.
Syntax class newClassName ( [ param ] [ , param, ... ] ) [ extends
parentClassName ( [ parentParam ] [ , parentParam, ... ] )] {
statements } ;
• newClassName [variable] The name of the new class.
• param [variable] Parameters of the new class (typically for assigning
values to properties). If you're extending an existing class, the parameter
list typically includes new parameters (for the new class) and inherited
parameters (for the parent class).
• parentClassName [variable] The name of the existing class that the new
class is derived from.
• parentParam [variable] Parameters for the parent class. Typically these
are a subset of the param list. The parent constructor is executed using
these parameters before the constructor of the new class is executed.
• statements Constructor statements for the new class. These statements
typically:
• Assign the new parameters to the properties you've added to the new
class, using the this keyword to reference the new class. For
example:
this.name = incomingName ;
• Define methods for the new class. If you define a method with the
same name as a method in the parent class, the new method overrides
the parent method.
You can define methods inline (inside the class definition), or by
assigning method names to existing functions (outside the class
definition). Inline method declaration is preferable, however, since it
encapsulates the method within the class and allows methods in
different classes to have the same name (making polymorphism
possible).
Example class salariedEmployee(name, title, managerName,
salary)
extends employee(name, title, managerName) {
this.salary = salary;
function PrintAllInfo() {
50
document.WriteLn("Name: " + this.name);

document.WriteLn("Title: " + this.title);
document.WriteLn("Reports to: " +
this.managerName);
document.WriteLn("Salary: " + this.salary);
}
this.PrintAllInfo = PrintAllInfo;
}
this keyword
The this keyword refers to the current object (in a method, the calling object)
and is typically used as the qualifier for that object’s properties and methods.
Syntax this.memberName
• memberName [variable] Any property or method of the object.
Example class product(id, name, size, color,
quantity, price) {
this.id = id ;
this.name = name ;
this.size = size ;
this.color = color ;
this.quantity = quantity ;
this.price = price ;
}
new operator
The new operator creates an instance of a class using the given parameters.
Syntax objectName = new className ( [ param ] [ , param, ... ] ) ;
• objectName [variable] The name of the new object instance.
• className [variable] The name of an existing class.
• param [variable | literal] A value for the corresponding class parameter.
Example var currentProduct = new product(600,
"Sweatshirt", "Large", "Green", 39, 24.00 ) ;
51
Statements
var statement
The var statement declares a variable, optionally assigning it an initial value.
The scope of a variable is the current function or (for variables declared outside
a function) the current script.
You do not have to declare variables using var; you can declare them
implicitly by assigning them values on the fly. However, it is good coding
practice to always use var. In addition to making your code more readable, this
can avoid scoping problems. For example, if you start using an apparently local
variable inside a function without declaring it, you could be inadvertently
referencing an existing global variable of that name, with unexpected results.
Syntax var varName [ = value ] [ ..., varName [ = value ] ] ;
• varName [variable] The name of the variable.
• value [variable | literal] A value for the variable.
Example var height = 42, width = height / 2 ;
function statement
The function statement declares a function, which is a set of instructions that
you can call from anywhere in a script.
A function can accept string, number, or object parameters.
• Simple arguments such as strings and numbers are passed to functions by
value. Any change made to the argument inside the function is not passed
back to the calling environment.
• Objects can be passed to functions, and are passed by reference, so that any
change made to an object property inside a function is passed back to the
calling environment. Since arrays are a special case of objects, they are
passed by reference.
• When the function is called, the actual parameters (arguments) are stored
in the arguments array property of the function. This array indexes all
actual parameters starting at 0. For example, you could access the third
parameter of a function called MyFunction as
MyFunction.arguments[2].
You can access the total number of actual parameters as
arguments.length.
52
Variable number of Functions can accept more or less parameters than are formally declared for
arguments them. Extra parameters are simply appended to the arguments array for the
function.
Returning a value The function can return a value to the caller by including a return statement.
Syntax function name ( [ param ] [ , param, ... ] ) {
statements }
• name [variable] The name of the function.
• param [variable] A name for a formal parameter.
Example function order ( orderQuantity ) {
// order returns true if the order is successful,
// false if stock is too low
if ( this.quantity >= orderQuantity ) {
this.quantity -= orderQuantity ;
return ( true ) ;
} else {
return ( false ) ;
}
}
return statement
The return statement is used inside a function to return a value to the caller
of the function.
Syntax return expression ;
• expression [expression] The value to return to the caller.
Example You could define the following order function:
function OrderItem( orderQuantity ) {
// order returns true if the order is successful,
// false if stock is too low
if ( this.quantity >= orderQuantity ) {
this.quantity -= orderQuantity ;
return ( true ) ;
} else {
return ( false ) ;
}
}
...then call the function in an expression:
53
Statements
if ( OrderItem(desiredQuantity) == true ) {
document.WriteLn("Ordered successfully");
} else {
document.WriteLn("Order failed - stock is low");
}
import statement
The import statement is a DynaScript extension that, when executed, imports
the text of another script at the statement’s position in the current script. This
allows you to store common functions in a separate script, then use them in
your other scripts by importing that script.
Execution context If you do not state and context or if you specify the newContext keyword
when using the import statement, the imported script code will run in its own
execution context. Only if you specify the useContext keyword will the
imported code share the same variable space as the document into which it was
imported. For example, imported code cannot normally reference the
document or site objects, since they do not exist in its (special) execution
context. Using the useContext keyword makes theses objects available to the
imported code. Objects such as Math, Date and Number are still available to
be referenced by imported code that uses the newContext keyword.
Syntax import documentName | (stringExpression) [newContext | useContext] ;
• documentName [string] The script file to include. This can be quoted or
unquoted.
• stringExpression [expression] The script file to include. This allows you
to build file names programmatically.
• newContext [keyword] Specifies that the current context (variables or
objects) is not to be shared with the imported file.
• useContext [keyword] Specifies that the imported file is to have access
to the current context.
Example If you stored a set of common functions in a script called common.ssc, you
could use these functions in another document by including the statement:
import "common.ssc" ;
To import a script called myScript.ssc, residing in a test folder at the root
of your Web site, you could use the statements:
rootDoc = site.GetRootDocument();
import (rootDoc.location + "/test/myScript.ssc");
54
The following example demonstrates the sharing of variables between a main

file and the file that it imports:


Executing main.ssc produces:

Start main.ssc
Start importee.ssc
This is from main.ssc
End importee.ssc
This is from importee.ssc
End main.ssc
comment statements
Comment statements are ignored by the script interpreter.
There are two ways to indicate comment statements in scripts:
• Anything inside the character pairs /* and */ is a comment. For example:
/* This is a comment
that extends
over three lines */
• Any characters on a line following the character pair // constitute a
comment. Characters on the next line are interpreted by the script
interpreter. For example:
x = 365 ; // Explanatory remarks can be placed here.
y = x / 12 ;
55
Functions
exit statement
The exit statement stops processing the current document without affecting
previous output. Portions of the document following the exit statement are not
processed.
The following example template checks a user’s password. If it is incorrect, it
notifies the user and exits from the script. Any output generated before the exit
statement was encountered still displays.
<HTML>
<TITLE>Secret Information</TITLE>
<BODY>

<H1>Secret Information</H1>



</BODY>
</HTML>
Functions
You can define and use functions in scripts. This allows you to encapsulate a
set of instructions once in a document as a function, then use it several times
throughout the document (by calling the function). For example:

56
Define functions before using them

You must define a function before it can be used, since the application server
processes an HTML document from top to bottom.
A function can accept string, number, or object parameters.

• Simple variables such as strings and numbers are passed to functions by
value. Any change made to the argument inside the function is not passed
back to the calling environment.
• Objects can be passed to functions, and are passed by reference, so that any
change made to an object property inside a function is passed back to the
calling environment. Since arrays are a special case of objects, they are
passed by reference.
Parentheses must be used

You must use parentheses when calling a function, even if it doesn’t take
away arguments.
A function can perform a set of statements without returning a value. For

example:
PrintInvoices();
A function can also return a value to the caller by including a return
statement. In this case, the function is typically called as part of an expression:
nextCustomerName = GetCustomerName(customerNum);
You can define functions inside a particular document. For more flexibility,
you can define them in a separate script, which can then be referenced by any
documents that use the function (using the import statement).
For more information on the function, return, and import statements, see
“Statements” on page 43.
Functions and the arguments object

The arguments object may be used with a function to return an array that
contains the arguments that were passed to the currently executing function.
For Example:

would return
1
{ 1, 2, 3 }
6
The arguments object has a length property which contains the number of
variables passed to the function.
The arguments object also has a callee property which may be used for
recursion. The following example creates a function dynamically and then
recursively calls the same function from within the function body:

Built-in functions
Dynamo supports the following ECMAScript built-in functions:
• escape(string) Returns a string containing the ISO Latin-1

representation of each character in string. This is typically used to encode
special characters so they can be used in URLs.
• eval(string) If string represents an expression, this evaluates the

expression. If the argument is one or more ECMAScript statements, this
performs the statements.
58
• isFinite(number) Returns a Boolean indicating whether the supplied

number is finite.
• isNaN(number) Returns a Boolean indicating whether the supplied

number is the reserved value NaN (not a number).
• parseFloat(string) Parses string and tries to return a floating-point

number.
• parseInt(string [, radix]) Parses string and tries to return an integer of

the specified radix (base).
• unescape(string) Returns a string containing the ASCII characters for

the encoded string. This is typically used to decode special characters from
URLs.
Dynamo-specific built-in functions

Dynamo provides the following built-in functions:
• CreateObject(string) Creates an instance of an ActiveX Object. string
represents the program ID of the object being called. Use CreateObject to
access data that is available through a third-party application. The program
ID is available from your Registry under HKEY_CLASSES_ROOT. If a
program ID is not listed in your Registry, the application is not available
for use.
Only available from Windows or NT

CreateObject is available only on Windows 95 or NT platforms, and
can be used only with nonvisual ActiveX objects.
The following example creates an instance of an ActiveX Object from a

Visual Basic application. The object is used for converting temperatures
from Celsius to Fahrenheit or from Fahrenheit to Celsius.
The template prompts the user to select the appropriate type of conversion
and to enter a value.
59
Functions
<HTML>
<H1>Converting Temperatures </H1>
<BODY>
<P>This page allows you to convert a temperature from

<I>Celsius</I> to
<I>Fahrenheit</I> or from <I>Fahrenheit</I> to
<I>Celsius</I>.
<BR>
<HR WIDTH="100%">
<P>Select the appropriate button and enter the

temperature you would like
to convert.
<FORM METHOD=POST ACTION="convert.stm">

<OL>
<LI><INPUT TYPE="radio" NAME="theType" value="CtoF"
CHECKED>Celsius to Fahrenheit<BR>
<INPUT TYPE="radio" NAME="theType"
value="FtoC">Fahrenheit to Celsius<BR>
<LI><INPUT TYPE="text" NAME="temperature" SIZE="4">
Temperature
</OL>
</FORM>
</BODY>
</HTML>
The second template, convert.stm, is called from the previous template and
creates an instance of the ActiveX Object
"SybaseDemoObject.TempConvert". This template uses the methods
of the SybaseDemoObject.TempConvert to calculate the request from
the first template.
<HTML>
<TITLE>convert.stm</TITLE>
<BODY>
<H1>Temperature</H1>
<P>Your answer is: </P>

</BODY>
</HTML>
• exists(variables) Checks if a variable has been assigned a value without

creating an instance of that variable.
if( exists( session.logon ))...
• formatString(string) Substitutes a parameter into a format string. The

format string should contain a “%1”, “%2”, etc. where the parameters are
to be substituted. Up to nine parameters are supported. For example:
Document.writeln( formatString("%1 students have %2
the exam", 32, "passed"));
Produces the output:
32 students have passed the exam
To have a percent sign in the format string, use “%%”.
61
Functions
• sqlEscape(string [,Boolean]) Prepares a string for use as a SQL

statement. This is typically used to encode special characters (apostrophe
and backslash for Adaptive Server Anywhere; apostrophe for Adaptive
Server Enterprise) so they can be used as string literals in a SQL statement.
sqlEscape takes two parameters. The first parameter is the string to be
processed, the second optional parameter is a Boolean that indicates
whether the backslash characters are to be escaped.
sqlEscape causes the special characters to be doubled up for the database
to read them correctly when being passed. If the string
\site\system\doc’s was being passed into a SQL statement against
an Adaptive Server Anywhere database it could be prepared as follows:
dir = sqlEscape( dir, true );
This would produce the string ’\\site\\system\\doc’’s’. Similarly,
to prepare the dir string to be used against Adaptive Server Enterprise
you would do something like:
dir = sqlEscape( dir, false );
This would produce the string ’\site\system\doc’’s’
• toDOMDocument(xmlString) Parses a document and returns an XML

DOM document. The DOM objects (see the Predefined Objects chapter)
can then be used to manipulate the document.

62
• toXMLString(object [, use_CDATA, index_tag]) Prepares a DynaScript

object for XML representation. Nesting objects is permitted.
• object is the DynaScript object for which XML representation is
required.
• use_CDATA indicates that you want to use CDATA to escape
special XML characters. If use_CDATA is false, characters will be
encoded with the normal ampersand method. The default value is
false.
• index_tag specifies a set of tags to use when unnamed members
of an object are encountered.
This example uses toXMLString to display automobile service information:

The output from the above example would look something like this:
Car for service
<manufac>Mazda</manufac>
<model>MX6</model>
<year>1998</year>
<color>blue</color>
<owner><name>Rick Smith<name>
<address>21 King St. Waterloo<address></owner>
<work>new brakes</new brakes>
The following example of the toXMLString built-in function sets use_CDATA
to true and specifies which tag to use if a member has not been named:

The output from the above example would look something like:
Parts for Order
<part>
<shop><![CDATA[Jim & Son’s Autobody]]></shop>
<partname>strut</partname>
<sku>123</sku>
</part>
<part><shop><![CDATA[Jim & Son’s Autobody]]></shop>
<partname>clutch</partname>
<sku>456</sku>
</part>
• typeof( ) The typeof() function takes a single object as an argument and

returns a string that can be:
• “object”
• “string”
• “number”
• “Boolean”
• “binary”
• “function”
• “null”
The following example stores multiple document values of the same name
as a DynaScript object. The typeof( ) function is used to determine
what values have been received:

For more information about working with multiple selection lists, see
“value property” on page 145.
• xmlEscape( string [,useCDATA] ) Prepares a string for use as XML.

If useCDATA is false, the characters &, <, and > are escaped as &,
< and &gt. For example:
document.writeln( xmlEscape( "<MyTag> Hello!
</MyTag>" ) );
would produce:
<MyTag> Hello! </MyTag>
If useCDATA is true, the string will be surrounded by the tags <![CDATA[
and ]]>. For example,
document.writeln( xmlEscape( "Tom & Jerry",
true ) );
would produce:
"<![CDATA[Tom & Jerry]]>"
If there is not an <, >, or & in the string, xmlEscape does not encode any
characters.
65
Objects
Objects
DynaScript is object-oriented, which means it supports objects and the
fundamental object-oriented concepts of:
• encapsulation An object contains both properties and the methods that
manipulate those properties.
• polymorphism Different kinds of objects can respond to the same
message in their own ways (by using their own methods of that name).
• inheritance You can define new objects that extend the capabilities of
existing objects (by inheriting existing properties and methods and then
adding new ones).
You can define your own custom object types (also called classes). You can
then create as many instances of each class as you require.
Predefined objects DynaScript also includes a number of predefined objects that simplify the task
of developing database-driven content. For more information, see “DynaScript
Predefined Objects” on page 75.
Properties and methods

An object is a convenient way to collect a set of related information
(properties) into one place, together with the actions (methods) that
manipulate that information.
Case-sensitive names
The names of object properties and methods are case-sensitive.
Properties A property is a variable in an object that describes some part or attribute of the
object.
A property can be any datatype. Objects can contain other objects as properties.
Property names must be unique within the scope of the class and its ancestor
classes (if any).
You can access an object property using standard dot notation:
objectName.propertyName
For example, for an object called sampleEmployee, you could assign
"Homer" as the value of its name property:
sampleEmployee.name = "Homer";
66
Methods A method is a function in an object that acts on one or more properties of the
object.
Name scoping depends on how the method was defined:
• If a method is defined inline (within the class definition), its name must be
unique within the scope of the class. If it has the same name as a method
in one of its ancestor classes, it overrides (redefines) that method for
instances of its own class.
• If a method is defined as a global function (outside the class definition), its
name must be unique within the scope of the current script.
You can call an object method using standard dot notation:
objectName.MethodName()
Parentheses must be used

You must use parentheses when calling a method, even if it takes no
arguments.
You can define objects as conventional arrays that use integer indexes. For
example:
price[0] = 19.95
price[1] = 42.99
You can also use text literals as indexes. In this case, the array notation simply
becomes an alternative to the dot notation for object properties. For example:
sampleEmployee.name
can also be referenced as
sampleEmployee["name"]
67
Objects
Restrictions on integer indexes

Note that, for integer indexes, you cannot use the dot notation
interchangeably with the array notation because of property-naming rules. For
example, you cannot reference price[2] as price.2, because 2 is not a valid
identifier name (it does not start with a letter). Also, you cannot reference it as
price["2"]. You must use the conventional array notation of price[2].
Object-oriented concepts
Encapsulation By using an object container to associate properties with the methods that
affect them, you can encapsulate the behavior of a conceptual object in one
place. This can make testing, maintenance, and subsequent enhancements
much easier.
You also avoid having name conflicts for your properties and methods, since
instead of being declared globally (where each name must be unique), they are
declared as part of an object (where they need be unique only within the scope
of the object itself).
Polymorphism Polymorphism is the ability of different classes of objects to respond to a
particular method call in their own ways.
For example, suppose that you define two object classes called
salariedEmployee and hourlyEmployee. Each type has its own
PrintAllInfo method that prints employee information a certain way.
To print information for an employee, you simply call the PrintAllInfo
method for the object. Depending on whether the employee is salaried or
hourly, the corresponding PrintAllInfo method will be called
automatically. If you add more classes of employees, they can redefine their
own PrintAllInfo methods. The actual code that calls PrintAllInfo does
not need to be changed to accommodate the new object types.
Polymorphism is particularly powerful when used in conjunction with
inheritance.
Inheritance ECMAScript lets you define new classes from scratch, but it does not support
inheritance – the ability to create new classes of objects that are extensions of
existing classes.
The simplest form of inheritance is single inheritance, in which a new class
can inherit properties and methods from a single parent class.
68
DynaScript adds single inheritance in the form of the class statement. You
can derive a new class from an existing class, adding new properties and
methods (or overriding existing properties and methods) as you require.
Inheriting objects also means that you can take better advantage of
polymorphism, since derived classes can override (redefine) existing methods
defined by their parent class, without needing to change other code that calls
these methods.
Defining base classes

To define a base class (one that does not inherit anything from existing
classes), you can:
• Define a function that represents the class
• Use the class statement (a DynaScript extension)
The Dynamo class statement is a more flexible construct (since you can also
use it for derived classes) but if you require compatibility with standard
ECMAScript you may want to use the function-declaration technique instead.
Using the function To define a base class using the standard function-declaration technique,
statement declare a function using the class name and the property names, assign the
property values, and define a method that references the function.
You can define methods inline (inside the class definition), or by assigning
method names to existing global functions (outside the class definition). Inline
method declaration is preferable, however, since it encapsulates the method
within the class and allows methods in different classes to have the same name
(making polymorphism possible).
The following example defines an employee class, with three properties
(name, title, and managerName) and one method (PrintAllInfo) defined
inline:
document.WriteLn("Reports to: " +this.managerName);
function employee(name, title, managerName) {
this.name = name;
this.title = title;
this.managerName = managerName;
69
Objects
}
For more information, see “function statement” on page 52.
Using the class To define a base object using the class statement, declare the class name and
statement the property names, assign the property values, and define a method that
references the function.
As in the function-declaration technique, you can define methods inline or
assign method names to existing global functions.
The following example defines the same employee class used in the function-
declaration example:
class employee(name, title, managerName) {
this.name = name;
this.title = title;
this.managerName);
}
}
The only difference in the two examples is the class keyword itself. The main
reason for using the class statement is for the additional ability to define
derived objects.
For more information, see “class statement” on page 50.
Extending existing classes by inheritance

A derived class (also called a subclass) extends the definition of an existing
class. It inherits the properties and methods of the parent class (also called a
superclass), and then adds (or redefines) its own additional properties and
methods.
To define a derived class, use the class statement as follows:
• Declare the class name and the property names (typically the new
properties and the parent properties).
• Identify the parent class and pass it the parameters that it expects.
70
• Assign the property values of the new class.

• Define the methods of the new class as functions.
As for base classes, you can define methods inline or assign method names
to existing global functions.
For more information, see “class statement” on page 50.
Example The following example defines an employee class, then derives a
salariedEmployee subclass from it:
• The subclass inherits the name, title, and managerName properties and
the PrintNameAndTitle method.
• The subclass adds one new property (salary) and one new method
(PrintAllInfo) method that includes the new salary information in the
output.
class employee(name, title, managerName) {
this.name = name;
this.title = title;
function PrintNameAndTitle() {
document.WriteLn("Name, title: " + this.name
+ ", " + this.title);
}
this.PrintNameAndTitle = PrintNameAndTitle;
}
class salariedEmployee(name, title, managerName,
salary)
extends employee(name, title, managerName) {
this.salary = salary;
this.managerName);
document.WriteLn("Salary: " + this.salary);
}
}
71
Objects
Creating instances of classes

Once you’ve defined an object class, you can start creating specific objects
(instances) of that class. If, for example, you’ve defined a
salariedEmployee class, you can then start creating records for salaried
employees.
To create instances of a class, you assign a variable using the new operator with
the name of the class and the property values for this new instance of the class.
The usage is the same whether you used the standard function-declaration
technique or the Dynamo class statement.
For more information, see “new operator” on page 51.
Example The following example creates salaryEmp as a new instance of the
salariedEmployee class, and supplies it with appropriate values for the
class properties (name, title, managerName, and salary).
var salaryEmp = new salariedEmployee("Ned Simpson",
"Technical Writer", "Barney Burns", 80000);
Working with named and indexed members

Named and indexed members are separate entities. For example, if X.a=1 and
X.b=2, document.writeline X[0] would not equal 1 but would have a value of
undefined. The following example further demonstrates this:

Would have this output:
1
3
4
2
The for in statement iterates through named members first, then indexed
members.
72
Paths
You can use both relative and absolute paths when working with DynaScript
objects. You can also use a tilde(~) with an absolute path instead of the Web
site name or Personal Web Server mapping for the following:
• site.GetDocument()
• site.CreateDocument()
• site.DeleteDocument()
• site.CopyDocument()
• site.RenameDocument()
• site.Include()
• the INCLUDE tag
• the import() statement
For example, if the name of the root document in your Web site is Product and
your mapping to that Web site is named product_site and you wanted to open
the document price.stm, you could use:
site.GetDocument("/Product/price.stm");
site.GetDocument("/product_site/price.stm");
The first example would work only from within Sybase Central while the
second example would work only through a Web server. Using the tilde allows
this statement in either situation:
site.GetDocument("~/price.stm");
The above-listed methods, tags, and statements also handle ..\ in a directory
path, which specifies that the path is relative to the current directory but is back
one level. Each occurrence of ..\ in a directory path specifies that the target
directory is back another level. If the number of occurrences of ..\ in a directory
path causes the directory to go back further than /Site, an error occurs.
Wildcards
There are two wildcard characters that you can use with
site.DeleteDocument(docName) and
document.GetDirectory([fileMask, sortOrder]): * and ?.
73
Objects
Use the * wildcard to represent any number of alphanumeric characters. For

example, site.DeleteDocument("/Site/a*.stm") deletes all templates
starting with the letter a from the root of the Web site.
Use the ? wildcard to represent a single alphanumeric character. For example,
site.DeleteDocument("/Site/a?.stm") would delete template files
that started with an a and had one more character in the file name such as
aa.stm or ab.stm. The previous example would not delete the files acrobat.stm
or a.stm.
74
CH A PTE R 3 DynaScript Predefined Objects
About this chapter This chapter lists the predefined objects supported by PowerDynamo.
These predefined objects include ECMAScript objects, DOM objects for
XML, and DynaScript-specific objects that offer useful properties and
methods for developing Web sites.
Contents
Topic Page
Array object 76
attachment object 80
Boolean object 86
connection object 87
Date object 104
document object 126
DOMAttribute object 143
DOMCharacterData object 146
DOMComment object 150
DOMDocument object 151
DOMDocumentFragment object 157
DOMDocumentType object 158
DOMElement object 160
DOMEntity object 166
DOMEntityReference object 168
DOMImplementation object 169
DOMNamedNodeMap object 170
DOMNode object 173
DOMNodeList object 183
DOMNotation object 184
DOMProcessingInstruction object 185
The DOMText object 187
file object 188
FTP object 197
The Function object 210
java object 212
75
Array object
Topic Page
mailList object 223
mailPiece object (incoming) 227
mailPiece object (outgoing) 238
Math object 252
Number object 261
Object object 265
recipient object 267
query object 269
session object 288
site object 291
String object 319
system object 323
Array object
Object Enables the creation and manipulation of arrays.
Standard: ECMAScript
Syntax To use an Array property:
Array.propertyName
To use an Array method:
Array.MethodName( parameter )
The Array object has both a built-in object as well as constructors that allow
users to create instances of an Array object. When referring to Array in the
syntax of this chapter, we are referring to an instance of an array, not the built-
in Array object.
Description Calling an array as a function or as a constructor has equivalent results – both
create and initialize a new Array object.
To create an Array with a constructor:
myArray = new Array( [item0 [, item1 [, item2...]]] );
myArray = new Array( length )
It is generally more efficient to create an array with the number of elements you
expect to use (or approximately), rather than growing the Array dynamically.
Example • This example creates an array, fills it, then displays the contents:
76
CHAPTER 3 DynaScript Predefined Objects

Array properties
The Array object has this property:
length property
Syntax Array.length
Description Returns a value one higher than the highest element in the array.
Return Integer.
Example • This example returns 7:

Array methods
The Array object has these methods:
join method
Syntax Array.join( separator )
77
Array methods
Description Converts the elements of the array into strings which are then concatenated. If
no separator is given, commas will separate the strings.
Return String object.
Example This example lists the elements of the Array separated by the
“&” character:

The output from this example is:
carrots & corn & green beans & celery
reverse method
Syntax Array.reverse( )
Description Reverses the order of the elements in the array.
Return Array object.
Example This example reverses and displays the content of the myArray array:

sort method
Syntax Array.sort( [compareFunction] )
78
Description Sorts the elements of an array. A compareFunction can optionally be used to

sort the array or the default may be used. The compare function takes two
arguments a, b. If
• a<b the return will be negative
• a=b the return will be 0
• a>b the return will be positive
Return Array object.
Example This example sorts the array alphabetically and displays the results:

toString method
Syntax Array.toString( )
Description Converts the elements of the array to concatenated strings, separated by
commas.
Return String.
Example This example converts the array elements to strings and displays them:

79
attachment object
attachment object
Object Represents file, data, or document attachments to incoming mail pieces.
Syntax attachment.propertyName
Description Use the attachment object to manipulate incoming mail piece attachments. You
can view and save attachments in different formats.
Example This script saves a mail piece file attachments to a hard drive:

See also “mailList object” on page 223
“mailPiece object (incoming)” on page 227
“mailPiece object (outgoing)” on page 238
“recipient object” on page 267
attachment properties
The attachment object has these properties:
80
mimeType property
Syntax attachment.mimeType
Attributes This property is read-only.
Description The MIME type of the attachment, for example “image/gif”.
Return String.
Example This example retrieves a mail piece with a subject heading of “The attachment
object” and displays the attachment name and MIME type.

name property
Syntax attachment.name
Description The name or description of the attachment, if present. This is extracted from
MIME headers.
Return String.
Example This example uses the name property to save the file with the same name as the
attached file.

attachment methods
The attachment object has these methods:
GetContents method
Syntax attachment.GetContents( )
Description Returns the content of the attachment.
Return String or binary.
Example This example retrieves a mail piece with an attachment and displays the
attachment:

See also “autoCommit property” on page 90.
“connected property” on page 90.
GetErrorCode method
Syntax attachment.GetErrorCode( )
Description Returns a code representing the last error that occurred.
Return Integer.
attachment:

83
attachment methods
GetErrorInfo method
Syntax attachment.GetErrorInfo( )
Description Returns a string containing a meaningful error message.
Return String.
attachment:

SaveAsDocument method
Syntax attachment.SaveAsDocument ( document_name [,
fail_if_document_exists] )
Description Saves the content of the attachment as a PowerDynamo Web site document. If
fail_if_document_exists is set to true (the default), SaveAsDocument
fails if the document already exists. If set to false the document is overwritten.
Return Boolean.
Example This example saves an attachment as a Dynamo document:

SaveAsFile method
Syntax attachment.SaveAsFile ( file_path [, fail if file exists] )
Description Saves the content of the attachment to the file system. If
fail_if_file_exists is set to true (the default), then SaveAsDocument
fails if the document already exists. If set to false, the file is overwritten.
Return Boolean.
Example This example retrieves a mail piece and saves the attachments as files:

Boolean object
Object Allows you to create an object with a value of true or false. The Boolean object
has no properties.
Syntax Boolean.MethodName( parameter )
Description You can set the Boolean object’s value when you create the object, or at a later
date. To create a Boolean object, use this constructor:
BoolObj = new Boolean ( [value] );
If you provide a value, the Boolean object will contain that initial value. If you
do not provide a value, the object will have the value of false.
Example This example creates a Boolean object and sets the value as false:

Boolean methods
The Boolean object has these methods:
toString method
Syntax Boolean.toString( )
Description Returns the value of the Boolean as a string.
Return String.
Example This example returns the value of the Boolean as a string:
86

valueOf method
Syntax Boolean.valueOf( )
Description Returns the value of the Boolean object.
Return Boolean.
Example This example returns the value of the Boolean object:

connection object
Object Describes a connection to a database.
Syntax To use a connection’s property:
connection.propertyName
To use a connection’s method:
connection.MethodName( parameter )
Description Dynamo requires two types of connections:
• Dynamo connections A connection to a data source capable of hosting a
Dynamo Web site (for example, Adaptive Server Anywhere).
• User connections definitions A connection to a data source that provides
the actual database content to the Web site.
When you create a Dynamo Web site, your Dynamo connection becomes the
default for your user connection as well. This connection information is
encapsulated in the <default> connection object.
You can use Sybase Central to change the default connection associated with a
script. For a detailed explanation of connections, see “Working with
connections” in the PowerDynamo User’s Guide.
87
connection object
If your database content is stored in one or more other data sources, you can
then create more connection objects to manage those sources.
There are two ways to create connection objects. To create a permanent User
connection that is added to the Connections folder, use this format:
For an ODBC connection:
site.CreateConnection( connName, description,
dataSource [,userName, password, ODBC,
connectParameters] )
For an Open Client connection:
site.CreateConnection( connName, description,
server, userName, password, Open Client [,database] )
The preferred method of creating a permanent user connection, however, is to
use Sybase Central to create it from within a script. For additional information,
see “Creating, deleting, modifying, and testing User connections” in the
For a temporary connection which lasts only as long as your script is executing,
use the following:
To create an ODBC connection:
X = new Connection ( name, description, datasource
[,userName, password, ODBC, connectParameters] );
To create an Open Client connection:
X = new Connection ( name, description,
server, userName, password, Open Client [,database] );
If a connection is not successfully created, null is returned. Use site.GetState,
site.GetErrorInfo, and site.GetErrorCode to retrieve information about the
state of the connection.
88
chained mode
Open Client connections are automatically set to CHAINED = ON which is
equal to autoCommit=false. Use autoCommit property to set chained mode to
off (autoCommit=true).
Stored procedures and chained mode

When stored procedures are created they inherit the mode of the connection
through which they were created. Stored procedures that are created through an
Open Client connection will have their mode set to chained by default. Once
a stored procedure has been created it is possible to change its mode, so that it
may be used by a connection regardless of mode, with the command:
sp_procxmode stored_procedure_name, “anymode”
Substitute your procedure name for the “stored_procedure_name”.
The connection object

If there is no connection associated with a script (the connection shown in the
document properties is “no connection”), then there will not be a connection
object.
The site object allows you to manipulate your Web site connections. For
information on CreateConnection, DeleteConnection or GetConnection see
“site object” on page 291
Example This script creates a permanent ODBC connection called myConn. Once
created, this connection is visible from the Connections folder in Sybase
Central:

See also “Connect method” on page 198
“Disconnect method” on page 200
“GetSupportedMoves method” on page 103
“Rollback method” on page 103
89
connection properties
The connection object has these properties:
autoCommit property
Syntax connection.autoCommit
Description If true, each SQL statement executed using the connection is automatically
committed immediately after it is executed.
chained mode
Open Client connections are automatically set to CHAINED = ON which is
equal to autoCommit=false. Use autoCommit property to set chained mode to
off (autoCommit=true).
Example This example adds $1000 to account 999999999. The insert is executed and
committed immediately:

connected property
Syntax connection.connected
Description Uses a Boolean value to indicate whether a connection has been made to the
database.
Example This example displays the return. True indicates a successful connection, false
indicates no connection has been made.

90
This example has an output of:

false
true
false
See also The “Disconnect method” on page 200
The “Connect method” on page 198
connectionType property
Syntax connection.connectionType
Description The type of connection (string). One of:
• ODBC
• Open Client
Example This example displays the connection type for a script's default connection
object:

connectParameters property
Syntax connection.connectParameters
Description Connection parameters for an ODBC data source (string).
Example This example lists the connection parameters for the ODBC data source:

This example could have the following output:
91
autostop = no
database property
Syntax connection.database
Description The name of the database to which an Open Client connection (string) is made.
Example This example changes the database to which "myConnection" will connect.

databaseType property
Syntax connection.databaseType
Description The type of database to which you are connecting; for example, Adaptive
Server Enterprise.
Example This example displays the type of database that is currently connected to:

dataSource property
Syntax connection.dataSource
Description Name of an ODBC data source (string).
Example This example changes the data sourcethat "MyConnection" uses to connect to
"PowerDynamo Demo":

92
dataSourceList property
Syntax connection.dataSourceList
Description Names of all available ODBC data sources (array of strings).
Example This example lists all the available ODBC data sources:

This example might have the following output:
SQL Anywhere Sample
PowerDynamo Demo
description property
Syntax connection.description
Description Description associated with the connection (string).
Example This example displays the description associated with the connection:

If the connection includes a description, this example might have output
similar to:
Connection to the sample site.
isolationLevel property
Syntax connection.isolationLevel
Description The isolation level for the database that you are connected to. You must be
connected to set the isolation level. You can set this value with an integer or a
string but it is always retrieved as a string. The possible values are:
93
• -1 “The isolation level is undetermined or cannot be determined.”

• 0 “ReadUncommitted”
• 1 “ReadCommitted”
• 2 “RepeatableRead”
• 3 “Serializable”
• 4 “Versioning”
If you set the isolation level to a value that the database does not recognize, the
old isolation value will remain.
Example This example displays the current isolation level and then resets the isolation
level to 3:

name property
Syntax connection.name
Description Name of the connection object (string). The name of the default connection is
<default>.
Example This example displays the name of the connection object. The Connections
folder in Sybase Central lists all connection object names.

<default>
94
password property
Syntax connection.password
Description User password for the data source (string).
Example This example changes the password for “MyConnection” to “secret”:

server property
Syntax connection.server
Description Server name for the Open Client connection (string). This property can be used
only when you are using an Open Client connection.
Example This example displays the server name to which the connection object is
connected:

myserver
simulateCursors property
Syntax connection.simulateCursors
Description Allows support for movement through a query result set for individual
connections. This property is useful when working with Adaptive Server
Enterprise connections.
95
[Adaptive Server Enterprise]

The cursor support of Adaptive Server Enterprise is not as extensive as that of
Adaptive Server Anywhere, and some of the Move functions are unavailable.
To use Move, MoveFirst, MoveLast, MovePrevious or MoveRelative
with an Adaptive Server Enterprise connection you simulate the cursor abilities
of Adaptive Server Anywhere using connection.simulateCursors.
To simulate cursors for all connections indefinitely, modify your Registry as
follows:
From your system’s Registry Editor, open the following file:
HKEY_LOCAL_MACHINE\SOFTWARE\SYBASE\SYBASE TOOLS
Add the new string value name Simulate Cursors with the string value of
"yes."
Using simulated cursors may cause a decline in performance. When possible,
use MoveNext instead.
Example This example allows MovePrevious to be used with an Adaptive Server

Enterprise connection:


See also “query object” on page 269
The “query properties” on page 271
The “Move method” on page 279
The “MoveFirst method” on page 280
The “MoveLast method” on page 281
The “MoveNext method” on page 282
The “MovePrevious method” on page 283
The “MoveRelative method” on page 284
96
userId property
Syntax connection.userId
Description User name for the ODBC data source (string).
Example This example gets the connection “Temp” and changes the password and user
ID.

connection methods
The connection object has these methods:
Commit method
Syntax connection.Commit ( )
Description Commits the transaction.
Return Boolean.
Example This example moves 100 dollars from a checking account to a savings account.
If the money is moved successfully, a commit is performed:

Connect method
Syntax connection.Connect ( )
Description Connects to a connection object.
Return Boolean. Indicates whether the connection was successful or not.
Example This example connects to the myConn connection:

See also The “Disconnect method” on page 200
CreateComponent method
Syntax connection.CreateComponent (packageName, componentName )
Description This method is for calling Jaguar components.
connection.CreateComponent returns a component object representing
the object referenced within the package.
98
Return The component object or null.

Example This example calls a Jaguar component and uses its setMessage method:

CreateQuery method
Syntax connection.CreateQuery ( [ SQLStatement, [doExecute ]] )
Description Executes a query containing a sqlStatement and returns a query object
(equivalent to performing myQuery.SetSQL and myQuery.Execute).
You can use CreateQuery method in these ways:
• connection.CreateQuery() creates an “empty” query object. You can
then call the SetSQL and Execute methods at a later time.
• connection.CreateQuery("select * from product") creates
and executes a query.
• connection.CreateQuery("select * from product", false)
creates a query object and sets the SQL statement, but does not execute it.
You can then call the Execute method at a later time.
Return Returns a query object.
Example This example queries the sample database (using the connection “sample”) for
a list of all the employees and then displays the list in alphabetical order:

This example has the following output:
Ahmed, Alex
Barker, Joseph
Barletta, Irene
Bertrand, Jeannette
Bigelow, Janet
Blaikie, Barbara
Braun, Jane
Breault, Robert
Bucceri, Matthew
Butterfield, Joyce
Chao, Shih Lin
Charlton, Doug
Chin, Philip
Clark, Alison
Cobb, Matthew
Coe, Kristen
Evans, Scott
...
See also “query object” on page 269.
Disconnect method
Description Disconnects a connection object from a database.
Syntax connection.Disconnect ( )
Example This example disconnects from a connection called myConn:

GetErrorCode method
Syntax connection.GetErrorCode( )
Description Returns the current error code.
100
Return Integer. Returns zero if a SQL instruction is carried out correctly, and
information to which the script can respond if it fails.
Example This example displays a 0 if the query executes without error:
<HTML>
<BODY>
<H1></H1>


</BODY>
</HTML>
The “query properties” on page 271.
The “GetErrorInfo method” on page 277.
The “GetState method” on page 278.
GetErrorInfo method
Syntax connection.GetErrorInfo( )
Description A description of the error.
Return String.
Example This example displays information explaining why the query did not work
correctly:
<HTML>
<BODY>
<H1></H1>


</BODY>
</HTML>
“GetErrorCode method” on page 277.
“GetState method” on page 278.
GetState method
Syntax connection.GetState( )
Description Returns the current SQL state of the query.
The values returned by GetState depend on your database driver. For more
information, see your database's documentation.
Example This example displays the SQL state for the connection:
<HTML>
<BODY>
<H1></H1>


</BODY>
102
</HTML>

“GetErrorInfo method” on page 277.
GetSupportedMoves method
Syntax connection.GetSupportedMoves ( )
Description Provides a list of Move methods that can be called for queries using that
particular connection.
Example This example displays the available Move methods for the connection
connection:

If this was a connection to Adaptive Server Anywhere, the output would be:
MoveFirst
MoveNext
MovePrevious
MoveRelative
Move
MoveLast
Rollback method
Syntax connection.Rollback ( )
Description Performs a rollback on the transaction.
Return Boolean.
103
Date object
Example This example moves 100 dollars from a checking account to a savings account.
If the money is not moved successfully, a rollback is done:

Date object
Object Enables the storage and retrieval of dates and times. The Date object has no
properties.
Syntax To use a Date’s method:
Date.MethodName( parameter )
104
Description The Date object may be constructed in any of these ways:

MyDateObj = new Date( )
MyDateObj = new Date( dateVal )
MyDateObj = new Date( [year, month [, date [, hours [, minutes [,
seconds [, ms]]]]]] )
The following syntax creates an integer holding the number of milliseconds
from midnight, January 1, 1970.
myInt = DateUTC( [year, [month [, date [, hours [, minutes [, seconds [,
ms]]]]]]] )
The parameters are:
• dateVal A string (Jan 30, 1938) or the number of milliseconds in
Universal Coordinated Time (previously known as Greenwhich Mean
time) between the specified date and midnight January 1, 1970. To
maintain accuracy a range between -2147483649 to 2147483647 may be
used. Dates that are outside of this range should use the other Date
constructor or a floating point.
• year The full year of the specified date. For example 1996. A value of
0 to 99 would be converted to a value between 1900 to 1999.
• month The month of the specified date. 0 is equal to January.
• date The date of the specified date.
• hours The hour of the specified date. 0 is equal to midnight. If
minutes is specified, the hours attribute must also be set.
• minutes The number of minutes of the specified date. If seconds is
specified, the minutes attribute must also be set.
• seconds The number of seconds of the specified date. If milliseconds
is specified, the seconds attribute must also be set.
• ms The number of milliseconds of the specified date.
The Date object has both a built-in object as well as constructors that allow
users to create instances of a Date object. When referring to Date in the syntax
sections of this chapter, we are referring to an instance of the Date object, not
the built-in Date object.
If a value for the date object goes beyond its boundaries, the other values will
be modified accordingly. For example if 14 is the given value for the month
parameter, the month value will be equal to March.
Example • This example uses the Date constructor to create a date object:
105
Date methods

See also “valueOf method” on page 265
Date methods
The Date object has these methods:
getDate method
Syntax Date.getDate( )
Description Returns the day of the month in local time.
Return Integer.
Example This example displays the numeric day of the month:

getDay method
Syntax Date.getDay( )
Description Returns the day of the week in local time.
Return An integer between 0 and 6.
• 0 Sunday
• 1 Monday
• 2 Tuesday
• 3 Wednesday
• 4 Thursday
• 5 Friday
• 6 Saturday
106
Example This example displays the day of the week, which in this case is 1 (Monday):

getFullYear method
Syntax Date.getFullYear( )
Description Returns the year in local time.
Return An absolute number representing the full year.
Example This example displays the full year of the Date object:

getHours method
Syntax Date.getHours( )
Description Returns the hours value in local time.
Return Integer between 0 and 23.
Example This example displays the numeric value of the Date objects hour:

getMilliseconds method
Syntax Date.getMilliseconds( )
Description Returns the milliseconds value in local time.
Return Integer from 0 to 999.
Example This example displays the number of milliseconds in the Date object:
107
Date methods

getMinutes method
Syntax Date.getMinutes( )
Description Returns the minutes value in local time.
Example This example displays the number of minutes in the Date object:

getMonth method
Syntax Date.getMonth( )
Description Returns the month value in local time.
Return Integer between 0 and 11. 0 is equal to January.
Example This example displays the month value of the Date object:

getSeconds method
Syntax Date.getSeconds( )
Description Returns the seconds value.
Example This example displays the seconds value of the Date object:
108

getTime method
Syntax Date.getTime( )
Description Returns the time value in local time. This value represents the number of
milliseconds between the specified time and midnight, January 1, 1970.
Negative numbers indicate dates prior to midnight, January 1, 1970.
Return Integer.
Example This example displays the number of milliseconds that have elapsed since
January 1, 1970 and the Date object:

getTimezoneOffset method
Syntax Date.getTimezoneOffset( )
Description Returns the difference in minutes, between the local time and the Universal
Coordinated Time.
Return Integer.
Example This example displays the number of minutes between the local time and the
Universal Coordinated Time:

109
Date methods
getUTCDate method
Syntax Date.getUTCDate( )
Description Returns the numeric date of the Date object, in Universal Coordinated Time.
Return Integer between 1 and 31 that represents the date value in the Date object.
Example This example displays the numeric date of the date object in Universal
Coordinated Time:

getUTCDay method
Syntax Date.getUTCDay( )
Description Returns the day of the week from the Date object, in Universal Coordinated
Time.
• 0 Sunday
• 1 Monday
• 2 Tuesday
• 3 Wednesday
• 4 Thursday
• 5 Friday
• 6 Saturday
Return Integer between 0 and 6 representing the day of the week.
Example This example displays the day of the week in UTC time:

110
getUTCFullYear method
Syntax Date.getUTCFullYear( )
Description Returns the full year from the Date object, in Universal Coordinated Time.
Return Integer.
Example This example displays the full year in UTC time:

getUTCHours method
Syntax Date.getUTCHours( )
Description Returns the hours from the Date object, in Universal Coordinated Time.
Return Integer 0 to 23.
Example This example returns the hours in UTC time:

getUTCMilliseconds method
Syntax Date.getUTCMilliseconds( )
Description Returns the milliseconds value in a Date object using Universal Coordinated
Time.
Return Integer.
Example This example displays the number of milliseconds being held in the Date object
in UTC time:

getUTCMinutes method
Syntax Date.getUTCMinutes( )
Description Returns the minutes value in a Date object, using Universal Coordinated Time.
Example This example displays the number of minutes being held in the Date object in
UTC time:

getUTCMonth method
Syntax Date.getUTCMonth( )
Description Returns the month value in a Date object, using Universal Coordinated Time.
• 0 January
• 1 February
• 2 March
• 3 April
• 4 May
• 5 June
• 6 July
• 7 August
• 8 September
• 9 October
• 10 November
• 11 December
112

Example This example displays the UTC month of the Date object:

getUTCSeconds method
Syntax Date.getUTCSeconds( )
Description Returns the seconds value in a Date object, using Universal Coordinated Time.
Example This example displays the number of seconds (in UTC time) in the Date object:

getYear method
Syntax Date.getYear( )
Description Returns the year value in a Date object in local time. Use the getFullYear
method instead, to avoid Y2K problems.
Return Integer.
Example This example displays the year of the Date object:

113
Date methods
parse method
Syntax Date.parse( string )
Description Parses a string containing a date and returns the number of milliseconds
between the date and midnight of January 1, 1970. The string may be in the
following formats:
• Month/day/year For example, 03/18/93,
• Month-day-year For example, 03-18-93
• Month day year For example, March 23 93
• Hour:minute:second For example, March 23 93 11:23:03. You do
not need to specify hours, minutes, and seconds. All, one, or none or these
values may be specified.
Use the parse method with the built-in Date object as shown in this example.
The parse method does not work with instances of the Date object.
Return Integer (milliseconds).
Example This example returns the number of milliseconds between the date string and
January 1, 1970:

setDate method
Syntax Date.setDate( numDate )
Description Sets the numeric day of the month of the Date object. numDate is a numeric
value equal to the numeric date. If a value is greater than its range, the other
values will be modified accordingly. For example, if the current date was
January 3 and setDate was set to 33, the month would change to February and
the date would be set to 2.
Return Integer. The number of milliseconds since midnight, January 1, 1970.
Example This example changes the numeric date of the Date object to the 23rd:

setFullYear method
Syntax Date.setFullYear( numYear [, numMonth, [numDate]] )
Description Sets the year value in the Date object. The range of years supported is
approximately 285616 years on either side of 1970. The parameters are:
• numYear The numeric value of the year to set.
• numMonth The numeric value of the month to set. If the numDate
parameter is specified, this parameter must also be set.
• numDate The numeric value of the date to set.
Example This example changes the year of the Date object to 1999:

setHours method
Syntax Date.setHours( numHours [, numMin, [numSec, [numMilli]]] )
Description Sets the hours value in the Date object using local time. If a value is greater
than its range, the value will be modified accordingly. For example, the
numHours value of 30 would actually be equal to 6:00:00 (a day plus 6 hours).
The parameters are:
• numHours The hour value you would like set.
• numMin The minute value you would like set. If you use numSec or
numMilli, numMin is required.
• numSec The number of seconds you would like set. If you use
numMilli, you must use numSec.
115
Date methods
• numMilli The millisecond value you would like set.

Example This example changes the time of the Date object:

setMilliseconds method
Syntax Date.setMilliseconds( numMilli )
Description Sets the milliseconds value in the Date object. numMilli is the numeric value
equal to the millisecond value you wish to set. If the value is greater than 999,
the number of seconds is increased as required. For example, 1020
milliseconds would be equal to one second and 21 milliseconds.
Example This example changes the number of milliseconds in the Date object:

setMinutes method
Syntax Date.setMinutes( numMin [, numSec, numMilli] )
Description Sets the minutes value in the Date object. If a value is greater than its range, the
value will be modified accordingly. For example, the value of 80 minutes
would actually be equal to 1:20:00. The parameters are:
116
• numMin The minute value to set. This parameter is required if you use
numSec or numMilli.
• numSec The number of seconds you would like set. This parameter is
required if you use numMilli.
Example This example changes the value of the minutes in the Date object. Because the
number of minutes is larger than 59, the and the hour value will be incremented
by one (to 9), and the minute value is changed accordingly.

Old Minutes: 30
New hours: 9
New minutes: 29
setMonth method
Syntax Date.setMonth( numMonth [, dateVal] )
Description Sets the month value for the Date object. January is equal to 0. If the value of
a parameter exceeds its range, other parameters will be changed accordingly.
The parameters are:
• numMonth The numeric value of the month.
• dateVal The numeric value of the date.
Example This example changes the month value of the Date object to March:

setSeconds method
Syntax Date.setSeconds( numSec [, numMilli] )
Description Sets the seconds value in the Date object using local time. If the value of a
parameter exceeds its range, other parameters are changed accordingly. The
parameters are:
• numSec The second value to set. If you use numMilli, you must use
numSec.
Example This example changes the value of the seconds in the Date object:

setTime method
Syntax Date.setTime( numMilli )
Description Sets the date and time value in the Date object. numMilli is an integer that
represents the number of milliseconds that have elapsed since midnight,
January 1, 1970 GMT. A negative number indicates a date earlier than January
1, 1970. PowerDynamo supports a range between -2147483649 and
2147483647. To set dates that are beyond this range, use a floating point.
118
Using setTime to set the date and time of a Date object is time zone
independent.
Example This example sets the date and time of a date object with the setTime method:

Year: 1970
Month: 0
Date: 1
Hours: 1
Minutes: 28
setUTCDate method
Syntax Date.setUTCDate( numDate )
Description Sets the numeric date in the Date object using Universal Coordinated Time.
numDate represents the date that is to be set.
If the value of a parameter exceeds its range, other parameters will be changed
accordingly. For example, if the current date was January 12 and
SetUTCDate(33) was given, the new month and date would be February 2.
Example This example changes the date of the Date object. Because the new date value
exceeds the number of days in the month of February, the month value is
incremented by one, and the date is changed accordingly:

This example displays this output:
Old date: 11
Old month: 1
New date: 17
New month: 2
setUTCFullYear method
Syntax Date.setUTCFullYear( numYear [, numMonth, [numDate]] )
Description Sets the value of the year in the Date object using Universal Coordinated Time.
The range of years supported is approximately 285616 years on either side of
1970. The parameters are
• numYear The numeric value of the year to set.
• numMonth The numeric value of the month to set. If the numDate
parameter is specified, this parameter must also be set.
• numDate The numeric value of the date to set.
If the value of a parameter exceeds its range, other parameters are changed
accordingly. For example if the current date value was January 1, 1983 and the
numDate parameter given is 32, the date changes to February 1, 1983.
Example This example changes the year of the Date object and displays the new value:

setUTCHours method
Syntax Date.setUTCHours( numHours [, numMin, [numSec, [numMilli]]] )
Description Sets the hours value in the Date object using Universal Coordinated Time. If a
value is greater than its range, the value will be modified accordingly. For
example, the numHours value of 30 would actually be equal to 6:00:00 (a day
plus six hours). The parameters are:
• numHours The hour value you would like set.
• numMin The minute value you would like set. If you use numSec or
numMilli, you must set numMin.
• numSec The second value you would like set. If you use numMilli,
you must set numSec.
Example This example changes the hours value of the Date object and displays the new
value:

setUTCMilliseconds method
Syntax Date.setUTCMilliseconds( numMilli )
Description Sets the milliseconds value for the Date object. If the number of milliseconds
is greater than 999 or a negative number, the stored number of seconds reflects
this accordingly. For example, 1020 milliseconds is equal to one second and 21
milliseconds.
Example This example changes the milliseconds value of the Date object and displays
the new value:
121
Date methods

setUTCMinutes method
Syntax Date.setUTCMinutes( numMin [numSec, numMilli] )
Description Sets the minutes value in the Date object using Universal Coordinated Time. If
a value is greater than its range, the value is modified accordingly. For
example, the value of 80 minutes would actually be equal to 1:20:00. The
parameters are:
• numMin The minute value to set. This parameter is required if you use
numSec or numMilli.
• numSec The second value to set. This parameter is required if you use
numMilli.
Example This example changes the minute value of the Date object and displays the new
value:

setUTCMonth method
Syntax Date.setUTCMonth( numMonth [, dateVal] )
Description Sets the month value for the Date object. January is equal to 0. If the value of
a parameter exceeds its range, other parameters are changed accordingly. The
parameters are:
122
• numMonth The numeric value of the month.

• dateVal The numeric value of the date.
Example This example changes the month value of the Date object and displays the new
value:

setUTCSeconds method
Syntax Date.setUTCSeconds( numSec [, numMilli] )
Description Sets the seconds value in the Date object using Universal Coordinated Time. If
the value of a parameter exceeds its range, other parameters are changed
accordingly. The parameters are:
• numSec The second value to set. This parameter is required if you use
numMilli.
• numMilli The millisecond value to set.
Example This example changes the second value of the Date object and displays the new
value:

setYear method
Syntax Date.setYear( numYear )
123
Date methods
Description Sets the year value in the Date object. This method is currently maintained only
for backward compatibility. Use the setFullYear method instead.
toGMTString method
Syntax Date.toGMTString( )
Description Returns a date as a string in Greenwich Mean Time. This method is currently
supported only for backward compatibility. Use the toUTCString instead.
Return String.
toLocaleString method
Syntax Date.toLocaleString( )
Description Returns a date as a string using the current locale.
Return String. The format of this string changes depending on the locale. For example,
the date January 10, 1998 is represented by:
• "01/10/98 00:00:00" in Canada or the United States or,
• "10/01/98 00:00:00" in Europe
Example This example displays the value of the Date object in local time:

Wed, 11 Feb 1998 08:30:11
toString method
Syntax Date.toString( )
Description Returns the date as a string in a convenient, readable format in local time.
Return String.
124
Example This example displays the value of the Date object in local time:

Wed, 11 Feb 1998 08:30:11
toUTCString method
Syntax Date.toUTCString( )
Description Returns a date as a string in Universal Coordinated Time.
Return String.
Example This example displays the value of the Date object in Universal Coordinated
Time:

Wed, 11 Feb 1998 13:30:11 UTC
valueOf method
Syntax Date.valueOf( )
Description Returns the time value in local time. This value represents the number of
milliseconds between the specified time and midnight, January 1, 1970.
Negative numbers indicate dates prior to midnight, January 1, 1970.
Return Integer.
Example This example displays the number of milliseconds that have elapsed since
January 1, 1970 and the value of the Date object:

document object
Object Represents a document in your Web site. Each document can be a file or folder.
Syntax To use a document’s property:
document.propertyName
To use a document’s method:
document.MethodName( parameter )
Description The methods that you use to manipulate documents are shared between the
document object and the site object.
The site object allows you to manipulate your Web site’s documents. For
example, use the following format to create a document:
site.CreateDocument(docName, documentType,
description, content[,connectionName | connectionId])
For information on site.CreateDocument, site.DeleteDocument, or
site.GetDocument, see “site object” on page 291.
Caution
Don’t confuse the Dynamo document object and the JavaScript document
object. The Dynamo document object supports a different set of properties and
methods that are customized for working with databases.
Example This example creates a new document called MyDoc in the Site folder:

See also “description property” on page 93.
“size property” on page 232.
“value property” on page 145.
126
document properties
The document object has these properties:
cachedOutputTimeOut property
Syntax document.cachedOutputTimeOut
Description Duration of time (integer) for which the generated output of a script or template
is cached. The default is zero. This property is not persistent–It is reset to zero
if you restart the Web server.
Example This example sets the cache time of the current document output to be 3
minutes.

connectionId property
Syntax document.connectionId
Description ID of associated connection object (integer). Connection IDs may change it
you restart the Web server. For this reason, Sybase recommends that you use
the connectionName property instead.
Example This example displays the connection Id of a script's associated connection
object:

The output from this example might look like this:
0
See also “connection object” on page 87.
127
document properties
connectionName property
Syntax document.connectionName
Description Name of the associated connection object (string).
Example This example displays the connection name of a script’s associated connection
object.

contentType property
Syntax document.contentType
Description Type of document being displayed (string). The content types are standard
MIME content types. This property is not persistent and will be reset if the Web
server is restarted.
Example This example selects a graphic called bart.gif from a table in the database and
then displays it to a browser. The second part of the example tells the browser
to expect an image rather than HTML.


description property
Syntax document.description
Description Description associated with the document (string).
128
Example This example displays the description that was entered when the document
/Site/descript.ssc was created.

id property
Syntax document.id
Description Internal document object ID (integer). IDs may change if you restart the Web
server. For this reason, Sybase recommends the use of the documentName
property to identify documents instead of the id property.
Example This example displays the document ID.
<HTML>
<TITLE>docid.stm</TITLE>
<BODY>
<H1>Display the document’s Id number.</H1>
<p>The document id for docid.stm is: </p>

</BODY>
</HTML>
The output would be similar to:
Display the document’s Id number.
The document id for docid.stm is:
265
lastModified property
Syntax document.lastModified
129
document properties
Description Returns the time (string) of the last change to the document (for example,
1996-10-24 14:24:29).
Example This example displays the date the document was last altered:

1997-06-06 10:40:30
location property
Syntax document.location
Description Full URL for the document.
Linked Folders
You cannot move a linked folder inside a linked folder.
Example This example displays the location of the document object.


/Site/location.ssc
name property
Syntax document.name
Description Name (including extension, if any).
Example This example displays the name of the document.

130
name.ssc
parent property
Syntax document.parent
Description The containing folder object of this document (document).
Linked Folders
You cannot move a linked folder inside a linked folder.
Example This example moves the document /site/sample/products.stm into

/site/myFolder:

redirect property
Syntax document.redirect
Description The name of the URL to which the current request is to be directed (string).
This property is not persistent and will be reset if you restart the Web server.
Example This example directs a request to http://www.sybase.com:

size property
Syntax document.size
Description Length in bytes (integer) of the document.
Example This example displays the size of the document:
131
document properties

source property
Syntax document.source
Description Uninterpreted document content (source).
Example This example changes the contents of /site/sample.stm to “hello world”:

status property
Syntax document.status
Description A string that indicates a status code and a brief explanation of that code. The
status code values are defined in the HTTP specification.
Example This example prompts the user for a user ID and a password, then displays the
status code.

type property
Syntax document.type
Description The type of Dynamo document (string). One of:
• directory Dynamo folder
• directoryLink Dynamo linked folder
• image binary file
• script DynaScript file
• text Dynamo HTML template
Example This example displays the document type:

value property
Syntax document.value.variable
Description Values of passed-in arguments (URL arguments, typically from an HTML
form), where variable is the argument name (array).
Example This example converts a user provided temperature from Celsius to Fahrenheit
or from Fahrenheit to Celsius.
133
document properties
The first part of the example prompts the user to select the type of conversion
and to enter a value. The values are held in the parameters theType and
temperature:
<HTML>
<H1>Converting Temperatures </H1>
<BODY>
<P>This page allows you to convert a temperature from

<I>Celsius</I> to
<I>Fahrenheit</I> or from <I>Fahrenheit</I> to
<I>Celsius</I>.
<BR>
<HR WIDTH="100%">
<P>Select the appropriate button and enter the

temperature you would like
to convert.
<FORM METHOD=POST ACTION="convert.stm">

<OL>
<LI><INPUT TYPE="radio" NAME="theType" value="CtoF"
CHECKED>Celsius to Fahrenheit<BR>
<INPUT TYPE="radio" NAME="theType"
value="FtoC">Fahrenheit to Celsius<BR>
<LI><INPUT TYPE="text" NAME="temperature" SIZE="4">
Temperature
</OL>
</FORM>
</BODY>
</HTML>
The next part of the example receives the values entered by the user and uses
the values to calculate the requested temperature:
<HTML>
<TITLE>convert.stm</TITLE>
<BODY>
<H1>Temperature</H1>
<P>Your answer is: </P>

</BODY>
</HTML>
The first part of the next example prompts the user to select items from a list in
which all the items have the same name element of "choice". If only one item
is selected, the value is held in document.value.variable. If two or more items
are selected from the list the values are held in document.value[0],
document.value[1], document.value[2], and so on.
The second part of the next example displays the arguments selected from the
first template.
<HTML>
<TITLE>multpar.stm</TITLE>
<BODY>
<HTML>
<H1>What Do I Have To Do Today? </H1>
<BODY>
<P> To do list:
<FORM METHOD=POST ACTION="display.stm" MULTIPLE
SIZE="5">
<OL>
<INPUT TYPE="checkbox" NAME="choice"
value="Laundry">Laundry<BR>
<INPUT TYPE="checkbox" NAME="choice" value="Walk the
dog">Walk the dog<BR>
<INPUT TYPE="checkbox" NAME="choice" value="Wash the
car">Wash the car<BR>
<INPUT TYPE="checkbox" NAME="choice"
value="Groceries">Get groceries<BR>
<INPUT TYPE="checkbox" NAME="choice" value="Dust">Dust
135
document methods
the house<BR>
</OL>
<P><INPUT TYPE="submit" VALUE="Submit List"></p>
</FORM>
</BODY>
</HTML>
<HTML>
<TITLE>display.stm</TITLE>
<BODY>
<H1>My tasks are:</H1>

</BODY>
</HTML>
The last example looks up and displays the ID for a customer whose first and
last name have been sent by a browser (typically in response to an HTML
form).

document methods
The document object has these methods:
136
ExportTo method
Syntax document.ExportTo(pathName [, newName])
Description For files, saves the file as an external (disk) file in the pathName disk directory.
For folders, saves the contained document tree (all nested files and folders) as
an external directory tree (disk files and folders) in the pathName disk
directory. newname allows you to optionally rename the file in its new location.
Return Boolean. This method returns true or false, indicating whether the method
succeeded or not.
Example This example exports /site/products.stm to the c:\ drive:

GetDirectory method
Syntax document.GetDirectory( [fileMask, sortOrder] )
Description For folder documents, returns an array of contained documents (for example, a
directory listing) matched by the string fileMask. fileMask can contain the
wildcard characters “*” and “?”. The sort order may be name or type. Name is
the sortOrder default.
For information on the wildcards, see “Wildcards” on page 73.
Return Array of document objects. Returns a list of contained documents.
Example This example displays all the documents in the /site folder that begin with the
letter a and then sorts them alphabetically:

137
document methods
GetGenerated method
Syntax document.GetGenerated( )
Description Returns the interpreted output from a document as a string. You cannot run this
method from within the same document from which you are calling
GetGenerated.
Return String. Returns the interpreted output.
Example This example runs the script /site/products.ssc and places the output in the
variable “part1”. /site/products.ssc takes two parameters; name and password.
myDoc = site.GetDocument( "/site/products.ssc" );
myDoc.value.name = "open";
myDoc.value.password = "sesame";
part1 = myDoc.GetGenerated();
Inside products.ssc you would use "document.value.name", and
"document.value.password" to access the parameter values.
See also The “Include method” on page 316.
GetServerVariable method
Syntax document.GetServerVariable( )
Description Returns a value from a server. The server variable name is dependent on which
server interface is being used. This method is not supported by CGI servers.
NSAPI
NSAPI (Dynamo
CGI (native cover for Personal
Equivalent ISAPI ) NSAPI) Web Server
AUTH_TYPE AUTH_TYPE auth- AUTH_TYP
type E
CONTENT_L CONTENT_LEN content CONTENT_ CONTENT_L
ENGTH GTH -length LENGTH ENGTH
CONTENT_T CONTENT_TYP content CONTENT_ CONTENT_T
YPE E -type TYPE YPE
GATEWAY_I GATEWAY_INT GATEWAY_I
NTERFACE ERFACE NTERFACE
HTTP_USER HTTP_USER_A user- HTTP_USE HTTP_USER
_AGENT GENT agent R_AGENT _AGENT
PATH_INFO PATH_INFO path PATH_INFO PATH_INFO
138
NSAPI
NSAPI (Dynamo
CGI (native cover for Personal
Equivalent ISAPI ) NSAPI) Web Server
PATH_TRAN PATH_TRANSL
SLATED ATED
QUERY_STR QUERY_STRIN query QUERY_ST QUERY_STR
ING G RING ING
REMOTE_A REMOTE_ADD ip REMOTE_A REMOTE_A
DDR R DDR DDR
REMOTE_H REMOTE_HOS
OST T
REMOTE_U REMOTE_USE auth- REMOTE_U
SER R user SER
REQUEST_ REQUEST_MET method REQUEST_ REQUEST_
METHOD HOD METHOD METHOD
SCRIPT_NA SCRIPT_NAME SCRIPT_NA SCRIPT_NA
ME ME ME
SERVER_NA SERVER_NAM
ME E
SERVER_PO SERVER_PORT SERVER_PO
RT RT
SERVER_PR SERVER_PROT protoco SERVER_PR SERVER_PR
OTOCOL OCOL l OTOCOL OTOCOL
SERVER_SO SERVER_SOFT SERVER_S SERVER_SO
FTWARE WARE OFTWARE FTWARE
HTTP_COOKIE cookie COOKIE COOKIE
URL URL_PREFI
X
UNMAPPED_R
EMOTE_USER
SERVER_PORT
_SECURE
HTTP_ACCEPT
ALL_HTTP
Return String. Returns a value from the server.

Example This example displays the address of the remote host:

The output for this example is:
REMOTE_ADDR = 122.47.156.352
ImportFrom method
Syntax document.ImportFrom(fileName[, replaceOption, newName ])
Description Imports the external file (or folder and its contents) named fileName into the
Web site.
If name conflicts occur, the optional replaceOption determines how to resolve
them:
• newer Replaces existing file if incoming one is newer. This is the
default if you do not specify replaceOption.
• all Replaces existing file regardless of modification dates.
You can rename an imported file or folder with the optional newName
parameter.
succeeded or not.
Example This example imports the file d:\test\products.stm into the Site folder:

IncludeGenerated method
Syntax document.IncludeGenerated( )
Description Includes the generated output of the document that is called in the output of the
currently executing script. A document cannot call
document.IncludeGenerated on itself.
140
succeeded or not.
Example This example gets the include.stm document and then generates and displays
the output of that document within the current document:

Here are the contents of include.stm:
<HTML>
<TITLE>include.stm</TITLE>
<BODY>
<H1></H1>

<TABLE BORDER>
<TR>
<TH>fname</TH>
<TH>lname</TH>
</TR>
<TD></TD>
</TABLE>
</BODY>
</HTML>
<HTML>
<TITLE>include.stm</TITLE>
<BODY>
<H1></H1>
<TABLE BORDER>
<TR>
<TH>fname</TH>
<TH>lname</TH>
</TR>
<TR>
<TD>Michaels</TD>
141
document methods
<TD>Devlin</TD>
</TR><TR>
<TD>Beth</TD>
<TD>Reiser</TD>
</TR><TR>
<TD>Erin</TD>
<TD>Niedringhaus</TD>
</TR><TR>
<TD>Meghan</TD>
<TD>Mason</TD>
</TR><TR>
<TD>Laura</TD>
<TD>McCarthy</TD>
...
Write method
Syntax document.Write(outputString)
Description Appends outputString to the output generated by this document.
Example This example generates output without a line break:

The output of this example is:
This is the write method. You can use a lower case w.
WriteLn method
Syntax document.WriteLn(outputString)
Description Same as Write, but also adds a line break.
Line breaks produced with WriteLn only work when viewing an HTML
document as plain ASCII source (for example, in a text editor).
When this HTML is processed by a Web client, the resulting layout ignores
these line breaks, so WriteLn ultimately produces the same output as Write.
To force line breaks in the final output, you must use the HTML <P> or <BR>
tag. For example:
142
document.WriteLn( "<P>This starts on a new line" );

In general, WriteLn makes your HTML source easier to read, but does not
reflect how it is formatted by a Web client.
To remain compatible with JavaScript, Dynamo allows you to use write for
Write, and writeln for WriteLn.
Example This example:

outputs:
This is the writeln method.
You can use lower case (writeln) or upper case
(WriteLn),
but not Writeln.
See also The “Write method” on page 196.
DOMAttribute object
Object Represents an attribute in an XML element. The XML element itself is
represented by a DOMElement object.
Syntax To use a DOMAttribute's property:
DOMAttribute.propertyName
To use a DOMAttribute's method:
DOMAttribute.MethodName( parameter )
Description DOMAttribute objects inherit the properties and methods of the DOMNode
object. The attributes for a particular DOMElement are accessible via the
attributes property of the DOMElement object.
The parentNode, previousSibling, and nextSibling properties of a
DOMAttribute object are null.
The children of the DOMAttribute object represent the attribute's value.
Attributes whose values are inferred from the DTD are not yet supported and
do appear within the document tree.
143
DOMAttribute properties
DOMAttribute objects have all of the properties and methods of the DOMNode
object as well as the properties defined here.
To obtain a DOMAttribute object in an existing document, you can use the
getAttributeNode method of a DOMElement object, or the attributes
property of a DOMNode object.
To add a DOMAttribute object to a DOM document, you can use the
setAttributeNode method of a DOMElement object.
See also “getAttributeNode method” on page 162.
“attributes property” on page 174.
“setAttribute method” on page 165.
DOMAttribute properties
The DOMAttribute object has these properties as well as all the properties of
the DOMNode object, which are inherited:
name property
Syntax DOMAttribute.name
Description Returns the name of the attribute.
For the following start tag of an element:
<Region Type="State">
there is one attribute, which has the name Type.
Example The following DynaScript fragment writes out the name of each attribute of a
DOMElement object named elem:
attlist = elem.attributes
for( iAtt=0; iAtt < attlist.length; iAtt++ ) {
document.writeln( attlist.item(iAtt).name );
}
See also “getAttributeNode method” on page 162.
144
specified property
Syntax DOMAttribute.specified
Description If the attribute was explicitly given a value in the original document, the
specified property will be set to true. If no value was given the specified
property is set to false.
This property is set to true if the value of the attribute is changed.
Attributes whose values are not explicitly specified, but are instead inferred
from the DTD are not yet supported and do not appear within the document
tree. Therefore, for attributes within the document tree, this property is always
true.
Example This example writes out the name of each specified attribute of a DOMElement
object named elem:
if( attlist.item(iAtt).specified == true ){
document.writeln( attlist.item(iAtt).name );
}
}
value property
Syntax DOMAttribute.value
Attributes This property is read/write.
Description When retrieved, this property returns the attribute value as a string. Entity
references will be replaced by their values.
When set, a DOMText object representing the string is created, and will become
the only child of the DOMAttribute object.
For the following start tag of an element:
<Region Type="State">
there is one attribute, which has the value State.
Example This DynaScript fragment writes out the value of each specified attribute of a
DOMElement object named elem:
145
DOMAttribute methods
document.writeln( attlist.item(iAtt).value );
}
}
DOMAttribute methods
The DOMAttribute object has no methods of its own but inherits all the
methods of the DOMNode object.
DOMCDATASection object
Object Holds text data that includes characters that would otherwise need escaping or
replacing by entity references in an XML document.
Syntax To use a DOMCDATASection’s property:
DOMCDATASection.propertyName
To use a DOMCDATASection’s method:
DOMCDATASection.MethodName( parameter )
Description The DOMCDATASection object has no properties or methods of its own, but
inherits all the methods and properties of the DOMText object.
DOMCharacterData object
Object Represents character data in an XML document.
Syntax To use a DOMCharacterData’s property:
DOMCharacterData.propertyName
To use a DOMCharacterData’s method:
DOMCharacterData.MethodName( parameter )
Description The DOMCharacterDATA object inherits all the methods and properties of the
DOMNode object as well as providing its own set of methods and properties to
access and manipulate character data in the DOM.
146
DOMCharacterData properties
The DOMCharacterData object has the properties listed in this section, in
addition to all of the properties of the DOMNode object, which are inherited:
data property
Syntax DOMCharacterData.data
Description The text represented by this object.
Example This DynaScript fragment writes out the character data associated with all text
node children of an element.
child = elem.firstChild;
do {
if( child.nodeType == 3 ){// text node
document.writeln( child.data );
child = child.nextSibling;
}
} while ( child != null )
length property
Syntax DOMCharacterData.length
Description The number of characters in the text representing by this object. The length is
an integer value greater than or equal to zero.
Example This DynaScript fragment writes out the length of each text node child of a
DOMElement object named elem.
child = elem.firstChild;
do {
if( child.nodeType == 3 ){// text node
}
147
DOMCharacterData methods
DOMCharacterData methods
The DOMCharacterData object inherits the methods from the DOMNode
object, but it also has its own methods, which are discussed in this section.
appendData method
Syntax DOMCharacterData.appendData( DOMString )
Description Appends the string to the end of the character data represented by this object.
DOMString is the string that is to be appended.
Example Here is a very simple document:
<?xml version=’1.0’ encoding=’ISO-8859-1’ ?>
<Customer>
<FName>Jessie</FName>
<LName>Gagliardo</LName>
<Address><Street>2800 Park Avenue</Street>
<City>Hull</City>
<Region Type="Province">PQ</Region>
</Address></Customer>
This DynaScript fragment, which includes a Region element, checks whether
the region is a province or a state, and appends a string indicating the country
to the text element.
child = elemRegion.firstChild;
if( elemRegion.getAttribute( "Type" ) == "Province" ){
child.appendData( ", Canada" );
} else {
child.appendData( ", USA" );
}
deleteData method
Syntax DOMCharacterData.deleteData( offset, count )
Description Removes a range of characters from the text represented by this object. The
parameters are:
• offset The offset from which to begin removing characters. Offset
values begin at zero.
148
• count The number of characters to delete. If the sum of offset and

count exceeds the length of the text, all characters from the offset to the
end of the data are deleted.
Example This DynaScript statement deletes the first two characters from a text node.
if( elem.nodeType == 3 ) { // text node
elem.deleteData( 0, 2 )
}
insertData method
Syntax DOMCharacterData.insertData( offset, DOMString )
Description Inserts a string at the specified character offset. The parameters are:
• offset The character offset at which to insert. Offset values begin at
zero.
• DOMString The string to insert.
Example This DynaScript fragment inserts a string at the beginning of a text node.
elem.insertData( 0, "Region: " )
}
replaceData method
Syntax DOMCharacterData.replaceData( offset, count, DOMString )
Description Replaces the character starting at the specified character offset with the
specified string. The parameters are:
• offset The offset from which to start replacing. Offset values begin at
zero.
• count The number of characters to replace. If the sum of offset and
count exceeds length, all characters to the end of the data are replaced.
• DOMString The string with which the range is to be replaced.
Example This DynaScript fragment replaces the third and fourth characters in a text
node with the string “XXX”.
elem.replaceData( 3, 2, "XXX" )
}
149
DOMComment object
substringData method
Syntax DOMCharacterData.substringData( offset, count )
Description Extracts a portion of the text represented by this object. The parameters are:
• offset The offset from which to start extracting. Offset values begin at
zero.
• count The number of characters to extract.
Return A string containing the extracted portion of the text.
Example This DynaScript fragment writes out the characters from the fourth to the
hundredth of all text nodes that are children of a Street element.
function SubstringDataCharacterData( domDoc ) {
var elemlist = domDoc.getElementsByTagName( "Street" )
for( iElem=0; iElem < elemlist.length; iElem++ ) {
var elem = elemlist.item( iElem );
var child = elem.firstChild;
do {
if( child.nodeType == 3 ){ // text node
var svar = child.substringData( 3, 99 );
document.writeln( "svar = " + svar );
}
}
}
DOMComment object
Object The DOMComment object represents the text within a comment in an XML
document.
Syntax To use a DOMComment’s property:
DOMComment.propertyName
To use a DOMComment’s method:
DOMComment.MethodName( parameter )
Description The DOMComment object has no properties or methods of its own, but it does
inherit the properties and methods of the DOMCharacterData object.
See also “DOMCharacterData object” on page 146.
150
DOMDocument object
Object Represents an XML document.
Syntax To use a DOMDocument’s property:
DOMDocument.propertyName
To use a DOMDocument’s method:
DOMDocument.MethodName( parameter )
Description The DOMDocument object represents the root of the DOM document node tree,
and provides the primary access to the document’s data.
You can create a DOMDocument object either by calling the toDOMDocument
method, or by invoking the DOMDocument constructor.
• Calling toDOMDocument parses an existing XML document and returns a
DOMDocument object representing the document contents.
• Invoking the DOMDocument constructor creates an empty DOMDocument
object. The node object creation methods on the DOMDocument can then
be called to create new node objects. The created DOMNode objects have
an ownerDocument property which associates them with the
DOMDocument within whose context they were created.
DOMDocument objects inherit all of the properties and methods of the DOMNode
object as well as the properties and methods defined here.
Dynamo's current implementation of DOM follows the DOM Level 1
specification.
Example This statement creates a new, empty DOMDocument object.
doc = new DOMDocument()
DOMDocument properties
The DOMDocument object inherits all the properties of the DOMNode object, as
well as the properties discussed in this section.
doctype property
Syntax DOMDocument.doctype
151
DOMDocument properties
Description The DOMDocumentType object representing the document type declaration

(DTD) associated with this document. XML documents without a DTD return
null. DOM Level 1 does not support editing the DTD.
Example To return the DTD associated with the parsed XML document domDoc.
dtd = domDoc.doctype
See also “DOMDocumentType object” on page 158.
documentElement property
Syntax DOMDocument.documentElement
Description Each XML document has a single element that contains all other elements in
the document. This is called the root element or the document element. The
documentElement method returns the DOMElement object representing the
root element of the XML document.
Example To parse a document held in xmlString, create a variable holding the root
element of the document, and write out the name of that element, enter:
domDoc = toDOMDocument( xmlString );
docElement = domDoc.documentElement;
document.writeln( docElement.tagName );
implementation property
Syntax DOMDocument.implementation
Description The DOMImplementation object that handles this document. The
implementation features can then be retrieved using the hasFeature method
of the DOMImplementation object.
Example This example writes out details of the current implementation.
imp = domDoc.implementation;
document.writeln( "HTML? " + imp.hasFeature( "HTML",
"1.0" ) ) ;
document.writeln( "XML? " + imp.hasFeature( "XML",
"1.0" ) ) ;
HTML? false
XML? true
152
See also “DOMImplementation object” on page 169.
DOMDocument methods
The DOMDocument object inherits the methods from the DOMNode object, as
well as the methods discussed in this section.
createAttribute method
Syntax DOMDocument.createAttribute( name )
Description Creates a DOMAttribute object representing an attribute of the given name.
The created attribute does not have any place in the document. It can be set on
an element by using the setAttributeNode method of a DOMElement
object, and the value of the attribute can be set using the setAttribute
method of a DOMElement object.
name is the name of the attribute for which a DOMAttribute object is being
created.
Return A DOMAttribute object.
Example This example creates an attribute named Region.
domDoc.createAttribute( "Region" );
See also “DOMAttribute object” on page 143.
“setAttribute method” on page 165.
createCDATASection method
Syntax DOMDocument.createCDATASection( data )
Description Creates a CDATA node whose value is the specified string. data is the content
of the CDATA section.
The created CDATA section does not have any place in the document. It can be
added as the child of a node by using the appendChild method of a DOMNode
object.
Return A DOMCDATASection object.
153
DOMDocument methods
Example This example creates a CDATA section with text “Jane & John Doe”, and adds
it to the document as the last element before the end of the document element.
xmlString = "Jane & John Doe"
domCDATA = domDoc.createCDATASection( xmlString );
element.appendChild( domCDATA );
See also “DOMCDATASection object” on page 146.
“appendChild method” on page 181.
createComment method
Syntax DOMDocument.createComment( comment )
Description Creates a DOMComment object representing a comment containing the specified
string. comment should contain the text of the comment only, and should
exclude the comment start () characters.
The DOMComment object can be added as the child of a node in the document
using the DOMNode.appendChild method, or one of the other DOMNode
methods.
Return A DOMComment object.
Example This example creates a comment on the document domDoc and adds it to the
document as the final element before the end of the document element
(docElem).
domComment = domDoc.createComment(
"Browsers ignore this string" );
docElem.appendChild( domComment );
See also “DOMComment object” on page 150.
“DOMNode methods” on page 181.
createDocumentFragment method
Syntax DOMDocument.createDocumentFragment( )
Description Creates an empty DOMDocumentFragment object. These fragments can be
used in copy and paste operations.
Return A document fragment
Example To create a document fragment, enter:
154
domDoc.createDocumentFragment;
See also “DOMDocumentFragment object” on page 157.
createElement method
Syntax DOMDocument.createElement( tagName )
Description Creates a DOMElement object representing the specified element. tagName is
the name of the element type that is to be instantiated. Tag names in XML are
case-sensitive.
The element can be added as the child of a node using
DOMNode.appendChild method, or one of the other DOMNode methods.
Return A DOMElement object
Example This example creates an element named Customer.
domDoc.createElement( "Customer" );
See also “DOMElement object” on page 160.
createEntityReference method
Syntax DOMDocument.createEntityReference( name )
Description Creates a DOMEntityReference object with the specified name.
Return A DOMEntityReference object.
Example This example creates a reference to the entity for the less than sign (left angle
bracket).
domDoc.createEntityReference( "lt" );
See also “DOMEntityReference object” on page 168.
createProcessingInstruction method
Syntax DOMDocument.createProcessingInstruction( target, data )
155
DOMDocument methods
Description Creates a DOMProcessingInstruction object given the specified target and

data strings. The parameters are:
• target The target part of the processing instruction.
• data The data for the object.
Return A DOMProcessingInstruction object.
Example This example creates a processing instruction that is a simple form of the
required heading for an XML document. It then appends this processing
instruction to an empty DOMDocument object.
domDoc = new DOMDocument();
docPI = domDoc.createProcessingInstruction( "xml",
"version=’1.0’" );
domDoc.appendChild( docPI );
See also “DOMProcessingInstruction object” on page 185.
createTextNode method
Syntax DOMDocument.createTextNode( data )
Description Creates a DOMText object representing the specified data string.
Return A DOMText object.
Example This example creates a text node with content “Bartlebooth”.
domDoc.createTextNode( "Bartlebooth" )
See also “DOMNode methods” on page 181
getElementsByTagName method
Syntax DOMDocument.getElementsByTagName( tagname )
Description Returns a DOMNodeList object of all the DOMElement objects with a given tag
name in the order in which they would be encountered in the document. Tag
names in XML are case-sensitive. The special tag name “*” can be used to
retrieve a list of all DOMElement objects regardless of the tag name.
To search for DOMElement objects that are children of a particular element, use
the getElementsByTagName method on the DOMElement object.
156
Return A DOMNodeList object containing all the matched objects.

Example This example gets all elements named Region from the document domDoc,
and loops over those elements.
elemList = domDoc.getElementsByTagName( "Region" );
for( iElem=0; iElem < elemList.length; iElem++ ){
elem = elemList.item( iElem );
-- operations here
}
prettyPrint method
Syntax DOMDocument.prettyPrint()
Description This method is not part of the DOM specification, and is provided for
debugging purposes.
Return A string containing a representation of the document structure.
Example To print out the entire structure of a document named domDoc, enter:
DOMDocumentFragment object
Object Represents a collection of node objects, and is typically used to represent a
portion of an XML document.
Syntax To use a DOMDocumentFragment’s property:
DOMDocumentFragment.propertyName
To use a DOMDocumentFragment’s method:
DOMDocumentFragment.MethodName( parameter )
Description The DOMDocumentFragment holds fragments of a DOMDocument object and
can be useful when you are rearranging documents.
When a DOMDocumentFragment object is inserted into the DOM document
tree, the children of the DOMDocumentFragment and not the
DOMDocumentFragment itself are inserted.
The DOMDocumentFragment object has no methods or properties of its own
but it does inherit all of the properties and methods of the DOMNode object.
157
DOMDocumentType object
See also “DOMNode object” on page 173
DOMDocumentType object
Object Represents the document type definition (DTD) portion of an XML document.
Syntax To use a DOMDocumentType's property:
DOMDocumentType.propertyName
To use a DOMDocumentType's method:
DOMDocumentType.MethodName( parameter )
Description The DOMDocumentType object is accessible through the docType property of
a DOMDocument object. The DOMDocumentType object provides access to the
list of entities and notations declared in the DTD. DOM Level 1 does not
support access to any other portion of the DTD.
The DOMDocumentType object has no methods of its own, but it does inherit
all of the properties and methods from the DOMNode object as well as the
properties defined here.
Example This example assigns a DOMDocumentType object to the variable dtd.
var xmlDoc = document.value.xml ;
var domDoc = toDOMDocument( xmlDoc );
var dtd = domDoc.doctype;
DOMDocumentType properties
The DOMDocumentType object inherits all properties from the DOMNode
object, but it also has its own properties, which are discussed in this section.
entities property
Syntax DOMDocumentType.entities
Description A DOMNamedNodeMap object containing the general entities both external and
internal. Each node in the node map is a DOMEntity object.
Example This XML document has a very simple DTD, consisting only of entity
declarations (only the first part of the document is shown).
158
<?xml version=’1.0’ encoding=’ISO-8859-1’?>

<!DOCTYPE Customers [
<!ENTITY PQ "Province of Quebec">
<!ENTITY Logo SYSTEM "nautilus.gif" NDATA GIF>
]>
<Customers><Customer><FName>Jessie...
If this XML document is held in a string named xmlDoc, this script writes out
the entity names.
var domDoc = toDOMDocument( xmlDoc );
var entlist = dtd.entities
for( iEnt = 0; iEnt < entlist.length; iEnt++ ){
ent = entlist.item(iEnt);
document.writeln( "Name = " + ent.nodeName );
}
Name = PQ
Name = Logo
See also “DOMEntity object” on page 166.
“DOMNamedNodeMap object” on page 170.
name property
Syntax DOMDocumentType.name
Description A string containing the name of the DTD that immediately follows the
DOCTYPE keyword.
In XML, the name of the DTD must match that of the document element.
]>
the DTD name.
159
DOMElement object
var domDoc = toDOMDocument( xmlDoc.source);

document.writeln( "Doctype name = " + dtd.name );
See also “documentElement property” on page 152.
notations property
Syntax DOMDocumentType.notations
Description A DOMNamedNodeMap containing the notations declared in the DTD. Each
node in the node map is a DOMNotation object.
]>
the notation name of the Logo entity.
See also “DOMNotation object” on page 184.
“DOMNamedNodeMap object” on page 170.
DOMElement object
Object Represents an element in an XML document.
Syntax To use a DOMElement's property:
DOMElement.propertyName
To use a DOMElement's method:
DOMElement.MethodName( parameter )
Description The getAttributes method of the DOMNode object can be used to get the set
of all attributes for an element. The getAttribute and getAttributeNode
methods on the DOMElement object can be used to retrieve individual
attributes.
160
DOMElement objects have all of the properties and methods of the DOMNode
object as well as the properties and methods defined here.
Example This example contains three elements – invoice, customer, and total:
<invoice >
<customer>Jina Janson</customer>
<total>$23.95</total>
</invoice>
DOMElement property
The DOMElement object inherits all of the properties of the DOMNode object,
as well as the tagName property, discussed here.
tagName property
Syntax DOMElement.tagName
Description A string containing the name of the element. Element names are case-sensitive
in XML.
Example This example writes out the name of the document element of an XML DOM
document stored in domDoc.
docElem = domDoc.documentElement;
document.writeln( docElem.tagName );
DOMElement methods
The DOMElement object inherits all of the methods of the DOMNode object, but
it also has its own methods, which are discussed in this section.
getAttribute method
Syntax DOMElement.getAttribute( name )
Description Retrieves an attribute value by name.
161
DOMElement methods
Return The attribute value as a string or an empty string if the attribute does not have
value.
Example This example writes out the value of the Type attribute for each Region
element in a DOM document stored in the variable domDoc.
elemlist = domDoc.getElementsByTagName( "Region" );
for ( iEl = 0 ; iEl < elemlist.length ; iEl++ ){
elem = elemlist.item(iEl);
document.writeln( elem.getAttribute( "Type" ) );
}
getAttributeNode method
Syntax DOMElement.getAttributeNode( name )
Description Retrieves an attribute node by name.
Return A DOMAttribute object or null if there is no such attribute.
Example This example assigns a DOMAttribute object to a variable named attnode.
This object represents the Type attribute for a Region element in the DOM
document domDoc.
for ( iEl = 0 ; iEl < elemlist.length ; iEl++ ){
elem = elemlist.item(iEl);
attnode = elem.getAttributeNode( "Type" );
document.writeln( attnode.nodeValue );
}
getElementsByTagName method
Syntax DOMElement.getElementsByTagName( name )
Description Returns a DOMNodeList object of all descendant elements with a given tag
name, in the order in which they would be encountered in the document. Tag
names in XML are case-sensitive. The special tag name “*” can be used to
retrieve a list of DOMElement objects regardless of the tag name.
To search for DOMElement objects in the entire document, use the
getElementsByTagName method on the DOMDocument object.
Return A list of matching Element nodes.
162
Example Here is a simple XML document with a nested structure:

<?xml version="1.0"?>
<List>
<ListItem>Item 1
<List><ListItem>Item 1.1</ListItem>
</List>
</ListItem>
<ListItem>Item 2</ListItem>
</List>
This script fragment writes out the text content of each ListItem element, in the
order in which they are encountered.
var docElem = domDoc.documentElement;
elemlist = docElem.getElementsByTagName( "ListItem" );
document.writeln( elemlist.length) ;
for( iEl=0; iEl < elemlist.length ; iEl++ ){
document.writeln(
elemlist.item(iEl).firstChild.nodeValue );
}
Item 1
Item 1.1
Item 2
See also “DOMNodeList object” on page 183.
normalize method
Syntax DOMElement.normalize( )
Description Normalizing an element places it and all its descendants into a standard format.
For all DOMText node objects that are descendants of this element, adjacent
(sibling) DOMText objects are combined into a single DOMText object.
Adjacent DOMCDATASection nodes are not combined even though they inherit
from DOMText.
Example This statement normalizes the element named elem.
elem.normalize();
163
DOMElement methods
removeAttribute method
Syntax DOMElement.removeAttribute( att_name )
Description Removes the specified attribute. att_name is the name of the attribute to be
removed.
The method returns nothing, as required by the DOM specification. This means
there is no natural way to check for the success of the method. You can,
however while debugging and testing, execute a prettyPrint() on the
element after the call.
Return This method returns nothing.
Example This function removes all Type attributes from Region elements in a
DOMDocument object stored in domDoc.
function RemoveTypeAttribute( domDoc ) {
elem = elemlist.item( iElem );
elem.removeAttribute( "Type" );
}
}
removeAttributeNode method
Syntax DOMElement.removeAttributeNode( att_node )
Description Removes the specified attribute node.
Return The DOMAttribute object that was removed.
Example This example removes all Type attributes from Region elements in a
DOMDocument object stored in domDoc. It confirms the removal by writing
out the name of the removed attribute.
function RemoveTypeAttribute( domDoc ) {
attnode = elem.getAttributeNode( "Type" )
old_att = elem.removeAttributeNode( attnode );
document.writeln( "Attribute " + old_att.name +
"removed" );
}
164
}
setAttribute method
Syntax DOMElement.setAttribute( name, value )
Description Adds a new attribute to the element. If an attribute with that name is already
present in the element, its value is changed to be that of the value parameter.
The parameters are:
• name The name of the attribute to create or alter.
• value Value to set in string form. The string is not parsed, so any
markup is treated as literal text and may need to be escaped.
To assign an attribute value that contains entity references, first create a
DOMAttribute object, plus any DOMText and DOMEntityReference
objects. Then insert the text and entity reference objects as children of the
DOMAttribute, and use setAttributeNode to assign the attribute to the
element.
Example This function changes the value of the Type attribute for all Region elements
from its current setting to County.
function SetAttribute( domDoc ){
elem.setAttribute( "Type", "County" )
document.writeln( elem.prettyPrint() );
}
}
See also “DOMAttribute object” on page 143
setAttributeNode method
Syntax DOMElement.setAttributeNode( newAttr )
Description Adds a new attribute. If an attribute with that name is already present in the
element, it is replaced by the new one. newAttr is the DOMAttribute object
representing the attribute to be set.
165
DOMEntity object
Return If the newAttr attribute replaces an existing attribute with the same name, the
previously existing DOMAttribute object is returned, otherwise null is
returned.
Example This function resets the value of the Type attribute for reach Region element to
County. It then uses prettyPrint to display the structure of the document for
debugging purposes.
function SetAttributeNode( domDoc ){
attnode = elem.getAttributeNode( "Type" );
attnode.value = "County";
old_att = elem.setAttributeNode( attnode );
}
}
DOMEntity object
Object Represents an entity declared in the document type declaration (DTD).
Syntax To use a DOMEntity's property:
DOMEntity.propertyName
To use a DOMEntity's method:
DOMEntity.MethodName( parameter )
Description The DOMEntity object has no methods of its own, but it does inherit all the
properties and methods of the DOMNode object, and has its own properties,
which are discussed in this section.
DOMEntity properties
The DOMEntity object inherits all the properties of the DOMNode object, as
well as the properties discussed in this section.
166
notationName property
Syntax DOMEntity.notationName
Description For unparsed entities, the name of the notation for the entity. For parsed entities
this is null.
]>
If the parsed XML document is held in a variable named domDoc, this script
writes out the notation names of each entity declared in the DTD.
document.writeln( "notationName = " +
ent.notationName );
}
The output of this example is:
notationName = null
notationName = GIF
publicId property
Syntax DOMEntity.publicId
Description The public identifier associated with the entity, if specified. If the public
identifier is not specified, it is null.
Example This declaration has a public identifier.
<!ENTITY PubLogo PUBLIC "-//MyOrg//GIF Logo//EN"
"logo.gif" NDATA GIF>
If this entity declaration is stored in a variable named ent, then the following
instructions write out the public identifier of the entity.
document.writeln( "publicId " + ent.publicId );
167
DOMEntityReference object

publicId -//MyOrg//GIF Logo//EN
systemId property
Syntax DOMEntity.systemId
Description The system identifier associated with the entity, if specified. Or null, if not
specified.
declarations. Only the first part of the document is shown.
]>
If the parsed XML document is held in a variable named domDoc, this script
writes out the notation names of each entity declared in the DTD.
document.writeln( "systemId = " +
ent.systemId );
}
This example is:
systemId = null
systemId = nautilus.gif
DOMEntityReference object
Object Represents an entity reference in an XML document.
Syntax To use a DOMEntityReference’s property:
DOMEntityReference.propertyName
To use a DOMEntityReference’s method:
168
DOMEntityReference.MethodName( parameter )
Description The DOMEntityReference object has no properties or methods of its own,
but it does inherit all of the properties and methods of the DOMNode object. The
children of the DOMEntityReference object represent the replacement value
of the entity reference.
See also “DOMNode object” on page 173.
“DOMEntity object” on page 166.
DOMImplementation object
Object Provides a means of querying the capabilities of this application's
implementation of DOM.
Syntax To use a DOMImplementation's method:
DOMImplementation.MethodName( parameter )
Description The DOMImplementation object has one method used to query the features
supported by this specific implementation of DOM. This method is
independent of any particular instance of a DOMDocument.
Dynamo's current implementation of DOM supports parsing of XML 1.0
documents according to DOM Level 1.
DOMImplementation methods
The DOMImplementation object has these methods:
hasFeature method
Syntax DOMImplementation.hasFeature( feature, version )
Description Tests if the DOM implementation includes a specific feature. The parameters
are:
• feature The package name of the feature to test. This can be “HTML”
or “XML”.
169
DOMNamedNodeMap object
• version The version number of the package to test. Currently the only
valid value for this parameter is “1.0”, because Dynamo supports XML
1.0.
Return Boolean. True if the feature is implemented in the specified version, false
otherwise.
Example To write out the features supported by the Dynamo XML parser, enter:
domDoc = new DOMDocument();
implementation = domDoc.implementation;
document.writeln( "HTML? " + implementation.hasFeature(
"HTML", "1.0" ) ) ;
document.writeln( "XML? " + implementation.hasFeature(
"XML", "1.0" ) );
The output is:
HTML? false
XML? true
DOMNamedNodeMap object
Object Represents a collection of DOMNode objects that can be accessed by name.
Syntax To use a DOMNamedNodeMap's property:
DOMNamedNodeMap.propertyName
To use a DOMNamedNodeMap's method:
DOMNamedNodeMap.MethodName( parameter )
Description DOMNamedNodeMap objects represent an unordered collection of DOMNode
objects. Objects within the node map can be accessed by an ordinal index, but
this is simply provided as a means of enumerating the objects within the node
map. It does not imply that the objects within the node map are ordered.
DOMNamedNodeMap property
The DOMNamedNodeMap object has these properties:
170
length property
Syntax DOMNamedNodeMap.length
Description The number of objects in the map.
Example This example loops over the items of a DOMNamedNodeMap object.
for ( i = 0; i < nodemap.length; i++ ){
// operations here
}
See also “DOMNamedNodeMap object” on page 170
DOMNamedNodeMap methods
The DOMNamedNodeMap object has these methods:
getNamedItem method
Syntax DOMNamedNodeMap.getNamedItem( name )
Description Retrieves a DOMNode specified by name.
Return A DOMNode object or null if the specified name did not identify any node in the
map.
Example This example creates a DOMNamedNodeMap named attlist from the
attributes property of an element, and then writes out the value of the
attribute with name attName.
att = attlist.getNamedItem( attName );
document.writeln( att.value );
See also “DOMNode object” on page 173.
item method
Syntax DOMNamedNodeMap.item( index )
Description Returns the index item in the map. If index is greater than or equal to the
number of nodes in the map, null is returned. Valid values for index are 0
through length – 1.
171
DOMNamedNodeMap methods
Return A DOMNode object or null if the index is invalid.

Example This script fragment loops over the items of a DOMNamedNodeMap object and
assigns each node to a variable named thisNode.
for ( i = 0; i < nodemap.length; i++ ){
thisNode = nodemap.item( i );
}
removeNamedItem method
Syntax DOMNamedNodeMap.removeNamedItem( name )
Description Removes a DOMNode object specified by name.
Return The DOMNode object that was removed or null if the specified name did not
identify any node in the map.
Example This example removes the attribute named attType from each Region element,
and prints out messages for debugging purposes.
function RemoveNamedItem( domDoc, attType ){
elemlist = domDoc.getElementsByTagName( "Region" )
node = attlist.removeNamedItem( attType );
if( node == null ) {
document.writeln( "No attribute removed" );
} else {
document.writeln( "Removed attribute with value"
+ node.nodeValue );
}
}
}
See also “DOMNode object” on page 173
setNamedItem method
Syntax DOMNamedNodeMap.setNamedItem( node-name )
172
Description Adds a node using its nodeName property. The node-name parameter is a
DOMNode object to be stored in the named node map. The node will later be
accessible using the value of the node’s nodeName property passed to the
getNamedItem method.
Return If the new node replaces an existing node with the same name, the previously
existing node is returned as a DOMNode object, otherwise null is returned.
Example This example replaces an attribute node with one of the same name, but a
changed value.
function SetNamedItem( domDoc, attType ){
elemlist = domDoc.getElementsByTagName( "Region" )
att = attlist.getNamedItem( attType );
att.value = "County";
oldNode = attlist.setNamedItem( att.name );
if( oldNode == null ) {
document.writeln( "New attribute added" );
} else {
document.writeln( "Replaced attribute" );
}
}
}
DOMNode object
Object Represents a single node in the DOM document tree.
Syntax To use a DOMNode’s property:
DOMNode.propertyName
To use a DOMNode’s method:
DOMNode.MethodName( parameter )
Description The DOMNode object is the primary object type for the entire Document Object
Model (DOM) suite of objects. It is the object from which most of the other
DOM objects inherit.
Each object that inherits from the DOMNode exposes a nodeType property to
identify the object. See the nodeType property below for valid values for the
nodeType.
173
DOMNode properties
All objects inheriting from the DOMNode object expose methods for dealing
with children, but not all node types necessarily have children. For example,
text nodes cannot have children. See the childNodes property below for a list
of which types of nodes can have children.
While each object that inherits from DOMNode exposes an attributes property,
only DOMElement objects can have attributes.
DOMNode properties
The DOMNode object has these properties:
attributes property
Syntax DOMNode.attributes
Description A DOMNamedNodeMap containing the attributes of this node. This property is
applicable only to nodes that are elements.
Example This fragment tests to see if a node is an element, and assigns the attributes of
the element to a DOMNamedNodeMap named attlist.
if( node.nodeType == 1 ){ // Element
attlist = node.attributes
} else {
document.writeln( "Not an element" );
}
See also “DOMNamedNodeMap object” on page 170.
childNodes property
Syntax DOMNode.childNodes
Description A DOMNodeList object that contains all the children of this node. If there are
no children, then this is a node list containing zero nodes.
174
Performance tip
To loop over a childNodes list, it is more efficient to use the nextSibling
property than to explicitly use the childNodes list of the parent object.
Not all nodes can have children. This table lists the types of children that are
valid for each type of node.
Node Type Node Types Valid for Children
document element (maximum of one), processing instruction,
comment, document type
document fragment element, processing instruction, comment, text,
CDATA section, entity reference
document type no children
entity reference element, processing instruction, comment, text,
element element, text, comment, processing instruction,
attribute text, entity reference
processing instruction no children
comment no children
text no children
CDATA section no children
entity element, processing instruction, comment, text,
notation no children
Example This example loops through the childNodes of a node.

function ChildNodes( domDoc ){
docElem = domDoc.documentElement;
var node = docElem.firstChild;
do {
document.writeln( node.nodeName );
node = node.nextSibling;
} while ( node != null )
}
firstChild property
Syntax DOMNode.firstChild
175
DOMNode properties
Description The DOMNode object representing the first child of this node, or null if there are
no children.
Example This fragment sets the variable node to the first child of the document element.
var node = docElem.firstChild;
lastChild property
Syntax DOMNode.lastChild
Description The DOMNode object representing the last child of this node, or null if there are
no children.
Example This fragment sets the variable node to the last child of the document element.
var node = docElem.lastChild;
nextSibling property
Syntax DOMNode.nextSibling
Description The DOMNode object representing the node immediately following this node,
or null if this is the last node.
Example This fragment loops over the siblings of an element named node.
do {
nodeName property
Syntax DOMNode.nodeName
Description The name of this node. The name of the node depends on the node type. This
table lists the contents of the nodeName property for each node type.
Node Type Contents of nodeName property
document “document”
document fragment “document-fragment”
176
Node Type Contents of nodeName property

document type document type name
entity reference name of entity referenced
element tag name
attribute name of attribute
processing instruction target
comment “comment”
text “text”
CDATA section “cdata-section”
entity entity name
notation notation name
XML is case sensitive. If you check the name of a node in a comparison, you
must ensure the check is case sensitive.
Example This fragment writes out the name of each of a set of nodes, held in a variable
named node.
do {
See also “getElementsByTagName method” on page 162.
nodeType property
Syntax DOMNode.nodeType
Description An integer representing the type of node object. This table lists the nodeType
number for each type of node.
Node Type Contents of nodeType property
element 1
attribute 2
text 3
CDATA section 4
entity reference 5
entity 6
processing instruction 7
comment 8
177
DOMNode properties
Node Type Contents of nodeType property

document 9
document type 10
document fragment 11
notation 12
Example This fragment performs different operations based on the type of node. The
node is held in a variable named domNode.
switch domNode.nodeType {
case 1:
//element operations
break;
case 2:
//attribute operations
break;
case 3:
//text operations
break;
case 4:
//CDATA section operations
break;
case 5:
//entity reference operations
break;
case 6:
//entity operations
break;
case 7:
// processing instruction operations
break;
case 8:
//comment operations
break;
case 9:
//document operations
break;
case 10:
// document type operations
break;
case 11:
// document fragment operations
break;
case 12:
//notation operations
178
break;
default:
document.writeln( "Invalid node type: " +
domChild.nodeType );
}
nodeValue property
Syntax DOMNode.nodeValue
Description The value of this node. The value depends on the type of node. This table lists
the contents of the nodeValue property for each node type.
Node Type Contents of nodeValue property
document null
document fragment null
document type null
entity reference null
element null
attribute value of attribute
processing instruction entire content excluding the target
comment content of the comment
text content of the text node
CDATA section content of the CDATA section
entity null
notation null
Example This fragment writes out the nodeValue for an attribute named Type:
if( domAtt.nodeName == "Type" ){
document.writeln( domAtt.nodeValue );
}
ownerDocument property
Syntax DOMNode.ownerDocument
Description The DOMDocument object associated with this node. For DOMDocument
objects, this property is null.
179
DOMNode properties
Example This fragment writes out the name of the document element for the
DOMDocument object that owns domNode.
var domDoc = domNode.ownerDocument;
document.writeln( domDoc.documentElement.nodeName );
See also “DOMDocument object” on page 151.
parentNode property
Syntax DOMNode.parentNode
Description The DOMNode object representing the parent of this node, or null if there is no
parent. This node objects do not have a parent: DOMDocument,
DOMDocumentFragment, DOMAttribute, DOMEntity,
DOMDocumentType, and DOMNotation.
Example This example writes out the parent of the node held in the variable domNode,
if it exists.
if( domNode.parentNode != null ){
document.writeln( domNode.parentNode.nodeName;
}
previousSibling property
Syntax DOMNode.previousSibling
Description The DOMNode object representing the node immediately preceding this node,
or null if no nodes precede this node.
Example This function loops backwards through the children of a node.
function BackwardsChildNodes( domNode ){
var domChild = domNode.lastChild;
do {
document.writeln( domChild.nodeName );
domChild = domChild.previousSibling;
} while ( domChild != null )
}
180
DOMNode methods
The DOMNode object has these methods:
appendChild method
Syntax DOMNode.appendChild( newChild )
Description Adds the DOMNode newChild to the end of the list of children of this node. If
newChild already exists in the tree, it is first removed.
Return The DOMNode which was added or null if the node could not be appended (for
example, if newChild is not a valid type of child for this node).
Example This fragment adds a child element to a node held in the customer variable.
new_elem = domDoc.createElement( "Name" );
new_text = domDoc.createTextNode("Ann T. Dote" );
el = customer.appendChild( new_elem );
el.appendChild( new_text );
cloneNode method
Syntax DOMNode.cloneNode( deep )
Description Returns a duplicate of this DOMNode. The duplicate node has no parent. deep is
a Boolean indicating whether to clone the subtree under this node.
For DOMElement objects, all attributes and their values are copied.
Return The duplicate DOMNode.
Example This fragment makes a duplicate of the first child of a document element (and
its subtree) and adds it to the end of the list of its children. The call to
prettyPrint is for debugging purposes.
var thisNode = docElem.firstChild;
var newNode = thisNode.cloneNode( true );
docElem.appendChild( newNode );
181
DOMNode methods
hasChildNodes method
Syntax DOMNode.hasChildNodes( )
Description Indicates whether a node has any children
Return Boolean.
Example This statement tests to see whether thisNode has any children.
if( thisNode.hasChildNodes() ){
// operations here
}
insertBefore method
Syntax DOMNode.insertBefore( newChild, refChild )
Description Inserts the DOMNode newChild before the existing child DOMNode refChild. If
refChild is null, newChild is inserted at the end of the list of children.
If newChild is a DOMDocumentFragment, all of its children are inserted, in
order, before refChild. If newChild already exists in the tree, it is first removed.
Return The inserted DOMNode, or null if the node could not be inserted (for example,
if refChild is not a child of this node).
Example This fragment makes a duplicate of the first child of a document element (and
its subtree) and adds it as the penultimate child. The call to prettyPrint is
for debugging purposes.
var newNode = thisNode.cloneNode( true );
docElem.insertBefore( newNode, docElem.lastChild );
removeChild method
Syntax DOMNode.removeChild( oldChild )
Description Removes from the list of children, the child node indicated by oldChild.
Return The removed DOMNode or null if the child could not be removed (for example,
if oldChild is not a child of this node.
182
Example This fragment removes the last child of the document element from a
document.
var thisNode = docElem.lastChild;
var oldNode = docElem.removeChild( thisNode );
replaceChild method
Syntax DOMNode.replaceChild( newChild, oldChild )
Description Replaces the child DOMNode oldChild with the DOMNode newChild in the list
of children. If newChild already exists in the tree, it is first removed.
Return The replaced DOMNode (oldChild) or null if the node could not be replaced (for
example, if oldChild is not a child of this node).
Example This fragment replaces the last child of the document element with the first
child. The first child is removed from its place in the beginning of the list.
var oldNode = docElem.replaceChild( thisNode,
docElem.lastChild );
DOMNodeList object
Object Represents an ordered collection of nodes.
Syntax To use a DOMNodeList’s property:
DOMNodeList.propertyName
To use a DOMNodeList’s method:
DOMNodeList.MethodName( parameter )
Description The DOMNodeList object represents an ordered collection of DOMNode
objects, or any object that inherits from DOMNode. The objects on the node list
are accessible via an integral index. Index values start at zero.
DOMNodeList property
The DOMNodeList object has this property:
183
DOMNodeList methods
length property
Syntax DOMNodeList.length
Description The number of objects in the list.
Example This fragment loops through the items of a DOMNodeList of elements.
for( iElem=0;
iElem < domParent.childNodes.length;
iElem++ ) {
thisChild = domParent.childNodes.item( iElem );
// other operations here
}
DOMNodeList methods
The DOMNodeList object has these methods:
item method
Syntax DOMNodeList.item( index )
Description Returns the indexth item in the collection. Valid values for index are 0 through
length – 1.
Return The node at the indexth position or null if the index is invalid.
Example This fragment loops through the items of a DOMNodeList of elements.
for( iElem=0;
iElem < domParent.childNodes.length;
iElem++ ) {
thisChild = domParent.childNodes.item( iElem );
// other operations here
}
DOMNotation object
Object Represents a notation declared in the DTD.
Syntax To use a DOMNotation's property:
DOMNotation.propertyName
184
To use a DOMNotation’s method:

DOMNotation.MethodName( parameter )
Description DOMNotation objects inherit the properties and methods of the DOMNode
object. The nodeName property inherited from DOMNode holds the declared
name of the notation.
A notation node does not have any parent.
DOMNotation properties
The DOMNotation object inherits all the properties of the DOMNode object,
and has the properties discussed in this section.
publicId property
Syntax DOMNotation.publicId
Description The public identifier of this notation, or null if no public identifier was
specified.
systemId property
Syntax DOMNotation.systemId
Description The system identifier of this notation, or null if no system identifier was
specified.
DOMNotation methods
The DOMNotation object has no methods of its own but inherits all of the
methods of the DOMNode object.
DOMProcessingInstruction object
Object Represents a processing instruction in the XML document.
185
DOMProcessingInstruction properties
Syntax To use a DOMProcessingInstruction’s property:

DOMProcessingInstruction.propertyName
To use a DOMProcessingInstruction’s method:
DOMProcessingInstruction.MethodName( parameter )
Description DOMProcessingInstruction objects have all the properties and methods of
the DOMNode object as well as the properties defined here.
DOMProcessingInstruction properties
The DOMProcessingInstruction object inherits all of the properties of the
DOMNode object, and has its own properties discussed in this section.
data property
Syntax DOMProcessingInstruction.data
Description The content of this processing instruction. This property contains the text
beginning at the first non-white space character after the target to the character
immediately preceding the ?>.
Example This processing instruction has a data property of version=1.0.
<?xml version=’1.0’ ?>
This instruction writes out the data of the processing instruction that is the first
child of the parsed XML document domDoc.
domPI = domDoc.firstChild;
document.writeln( domPI.data );
target property
Syntax DOMProcessingInstruction.target
Description The target of this processing instruction. This is the first token following the
markup that begins the processing instruction.
Examples This processing instruction has a target of xml.
<?xml version=’1.0’ encoding=’ISO-8859-1’ ?>
186
This instruction writes out the target of the processing instruction that is the
first child of the parsed XML document domDoc.
domPI = domDoc.firstChild;
document.writeln( domPI.target );
DOMProcessingInstruction methods
The DOMProcessingInstruction object has no methods of its own but
inherits all the methods of the DOMNode object.
The DOMText object

Object Represents textual content.
Syntax To use a DOMText’s property:
DOMText.propertyName
To use a DOMText’s method:
DOMText.MethodName( parameter )
Description DOMText objects inherit all of the properties and methods of the
DOMCharacterData object.
If there is no markup inside an element’s content, the text is contained in a
single DOMText object that is the only child of the element. If there is markup,
the content is parsed into a list of elements and text nodes that form the list of
children of the element.
When a DOMDocument is created (via the toDOMDocument method), there is
only one DOMText object for each block of text. Additional DOMText objects
can then be added, resulting in adjacent text nodes without intervening markup.
You can use the normalize method on a DOMElement to merge adjacent
DOMText objects into a single DOMText object.
See also “DOMCharacterData object” on page 146.
187
DOMText properties
DOMText properties
The DOMText object has no properties of its own but does inherit all the
properties of the DOMCharacterData object.
DOMText methods
The DOMText object inherits all the methods of the DOMCharacterData
object, but it also has one of its own methods, which is discussed here.
splitText method
Syntax DOMText.splitText( offset )
Description Breaks this text node into two text nodes at the specified offset, keeping both
in the tree as siblings. offset is the point where the text is to be split, starting
from 0.
After the split, this DOMText object contains the content up to the offset point.
The new DOMText node, added as the next sibling of this node, contains the
content at or after the offset point.
Return The new added DOMText node.
Example This script takes an element that has a single text node as child (holding a street
address), and adds text to the end of that node by splitting the text and then
normalizing:
streetText = streetElement.firstChild;
streetText.splitText(stText.length );
streetElement.lastChild.data = " -- now moved";
streetElement.normalize();
See also “normalize method” on page 163.
file object
Object Provides manipulation of files through the file system. These are files external
to the Web site.
188
For information on manipulating documents internal to the Web site, see “site
object” on page 291.
Syntax To use a file property:
file.propertyName
To use a file method:
file.MethodName( parameter )
Description To manipulate a file, a file object is created to represent the file. To create a file
object, use the file constructor. The syntax to create a new file object is:
fileObj = new File( fileName, accessMode);
The specified file is opened using the access mode provided, and a file object
representing the open file is returned.
Example This example reads information from FILE_A.DAT and adds it to the end of
FILE_B.DAT, converting all tabs to spaces:

See also “name property” on page 81.
“mode property” on page 268.
file properties
The file object has these properties:
189
file properties
eof property
Syntax file.eof
Description Set to true when an input operation attempts to read past the end of the file.
Example This example reads each character in the file input.txt:

errorNumber property
Syntax file.errorNumber
Description A number representing the error code of the last file method called. If an error
occurred the errorNumber will be non-zero. The values for errorNumber
and errorString are system dependent and may differ between NT and
versions of UNIX.
Example This example displays the error number that results from opening a file in one
mode and then opening it again in a different mode without closing the first
instance:

This example checks for an error code of 0 and returns a message if a new file
is created successfully:
190

errorString property
Syntax file.errorString
Description A string containing an error message for the error code of the last file method
called.
Example This example displays an error message if there is a problem with the first file
method called:

If the file input5.txt cannot be found in the specified directory, the output looks
like:
No such file or directory
null
191
file properties
name property
Syntax file.name
Description Name of the file to be manipulated (string).
Example This example displays the name of the file represented by the file object
myFile:

input.txt
mode property
Description The access mode with which the file was opened:
Access mode Description
r Open for read-only.
w Open for write, the file length to zero.
a Open for write at end of file.
rb Open binary file for reading.
rt Open text file for reading.
wb Create binary file for writing.
wt Create text file for writing.
ab Open binary file for write at end of file.
at Open text file for write at end of file.
r+ Open file for update (reading/writing).
w+ Create file for update (reading/writing).
a+ Open file for update at end of file.
rb+ Open binary file for update (reading/writing).
wb+ Create binary file for update.
ab+ Open binary file for update at end of file.
rt+ Open text file for update (reading/writing).
wt+ Create text file for update (reading/writing).
at+ Open text file for update at end of file.
192
Changing a file mode

Simply changing the file mode does not change the mode of the currently
opened file. A call to Close followed by a call to Open is required to change a
file mode.
Syntax file.mode
Example This example opens the file output.txt and appends the phrase “hello world” to
the end of the file:

file methods
The file object has these methods:
Close method
Syntax file.Close( )
Description Closes the file associated with the file object.
Return Boolean. Returns true or false indicating whether the file was successfully
closed.
Example This example opens and then closes the file input.txt:

Delete method
Syntax file.Delete( )
193
file methods
Description Deletes the file associated with the file object. The file must be closed to be
deleted.
Return Boolean. Returns true or false indicating whether the file was successfully
deleted.
Example This example deletes the file input.txt:

GetFilePtr method
Syntax file.GetFilePtr( )
Description Returns the current file position. This position defines the position of the next
character read or written.
Return Integer. Position.
Example This example displays the current position within the file input.txt:

Open method
Syntax file.Open( )
Description Opens the file specified by the name property in the read/write mode specified
by the mode property.
Return Boolean.
Example This example opens the file data.txt for reading, then reopens the file for
writing:

Read method
Syntax file.Read( numBytes )
Description Reads the contents of a file. numBytes specifies the number of bytes to read. If
no value is given, the entire contents of the file are read. This method is the
recommended way of reading a binary file as ReadChar returns string data and
ReadLine assumes line end characters are present.
Return If the file is opened in text mode, the data returned is a string. If the file was
opened in binary mode, the data returned is of type binary.
Example This example reads the data from the input.txt file and displays it:

ReadChar method
Syntax file.ReadChar( )
Description The character at the current file position is returned, and the file position is
advanced by one.
Return String. Returns the character read.
Example This example displays the first character of the file input.txt:

195
file methods
ReadLine method
Syntax file.ReadLine( )
Description Reads and returns a string starting from the current file position to the next
newline character or until end of file is reached. The newline character is not
discarded.
Return String. Returns the line read.
Example This example displays the first line of the file input.txt:

Seek method
Syntax file.Seek(offset)
Description Changes the current file position to the position indicated by offset. This
position defines the position of the next character read or written. The position
of the first character in the file is 0.
Return Boolean. Indicates whether the current file position was successfully set.
Example This example displays the fifth character from the file input.txt:

Write method
Syntax file.Write(s)
Description The string value of s is written at the current file position. At the end of this
operation, the current file position is set just after the written value.
Return Boolean.
196
Example This example writes “hello world” to the file d:\test\output.txt, and erases all
other text in the file:

WriteLine method
Syntax file.WriteLine(s)
Description Identical to the Write method except that a new line is written following the
written value.
Return Boolean.
Example This example writes “hello world” to the file output.txt, and erases all other text
in the file:

FTP object
Object Allows for FTP access through PowerDynamo.
Syntax To use an FTP method:
FTP.MethodName( parameter )
Description The FTP object has no properties. To use the FTP object, create a connection
to an FTP server using the FTP constructor:
FTPObj = new FTP( ftpServer, ftpUserId, ftpPassword);
Once the connection has been made, you can use the methods of the FTP object
to manipulate files and data between the local and a remote machine.
Example This example creates a connection to an FTP server and puts a file on the
remote machine:

FTP methods
The FTP object has these methods:
ChangeCurrentDirectory method
Syntax FTP.ChangeCurrentDirectory( directoryName )
Description Changes the current directory name on the FTP server.
Return Boolean.
Example This example creates a directory called Dynamo on the FTP server, changes to
that directory, and places a file called test.doc in it:

Connect method
Syntax FTP.Connect( )
Description Connects to the FTP server.
198
Example This example connects to an FTP server and displays the current directory. It
then disconnects and requests again to display the current directory, but no
directory should be displayed. It then connects again, and once again displays
the current directory:

CreateDirectory method
Syntax FTP.CreateDirectory( directoryName )
Description Creates a directory on the FTP server.
Return Boolean.
Example This example creates a directory called Dynamo on the FTP server, changes to
that directory, and places a file called test.doc in it:

DeleteFile method
Syntax FTP.DeleteFile( fileName )
199
FTP methods
Description Deletes a file from the FTP server.

Return Boolean.
Example This example deletes the test.doc file:

Disconnect method
Syntax FTP.Disconnect( )
Description Disconnects from the FTP server.
Example This example connects to an FTP server, deletes a file, then disconnects:

GetErrorCode method
Syntax FTP.GetErrorCode( )
Description Returns a code representing the most recent error. This may be either a three-
digit FTP code or a three-digit code in the 900s that has been generated by
Dynamo.
Return Integer.
200
Example This example puts a file on the FTP server and checks for errors:

GetErrorInfo method
Syntax FTP.GetErrorInfo( )
Description Returns a string containing an error message, either from the FTP server or
from PowerDynamo.
Return String.
Example This example places a file on the FTP server and checks for errors:

PutData method
Syntax FTP.PutData( remoteFileName, localData [,transferType,
failIfRemoteFileExists] )
Description Stores Dynamo data to the FTP server from a local machine. The parameters
are:
• remoteFileName The name of the file on the remote machine.
• localData The name of the data variable in your script.
201
FTP methods
• transferType Can be one of ASCII, binary, EBCDIC, image or local.

The default is binary.
• failIfRemoteFileExists A Boolean specifying the action to be
taken if the file already exists. The default is true.
Return Boolean.
Example This script is called from another script where users already entered their first
and last name and those values are held in document.value.fname and
document.value.lname. This script sends the data in
document.value.lname to a file called putdata.ssc on the FTP server:

PutDataWithAppend method
Syntax FTP.PutDataWithAppend( remoteFileName, localData [, transferType] )
Description Similar to the PutData method except that if the remote file already exists, the
local data is appended to the end of the file. If the remote file does not exist, a
new file is created.
• localData The name of the data on the local machine.
• transferType Can be one of ASCII, binary, EBCDIC, image, or local.
Return Boolean.
202
Example This script is called from another script where users entered their first and last
name and those values are held in document.value.fname and
document.value.lname. This script appends the data in
document.value.lname to a file called putdata.ssc on the FTP server:

PutDocument method
Syntax FTP.PutDocument( remoteFileName, documentName [, transferType ] )
Description Copies a Dynamo Web site document to an FTP server. The parameters are:
• documentName The name of the PowerDynamo document on the local
machine.
Return Boolean.
Example This example puts the Dynamo script test.ssc on the FTP server:

PutDocumentWithAppend method
Syntax FTP.PutDocumentWithAppend( remoteFileName, documentName [,
tranferType, failIfRemoteFileExists] )
Description Similar to the PutData method except that if the remote file already exists on
the remote machine the Dynamo document is appended to the end. If the
remote file does not exist, a new file is created. The parameters are:
• documentName The name of the PowerDynamo document on the local
machine.
Return Boolean.
Example This example appends the content of test.ssc to the content of the existing
test.ssc file on the remote machine:

204
PutFile method
Syntax FTP.PutFile( remoteFileName, localFileName [, transferType,
failIfRemoteFileExists] )
Description Puts a file to the FTP server from the Dynamo machine. The parameters are:
• localFileName The name of the file on the local machine.
Return Boolean.
Example This example puts a file on the FTP server:

PutFileWithAppend method
Syntax FTP.PutFileWithAppend( remoteFileName, localFileName [,
transferType ] )
Description Similar to the PutFile method, except that if a file already exists on the
remote machine, the file is appended to the end. If the file does not already
exist, a new one is created. The parameters are:
Return Boolean.
205
FTP methods
Example This example appends the text in the file test.txt to an existing file called test.txt
on the FTP server:

RemoveDirectory method
Syntax FTP.RemoveDirectory( directoryName )
Description Removes a directory from the FTP server. directoryName is the directory to
remove.
Return Boolean.
Example This example deletes a directory called Dynamo from the FTP server:

RetrieveCurrentDirectory method
Syntax FTP.RetrieveCurrentDirectory( )
Description Retrieves the current directory name from the FTP server.
Return String.
Example This example displays the current FTP directory:

RenameFile method
Syntax FTP.RenameFile( oldFileName, newFileName )
Description Renames a file on the FTP server. The parameters are:
• oldFileName The name of the existing file on the FTP server.
• newFileName The new name for the file.
Return Boolean.
Example This example renames a file on the FTP server from test.txt to newtest.txt:

RetrieveData method
Syntax FTP.RetrieveData( remoteFileName [, transferType] )
Description Retrieves data from the FTP server and turns it into a DynaScript variable. The
parameters are:
• remotefileName The name of the file on the remote machine.
• transferType Can be one of ASCII, binary, EBCDIC, image, or
local. The default is binary.
Return String or binary.
207
FTP methods
Example This example retrieves data from a file on an FTP server and displays the value:

RetrieveDirectoryListing method
Syntax FTP.RetrieveDirectoryListing( [ directoryName ] )
Description Returns a directory listing from the FTP server. If you do not provide a
directory name, a directory listing from the current directory is provided.
Return List of strings.
Example This example displays a directory listing for the FTP server:

RetrieveDocument method
Syntax FTP.RetrieveDocument( remoteFileName, documentName [,
connectionName, transferType, failIfLocalFileExists] )
Description Retrieves a document from the FTP server and stores it in a PowerDynamo
Web site. The parameters are:
• documentName The name of the file on the local machine.
• connectionName The name of the connection to be associated with the
document. The default is <inherited>.
208
• failIfLocalFileExists A Boolean specifying the action to be

Return Boolean.
Example This example retrieves a document from the FTP server called test.ssc and
stores it in a PowerDynamo Web site:

RetrieveFile method
Syntax FTP.RetrieveFile( remoteFileName, localFileName [, transferType,
failIfLocalFileExists] )
Description Retrieves a file from the FTP server and saves it to the local machine. The
parameters are:
• failIfLocalFileExists A Boolean specifying the action to be
Return Boolean.
Example This example retrieves a file from the FTP server and places it on the local
machine:

RetrieveFileWithAppend method
Syntax FTP.RetrieveFileWithAppend( remoteFileName, localFileName [,
transferType ] )
Description Similar to the RetrieveFile method, except if the file already exists locally,
the remote file is appended to the end. If the file does not exist a new one is
created. The parameters are:
Return Boolean.
Example This example retrieves a file from the FTP server and appends the content to a
file called test.txt that already exists on the local machine:

The Function object

Object Enables the creation of functions.
210
Syntax To use a Function property:

Function.propertyName
To use a Function method:

Function.MethodName( parameter )
Description The function constructor can be used to create a function on the fly:
funcName = new Function( [[parameter1 [, parameter2...]], body] );
The function keyword can also be used to create a function, in which case the
function is not created until it has been called from somewhere else in the
script:
function funcName ( [parameter1 [, parameter2...]], ) {
body
}
Example This example creates two Function objects called square and square1 and
executes them:

Function properties
The Function object has this property:
length property
Syntax Function.length
211
Function methods
Description Returns the number of parameters required by the Function.

Return Integer.
Example This example returns the number of parameters required by the function:

Function methods
The Function object has this method:
toString method
Syntax Function.toString( )
Description Returns the body of the function as a string.
Return String.
Example • This example displays the body of the function:

java object
Object Allows for manipulation of Java classes within PowerDynamo scripts.
The java object represents an object used for working with a Java class within
your Web site.
Syntax To use a java method:
java.MethodName( parameter )
212
Description To use Java class objects within your Web site, your Web site must be
configured to enable Java. Sybase Central allows for easy Java class setup for
PowerDynamo Web sites. You should be aware of the following configuration
options in the Configuration folder of Sybase Central if you want to create and
use instances of Java class objects within your Dynamo scripts:
• Java VM PowerDynamo supports the Sun Java VM and the Microsoft
VM. You must select one of these VMs for PowerDynamo to support Java.
• Java class cache size To improve performance, information about
the methods and properties of Java classes is cached. This option enables
you to set the cache size.
• Class path for the mapping You must specify a path for class files
that are stored in a Dynamo Web site.
Executing from within Sybase Central

To execute scripts that use the Java object from within Sybase Central, the
mapping and Dynamo site name must be the same.
For more information on PowerDynamo configuration settings in Sybase

Central, see “Changing Dynamo configuration settings” in the PowerDynamo
User’s Guide.
You must specify all parameters when you are working with the java object.
Unlike other DynaScript objects, an error occurs if parameters are excluded
when calling a Java class method or property.
Accessing Java methods and properties

You can access methods from any Java class. Properties, however, can be
accessed only from JavaBeans.
Example Let’s assume we are working with this class:

class Fibonacchi
{
public long prev1;
public long prev;
public long next;
public long getPrev() { return prev; }

public long getNext() { return next; }
public Fibonacchi()
{
213
java methods
prev1 = 1;
prev = 0;
next = 0;
}
public void generateNext()

{
next = prev1 + prev;
prev = prev1;
prev1 = next;
}
static public double doubleme( double t )

{
return t*2;
}
}
To call this class, your script might look something like this:
// call a static method on the class
result = java.CallStaticMethod( "Fibonacchi",
"doubleme", 2.5 );
document.writeln( result );
// create a DynaScript object representing a Java class
fib = java.CreateObject( "Fibonacchi" );
// retrieve a property on the class
document.writeln( "The value of next is " + fib.next +
" The value of prev is " + fib.prev );
for( i = 0; i < 20; i++ ) {
// invoke a method on the class
fib.generateNext();
document.writeln( "The value of next is " + fib.next
+ " The value of prev is " + fib.prev );
}
For more information on using Java in your PowerDynamo scripts see
“PowerDynamo and Java” in PowerDynamo User’s Guide.
java methods
The java object has these methods:
214
CreateComponent method
Syntax java.CreateComponent( componentName [, managerUrl, id, password,
narrowingComponent] )
Description Creates an instance of a Jaguar component, using CORBA naming services,
through Java. The parameters are:
• componentName The name of the component.
• managerUrl An URL to Jaguar Manager. For example,
“iiop://testMachine:9000”. This parameter is required to call a component
on another machine.
• id A Jaguar Manager user ID.
• password A Jaguar Manager password.
• narrowingComponent The name of the component you would like to
narrow.
The Jaguar server returns a component instance which must be narrowed
(cast) to an instance of an interface that the component supports. The
default interface is set to the name of the Jaguar component that is being
called. Use this only if you want to change the interface to something other
than the default. For example, by default, the component
SVU/SVUEnrollment is narrowed to the interface
“SVU/SVUEnrollment”. For more information on narrowing, see the
Jaguar Programmer’s Guide.
When you are generating stubs for your Jaguar components you can
specify a Java package other than the default, in which to store the stubs.
If this is the case, when the component is later being created by
DynaScript, the location of the stubs must be specified. To specify a stub
location that is something other than the default, the
narrowing_component parameter of the CreateComponent method
should be used. For example, if you have stored your Java stubs for the
SVU Jaguar package in com/sybase/jaguar/sample/svu/SVUMetaData
then you would use the following syntax to create an instance of a
SVUMetaData component that resides in the SVU Jaguar package:
java.CreateComponent( "SVU/SVUMetaData",
"iiop://localhost:9000", "Jagadmin", "", "
com/sybase/jaguar/sample/svu/SVUMetaData" );
If however, you used the default value when generating stubs for the SVU
package, your syntax would look like the following:
java.CreateComponent( "SVU/SVUMetaData" );
215
java methods
Setting the Java VM

The Java VM configuration option must be set to the Sun VM for scripts with
this method to execute. Change the VM option using the
Configuration\Default General Settings\Java VM folder in Sybase Central.
Return A Jaguar component object or null if the component could not be created. This
is a DynaScript Java object.
Example This example creates an instance of a component called comp. Once the object
is created, its method getMajors is called and the Record Set is displayed:
<HTML>
<H1>A CreateComponent example</H1>

</HTML>
For information on result sets and the getResultSet method, see the Jaguar CTS
Programmer’s Guide.
site.GetErrorInfo( )
The site.GetErrorInfo( ) method may be used for retrieving error information.
See also “Calling Jaguar Component Methods from PowerDynamo” in the

216
CreateObject method
Syntax java.CreateObject( className [, list of constructor parameters ] )
Description Instantiates a Java class object. The parameters are:
• className The name of the Java class.
• list of constructor parameters These parameters are passed to the
Java class constructor.
Setting the Java VM

The Java VM configuration option must be set to the Sun VM for scripts with
this method to execute. Change the VM option using the
Configuration\Default General Settings\Java VM folder in Sybase Central.
Return A DynaScript object representing the Java class. Returns Null if the Java class
cannot be created.
Example This example creates an instance of Java class that performs the fibonacchi
mathematical procedure. It involves the GenerateNext method and returns
results.

See also “PowerDynamo and Java” in the PowerDynamo User’s Guide.
CallStaticMethod method
Syntax java.CallStaticMethod( className, staticMethod [, list of method
parameters] )
Description Calls a static Java method. You need not create a Java object
(java.CreateObject) to call static methods of that object. The parameters are:
217
java methods
• className The name of the Java class containing the static method.
• staticMethod The name of the static method to be called.
• list of method parameters Any parameters to be passed on to the
static method.
Return The return type is dependent on the type of return value of the static method.
Example This example executes the static method doubleme of the class Fibonacchi.
Calling a static method does not require that an object representing a Java class
instance be created.

See also “PowerDynamo and Java” in PowerDynamo User’s Guide
GetHomeInterface method
Syntax java.GetHomeInterface(component_name [, provider_url, user_id,
password] )
Description Allows access to the EJBHome interface for a Jaguar component. The
parameters are:
• component_name The name of the component to instantiate.
Component names are composed as follows:
[<server-context>]<package>/<comp>
• server-context – The root naming context for the server where the
component is installed. server-context is optional and necessary only
if a root naming context has been set for the server. The root naming
context can also be given as the initial context in the provider_url.
• package – The Jaguar package to which the component belongs, as
displayed in Jaguar Manager.
• component – The component name, as displayed in Jaguar Manager.
218
You can view and edit this setting using the Naming Service tab of the
Server Properties window from Jaguar Manager. The default for a new
server is “/”. If you specified an initial name context in
GetHomeInterface()'s provider_url parameter, then the server context is
assumed to be relative to this initial name context. For example, if the
provider_url parameter is set to iiop://localhost:9000/USA/Sybase, and
your server's root context is USA/Sybase/Engineering, then you can
resolve component names as Engineering/package/component.
• provider_url The provider_url is optional and defaults to
“iiop://localhost:9000”. If used, it identifies the URL of the JNDI name
server. This parameter should be of the form iiop://<hostname>[:<iiop-
port>][/<initial-context>] where:
• hostname Is the host machine name for the Jaguar server that serves
as the name server for your application.
• iiop-port Is the IIOP port number for the server.
• initial-context Is the optional initial naming context, which can be
used to set a default prefix for name resolution. For example, if you
specify USA/Sybase/, then the component_name parameter is
assumed to be relative to this location in the name hierarchy. When
specifying the initial context, the trailing slash is optional; it is added
automatically if you do not specify an initial context that ends with a
slash.
• user_id The user name for the Jaguar session. If authorization is enabled
for your Jaguar server, this parameter is used to authorize access to Jaguar
components.
The user_id parameter is optional and defaults to “guest”.
• password The password for the Jaguar session. If authorization is
enabled for your Jaguar server, the password is used to authorize access to
Jaguar components.
219
java methods
The password parameter is optional and default is no password.
Note The Dynamo methods GetHomeInterface and GetUserTransaction

enable access to EJB interfaces of Jaguar components.
To access EJB interfaces of Jaguar components, Dynamo requires a Jaguar
client zip file, jagclient.zip, from a Jaguar CTS installation version 3.5 or
above. Refer to PowerDynamo installation instructions for your platform and
ensure that this file is included in your JAGUARCLASSES (Solaris) or
CLASSPATH (NT) variable.
Example Use java.GetHomeInterface to create an instance of the EJBHome

interface for the component Test/Cart. Then use the Home interface to
create an actual instance of Test/Cart.
carthomeObj =
java.GetHomeInterface("CartPackage/Cart")
cartObj = carthomeObj.create("John", "7506");
cartObj.addItem(66)
cartObj.addItem(22)
cartObj.purchase()
carthomeObj.remove(...)
GetUserTransaction method
Syntax java.GetUserTransaction( [ <provider_url>, <user_id>, <password>] )
Description Allows access to the EJB UserTransaction object. The parameters are:
• provider_url The provider_url is optional and defaults to
“iiop://localhost:9000”. It identifies the URL of the JNDI name server.
This parameter should be of the form iiop://<hostname>[:<iiop-
port>][/<initial-context>] where:
• hostname Is the host machine name for the Jaguar server that serves
as the name server for your application.
• iiop-port Is the IIOP port number for the server.
220
• initial-context Is the optional initial naming context, which can be

used to set a default prefix for name resolution. For example, if you
specify USA/Sybase/, all names that you resolve with the context are
assumed to be relative to this location in the name hierarchy. When
specifying the initial context, the trailing slash is optional; it is added
automatically if you do not specify an initial context that ends with a
slash.
• user_id The user name for the Jaguar session. If authorization is enabled
for your Jaguar server this optional parameter, which defaults to “guest”,
is used to authorize access to Jaguar components.
• password The password for the Jaguar session. If authorization is
enabled for your Jaguar server, this optional parameter, which defaults to
no password, is used to authorize access to Jaguar components.
Note The Dynamo methods GetHomeInterface and GetUserTransaction

enable access to EJB interfaces of Jaguar components.
To access EJB interfaces of Jaguar components, Dynamo requires a Jaguar
client zip file, jagclient.zip, from a Jaguar CTS installation version 3.5 or
above. Refer to PowerDynamo installation instructions for your platform and
ensure that this file is included in your JAGUARCLASSES (Solaris) or
CLASSPATH (NT) variable.
Comments The components that participate in the transaction managed with the
UserTransaction object must be in the same server as the UserTransaction
object, which cannot be assumed if a Jaguar cluster is used to ensure that this
requirement is met:
1 Use the same name server to create the UserTransaction object that was
used when creating the component instances. That is, supply the same
provider_url to GetUserTransaction() and GetHomeInterface(),
CreateComponent(). The initial-context values of the URLs can differ.
2 Get the UserTransaction object and begin the transaction before creating
any component instances.
3 In addition, follow the same restrictions as other Java clients when using
the UserTransaction object. Refer to the Jaguar CTS Programmer’s Guide
and Jaguar CTS Reference Manual for details.
221
java methods
The UserTransaction interface defines exceptions that are thrown when errors
occur. For example, TransactionRolledbackException is thrown when
commit() is called after setRollbackOnly() has already been called for a
transaction.
As many of the methods in the UserTransaction interface for example, return
void, begin(), commit(), rollback(), these exceptions are the only way
to detect errors.
In DynaScript, exceptions are passed to the user through the
site.GetErrorInfo() method. That is, the exception is converted to an
error string. For example:
ut.begin()
...
ut.commit()
errMsg = site.GetErrorInfo();
if ((errMsg != null) && (errMsg != ""))
{
/* the transaction was not committed */
}
The UserTransaction.getStatus() method returns an integer value
indicating the status of the current transaction. Dynamo users can include the
script ~/system/utils/usertran.ssc to get the definitions of variables that map to
the integer values returned by getStatus().
import "~/system/utils/usertran.ssc"
...
ut = java.GetUserTransaction(...);
ut.begin()
status = ut.getStatus();
if (status != UserTran.STATUS_ACTIVE)
{
/* the transaction was not started */
}
...
Example Use java.GetUserTransaction to get the UserTransaction object,
instantiate the components that will participate in the transaction, begin the
transaction, perform the operations required in the transaction, and commit the
transaction.
ut = java.GetUserTransaction("iiop://my-host:9000")
222
acctHome = java.GetHomeInterface("Bank/Account",
"iiop://my-host:9000")
acct1 = acctHome.create("John", "Doe", "111-11-1111")
acct2 = acctHome.create("Jane", "Doe", "222-22-2222")
acct3 = = java.CreateComponent("Bank/Account",
"iiop://my-host:9000")
ut.begin();
{
/* handle error, the transaction did not begin return
}
acct1.withdraw(100);
acct2.deposit(50);
acct3.deposit(50);
ut.commit();
{
/* handle error, the transaction did not commit
return
}
mailList object
Object Represents a list of mail pieces on a POP3 server.
Syntax To use a mailList property:
mailList.propertyName
To use a mailList method:

mailList.MethodName( parameter )
Description The mailList object is used to retrieve a list of the mail pieces on a POP3 server.
The list, once returned, contains enough information for the user to sort
through and select particular mail pieces for full retrieval.
To create a preview list of incoming mail piece objects, use the mailList
constructor. The syntax to create a new mailList object is:
mailListObj = new MailList( popServer, popUser, popPassword,
fullUserName [, useAPOP] );
The parameters are:
223
mailList properties
• popServer The name of the POP3 server.

• popUser The user ID for the POP3 server.
• popPassword The password for the POP3 server.
• fullUserName The full mail address.
• useAPOP If true, specifies that the POP3 APOP command should be
used to log on to the POP3 server. If false, the POP3 commands USER and
PASS are used – this causes your password to be sent as clear text. The
default is true.
Example This example returns a list of the mail pieces that are waiting for the user elmo.
The list indicates where the message was sent from and the subject line of the
message:

See also “mailPiece object (incoming)” on page 227.
“mailPiece object (outgoing)” on page 238.
“attachment object” on page 80.
mailList properties
The mailList object has this property:
count property
Syntax mailList.count
Description The number of messages in the mail list.
Return Integer.
224
Example This example displays the number of messages in the mail list.

mailList methods
The mailList object has these methods:
Disconnect method
Syntax mailList.Disconnect( [deleteMarkedPieces] )
Description Disconnects from the mail server. The optional parameter deleteMarkedPieces
indicates whether or not mail pieces marked for deletion should be deleted
from the mail server at the time of disconnect. The default is true.
Return Boolean indicating if the disconnect was successful.
Example This example connects and then disconnects from the mail server:

225
mailList methods
GetErrorCode method
Syntax mailList.GetErrorCode( )
Description Returns a code representing the most recent generated error. The error will
either be a three-digit POP3 reply code or a three-digit code in the 900 range
generated by Dynamo.
Return Integer.
Example This example returns an error if any problems are encountered while
disconnecting from the mail server:

GetErrorInfo method
Syntax mailList.GetErrorInfo( )
Description Returns a string containing an error message. The error can either be a
complete reply from the POP3 server or from PowerDynamo.
Return String.
Example This example returns an error if any problems are encountered while
disconnecting from the mail server

mailPiece object (incoming)

Object This object is a mail piece received by a specific recipient which is being held
on a mail server. The mailList object is a list of incoming mail piece objects
representing mail accessible via a POP3 server.
Syntax To use an incoming mail piece property:
mailPiece.propertyName
To use an incoming mail list method:

mailPiece.MethodName( parameter )
Description Each incoming mail piece is represented by an incoming mail piece object. You
can manipulate the object to display the different parts of the incoming mail
piece.
Example This example retrieves a mail piece (mlistitem) and displays its subject, body,
and attachments:

See also “attachment object” on page 80.
“mailList object” on page 223.
“recipient object” on page 267.
227
mail piece properties (incoming)

The incoming mail piece object has these properties:
attachments property
Syntax mailPiece.attachments
Description A list of attachments contained with the incoming mail piece.
Return List of attachment objects.
Example This example displays the names of all attachments in incoming mail piece
number 7:

See also “mailList object” on page 223.
body property
Syntax mailPiece.body
Description The body or content text of the incoming mail piece. This property is available
only after doing a Retrieve.
Return String.
Example This example displays the body of an incoming mail piece:

from property
Syntax mailPiece.from
Description The person from whom the mail piece originated.
Return String.
Example This example display the address from which the mail piece originated:

headers property
Syntax mailPiece.headers
Description The ARPA message headers. These are the unprocessed header fields from the
mail piece.
Return String.
Example This example displays the headers:

recipients property
Syntax mailPiece.recipients
Description The recipients of the incoming mail piece.
Return List of recipient objects.
Example This example displays a list of the recipients for the incoming mail piece:

replyTo property
Syntax mailPiece.replyTo
Description Who the recipient of the mail piece should reply to. This is a list of recipient
objects. If this field exists, the reply method responds to the recipients listed
here instead of to addresses specified in the from field.
Return List of recipient objects.
230
Example This example displays the address of the individual to whom the mail piece is
sent if the Reply method is used. If the replyTo property is null, the mail
piece will be sent to the address held in the from property


sender property
Syntax mailPiece.sender
Description The address from where the mail piece was sent. This is not necessarily the
same address as the from field (in the case where a mail piece has been
redirected).
Return String.
Example This example indicates if the mail piece was sent directly by the author or by a
“sender”:

size property
Syntax mailPiece.size
Description The size (bytes) of the incoming mail piece.
Return Integer.
Example This example displays the size of the mail piece:

subject property
Syntax mailPiece.subject
Description The subject of the incoming mail piece.
Return String.
Example This example displays the subject of the mail piece:

mail piece methods (incoming)

The incoming mail piece object has these methods:
Delete method
Syntax mailPiece.Delete( )
Description Marks a mail piece for deletion. The mail piece is not actually deleted until the
POP3 server is disconnected.
Return Boolean.
Example This example marks a mail piece for deletion:

mlist.Disconnect();
Forward method
Syntax mailPiece.Forward( userName [, includeAttachments] )
233
Description Prepares an outgoing mail piece object to be forwarded with all the appropriate
properties and recipients specified from the incoming mail piece. The
forwarded mail piece may be edited and then sent with the outgoing mail piece
send method. The parameters are:
• userName The address of the user to forward the mail piece to.
• includeAttachments Specifies whether all attachments of the
incoming mail piece should be included in the preparation of the outgoing
mail piece. The default is true.
Setting the smtpHost

You must either set the smtpHost property or specify a default for it in Sybase
Central before you can forward a message using this method.
Return Outgoing mail piece object.

Example This example forwards a piece of mail:

GetErrorCode method
Syntax mailPiece.GetErrorCode( )
Description Returns a code representing the most recently generated error. The error
generated will either be a three-digit POP3 reply code or a three-digit code in
the 900 range generated by Dynamo.
Return Integer.
Example This example checks that the send method was completed successfully:
234

GetErrorInfo method
Syntax mailPiece.GetErrorInfo( )
Description Returns a string containing an error message. The error generated is either a
reply from the POP3 server or from PowerDynamo.
Return String.
Example This example verifies that the send method completed successfully:

Redirect method
Syntax mailPiece.Redirect( userName )
235
Description Prepares an outgoing mail piece object to be redirected with all the appropriate
properties and recipients specified from the incoming mail piece. userName is
the internet e-mail address of the person to redirect the mail piece to. The
redirected mail piece may be edited and then sent with the outgoing mail piece
object Send method.


Example This example retrieves a mail piece and then redirects it to another user:

Reply method
Syntax mailPiece.Reply( [replyMode, includeOriginal, includeAttachments] )
Description Creates an outgoing mail piece from an incoming mail piece with some
properties and the recipients preset.
• replyMode can be one of:
• " sender" Indicates that the mail piece is to be sent to the address
specified in the replyTo property. If the replyTo property of the
original mail piece does not exist, the mail piece will be sent to the
address specified in the from property of the original mail piece.
• " all" Indicates that the mail piece is to be sent to all recipients
including the sender.
236
• includeOriginal Can be true or false. If true, the original mail piece

body is included in the body of the outgoing mail piece. The default is
false.
• includeAttachments Can be true or false. If true, all attachments to
the original mail piece are included in the outgoing mail piece. The default
is false.


Example This example retrieves and replies to a mail piece.

Retrieve method
Syntax mailPiece.Retrieve( [deleteFromServer] )
Description Retrieves the full mail piece from the POP3 server. You must be connected to
the POP3 mail server to use this method. The deleteFromServer parameter
specifies whether to mark the retrieved mail piece for deletion after retrieval.
The deleteFromServer parameter may be set to true or false. The default is
false. If set to true, the marked mail piece is deleted from the server once you
disconnect from the POP3 server.
Return Boolean.
Example This example retrieves a mail piece:
237
mailPiece object (outgoing)

mailPiece object (outgoing)

Object Represents a mail piece that is to be sent via SMTP.
Syntax To use a mailPiece property:
mailPiece.propertyName
To use a mailPiece method:
mailPiece.MethodName( parameter )
Description Use the mailPiece constructor to create an outgoing mail piece object that
represents a piece of outgoing mail. The syntax is:
mailPiece = new MailPiece( );
You can also create outgoing mail pieces by calling the Forward, Redirect or
Reply method on an incoming mail piece object.
Example This example creates and sends a simple mail piece with an attachment:
mp = new MailPiece();
mp.subject = "This is my subject text";
mp.from = "elmo@sybase.com";
mp.body = "This is my mail piece body.";
mp.smtpHost = "mail.sybase.com";
mp.AddRecipient( "theGrouch@sybase.com");
mp.AttachDocument( "attachment.gif" );
if( !mp.Send() ) {
238
}
See also “attachment object” on page 80
“mailList object” on page 223
“recipient object” on page 267
mailPiece properties (outgoing)

The mailPiece object has these properties:
body property
Description The body text of the mail piece.
Binary data
Binary data must be sent as an attachment.
Example This example creates an outgoing mail piece. It is assumed that you have set
the smtpHost from within Sybase Central:


“mailPiece object (incoming)” on page 227.
239

from property
Syntax mailPiece.from
Description The address from where the mail piece is being sent. This address must be a
valid Internet mail user name in canonical form.
Example This example sends a piece of e-mail to a specific address depending on the
input given by the user. The user must also enter their own e-mail address so
the recipient knows who to respond to.
Following is the form that requests information from the user:
<HTML>
<BODY>
<H1>Problem tracking</H1>
<p>This Web page is used to filter software problems to
the appropriate help personel.
<p>Select the product that you require help for:

<FORM METHOD=POST ACTION=’mailsend.ssc’>
<OL>
<LI><INPUT TYPE=’radio’ Name="product" Value="Product
A">Product A
B">Product B
C">Product C
Other">Product Other
</OL>
<P>Enter your mail address:
<INPUT Type="TEXT" Name="from" SIZE=40></P>
<P>Describe your problem:
<INPUT Type="TEXT" Name="body" SIZE="50" ></P>
<INPUT TYPE="SUBMIT">
</FORM>
</BODY>
</HTML>
240
From a browser, the form would look something like this:
Following is the script (mailsend.ssc) that is called to process the information

entered on the form:
<HTML>
<BODY>

<P>Select the back buttom if you wish to send another
e-mail</P>
</BODY>
</HTML>
sender property
Syntax mailPiece.sender
Description You can use this property if a mail piece is sent from a destination other than
that of the person who the message is from. For example, if an assistant wanted
to send a message as requested by their supervisor, mailPiece.sender
would be the address of the assistant while mailPiece.from would be the
address of the supervisor.
Example This example sets the sender property on the mp mailpiece object:

smtpHost property
Syntax mailPiece.smtpHost
Description Specifies the name of the host to be used as a gateway for sending the mail
piece. If this value is empty, the value of smtpHost in the PowerDynamo
Configuration folder is used as the gateway. If the smtpHost has not been
specified in Sybase Central or the document, the mail piece will not be sent.
For information on setting the smtpHost in Sybase Central see “Changing
Dynamo configuration settings” in the PowerDynamo User’s Guide.
Example This example sets the smtpHost as mailsrv.sybase.com:

243
mailPiece methods (outgoing)
body property
Description The body text of the mail piece.
Binary data
Binary data must be sent as an attachment.
Example This example creates a simple outgoing mail piece:



The mailPiece object has these methods:
AddRecipient method
Syntax mailPiece.AddRecipient( userName [, userMode] )
Description Specifies the address or addresses where a mail piece is to be sent. The
parameters are:
• userName The e-mail address of the recipient.
• userMode Identifies the type of delivery.
Mode can be one of:
244
• to recipient is the main target of the mail piece.

• cc recipient is being carbon-copied.
• bcc recipient is being blind carbon-copied.
Return Boolean.
Example The following example sends a piece of mail to a specific address depending
on the input given by the user. The user must also enter their own e-mail
address so the recipient will know who to respond to.
This script creates a form that requests information from the user:
<HTML>
<BODY>
<H1>Problem tracking</H1>
<p>This Web page is used to filter software problems to
the appropriate help personel.
<p>Select the product that you require help for:

<FORM METHOD=POST ACTION=’mailsend.ssc’>
<OL>
A">Product A
B">Product B
C">Product C
Other">Product Other
</OL>
<P>Enter your mail address:
<INPUT Type="TEXT" Name="from" SIZE=40></P>
<P>Describe your problem:
<INPUT Type="TEXT" Name="body" SIZE="50" ></P>
<INPUT TYPE="SUBMIT">
</FORM>
</BODY>
</HTML>
From a browser, the form looks something like this:
this is the script (mailsend.ssc) to process information entered on the form:
<HTML>
<BODY>

<P>Select the back button if you wish to send another
e-mail</P>
</BODY>
</HTML>
AddReplyTo method
Syntax mailPiece.AddReplyTo( userName )
Description Adds an address to the list of addresses from which responses to this mail piece
are directed.
Return Boolean.
Example This mail piece, when replied to, will be sent to elmo and elmojr:

247
AttachData method
Syntax mailPiece.AttachData( data [,MIMEtype, description] )
Description Attaches a piece of data (typically held in a DynaScript variable) to the mail
piece.
Return Boolean.
Example This example attaches a piece of data to the mail piece after retrieving it from
the database:

“AttachDocument method” on page 248.
“AttachFile method” on page 249.
AttachDocument method
Syntax mailPiece.AttachDocument( documentName )
Description Attaches a document in a PowerDynamo Web site to the mail piece.
Return Boolean.
248
Example This example attaches a document called muppets.gif to the mail piece object:

“AttachData method” on page 248.
“AttachFile method” on page 249.
AttachFile method
Syntax mailPiece.AttachFile( filePath )
Description Attaches a file from the file system to the mail piece.
Return Boolean.
Example This example attaches a system file called autoexec.bat to the mail piece
object:

249

“AttachData method” on page 248.
“AttachDocument method” on page 248.
GetErrorCode method
Syntax mailPiece.GetErrorCode( )
Description Returns a code representing the most recent error that occurred. The error is
either a three-digit SMTP reply code or a three-digit code in the 900 range
generated by PowerDynamo.
Return Integer.
Example This example sends a piece of mail and then checks for errors:

GetErrorInfo method
Syntax mailPiece.GetErrorInfo( )
250
Description Returns a string containing an error message. The message is either a reply
either from the SMTP server or from PowerDynamo.
Return String.
Example This example sends a mail piece and then checks for errors:

Send method
Syntax mailPiece.Send( userName )
Description Sends a mail piece through SMTP. Use GetErrorInfo and GetErroCode to
check for failures.
Return Boolean.
Example This example creates and sends a mail piece:

251
Math object

Math object
Object The Math object provides basic Math functionality to users.
Syntax To use a Math property:
Math.propertyName
To use a Math method:

Math.MethodName( parameter )
Description The Math object provides basic math functionality in your PowerDynamo
script or template.
The Math object is provided as a built-in object. There are no constructors for
creating instances of a Math object. When referring to Math in this chapter, we
are referring to the built-in Math object, not an instance of the Math object.
Example This example uses the pow method of the Math object and displays the results:

Math properties
The Math object has these properties:
E property
Syntax Math.E
252
Description Returns the number value for e, the base of the natural logarithms, which is
approximately 2.71828182845905.
Return Floating point.
Example To display the value of e:

LN2 property
Syntax Math.LN2
Description Returns the number value for the natural logarithm of 2, which is
Example To display the value of LN2:

LN10 property
Syntax Math.LN10
Description Returns the value for the natural logarithm of 10, which is approximately
2.30258509299405.
Example To display the value of LN10:

253
Math properties
LOG2E property
Syntax Math.LOG2E
Description Returns the number value for the base-2 logarithm of e, Euler’s constant. This
value is approximately 1.44269504088896.
Example To display the value of LOG2E:

LOG10E property
Syntax Math.LOG10E
Description Returns the number value for the base-10 logarithm of e, Euler’s constant. This
value is approximately 0.434294481903252.
Example To display the value of LOG10E:

PI property
Syntax Math.PI
Description Returns the ratio of the circumference of a circle to its diameter, which is
Example To display the value of PI:
254

SQRT1_2 property
Syntax Math.SQRT1_2
Description Returns the number value for the square root of 1/2, which is approximately
0.707106781186548.
Example To display the value of the square root of 1/2:

SQRT2 property
Syntax Math.SQRT2
Description Returns the number value for the square root of 2, which is approximately
1.4142135623731.
Example To display the value of the square root of 2:

Math methods
The Math object has these methods:
255
Math methods
abs method
Syntax Math.abs( num )
Description Returns the absolute value of a number.
Return The absolute value of the number argument.
Example This example returns the absolute value of -8:

acos method
Syntax Math.acos( num )
Description Returns the arc cosine of a number.
Example This example returns the arc cosine of .43:

asin method
Syntax Math.asin( )
Description Returns the arc sine of a number.
Example This example returns the arc sine of 1:

atan method
Syntax Math.atan( num )
Description Returns the arc tangent of a number.
256

Example This example displays the arc tangent of .43:

atan2 method
Syntax Math.atan2( y, x )
Description Returns the angle in radians from the x axis to the y, x point. The parameters
are:
• y The y coordinate.
• x The x coordinate.
Example This example returns the angle from the x axis to the y, x point:

ceil method
Syntax Math.ceil( num )
Description Returns the smallest number value that is not less than the argument and is
equal to a mathematical integer.
Return Integer.
Example This example displays the smallest integer possible that is not less than 6.333:

cos method
Syntax Math.cos( num )
257
Math methods
Description Returns the cosine of a number.

Example This example returns the cosine of 45:

exp method
Syntax Math.exp( num )
Description Returns E raised to the power of the argument (num).
Example This example calculates and displays the value of E to the power of 8:

floor method
Syntax Math.floor( num )
Description Returns the greatest number value that is not greater than the argument and is
equal to a mathematical integer.
Return Integer.
Example This example calculates and displays the greatest number value that is not
greater than the argument and is equal to a mathematical integer:

log method
Syntax Math.log( num )
Description Returns the natural logarithm of a number.
258

Example This example displays the logarithm of the number 6:

max method
Syntax Math.max( numExp, numValue )
Description Returns the larger of two arguments. The parameters are:
• numExp A numeric expression that will be compared with numValue.
• numValue A numeric value that will be compared with numExp.
Example This example returns the larger value of x and y:

min method
Syntax Math.min( numExp, numValue )
Description Returns the smaller of the two arguments. The parameters are:
• numExp A numeric expression that will be compared with numValue.
• numValue A numeric value that will be compared with numExp.
Example This example returns the smaller value:

259
Math methods
pow method
Syntax Math.pow( num, exponent )
Description Returns the result of raising x to the power y. The parameters are:
• num The base value (x).
• exponent The exponent value (y).
Example This example returns the results of calculating 3 to the power of 8:

random method
Syntax Math.random( )
Description Returns a randomly generated positive number equal to or greater than 0 but
less than 1.
Example To return a number s equal to or greater than 0 but less than 1:

round method
Syntax Math.round( num )
Description Returns the supplied number, rounded to the nearest integer.
Return Integer.
Example This example rounds the number 54.354 to the nearest integer:

260
sin method
Syntax Math.sin( num )
Description Returns the sine of a number.
Example This example displays the sine of 54:

sqrt method
Syntax Math.sqrt( num )
Description Returns the square root of a number.
Example This example displays the square root of 64:

tan method
Syntax Math.tan( num )
Description Returns the tangent of a number.
Return Floating point
Example This example displays the tangent of 43:

Number object
Object Enables you to use methods and obtain properties on a number.
261
Number properties
Syntax To use a Number property:
Number.propertyName
To use a Number method:
Number.MethodName( parameter )
Description The Number object represents a number for which you want to use methods
and properties made available with the Number object. These methods and
properties are not available to numbers that are held by variables ( num = 14 ).
You can call a Number object as a function:
Number( value );
or as a constructor:
myNumber = new Number( value );
When called as a function, a type conversion is performed and a number is
returned. A new Number object is not created. When a Number object is
created through a constructor, a Number object is returned.
The Number object has both a built-in object as well as constructors that allow
users to create instances of a Number object. When referring to Number in the
syntax sections of this chapter, we are referring to an instance of a Number
object, not the built-in Number object.
Example This example creates a Number object with the value of 32:

Number properties
The Number object has these properties:
MAX_VALUE property
Syntax Number.MAX_VALUE
262
Description Returns the largest positive finite value of the number type, which is
approximately 1.7976931348623157e308.
Return Integer.
Example This example displays the largest possible number that can be used in
PowerDynamo:

MIN_VALUE property
Syntax Number.MIN_VALUE
Description Returns the smallest positive nonzero value of the number type, which is
approximately 5e-324.
Return Integer.
Example This example displays the smallest positive non-zero number that can be used
in PowerDynamo:

NaN property
Syntax Number.NaN
Description A value that indicates that an arithmetic expression returned a value that was
not a number.
Return String (NaN)
Example This example will have an output of NaN.

263
Number methods
NEGATIVE_INFINITY property
Syntax Number.NEGATIVE_INFINITY
Description Returns a string indicating that a number is outside the range that ECMAScript
is capable of representing.
Return String (-Infinity).
Example This example will have an output of -Infinity:

POSITIVE_INFINITY property
Syntax Number.POSITIVE_INFINITY
Description Returns a string indicating that a number is outside the range that ECMAScript
is capable of representing.
Return String (Infinity)
Example This example will have an output of Infinity:

Number methods
The Number object has these methods:
toString method
Syntax Number.toString( [radix] )
Description Returns a string representation of the Number object. A radix may be used if
you wish to work with something other than base 10.
264
Return String.
Example This example creates a number object and converts the value to a string:

valueOf method
Syntax Number.valueOf( )
Description Extracts the number value of the number object as an integer.
Return Integer.
Example This example creates a number object, and then converts it back to an integer,
which is held in the variable intNum.

Object object
Object Allows you to create an instance of an object that is set depending on the type
of value that is passed in as a parameter.
Syntax To use an Object property:
Object.propertyName
To use an Object method:
Object.MethodName( parameter )
Description The actual object that is created when using this constructor varies depending
on the parameter that is supplied. For example, if you supply a Boolean value
such as true (new Object(true); ) a Boolean object is created. The only
time that an actual Object object is created is when no value or null is supplied
as the constructor parameter.
265
Object methods
To create a new Object object, use:

myObj = new Object ( [parameter] );
Example This example creates several different objects:

Object methods
The Object object has these methods:
toString method
Syntax Object.toString( )
Description Returns the value of the object as a string.
Return String.
Example To display the value of the myObj object:

266
valueOf method
Syntax Object.valueOf( )
Description Extracts the value of the object.
Return Integer.
Example To return the value of the myObj object:

recipient object
Object Represents the recipients of a mail piece.
Syntax To use a recipient property:
recipient.propertyName
Description Use the recipient object to view the names and delivery mode of the recipients
mail piece.
Example This example checks the name and mode of the recipients of the mail piece:

See also “recipients property” on page 230.
“attachment object” on page 80.
267
recipient properties

recipient properties
The recipient object has these properties:
mode property
Syntax recipient.mode
Description Identifies the type of delivery.
Mode can be one of:
• to recipient is the main target of the mail piece.
• cc recipient is being carbon-copied.
• bcc recipient is being blind carbon-copied.
Return String.

268
name property
Syntax recipient.name
Description The name of the recipient for a mail piece.
Return String.

query object
Object Provides a scriptable way to work with a SQL query embedded in a Dynamo
template.
Syntax To use a query's property:
query.propertyName
To use a query's method:
query.MethodName( parameter )
Description Each embedded query has a name (by default, SQL). In scripts following the
embedded query, you can obtain and change information about the query by
working with the query object of the same name.
269
query object
You can also create a query object from within a script. To do this, use
connection.CreateQuery.
Example The following query prints out the number of rows in a result set:


In this example, the query has the default name of SQL. If the SQL tag
explicitly specified a name, as in:


</BODY>
</HTML>
This query has the default name SQL; Columns and rows are numbered starting
at 1.
• The HTML table tags used in this example are:
• <TABLE> and </TABLE> mark the start and end of the table.
• <TR> and </TR> mark the start and end of a table row.
• <TH> and </TH> mark the start and end of a table heading cell.
• <TD> and </TD> mark the start and end of a table data cell.
• The while statement is used to loop over the rows of the table.
• The for statement is used to loop over the columns of each row.
query properties
The query object has this property:
connection property
Syntax query.connection
Description The connection object used to execute the query.
271
query properties
Example This example displays the name of the connection used to execute the query:



“CreateQuery method” on page 99.
cursorType property
Syntax query.cursorType
Description Use this property when you are executing stored procedures in a Microsoft
SQL Server database that return multiple result sets. The cursorType must be
set to ForwardOnly to avoid problems during execution.
Example This example executes a stored procedure that returns multiple results sets
from a Microsoft SQL Server database:

See also “CreateQuery method” on page 99.
272
stripTrailingBlanks property
Syntax query.stripTrailingBlanks
Description Use this property to strip trailing blanks from query data. This property is quite
useful when executing queries against databases that have trailing blank
characters such as Adaptive Server Enterprise. The stripTrailingBlanks
property may be set to true or false. False is the default.
Example This example executes a query against an Adaptive Server Enterprise database
and strips that trailing blanks from the output:

[Baseball Cap]
[Shorts]
[Sweatshirt]
[Tee Shirt]
[Visor]
Without stripping the trailing blanks, the output might look like this:
[Baseball Cap ]
[Shorts ]
[Sweatshirt ]
[Tee Shirt ]
[Visor ]
You can also use the stripTrailingBlanks property in conjunction with
the ResultsToXMLString:

See also “CreateQuery method” on page 99.
273
query methods
query methods
The query object has these methods:
Close method
Syntax query.Close( )
Description Closes the active query. To reestablish the query you must execute it again.
Closing a query
A query is automatically closed when the query object (myQuery in the
following example) goes out of scope. Typically, this is at the end of the script.
succeeded or not.
Example This example executes a query, then closes it.

Execute method
Syntax query.Execute( )
Description Executes the current query object’s SQL statement.
succeeded or not.
Example This example prepares a query using a SQL tag with the attribute NO_EXECUTE,
and later executes the query from within a SCRIPT tag:


274
GetColumnCount method
Syntax query.GetColumnCount( )
Description Returns the number of columns in the query result set.
Example This example writes out the labels for each column within the result set of the
query:

GetColumnIndex method
Syntax query.GetColumnIndex(colName )
Description Returns the index of the column named colName [case-insensitive string] in
the query, where the first column’s index is 1.
Return Integer. If no match is found, returns false.
Example This example displays the index of the fname column:

2
GetColumnLabel method
Syntax query.GetColumnLabel(colNum)
Description Returns the column name or column alias (as specified in the SQL query) for
the colNum column. Columns are numbered starting with 1.
Return String. Returns the column name or alias.
275
query methods
Example This example writes out the labels for each column within the result set of the
query:

GetEmpty method
Syntax query.GetEmpty( )
Description Indicates if the result set is empty.
Note
If no Move method has yet been called on the query object, calling GetEmpty
moves the cursor to the first row of the result set.
Return Boolean. This method returns true if the result set is empty.
Example This example performs two queries and then displays one of two outputs,
depending on the result of the query:



There are some white products.
There are no red products.
276
GetErrorCode method
Syntax query.GetErrorCode( )
Return Integer. Returns zero if a SQL instruction is carried out correctly, and
information to which the script can respond if it fails.
Example This example displays a message that indicates whether the query was
successfully executed or not:


GetErrorInfo method
Syntax query.GetErrorInfo( )
Description A description of the error.
Return String.
Example This example displays a message indicating why the query failed:

[Sybase][ODBC Driver]: column ’badname’ not found
GetRowCount method
Syntax query.GetRowCount( )
277
query methods
Description The number of rows in the result set of the current query.
[Adaptive Server Enterprise]

Row count is not always available for some database servers, including
Adaptive Server Enterprise. If unavailable, a return of -1 will be given.
Example This example displays the number of products in the query result set:


GetState method
Syntax query.GetState( )
Description Returns the current SQL state of the query.
The values returned by GetState depend on your database driver. For more
information, see your database’s documentation.
Example This example displays the SQL state for the query:


The output is:
S0022
GetValue method
Syntax query.GetValue(colNum|colName)
Description Returns the value in the colNum [integer] or colName[string] column of the
current row of the result set.
Example This example displays a list of first and last names.
278


The output from this example looks something like this:
Devlin,Michaels
Reiser,Beth
Niedringhaus,Erin
Mason,Meghan
McCarthy,Laura
Phillips,Paul
Colburn,Kelly
Goforth,Matthew
Gagliardo,Jessie
Agliori,Michael
Ricci,Dylan
...
Move method
Syntax query.Move(rowNum )
Description Changes the current row to the rowNum [integer] row of a query result set.
279
query methods
Cursor support for some database servers

The cursor support of some database servers, including Adaptive Server
Enterprise, is not as extensive as that of Adaptive Server Anywhere, and some
of the Move functions are unavailable.
To use Move, MoveFirst, MoveLast, MovePrevious, or MoveRelative
with these database servers you can simulate the cursor abilities of Adaptive
Server Anywhere. To do this for all connections, modify your registry. From
your system’s Registry Editor, open the following file:
"yes".
To do this for a specific connection, use the simulateCursors property of

the connection object.
Using simulated cursors will cause a decline in performance. When possible,
use MoveNext instead of modifying your Registry settings.
succeeded or not.
Example This example displays the data in the fifth row of the result set:


MoveFirst method
Syntax query.MoveFirst( )
Description Changes the current row to the first row of a query result set.
280

"yes".

succeeded or not.
Example This example moves through each of the rows of a query result set and
repositions at the first row.


See also “simulateCursors property” on page 95.
MoveLast method
Syntax query.MoveLast( )
Description Changes the current row to the last row of a query result set.
281
query methods

"yes".

succeeded or not.
Example This example displays the results of a query from the end of the result set to the
beginning:


See also The “simulateCursors property” on page 95.
MoveNext method
Syntax query.MoveNext( )
Description Changes the current row to the next row of a query result set.
282
succeeded or not.
Example This example displays the data in each row of a query result set.


MovePrevious method
Syntax query.MovePrevious( )
Description Changes the current row to the previous row of a query result set. This is a
method of the query object.

"yes".

succeeded or not.
283
query methods
Example This example displays the results of a query from the end of the result set to the
beginning:


See also “simulateCursors property” on page 95.
MoveRelative method
Syntax query.MoveRelative(relativeRowNum)
Description Moves to a row that is relativeRowNum [integer] rows before or after the
current row of a query result set.

your system's Registry Editor, open the following file:
"yes".

succeeded or not.
284
Example This example displays the data in the row that is sixth from the end of the
rowset and then the second last row of the rowset:


Opened method
Syntax query.Opened( )
Description Indicates whether a query object is open. The query object is opened either by
calling the Execute method on the query, using the site.CreateQuery method,
or by executing the query through a SQL tag.
Return Boolean. This method returns true if a query object is open.
Example This example displays whether the query was successfully opened:


Refresh method
Syntax query.Refresh( )
Description Reexecutes the current query and obtains a new result set. This may or may not
reset the current cursor. If the cursor cannot be moved to the current row
(because, for example, the row has been deleted), the cursor is moved to the
first row of the result set.
285
query methods
To guarantee that the cursor is at the beginning of the result set after calling
Refresh, you must call MoveFirst (or Move(0)).
succeeded or not.
Example This example executes the same query choice twice; once via the SQL tag, and
once via the refresh method:


ResultsToXMLString method
Syntax query. ResultsToXMLString ( [resultSetTag, rowTag, columnTag,
useCDATA ] )
Description Returns the result of a query formatted as an XML string.
The parameters for this method are:
• resultSetTag The tag surrounding the full result set. If no tag is
specified, SYBRESULTSET is used.
• rowTag The tag for defining a row. If no tag is specified, SYBROW is
used.
• columnTag The tag for defining a column. If no tag is specified, the
column's label is used.
• useCDATA Instructs Dynamo to encode characters using CDATA to
escape special XML characters. If use_CDATA is not specified, characters
are encoded using the ampersand method.
Return String. The result set is returned as an XML formatted string.
Example This example performs a query and returns the results as an XML string:

The output from this example looks similar to this (line breaks have been added
for display reasons, but do not normally occur):
<MYRESULTSET>
<MYROW><MYCOLUMN>Cloth
Visor</MYCOLUMN><MYCOLUMN>White</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>Cotton
Cap</MYCOLUMN><MYCOLUMN>Black</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>Cotton
Shorts</MYCOLUMN><MYCOLUMN>Black</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>Crew
Neck</MYCOLUMN><MYCOLUMN>Black</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>Hooded
Sweatshirt</MYCOLUMN><MYCOLUMN>Green</MYCOLUMN></MYROW
>
<MYROW><MYCOLUMN>Plastic
Visor</MYCOLUMN><MYCOLUMN>Black</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>Tank
Top</MYCOLUMN><MYCOLUMN>White</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>V-
neck</MYCOLUMN><MYCOLUMN>Orange</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>Wool
cap</MYCOLUMN><MYCOLUMN>White</MYCOLUMN></MYROW>
<MYROW><MYCOLUMN>Zipped
Sweatshirt</MYCOLUMN><MYCOLUMN>Blue</MYCOLUMN></MYROW>
</MYRESULTSET>
SetSQL method
Syntax query.SetSql(sqlStatement )
Description Sets the SQL statement in the current query object to sqlStatement [string].
succeeded or not.
Example This example issues two queries by reusing the same query object:

session object
Object The session object is a special object that the Web site uses to store
information about a session for a given Web client.
Syntax To use a session property:
session.propertyName
Description The session object provides a way of maintaining information while a user of
your site navigates through a set of pages.
Web connections and Web connections are typically sessionless – from your Web client, you can
sessions jump from one Web site to another (and back) at any time. The Web site never
knows exactly when you've ended your “session” with it.
It is desirable, though, to maintain some concept of a session between the Web
client and the Web site. If you, as the Web site, set up a welcome page that asks
the user to log in with a name and password, each of the pages that you then
make available to them must “know” somehow that the user has already logged
in. If, however, they haven't logged in (or haven't logged in recently), the site
needs a way of detecting this to force them to log in again.
Duration of a session The Dynamo session object provides a way of storing session information so
that it persists for the duration of this particular client-to-site connection.
Because there is no explicit end to a session, though, the duration of the
connection must be decided arbitrarily. Session objects are created once they
are accessed.
By default, Dynamo considers a session to last five minutes from the time of
the user's last action at a given Web site (you can change this default duration
globally or for specific session objects). For the duration of a session, the site
maintains information about the user's connection – a login name, their last
action, or whatever other information the site requests from the client.
288
The site stores session information in a session object – one object for each
client. A session object is accessible to all Web pages in the site, so they can
check its status as they require. After the specified duration elapses (or times
out), the session object associated with the client goes away. Web pages
accessing the object are still able to query the session object to determine that
the session has ended (no longer exists). Null would be returned in this case.
Using the session The session object has only one predefined property (timeOut). You define
object the additional properties that you want to keep track of during a client's session.
The session information itself typically comes from client input such as an
HTML form. A login page, for example, might prompt a user for a name and
password.
To check whether or not there is session information available, use:
if ( exists(session) ){
...
The client sends the requested information as a URL with arguments. For
example:
http://www.acme.com/check_login.htm?username=hsimpson&
password=doh
The receiving document (in this case, check_login.htm) can then read the
incoming values, look them up in a password list or database table, and set a
property in the session object accordingly. For example, if the user's login is
correct, the following statement sets a user-defined property called
loginCorrect:
session.loginCorrect = true;
Until the session times out, other pages can then check the
session.loginCorrect property each time they load. For example:

For a working example of the session object used in a login page, see the
sample application in the /Site/app folder of the Dynamo demo database.
289
session property
Using cookies for Internally, Dynamo implements the session object using cookies, which are
sessions small chunks of information passed between a particular Web client and Web
site. A cookie provides a way for the site to remember information about that
client’s session. For more information on cookies and how they store persistent
information for a Web connection, see the Netscape Web site at
http://www.netscape.com.
session property
The session object has this property:
timeOut property
Syntax session.timeOut
Description The duration of the session (in minutes). This property exists only if the
timeOut value has been changed from the default of five minutes. To check if
this property exists, use:
if ( exists (session.timeOut)) {
. . .
For more information on Dynamo's default cookie timeout see “Changing
Dynamo configuration settings” in PowerDynamo User’s Guide.
Each session instance can set its own timeOut value.
Example This script sets a time out of 10 minutes for the session object after a user’s
login has been validated:

290
site object
Object Describes a Web site. Using the site object, you can manage documents and
database connections in your site, and customize the management interface to
suit your needs.
Syntax To use a site property:
site.propertyName
To use a site method:
site.MethodName( parameter )
Description Only one site object allowed

You cannot create additional site objects in your scripts.
Script-based Management of Dynamo Web sites is driven by scripts. The site object
management provides methods that allow you to perform common management tasks:
• Creation and management of templates and scripts in your Web site.
• Creation and management of the connections to the databases providing
the live content for your Web site.
• Creation and modification of wizards and property sheets to suit your
work style and content needs.
• Addition of menu items and icons to the Sybase Central interface, to use
the wizards that you create.
Managing documents In a Dynamo Web site, you can manage documents and database connections
and connections either by using Sybase Central or by writing your own scripts. In either case,
the site object is responsible for the basic management tasks:
• Documents are manipulated using CreateDocument,
DeleteDocument, and GetDocument.
• Database connections are manipulated using CreateConnection,
DeleteConnection, and several GetConnection variants.
Customizing the Because the Dynamo management tools are script-based, you can alter these
management interface scripts or create new ones to tailor the interface to your needs:
• You can create your own wizard dialogs using CreateWizard.
291
site properties
You can examine how Dynamo constructs its own wizards by inspecting
the NewTempl.ssc, NewConn.ssc, and NewFold.ssc scripts in the
Site/system folder.
• You can create your own controls (icons, menu items, and so on) by using
the OnEvent method.
You can examine how Dynamo adds its own controls at startup by
inspecting the Autoexec.ssc script in the Site/system folder.
Example This example creates a new connection called myConnection, and then
creates a new document in the Web site to use the new connection. The contents
of the new document is the word “hello”:

See also For more information on the document object, see “document object” on page
126.
For more information on the connection object, see “connection object” on
page 87.
site properties
The site object has this property:
type property
Syntax site.type
Description Indicates if the site type is of database or dynamic file.
Example This example displays the type of site that is being used by the sample Dynamo
application:

292

database
site methods
The site object has these methods:
AskQuestion method
Syntax site.AskQuestion (title, message)
Description Displays a message with Yes and No buttons. This method is supported only
when executing documents through Sybase Central.
Return Boolean. Returns true if the user picked Yes, and false otherwise.
Example To ask the user if he would like to continue:

CopyDocument method
Syntax site.CopyDocument (source document, destination document)
Description Copies a document from one location to another. The destination document
may be given a name other than the source document name when being copied.
The specified path may be a relative or an absolute path or the tilde (~)
character may be used. This is a method of the site object.
For information on using the tilde character see “Paths” on page 73.
Return Boolean.
Example This example takes a copy of form.stm and places it into a folder called Forms
with the new name form_new.stm:

CreateConnection method
Syntax For ODBC connections:
site.CreateConnection(connName, description, dataSource [,
userName, password, type, connectParameters])
For Open Client connections:
site.CreateConnection(connName, description, server, userName,
password, type [, database])
Description Creates a new persistent connection and returns a new connection object,
where:
• connName [string] is the name of the connection.
• description [string] is a comment for the connection object.
• dataSource [string] is the name of the ODBC data source (not applicable
to Open Client connections),
or
server [string] is the server name of the Open Client connection (not
applicable to ODBC connections).
• userName [string] is the name of the database user (optional for ODBC
connections).
• password [string] is the password of the database user (optional for ODBC
connections).
• type [string] is the type of connection, can be ODBC or Open Client. The
default is ODBC.
• connectParameters [string] are the parameters for connecting to the
database (optional for ODBC connections, not applicable to Open Client
connections).
• database [string] is the name of the database to which to connect (optional
for Open Client connection; not applicable to ODBC connections).
294
CreateConnection and DeleteConnection

You cannot delete a connection that a script is actively referencing.
Because of this, do not use CreateConnection and DeleteConnection in the
same script unless the connection object has gone out of scope, or has been
set to null by the time DeleteConnection is called.
If the data source or server is blank, the connection inherits the necessary
information from the main connection (the connection used by Dynamo to
access the Web site documents). The connection object returned by
CreateConnection in this case is “incomplete” and cannot be used to create
a query. To obtain a connection object with the blank fields filled in, use
site.GetConnection.
Temporary connection
To create a temporary connection, use the connection constructor. See
“connection object” on page 87 for more information.
Return Connection object representing the newly created connection, or null if the
connection cannot be created.
Typical reasons for null to be returned are:
• A connection of the given name already exists.
• A successful connection could not be made to the database using the
parameters supplied.
Example This script creates a new ODBC connection to the sample database, and uses
the new connection to execute a query.

<HTML>
<TITLE>Query of the sample database </TITLE>
<BODY>
<H1>Information regarding the management team</H1>

<TABLE BORDER>
<TR>
<TH>manager_id</TH>
<TH>emp_lname</TH>
<TH>emp_fname</TH>
<TH>salary</TH>
</TR>
</TABLE>
</BODY>
</HTML>
CreateDocument method
Syntax site.CreateDocument(docName, documentType, description, content [,
connectionName | connectionId])
Description Creates a new document in the Web site and returns a document object. The
parameters are:
• docName [string] is the name of the document. docName can be a relative
or an absolute path or the tilde (~) character may be used (see “Paths” on
page 73).
Example: "/Site/test/customer.stm"
• documentType [string] is the type of document (see document.type).
• description [string] is a comment for the document object.
If the documentType is directoryLink, description is the directory path
of the disk-based folder.
• content [string] is the document content (source).
• connectionName | connectionId [string | integer] is the name or ID of a
connection object, representing the database to which the document will
connect (optional).
296
Note:
Connection IDs are not persistent. If you restart Dynamo, connection IDs may
not be the same. For this reason, we recommend the use of connection names
whenever possible.
CreateDocument and DeleteDocument:

You cannot delete a document that a script is actively referencing. Because of
this, do not use CreateDocument and DeleteDocument in the same script unless
the document object has gone out of scope, or has been set to null by the time
DeleteDocument is called.
Return Document object representing the newly created document, or null if the
document cannot be created.
A typical reason for null to be returned is that a document by that name already
exists.
Example This script creates a new template called MyDoc.stm inside the Site folder. The
new document will consist of the word “hello”.

See also “document object” on page 126.
CreatePropertySheet method
Syntax site.CreatePropertySheet(propertySheetObject)
Description Starts the property sheet defined by propertySheetObject, where
propertySheetObject is an indexed object, and each array element in it
represents a separate property sheet page with the following properties:
• type Type of input required for the page. One of:
• text Single-line text box.
• password Single-line text box with typed characters shown as
asterisks (for security).
• textArea Multi-line text box.
297
site methods
• choice Combo box of values (uses choices).

• sql SQL-query textArea with button to open query editor.
• fileBrowse Single-line text box with Browse button to open
standard file-selection dialog.
• directoryBrowse Single-line text box with Browse button to
open standard folder-selection dialog.
• explanation [string] Explanatory text for the page (ignored if the type is
sql).
• question [string] Text that prompts for the value (ignored if the type is
sql).
• choices [array] The enumerated values for the combo box (if type is
choice).
• selected [integer] The number of the element of the choices array that
is selected by default when the wizard page is displayed (if type is
choice).
• help [string] The help that you would like displayed for the page. The
help is displayed by right clicking on the page.
• value The value entered by the user when the property sheet is created.
This method is supported only when executing documents from within Sybase
Central.
You can find the following propsht.ssc class file in the /system/utils directory
of your site folder:

Return Boolean. Returns true or false, indicating whether the user proceeded through
the wizard or not.
Example This example shows how a script can use the site object to create a property
sheet.

CreateWizard method
Syntax site.CreateWizard(wizardObject)
Description Starts the wizard defined by wizardObject, where wizardObject is an indexed
object, and each array element in it represents a separate wizard page with the
following properties:
• type Type of input required for the page. One of:
• text Single-line text box.
• password Single-line text box with typed characters shown as
asterisks (for security).
• textArea Multi-line text box.
• choice Combo box of values (uses choices).
• sql SQL-query textArea with button to open query editor.
• fileBrowse Single-line text box with Browse button to open
standard file-selection dialog.
• directoryBrowse Single-line text box with Browse button to
open standard folder-selection dialog.
• explanation [string] Explanatory text for the page (ignored if the type is
sql).
• question [string] Text that prompts for the value (ignored if the type is
sql).
301
site methods
• choices [array] The enumerated values for the combo box (if type is
choice).
• selected [integer] The number of the element of the choices array that
is selected by default when the wizard page is displayed (if type is
choice).
• next [integer, string, or function] The page to go to when the user presses
the “Next” button. Usually used to validate input or select a different
branch of the wizard. An integer represents an index to a wizard page, a
string represents the name of a wizard page, and a function can return
either an integer or a string that indicates which page to go to.
• help [string] The help that you would like displayed for the page. The
help is displayed by right-clicking in the page.
• value The value entered by the user when the wizard is created.
This method is supported only when executing documents from within Sybase
Central.
You can find the following wizard.ssc class file in the /system/utils directory of
your site folder:

303
site methods
Return Boolean. Returns true or false, indicating whether the user proceeded through
the wizard or not.
Examples This example shows how a script can use the site object to create a wizard.
Each page contains a single item:

This example uses the wizardAdvanced class and the itemPosition class while
creating a wizard that asks users for their mailing address. The
wizardAdvanced class is used to create wizards that have multiple items per
page:

This example uses the next element to conditionally choose which wizard
page should be displayed next:

DeleteConnection method
Syntax site.DeleteConnection(connName)
Description Deletes the persistent connection defined by connName.
CreateConnection and DeleteConnection

You cannot delete a connection that a script is actively referencing. Because of
this, CreateConnection and DeleteConnection should not be used in the same
script unless the connection object has gone out of scope, or has been set to null
at the time DeleteConnection is called.
succeeded or not.
Typical reasons for false to be returned include:
• A connection by that name does not exist.
• The connection is in use.
Example This example deletes the connection named MyConnection:

DeleteDocument method
Syntax site.DeleteDocument(docName)
Description Deletes the document object defined by docName. docName may contain the
wildcard characters * and ? and can be an absolute or relative path. The tilde
(~) may also be used.
For information on the * and ? wildcards see “Wildcards” on page 73.
309
site methods
CreateDocument and DeleteDocument

You cannot delete a document that a script is actively referencing. Because of
this, CreateDocument and DeleteDocument should not be used in the same
script unless the document object has gone out of scope, or has been set to null
at the time DeleteDocument is called.
succeeded or not.
Typical reasons for false to be returned include:
• A document by that name does not exist.
• The document is in use.
Example This example deletes a document called MyDoc.stm from within the Site
folder.

GetConnection method
Syntax site.GetConnection(connName | connId)
Description Returns the connection object representing the persistent connection called
connName[string], or having id connId[integer].
Note:
Connection IDs are not persistent. If you restart Dynamo, connection IDs may
not be the same. For this reason, Sybase recommends the use of connection
names whenever possible.
Return Connection object representing the specified connection, or null if the

connection cannot be retrieved.
Typical reason for null to be returned include:
310
• The specified connection does not exist.

• A successful connection to the database could not be made.
Example This example changes the database to which “myConnection” connects:

GetConnectionIdList method
Syntax site.GetConnectionIdList( [true|false] )
Description Returns an array of IDs of connection objects. If true is specified, the list of
connection IDs will include IDs representing the special connections <no
connection> and <inherited>. If false is specified, the list of connection IDs
does not include IDs representing the special connections. The default is true.
Return Array of integers.
Example To display a list of connection IDs.

GetConnectionNameList method
Syntax site.GetConnectionNameList( [true|false] )
Description Returns an array of names of connection objects. If true is specified, the list of
connection names includes the two special connections <no connection> and
<inherited>. If false is specified, the list does not include the special
connections. The default is true.
Return Array of strings.
Example This script displays the list of connection names.

GetDocument method
Syntax site.GetDocument(docName | docId)
Description Returns the document object defined by docName [string] or docId [integer].
docName may be a relative or an absolute path or you can use the tilde (~)
character. For more information on using the tilde please see “Paths” on page
73.
Note:
IDs are not guaranteed to be the same after restarting the Web server. For this
reason, Sybase recommends that you use the document name to identify
documents.
Return Document object representing the specified document, or null if the document
could not be retrieved. A typical reason for null to be returned is that the
specified document does not exist.
Example This script retrieves the document MyDoc.stm from within the Site folder,
passes a login name and password to MyDoc.stm, executes MyDoc.stm, and
displays the output:

GetErrorCode method
Syntax site.GetErrorCode( )
Return Integer. Returns an error code associated with the last operation performed.
Example This example displays information as to why the connection was not created
successfully:
312
<HTML>
<BODY>

</BODY>
</HTML>
“connection properties” on page 90.
GetErrorInfo method
Syntax site.GetErrorInfo( )
Description A description of the error associated with the last operation performed.
Return String.
Example This example displays information as to why the connection was not created
successfully:
<HTML>
<BODY>

</BODY>
</HTML>>
“query object” on page 269.
“query properties” on page 271.
“connection properties” on page 90.
GetEventList method
Syntax site.GetEventList([controlType])
Description Returns an array of all controlType event handlers currently installed (by
OnEvent). If controlType is not specified, all installed event handlers are
returned.
controlType is described in the OnEvent method.
Each event handler object contains read-only properties that correspond to the
parameters of the OnEvent method. The only difference is the handlerScript
property, which always has an absolute path, regardless of how it was initially
specified with OnEvent.
Return Array of event handler objects.
Example This example uses GetEventList to display all previously created event
handlers with the control type of Icon.

GetRootDocument method
Syntax site.GetRootDocument( )
Description Returns the document object representing the root document of the Web site (in
most cases, the Site folder).
Return Document object.
Example This script executes a template called MyDoc.stm which resides in the root
directory of the Web site:

GetState method
Syntax site.GetState( )
Description Returns information about the SQL state of the last query operation performed.
GetState is meaningful only if the most recent error was database-related.
Example This example displays the state of the most recent Dynamo database error:
<HTML>
<BODY>


</BODY>
</HTML>
Include method
Syntax site.Include(scriptName)
Description Executes the specified script and returns a string containing the generated
output of scriptName (absolute or relative path).
Return String.
Example This executes the script sample.ssc and returns the generated output.

See also “site object” on page 291.
“site properties” on page 292.
“GetGenerated method” on page 138.
OnEvent method
Syntax site.OnEvent(itemName, controlType, controlLabel, description,
handlerScript)
Description Adds an event handler to the management interface (typically for creating an
icon or menu item in Sybase Central), where:
• itemName is the type of item to which the control applies. One of:
• connection Any connection.
• connectionFolder The connection folder.
• directory Any document folder.
• image Binary data (not script or template).
• script Any script.
• site The Web site database (not the Web site folder).
316
• text Any template.

• controlType is one of:
• Get Command that comes from the Web server when a document is
requested. Applies only to directory, image, script, and text
item types.
• NewMenu Displays from a new menu option, within a menu.
• ContextMenu Menu that appears when you right-click.
• Icon Only for site, directory, and connectionFolder.
• Status404 Occurs when a request for a document is made that is
not available.
• Parser Occurs when a request for a document generates an error.
• SessionTimeOut Occurs just before a session times out. This
controlType applies to the site itemType. The parameters
controlLabel and description are not applicable.
• controlLabel is the visible name of the control. This does not apply to the
control type of Get, Status404, or SessionTimeOut.
• description is a comment for the control that displays as help on the
Sybase Central status bar. This does not apply to the control type of Get
or Status404.
• handlerScript is the script to trigger when the control is used. The path
name is relative to the script from which the OnEvent method is called.
succeeded or not.
Example For example, the following code is added to the autoexec.ssc file in the System
folder to create an icon to execute the wizard created in the site method
CreateWizard example.
//Example Wizard
site.OnEvent( ’directory’,’Icon’,’Dynamo Example for
Creating Wizards’,’Wizard Example’,’NewLink.ssc’ );
This example, if added to the autoexec.ssc file, would cause the execution of
the cleanup.ssc script just before a session times out:
site.OnEvent( ’Site’, ’SessionTimeOut’, ’ ’, ’ ’,
’cleanup.ssc’ );
317
site methods
error.ssc whenever a request was made for a document that generates an error:
site.OnEvent(’’,’Parser’,’’,’’,’error.ssc’);
notfound.ssc whenever a request was made for a document that could not be
found:
site.OnEvent(’’,’status404’,’’,’’,’notfound.ssc’);
Execute from /system/autoexec.ssc

You should only call the OnEvent method from /system/autoexec.ssc or
from another script that is executed from within the autoexec script.
RenameDocument method
Syntax site.RenameDocument(source document, destination document)
Description Takes source document, renames and saves it in destination document (i.e.
source document is moved). The specified path may be a relative or an absolute
path or the tilde (~) character may be used. This is a method of the site object.
For information on using the tilde character, see “Paths” on page 73.
Return Boolean.
Example This example moves forms.stm from the root of the Web site, renames it to
test.stm and places it in the Sample location:

ShowMessage method
Syntax site.ShowMessage (title, message)
Description Displays a message with an OK box. This method is supported only from
within Sybase Central.
Example This example displays the message “Task complete”.

318
String object
Object Enables manipulation and formatting of strings as objects and objects as
strings.
Syntax To use a String method:
String.MethodName( parameter )
Description You can call String object as a function:
String( value );
or as a constructor:
myString = new String( value );
When called as a function, a type conversion is performed and a string is
returned. A new String object is not created. When a String object is created
through a constructor a String object is returned.
Example This example creates a new String object:

String methods
The String object has these methods:
charAt method
Syntax String.charAt( position )
Description Returns the character in the string located at position. The position is 0 indexed.
Return Character.
Example This example displays the character e:

319
String methods
indexOf method
Syntax String.indexOf( substring [, position] )
Description Searches for substring within a string. You can optionally specify the position
that the search is to begin. If not specified, the search begins at 0.
Return An integer indicating the start location of the substring. If the substring is not
found, -1 is returned.
Example This example has a return of 3:

lastIndexOf method
Syntax String.lastIndexOf( substring [, position] )
Description Searches for the last occurrence of a substring within a script. The position that
the search is to begin may be optionally specified. If not specified, the search
will begin at 0.
Return An integer indicating the start location of the last substring found. If the
substring is not found, -1 is returned.
Example This example has a return of 14:

split method
Syntax String.split( separatorString )
Description Separates a string at the separatorString and returns the resulting substrings as
an Array object. The separatorString characters are not part of the returned
substrings.
If an empty separator string is provided (“ ”) as the separator string, the string
is split into an array of chars.
320
Return An Array object.

Example This example splits a string each time the separator string ’split’is encountered:

The output from this example looks similar to:
{ This string will , each time the string ’, ’ is
encountered }
substring method
Syntax String.substring( start )
Description Returns a substring value that is extracted from the string object starting at the
start value (numeric position) and continuing to the end of the string object.
Return String.
Example This example returns “hello”:

substring method
Syntax String.substring( start, end )
Description Returns a substring value that is extracted from the string object starting at the
start value and ending (but not including) the end value.
Return String.
Example This example returns “world”:

toLowerCase method
Syntax String.toLowerCase( )
Description Converts a string object to an entirely lower-case string.
Return String.
Example This example returns of “hello, world hello”:

-->
toString method
Syntax String.toString( )
Description Returns the string value of the object.
Return String.
Example This example returns “Hello world, hello”:

toUpperCase method
Syntax String.toUpperCase( )
Description Converts a string object to upper case.
Return String.
Example This example will returns of “HELLO WORLD, HELLO”:

valueOf method
Syntax String.valueOf( )
Description Returns the string value.
Return String.
Example • This example returns “Hello world, hello”:

system object
Object Provides functionality for interacting with the server's operating system
environment.
Syntax To use a system property:
system.propertyName
To use a system method:
system.MethodName( parameter )
Description The system object is provided for you.
Example This example modifies the system path.
<--SCRIPT
// Adds e:\src to the Environment System Path
path = system.GetEnv( "PATH" );
path = path + "e:\src;";
system.SetEnv( "PATH", path, true );
-->
See also “errorNumber property” on page 190.
“errorString property” on page 191.
323
system properties
system properties
The system object has these properties:
errorNumber property
Syntax system.errorNumber
Description A number [integer] representing the error code of the last system method call.
Example This example displays an error code:

See also “errorString property” on page 191.
errorString property
Syntax system.errorString
Description A string containing an error message for the error code of the last system
method call. This is a read only property.
Example This example displays an error message:

See also “errorNumber property” on page 190.
system methods
The system object has these methods:
324
Exec method
Syntax system.Exec(cmd)
Description Executes a command outside the Dynamo Script Interpreter.
Return Boolean. Returns true or false indicating whether or not the call succeeded:
Example This example launches the Windows Notepad utility.
<--SCRIPT
// Launches notepad
system.Exec( "notepad.exe" );
-->
GetCWD method
Syntax system.GetCWD( )
Description Returns the current working directory.
Return String.
Example To return the current directory:

GetEnv method
Syntax system.GetEnv(env)
Description Searches the environment for an environment entry matching env, and returns
its value.
Return String or null if no matching entry found.
Example This example retrieves the environment’s PATH entry:

325
system methods
SetEnv method
Syntax system.SetEnv(env,value,overwrite)
Description Searches the environment for an entry matching env. If there is no such entry,
an entry is created and set to value; otherwise, if overwrite is true the entry
is set to value.
Example This example modifies the system path.

326
Index
Symbols atan2 method (Math object) 257

AttachData method (outgoing mail piece object) 248
* 73
AttachDocument method (outgoing mail piece object)
+ 41
248
+= 41
AttachFile method (outgoing mail piece object) 249
.. 73
attachment object
? 40, 73
about 80
~ 73
methods 82
properties 80
attachments property (incoming mail piece object) 228
Numerics attributes property (DOMNode object) 174
autoCommit property (connection object) 90
404 (not found) messages 316 Autoexec.ssc 292
A B
abs method (Math object) 256 backslash
absolute paths 73 special character 62
acos method (Math object) 256 base classes
ActiveX objects 59 about 69
AddRecipient method (outgoing mail piece object) body property (incoming mail piece object) 228
244 body property (outgoing mail piece object) 239, 244
AddReplyTo method (outgoing mail piece object) Boolean literals 35
247 Boolean object
apostrophe about 86
special character 62 methods 86
appendChild method (DOMNode object) 181 BORDER attribute (FORMATTING tag) 13
appendData method (DOMCharacterData object) break statements
148 about 48
arguments object 57 built-in functions 58
Array object
about 76
methods 77
properties 77 C
arrays
CACHED_OUTPUT_TIMEOUT attribute
about 67
(DOCUMENT tag) 9
asin method (Math object) 256
cachedOutputTimeOut property (document object)
AskQuestion method (site object) 293
127
atan method (Math object) 256
callee property (arguments object) 57
327
Index
CallStaticMethod method (java object) 217, 218, 220 connectionType property (connection object) 91
CDATA connectParameters property (connection object) 91
FORMATTING tag 13 CONTENT_TYPE attribute (DOCUMENT tag) 9
ceil method (Math object) 257 contentType property (document object) 128
chained mode 88 continue statement
ChangeCurrentDirectory method (FTP object) 198 about 48
charAt method (String object) 319 control characters in strings 36
childNodes property (DOMNode object) 174 controls
class statements creating 316
about 50, 69, 70 conventions
classes about xviii
about 66, 69 syntax xviii
instances 72 cookies for sessions 288
cloneNode method (DOMNode object) 181 CopyDocument method (site object) 293
Close method (file object) 193 cos method (Math object) 257
Close method (query object) 274, 275 count property (mailList object) 224
COLUMN_TAG attribute (FORMATTING tag) 13 createAttribute method (DOMDocument object) 153
COMMAND attribute (EXECUTE tag) 13 createCDATASection method (DOMDocument object)
comment statements 153
about 55 createComment method (DOMDocument object) 154
comments CreateComponent method 215
HTML 34 CreateComponent method (connection object) 98
Commit method (connection object) 97 CreateComponent method (java object) 215
COMPONENT (Dynamo tag) 4 CreateConnection method (site object) 294
COMPONENT_NAME attribute (COMPONENT tag) 5 CreateDirectory method (FTP object) 199
conditional SQL tags 28 CreateDocument method (site object) 296
Connect method (connection object) 98 createDocumentFragment method (DOMDocument
Connect method (FTP object) 198 object) 154
connected property (connection object) 90 createElement method (DOMDocument object) 155
connection object createEntityReference method (DOMDocument object)
about 87 155
methods 97 CreateObject function (built-in) 59
properties 90 CreateObject method (java object) 217
connection property (query object) 271 createProcessingInstruction method (DOMDocument
CONNECTION_NAME attribute (SQL tag) 23 object) 155
CONNECTION_NAME attribute (SQL_INSERT tag) 26 CreatePropertySheet method (site object) 297
CONNECTION_OBJECT attribute (COMPONENT tag) CreateQuery method (connection object) 99
5 createTextNode method (DOMDocument object) 156
CONNECTION_OBJECT attribute (SQL tag) 23 CreateWizard method (site object) 301
CONNECTION_OBJECT attribute (SQL_INSERT tag) cursorType property (query object) 272
26
connectionId property (document object) 127
connectionName property (document object) 128
connections D
site object 291 DATA
temporary 87 in HTML 8
328
Index
DATA (Dynamo tag) 8 DOMCDATASection object

data property (DOMCharacterData object) 147 about 146
data property (DOMProcessingInstruction object) DOMCharacterData object
186 about 146
database property (connection object) 92 methods 148
databaseType property (connection object) 92 properties 147
dataSource property (connection object) 92 DOMComment object
dataSourceList property (connection object) 93 about 150
datatypes for variables 37 DOMDocument object
Date object about 151
about 104 constructor 151
methods 106 methods 153
declaration properties 151
variables 37 DOMDocumentFragment object
Delete method (file object) 193 about 157
Delete method (incoming mail piece object) 233 DOMDocumentType
DeleteConnection method (site object) 309 temporary 158
deleteData method (DOMCharacterData object) 148 DOMDocumentType object
DeleteDocument method (site object) 309 about 158
DeleteFile method (FTP object) 199 properties 158
derived classes DOMElement object
about 70 about 160
description property (connection object) 93 methods 161
description property (document object) 128 properties 161
Disconnect method (connection object) 100 DOMEntity object
Disconnect method (FTP object) 200 about 166
Disconnect method (mailList object) 225 properties 166
doctype property (DOMDocument object) 151 temporary 166
DOCUMENT (Dynamo tag) 9 DOMEntityReference object
document object about 168
about 126 DOMImplementation object
methods 136 about 169
properties 127 methods 169
Document Type Definition DOMImplementations
DOMDocumentType object 158 temporary 169
documentation DOMNamedNodeMap object
conventions xviii about 170
online xvii methods 171
documentElement property (DOMDocument object) properties 170
152 DOMNode object
documents about 173
site object 291 methods 181
DOMAttribute object properties 174
about 143 DOMNodeList object
methods 146 about 183
properties 144 methods 184
Index
properties 183 SQL_ON_NO_ROWS 28

DOMNotation object SQL_ON_ROWS 28
about 184 SQL_STATE 31
methods 185 syntax 1
properties 185 Dynamo tags vs DynaScript 3
DOMProcessingInstruction object DynaScript
about 185 calling Jaguar components 98
methods 187 objects 66
properties 186 DynaScript vs Dynamo tags 3
DOMText object
about 187
methods 188
properties 188 E
temporary 187 E property (Math object) 252
do-while statement ELSE (Dynamo tag) 11
about 45 ELSEIF (Dynamo tag) 11
DSN, UID, PWD attribute (SQL tag) 23 encapsulation
DSN, UID, PWD attribute (SQL_INSERT tag) 26 about 66, 68
dynamic content ENDIF (Dynamo tag) 12
Dynamo tags 8 entities property (DOMDocumentType object) 158
dynamic files eof property (file object) 190
type property 292 errorNumber property (file object) 190
Dynamo tags errorNumber property (system object) 324
about 1 errorString property (file object) 191
COMPONENT 4 escape 65
conditional 28 escape function (built-in) 58
DATA 8 escaping characters in strings 36
DOCUMENT 9 eval function (built-in) 58
DynaScript equivalent 3 EVALUATE (Dynamo tag) 12
ELSE 11 Exec(cmd) method (system object) 325
ELSEIF 11 EXECUTE (Dynamo tag) 13
ENDIF 12 Execute method (query object) 274
EVALUATE 12 exists function (Dynamo built-in) 61
EXECUTE 13 exit statement
FORMATTING 13 about 56
IF 19 exp method (Math object) 258
INCLUDE 19 exponential literals 35
LABEL 20 ExportTo method (document object) 137
MAILPIECE 21 EXPR attribute (ELSEIF tag) 11
SCRIPT 22 EXPR attribute (EVALUATE tag) 12
SQL 23 expressions
SQL_ERROR_CODE 29 about 38
SQL_ERROR_INFO 30
SQL_INSERT 25
SQL_ON_ ERROR 28
SQL_ON_NO_ERROR 28
330
Index
F getAttributeNode method (DOMElement object) 162

GetColumnCount method (query object) 275
file object
GetColumnLabel method (query object) 275
about 188
GetConnection method (site object) 310
methods 193
GetConnectionIdList method (site object) 311
properties 189
GetConnectionNameList method (site object) 311
firstChild property (DOMNode object) 175
GetContents method (attachment object) 82
floating-point literals 35
GetCWD method (system object) 325
floor method (Math object) 258
getDate method (Date object) 106
for statements
getDay method (Date object) 106
about 44
GetDirectory method (document object) 137
for-in statements
GetDocument method (site object) 312
about 48
getElementsByTagName method (DOMDocument
FORMAT_AS attribute (FORMATTING tag) 13
object) 156
formatString function (built-in) 61
getElementsByTagName method (DOMElement object)
FORMATTING
162
XML 13
GetEmpty method (query object) 276
formatting
Getenv(env) method (system object) 325
data placeholders 8
GetErrorCode method (attachment object) 83
FORMATTING (Dynamo tag) 13
GetErrorCode method (connection object) 100
nesting 17
GetErrorCode method (FTP object) 200
forms
GetErrorCode method (incoming mail piece object)
passing variables 133
234
Forward method (incoming mail piece object) 233
GetErrorCode method (mailList object) 226
FROM attribute (MAILPIECE tag) 22
GetErrorCode method (outgoing mail piece object)
from property (incoming mail piece object) 229
250
from property (outgoing mail piece object) 240
GetErrorCode method (query object) 277
FTP object
GetErrorCode method (site object) 312
about 197
GetErrorInfo method (attachment object) 84
methods 198
GetErrorInfo method (connection object) 101
Function object
GetErrorInfo method (FTP object) 201
about 210
GetErrorInfo method (incoming mail piece object)
methods 212
235
properties 211
GetErrorInfo method (mailList object) 226
function statements
GetErrorInfo method (outgoing mail piece object) 250
about 52
GetErrorInfo method (query object) 277
functions
GetErrorInfo method (site object) 313
about 56
GetEventList method (site object) 314
arguments object 57
GetFilePtr method (File object) 194
built-in 58
getFullYear method (Date object) 107
defining classes 69
GetGenerated method (document object) 138
syntax 52, 53
passing parameters 138
GetHomeInterface method 218, 220
getHours method (Date object) 107
G getMilliseconds method (Date object) 107
getMinutes method (Date object) 108
getAttribute method (DOMElement object) 161
Index
getMonth method (Date object) 108 ImportFrom method (document object) 140
getNamedItem method (DOMNamedNodeMap object) INCLUDE 19
171 in HTML 19
GetRootDocument method (site object) 315 INCLUDE (Dynamo tag) 19
GetRowCount method (query object) 277 Include method (site object) 316
getSeconds method (Date object) 108 IncludeGenerated method (document object) 140
GetServerVariable method (document object) 138 INDEX attribute (LABEL tag) 19, 21
GetState method (connection object) 102 indexed and named members 72
GetState method (query object) 278 indexOf method (String object) 320
GetState method (site object) 315 inheritance
GetSupportedMoves method (connection object) 103 about 66, 68, 70
getTime method (Date object) 109 insertBefore method (DOMNode object) 182
getTimezoneOffset method (Date object) 109 insertData method (DOMCharacterData object) 149
getUTCDate method (Date object) 110 inserting data 26
getUTCDay method (Date object) 110 instances
getUTCFullYear method (Date object) 111 creating 66, 72
getUTCHours method (Date object) 111 integer literals 35
getUTCMilliseconds method (Date object) 111 interface
getUTCMinutes method (Date object) 112 customizing 291
getUTCMonth method (Date object) 112 isFinite function (built-in) 58
getUTCSeconds method (Date object) 113 isNan function (built-in) 59
GetValue method (query object) 278 isolationLevel property (connection object) 93
getYear method (Date object) 113 item method (DOMNamedNodeMap object) 171
item method (DOMNodeList object) 184
H
hasChildNodes method (DOMNode object) 182 J
hasFeature method (DOMImplementation object) 169 Jaguar
headers property (incoming mail piece object) 229 calling components 98
HTML COMPONENT tag 4
comments 34 JaguarL creating a component 215
HTML headers for functions 56 java object
about 212
methods 214
JavaScript
I tags 34
id property (document object) 129 JavaScript Authoring Guide
identifiers URL 33
about 36 join method (Array object) 77
IF (Dynamo tag) 19
if-else statements
about 44
implementation property (DOMDocument object) 152 L
import statements LABEL (Dynamo tag) 20
about 54, 57 lastChild property (DOMNode object) 176
332
Index
lastIndexOf method (String object) 320 properties 252

lastModified property (document object) 129 max method (Math object) 259
length property (arguments object) 57 MAX_VALUE property (Number object) 262
length property (Array object) 77 MAXROWS attribute (FORMATTING tag) 13
length property (DOMCharacterLength object) 147 members
length property (DOMNamedNodeMap object) 171 named and indexed 72
length property (DOMNodeList object) 184 methods
length property (Function object) 211 about 67
LIST attribute (FORMATTING tag) 13 inline vs. global 69
literals mimeType property (attachment object) 81
about 34 min method (Math object) 259
boolean 35 MIN_VALUE property (Number object) 263
floating-point numbers 35 mode property (file object) 192
integers 35 mode property (recipient object) 268
strings 35 Move method (query object) 279
LN10 property (Math object) 253 MoveFirst method (query object) 280
LN2 property (Math object) 253 MoveLast method (query object) 281
location property (document object) 130 MoveNext method (query object) 282
log method (Math object) 258 MovePrevious method (query object) 283
LOG10E property (Math object) 254 MoveRelative method (query object) 284
LOG2E property (Math object) 254 multiple values
logical literals 35 passing 133
M N
mail NAME attribute (DATA tag) 8
sending 21, 251 NAME attribute (FORMATTING tag) 13
mail piece object (incoming) NAME attribute (LABEL tag) 19, 21
about 227 name property (attachment object) 81
methods 233 name property (connection object) 94
properties 228 name property (document object) 130
mail piece object (outgoing) name property (DOMAttribute object) 144
about 238 name property (DOMDocumentType object) 159
methods 244 name property (file object 192
properties 239 name property (recipient object) 269
mailList named and indexed members 72
methods 225 NaN property (Number object) 263
mailList object NEGATIVE_INFINITY property (Number object)
about 223 264
properties 224 nesting
MAILPIECE (Dynamo tag) 21 FORMATTING tag 17
Math new features
methods 255 documentation xvii
Math object new operator
about 252 about 51, 72
Index
NewConn.ssc 291 DOMNodeList 183

NewFold.ssc 291 DOMNotation 184
NewTemp1.ssc 291 DOMProcessingInstruction 185
nextSibling property (DOMNode object) 176 DOMText 187
nodeName property (DOMNode object) 176 encapsulation 68
nodeType property (DOMNode object) 177 file 188
nodeValue property (DOMNode object) 179 for-in statement 48
normalize method (DOMElement object) 163 FTP 197
notationName property (DOMEntity object) 167 Function 210
notations property (DOMDocumentType object) 160 function statement 52
Number inheritance 68, 70
methods 264 instances 72
Number object java 212
about 261 mail piece (incoming) 227
properties 262 mail piece (outgoing) 238
mailList 223
Math 252
methods 67
O new operator 51
Object object Number 261
about 265 Object 265
methods 266 polymorphism 68
objects predefined 75
about 66 properties 66
Array 76 query 269
arrays 67 recipient 267
attachment 80 session 288
base classes 69 site 291
Boolean 86 String 319
class statement 50 system 323
connection 87 this keyword 51
Date 104 var statement 52
document 126 with statement 49
DOMAttribute 143 OnEvent method (site object) 316
DOMCDATASection 146 Open method (file object) 194
DOMCharacterData 146 Opened method (query object) 285
DOMComment 150 operators
DOMDocument 151 about 39
DOMDocumentFragment 157 arithmetic 40
DOMDocumentType 158 comparison 41
DOMElement 160 conditional 40
DOMEntity 166 new 51
DOMEntityReference 168 string 41
DOMImplementation 169 ownerDocument property (DOMNode object) 179
DOMNamedNodeMap 170
DOMNode 173
334
Index
P java 212
mail piece (incoming) 227
parent property (document object) 131
mail piece (outgoing) 238
parentNode property (DOMNode object) 180
mailList 223
parse method (Date object) 114
Math 252
parseFloat function (built-in) 59
Number 261
parseInt function (built-in) 59
Object 265
passing parameters 138
query 269
passing values 133
recipient 267
passing variables 56
session 288
password property (connection object) 95
site 291
path 73
String 319
PI property (Math object) 254
system 323
PKG attribute (COMPONENT tag) 5
prettyPrint method (DOMDocument object) 157
polymorphism
previousSibling property (DOMNode object) 180
about 66, 68
properties
POSITIVE_INFINITY property (Number object)
about 66
264
property sheets
pow method (Math object) 260
creating 297
predefined objects
publicId property (DOMEntity object) 167
about 75
publicId property (DOMNotation object) 185
Array 76
PutData method (FTP object) 201
attachment 80
PutDataWithAppend method (FTP object) 202
Boolean 86
PutDocument method (FTP object) 203
connection 87
PutDocumentWithAppend method (FTP object) 204
Date 104
PutFile method (FTP object) 205
document 126
PutFileWithAppend method (FTP object) 205
DOMAttribute 143
DOMCDATASection 146
DOMCharacterData 146
DOMComment 150 Q
DOMDocument 151
QUERY attribute (DATA tag) 8
DOMDocumentFragment 157
query object
DOMDocumentType 158
about 269
DOMElement 160
methods 274
DOMEntity 166
properties 271
DOMEntityReference 168
DOMImplementation 169
DOMNamedNodeMap 170
DOMNode 173 R
DOMNodeList 183
DOMNotation 184 random method (Math object) 260
DOMProcessingInstruction 185 Read method (file object) 195
DOMText 187 ReadChar method (file object) 195
file 188 ReadLine method (file object) 196
FTP 197 recipient object
Function 210 about 267
Index
properties 268 literals 34

recipients property (incoming mail piece object) 230 objects 66
recursion (callee property 57 operators 38, 39
REDIRECT attribute (DOCUMENT tag) 9 overview 33
Redirect method (incoming mail piece object) 235 statements 43
redirect property (document object) 131 tags 34
Refresh method (query object) 285 variables 36
relative paths 73 scripts
removeAttribute method (DOMElement object) 164 functions 56
removeAttributeNode method (DOMElement object) 164 importing 54, 57
removeChild method (DOMNode object) 182 objects 66
RemoveDirectory method (FTP object) 206 overview 33
removeNamedItem method (DOMNamedNodeMap object) tags 34
172 Seek(offset) method (file object) 196
RenameDocument method (site object) 318 semi-colons in statements 44
RenameFile method (FTP object) 207 Send method (outgoing mail piece object) 251
replaceChild method (DOMNode object) 183 sender property (incoming mail piece object) 231
replaceData method (DOMCharacterData object) 149 sender property (outgoing mail piece object) 242
Reply method (incoming mail piece object) 236 server property (connection object) 95
replyTo property (incoming mail piece object) 230 server variables 138
RESULTSET_TAG (FORMATTING TAG) 13 session object
ResultsToXMLString method (query object) 286 about 288
Retrieve method (incoming mail piece object) 237 properties 290
RetrieveCurrentDirectory method (FTP object) 206 setAttribute method (DOMElement object) 165
RetrieveData method (FTP object) 207 setAttributeNode method (DOMElement object) 165
RetrieveDirectoryListing method (FTP object) 208 setDate method (Date object) 114
RetrieveDocument method (FTP object) 208 SetEnv(env,value,overwrite) method (system object)
RetrieveFile method (FTP object) 209 326
RetrieveFileWithAppend method (FTP object) 210 setFullYear method (Date object) 115
return statements setHours method (Date object) 115
about 53, 56 setMilliseconds method (Date object) 116
reverse method (Array object) 78 setMinutes method (Date object) 116
Rollback method (connection object) 103 setMonth method (Date object) 117
round method (Math object) 260 setNamedItem method (DOMNamedNodeMap object)
ROW_TAG attribute (FORMATTING tag) 13 172
setSeconds method (Date object) 118
SetSQL method (query object) 287
setTime method (Date object) 118
S setUTCDate method (Date object) 119
SaveAsDocument method (attachment object) 84 setUTCFullYear method (Date object) 120
SaveAsFile method (attachment object) 85 setUTCHours method (Date object) 121
scoping setUTCMilliseconds method (Date object) 121
methods 67 setUTCMinutes method (Date object) 122
variables 38 setUTCMonth method (Date object) 122
SCRIPT (Dynamo tag) 22 setUTCSeconds method (Date object) 123
script language setYear method (Date object) 123
336
Index
ShowMessage method (site object) 318 if-else 44

simulateCursors property (connection object) 95 import 54
sin method (Math object) 261 return 53
site object switch 46
about 291 this 51
methods 293 var 52
properties 292 while 45
size property (document object) 131 with 49
size property (incoming mail piece object) 232 STATUS attribute (DOCUMENT tag) 9
SMTPHOST attribute (MAILPIECE tag) 22 status property (document object) 132
smtpHost property (outgoing mail piece object) 243 status404 316
sort method (Array object) 78 String
source property (document object) 132 methods 319
special characters in strings 36 string literals 35
specified property (DOMAttribute object) 145 String object
split method (String object) 320 about 319
splitText method (DOMText object) 188 stringError property (system object) 324
SQL STRIP_TRAILING_BLANKS (FORMATTING tag)
condition tags 28 13
SQL (Dynamo tag) 23 stripTrailingBlanks property (query object) 273
SQL as HTML comment tags stubs
DATA 8 generating 215
SQL_ERROR_CODE (Dynamo tag) 29 SUBJECT attribute (MAILPIECE tag) 22
SQL_ERROR_INFO (Dynamo tag) 30 subject property (incoming mail piece object) 232
SQL_INSERT (Dynamo tag) 25 substring method (String object) 321
SQL_ON_ ERROR (Dynamo tag) 28 substringData method (DOMCharacterData object)
SQL_ON_NO_ERROR (Dynamo tag) 28 150
SQL_ON_NO_ROWS (Dynamo tag) 28 switch statement
SQL_ON_ROWS (Dynamo tag) 28 about 46
SQL_STATE (Dynamo tag) 31 syntax
sqlEscape function (built-in) 61 Dynamo tags 1
sqrt method (Math object) 261 syntax conventions xviii
SQRT1_2 property (Math object) 255 system folder
SQRT2 property (Math object) 255 Autoexec.ssc 291
STARTROW attribute (FORMATTING tag) 13 NewConn.ssc 291
statements NewFold.ssc 291
about 43 NewTemp1.ssc 291
break 48 system object
class 50 about 323
comment 55 methods 324
continue 48 properties 324
do-while 45 systemId property (DOMEntity object) 168
exit 56 systemId property (DOMNotation object) 185
for 44
for-in 48
function 52
Index
T JavaScript guide 33
USE_CDATA attribute (FORMATTING tag) 13
tagName property (DOMElement object) 161
userId property (connection object) 97
tags
Dynamo tags 1
Jaguar 4
JavaScript vs Dynamo 34 V
scripts 34
value property (document object) 133
tan method (Math object) 261
value property (DOMAttribute object) 145
target property (DOMProcessingInstruction object) 186
valueOf method (Boolean object) 87
temporary
valueOf method (Date object) 125
connections 87
valueOf method (Number object) 265
DOMDocumentTypes 158
valueOf method (Object object) 267
DOMEntitys 166
valueOf method (String object) 323
DOMImplementations 169
values
DOMTexts 187
passing 133
this keyword
var statements
about 51
about 52
tilde 73
variables
timeOut property (session object) 290
about 36
TO attribute (MAILPIECE tag) 22
assigning values 37
toDOMDocument function (built-in) 62
checking, 61
toGMTString method (Date object) 124
data types 37
toLocaleString method (Date object) 124
declaration 37
toLowerCase method (String object) 322
passing by value and reference 56
toString method (Array object) 79
scope 38
toString method (Boolean object) 86
toString method (Date object) 124
toString method (Function object) 212
toString method (Number object) 264 W
toString method (Object object) 266
toString method (String object) 322 Web authoring tools
toUpperCase method (String object) 322 using with PowerDynamo 34
toUTCString method (Date object) 125 while statements
toXMLString function (built-in) 62 about 45
trailing blanks wildcards 73
stripping them 13 with statements
type property (document object) 133 about 49
type property(site object) 292 wizards
typeof function (built-in) 64 creating 301
typing of variables 37 Write method (document object) 142
Write(s) method (file object) 196
WriteLine(s) method (file object) 197
WriteLn method (document object) 142
U
unescape function (built-in) 59
URL
338
Index
X
XML
FORMATTING 13
ResultsToXML method 286
xmlEscape function (built-in) 65
Index
340

Dyrf03en PDF

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Dyrf03en PDF

Hochgeladen von

Copyright:

Verfügbare Formate

PowerDynamo Reference

Copyright © 1989-1999 by Sybase, Inc. All rights reserved.

Sybase, Inc., 6475 Christie Avenue, Emeryville, CA 94608.

About This Book ........................................................................................................................ xvii

CHAPTER 1 Dynamo Tags................................................................................... 1

CHAPTER 2 The DynaScript Language............................................................ 33

CHAPTER 3 DynaScript Predefined Objects ................................................... 75

Commit method ....................................................................... 97

setUTCMinutes method......................................................... 122

DOMCharacterData properties .................................................... 147

DOMEntity object ......................................................................... 166

publicId property.................................................................... 185

PutFileWithAppend method................................................... 205

Redirect method .................................................................... 235

round method ........................................................................ 260

MoveRelative method............................................................ 284

valueOf method ..................................................................... 323

Printed and online documentation

Online documentation more complete and timely

Type Symbol Syntax Convention

Conventions used in this book

Dynamo Tag Syntax

Dynamo Tag Syntax

Dynamo tags versus DynaScript

Dynamo tag DynaScript equivalent

For complete information on DynaScript, see “The DynaScript Language” on

The Dynamo tags

Only one row of placeholders is included within a FORMATTING statement.

Example An example of the ELSEIF tag is as follows:

num is greater than 5 and less than 10

Example An example of the EVALUATE tag is as follows:

Examples This example launches notepad.exe:

Formatting using scripts

“LABEL” on page 20.

Example • This template:

name: Tee Shirt

name: Tee Shirt

Syntax <!--MAILPIECE TO = recipientAddress [ FROM = fromAddress ] [

Only one connection

Syntax <!--SQL_INSERT TABLE= tableName [ NAME = queryname ]

Only one connection

Syntax

Example This example displays the state of the SQL query:

In some cases, the value of an expression is obvious; in others, it is not. For

To make meaningful evaluation of expressions possible, DynaScript has rules

The ? operator is ternary, meaning that it acts on three expressions.

Returns true if deletion is successful, false otherwise.

• break and continue

• class, this, and new

First, the statements are executed.

function countVowels( phrase ) {

• variable A variable to be used as the loop iterator.

document.WriteLn("Name: " + this.name);

The following example demonstrates the sharing of variables between a main

Executing main.ssc produces:

Define functions before using them

A function can accept string, number, or object parameters.

Parentheses must be used

A function can perform a set of statements without returning a value. For

Functions and the arguments object

• escape(string) Returns a string containing the ISO Latin-1

• eval(string) If string represents an expression, this evaluates the

• isFinite(number) Returns a Boolean indicating whether the supplied