# AWProgram JSP Tag Attributes

Use the AWProgram JSP tag to specify an OLAP DML program that runs in an analytic workspace and has the capability of capturing screen input. You can optionally identify actions that are triggered by specific return values from the program.

The wizard that guides you in the definition of the AWProgram also generates nested AWReturnAction tags if you specify return values and the associated actions that they trigger.

## Attributes for the AWProgram tag

additionalDimensionListIds -- Identifiers of dimension lists tags that supply arguments for the OLAP DML program

additionalHTMLIds -- Identifiers of the BI list tags that supply arguments for the OLAP DML program. The sequence of these arguments must be identical to the arguments that the program expects to receive. This attribute can also contain the IDs of additional HTML components on the page so that their contents can be passed to the OLAP DML program.

awDimensionListContextName -- Name of the context object that is to be updated by dimension list tags.

awPresentationContextName -- Name of the context object that is to be updated by the dimension status of the presentation. If this attribute is specified, then the status for all dimensions, including measures, is sent to the analytic workspace. The dimension values are set into the context and the measures are set into ALL_OBJECTS. If no context is specified, then no dimension member or measure information is sent to the analytic workspace.

awProgramName -- Name of the OLAP DML program that is to be invoked.

debugPath -- Server path where temporary trace files and other debug information will be written. If this attribute is not specified, then the following attributes cannot be used: showBadLine, showMonitor, showTrace, showTrackProg.

execAWCommandIds -- Identifiers of AWCommand tags that are to be run before the OLAP DML program runs. These commands are useful for attaching databases.

id -- (Required) A unique identifier for this tag.

maxDimValueCount -- Maximum number of dimension members that can be set into the context for the OLAP DML program.

partialTargets -- Tag identifiers of any objects that this tag should update and include in a partial page refresh.

showBadLine -- Indicates whether to use the debugging aid that displays bad line information for the analytic workspace. Note: In order to use this attribute, you must specify a value for the debugPath attribute.

showMonitor -- Indicates whether to use the monitor debugging aid in the analytic workspace. Note: In order to use this attribute, you must specify a value for the debugPath attribute.

showTrace -- Indicates whether to use the trace debugging aid in the analytic workspace. Note: In order to use this attribute, you must specify a value for the debugPath attribute.

showTrackProg -- Indicates whether to use the trace program debugging aid in the analytic workspace. Note: In order to use this attribute, you must specify a value for the debugPath attribute.

sourcePresentationId -- Identifier of the tag for a presentation that serves as a source of input to the OLAP DML program.

## Attributes for the AWReturnAction tag

executeTargetIds -- Identifiers of the list tags that are to be refreshed when the value that is specified in the value attribute is passed. These list tags can include: dimensionMemberList, cascadingDimensionMemberList, savedSelectionList, and measureList.

gotoPage -- Identifier of a page that is to be displayed when this return value is passed.

refreshTargetIds -- Tag identifiers of presentations that are to be refreshed when this return value is passed.

value -- Return value that triggers the actions that are specified in this tag.