The DSP tag library lets you work with Nucleus components and other dynamic elements in your JSPs. DSP library tags support both runtime expressions, such as references to scripting variables, and the JSTL Expression Language (EL) elements, which also evaluated at runtime.

The table below lists alphabetically the tags that are implemented in the DSP tag libraries. This appendix combines these tag libraries into one discussion by describing all relevant attributes and properties for each tag.

This section is followed by a complete discussion of each tag, its attributes and, when applicable, its variables and properties.

Finally, an example and corresponding explanation are provided for each tag.

DSP tag names and attributes that have equivalent names in HTML, JSP, or WML typically replicate the functionality of the corresponding tag while providing extra functionality. One exception applies: the iclass attribute is used in place of the class attribute to avoid using a standard method name in Java code. The discussions that follow omit explanations for non-required attributes that provide expected functionality, such as onmouseoverand other custom event attributes. All such attributes are specified in the TLD with lowercase characters.

See the DSP tag library tld files for a listing of each tag and its attributes: <ATG10dir>/DAS/taglib/dspjspTaglib/1.0/tld.

Summary of DSP tags

DSP tag

Summary description

dsp:a

Supports passing values to component properties and page parameters on click-through. Also handles URL rewriting.

dsp:beginTransaction

Starts a transaction.

dsp:commitTransaction

Completes a transaction.

dsp:contains

Determines whether a Collection contains a specific single valued item.

dsp:containsEJB

Determines whether a Collection contains an EJB.

dsp:demarcateTransaction

Manages a transaction by starting the transaction, checking for errors, rolling back the transaction when errors are found and committing it when they are not.

dsp:droplet

Invokes an ATG Servlet Bean.

dsp:equalEJB

Determines whether two EJBs have the same primary keys.

dsp:form

Encloses a form that can send DSP form events.

dsp:frame

Embeds a page by encoding the frame src URL.

dsp:getvalueof

Creates an EL variable that references the specified component property or page parameter.

dsp:go

Encloses a form that can send WML form events.

dsp:iframe

Embeds a dynamic page, by encoding the frame src URL.

dsp:img

Inserts an image.

dsp:importbean

Imports a Nucleus component into a page so it can be referred to without using its entire pathname. Also, creates a reference to a Nucleus component in an attribute visible to EL expressions.

dsp:include

Embeds a page into another page.

dsp:input

Passes values to a component property on submission.

dsp:link

References a page, such as a stylesheet, by encoding the link src URLs.

dsp:oparam

Specifies content to be rendered by an enclosing dsp:droplet tag.

dsp:option

Specifies content to be rendered by an enclosing dsp:select tag.

dsp:orderBy

Provides the sorting pattern to parent tag dsp:sort.

dsp:page

Enables ATG page processing functionality.

dsp:param

Stores a value in a parameter.

dsp:postfield

Passes values to a component property on submission. (WML)

dsp:property

Sets a component property from dsp:a tag.

dsp:rollbackTransaction

Causes any actions in the current transaction to be returned to their pretransaction state.

dsp:select

Passes values to a component property on submission.

dsp:setTransactionRollbackOnly

Specifies that, when a transaction is prompted to end, it ends in a rollback action.

dsp:setvalue

Sets the value of a component property or a page parameter to a specified value.

dsp:setxml

Sets attribute display format to XML or HTML.

dsp:sort

Organizes the contents of a Container or array based on a sorting pattern.

dsp:test

Makes an object’s descriptive information available so other tags can find out its size, data type, and so on.

dsp:textarea

Passes values to a component property on submission.

dsp:tomap

Introduces a page parameter, standard JavaBean or Dynamic Bean component, or constant value as an element in a JSP that other tags can render using EL.

dsp:transactionStatus

Reads the current transaction’s status.

dsp:valueof

Retrieves and displays the value of a page parameter, component property, or constant value.