ScreenMan Forms

DDSBR Variable

ScreenMan allows you to branch the user to a field under conditions you specify. You can do this by defining M code in the following properties:

• Branching Logic
  
  
• Pre Action
  
  
• Post Action
  
  
• Post Action on Change (at the field level)
  
  
• Data Validation (at the form level)

The M code can set the local variable DDSBR to a value that defines the location of the field to which you wish to take the user.

DDSBR has the following format:

    DDSBR=Field id^Block id^Page id

Where:

• Field id = Field Order number; or Caption of the field; or Unique Name of the field
  
  
• Block id = Block Order number; or Block Name
  
  
• Page id = Page Number; or Page Name

For example:

Figure 226: ScreenMan Forms—DDSBR Variable: Example

    S:X="Y" DDSBR="FIELD 1^BLOCK 1^PAGE 2"

This would take the user to the field with unique name or caption "FIELD 1" on the block named "BLOCK 1" on the page named "PAGE 2", if the internal value of the field equals Y.

ScreenMan assumes values for any of the ^-pieces of DDSBR that are empty, as listed in Table 78:

Table 78: ScreenMan Forms—Assumptions when Pieces of DDSBR are NULL

To branch the user to the command line, DDSBR takes the following format:

Figure 227: ScreenMan Forms—DDSBR Variable: Example of Format to Branch the User to the Command Line

    S DDSBR="COM"

Reviewed/Updated: May 2026