com.ibm.pdp.maf.rpp.pac.dialog
Interface AbstractDialog

All Superinterfaces:
AbstractRadicalElement, Element, RadicalElement
All Known Subinterfaces:
Dialog, Screen

public interface AbstractDialog
extends AbstractRadicalElement

The purpose of the Dialog entity is to develop and generate the online applications of the OnLine Systems Development function or the TUI applications of the Pacbench C/S function.

A Dialog represents the interaction between Screens that are logically related to each other. A Dialog is therefore made up of a logical family of Screens. It is described independently of the physical characteristics of the environment or the TP monitor in use.

For each Dialog, you define the characteristics common to all the Screens which make up the Dialog. These characteristics, which become the default values of the Screens, are the:

These default options can be modified for each Screen of the Dialog.

There are two types of Dialogs:

Two basic types of architecture are possible: one which uses a monitor, and the other which does not:

These calls are indicated in each client component.

Each client sends its data to the service, according to the communication mode in use. The return to the client is performed just after the call function and the processing is performed in sequence.

You can always add specific processing by inserting code before or after the service call.

A monitor groups common information and processing (communication management, compacting, trace, COMMIT/ROLLBACK, site-specific features). For some platforms, like MICRO FOCUS and TUXEDO, using a monitor is a requirement.

Moreover, using a monitor are sometimes justified by application requirements (confidentiality, data encryption) or technical constraints (communication protocols). The monitor option enables you to interface more easily with your own communication method and to insert data security and encryption/decryption processing


Field Summary
static java.lang.String copyright
           
 
Method Summary
 java.lang.String getCobolFolder()
          Returns the folder where the cobol is generated.
 java.lang.String getCobolProject()
          Returns the project where the cobol is generated.
 CobolTypeValues getCobolType()
          In this field, you have the COBOL variant for the generated Screen.
 java.util.List<CPLine> getCPLines()
          List of called predefined Macros into the generated program.
 java.util.List<AbstractCSLine> getCSLines()
          It indicates how Segments are accessed in the validation, update and display processing associated with the Screen.
 DialogTypeValues getDialogType()
          In this field, you can see if the Dialog or Screen type is a standard online type or a TUI type.
 ColorAttributeValues getDisplayColorAttribute()
          Color attribute of display fields presents on Screen.
 IntensityAttributeValues getDisplayIntensityAttribute()
          Intensity attribute of display fields presents on Screen.
 PresentationAttributeValues getDisplayPresentationAttribute()
          Presentation attribute of display fields presents on Screen.
 ColorAttributeValues getErrorFieldColorAttribute()
          Color attribute of error fields presents on Screen.
 IntensityAttributeValues getErrorFieldIntensityAttribute()
          Intensity attribute of error fields presents on Screen.
 PresentationAttributeValues getErrorFieldPresentationAttribute()
          Presentation attribute of error fields presents on Screen.
 ColorAttributeValues getErrorMessageColorAttribute()
          Color attribute of error messages presents on Screen.
 IntensityAttributeValues getErrorMessageIntensityAttribute()
          Intensity attribute of error messages presents on Screen.
 PresentationAttributeValues getErrorMessagePresentationAttribute()
          Presentation attribute of error messages presents on Screen.
 java.util.List<GLine> getGELines()
          The -GELines indicate :the list of the automatically generated error messages which have been replaced,the declaration of explicit error messages,the help on a Screen, a Data Element or an error message.
 Library getGenerationLibrary()
          

Indicates the Library on which we can find the generation parameters for the entity.

 java.util.List<GLine> getGGLines()
          These lines on a given Screen or Dialog are used to override some of the values of the generated constants.
 java.util.List<GLine> getGOLines()
          The GOLines indicates the list of the generation options.
 java.lang.String getHelpCharacterElement()
          You can have any character in this field.
 java.lang.String getHelpCharacterScreen()
          This character is to be used to request documentation on a screen.
 java.lang.String getInitialCharacter()
          This field indicates the default initial value for the variable Data Elements called in the Screen.
 ColorAttributeValues getInputColorAttribute()
          Color attribute of input fields presents on Screen.
 IntensityAttributeValues getInputIntensityAttribute()
          Intensity attribute of input fields presents on Screen.
 PresentationAttributeValues getInputPresentationAttribute()
          Presentation attribute of input fields presents on Screen.
 ColorAttributeValues getLabelColorAttribute()
          Color attribute of labels presents on Screen.
 IntensityAttributeValues getLabelIntensityAttribute()
          Intensity attribute of labels presents on Screen.
 LabelPresentationValues getLabelPresentation()
          The values of this field correspond to the association between the Data Element and the presentation characteristics for these labels (left-aligned...).
 PresentationAttributeValues getLabelPresentationAttribute()
          Presentation attribute of labels presents on Screen.
 MapTypeValues getMapType()
          In this field, you have the variant of the TP monitor for the generated Screen.
 java.lang.String getProgramExternalName()
          The name entered here is the name of the file generated from this instance.
 int getScreenColumnNumber()
          This field indicates the number of columns per Screen.
 int getScreenLineNumber()
          This field indicates the number of lines per Screen.
 int getTabs()
          This field indicates the number of tabulation points per line.
 java.lang.String getTransactionCode()
          This field corresponds to: The four-character transaction code (Dialog default code) for a CICS variant.
 
Methods inherited from interface com.ibm.pdp.maf.rpp.pac.common.AbstractRadicalElement
getGCLines
 
Methods inherited from interface com.ibm.pdp.maf.rpp.kernel.RadicalElement
getDescriptionTypes, getKeywords, getLabel, getName, getPackage, getProject
 

Field Detail

copyright

static final java.lang.String copyright
See Also:
Constant Field Values
Method Detail

getCobolFolder

java.lang.String getCobolFolder()

Returns the folder where the cobol is generated.

Returns:

getCobolProject

java.lang.String getCobolProject()

Returns the project where the cobol is generated.

Returns:

getCobolType

CobolTypeValues getCobolType()

In this field, you have the COBOL variant for the generated Screen.

Returns:

getCPLines

java.util.List<CPLine> getCPLines()

List of called predefined Macros into the generated program.

Returns:

getCSLines

java.util.List<AbstractCSLine> getCSLines()

It indicates how Segments are accessed in the validation, update and display processing associated with the Screen.

Returns:

getDialogType

DialogTypeValues getDialogType()

In this field, you can see if the Dialog or Screen type is a standard online type or a TUI type.

Returns:

getDisplayColorAttribute

ColorAttributeValues getDisplayColorAttribute()

Color attribute of display fields presents on Screen.

Returns:

getDisplayIntensityAttribute

IntensityAttributeValues getDisplayIntensityAttribute()

Intensity attribute of display fields presents on Screen.

Returns:

getDisplayPresentationAttribute

PresentationAttributeValues getDisplayPresentationAttribute()

Presentation attribute of display fields presents on Screen.

Returns:

getErrorFieldColorAttribute

ColorAttributeValues getErrorFieldColorAttribute()

Color attribute of error fields presents on Screen.

Returns:

getErrorFieldIntensityAttribute

IntensityAttributeValues getErrorFieldIntensityAttribute()

Intensity attribute of error fields presents on Screen.

Returns:

getErrorFieldPresentationAttribute

PresentationAttributeValues getErrorFieldPresentationAttribute()

Presentation attribute of error fields presents on Screen.

Returns:

getErrorMessageColorAttribute

ColorAttributeValues getErrorMessageColorAttribute()

Color attribute of error messages presents on Screen.

Returns:

getErrorMessageIntensityAttribute

IntensityAttributeValues getErrorMessageIntensityAttribute()

Intensity attribute of error messages presents on Screen.

Returns:

getErrorMessagePresentationAttribute

PresentationAttributeValues getErrorMessagePresentationAttribute()

Presentation attribute of error messages presents on Screen.

Returns:

getGELines

java.util.List<GLine> getGELines()

The -GELines indicate :

Returns:

getGenerationLibrary

Library getGenerationLibrary()

Indicates the Library on which we can find the generation parameters for the entity.

Parameters are related to the adaptation to the operating system in use.

Returns:

getGGLines

java.util.List<GLine> getGGLines()

These lines on a given Screen or Dialog are used to override some of the values of the generated constants.

Returns:

getGOLines

java.util.List<GLine> getGOLines()

The GOLines indicates the list of the generation options.

Returns:

getHelpCharacterElement

java.lang.String getHelpCharacterElement()

You can have any character in this field. It must be left-aligned.

It is recommended to reserve this character for field help.

The documentation request is automatically recognized by the generated program.

The character for documentation request at the Data Element level is taken into account.

Note: If the Generated language specified in the Library Definition tab is COBOL II or 85, the tests generated in F8150 to detect the characters for documentation request are carried out on the first character of the field only. They are not carried out on the whole field as it is the case for standard COBOL.

For the environments which authorize the use of PF keys, you can enter a specific PF key to call the documentation associated with a field.

The documentation request is automatically recognized by the generated program when the user moves the cursor to a an element and presses the PF key.

Depending on the type of COBOL to generate, some specificities are added:

Returns:

getHelpCharacterScreen

java.lang.String getHelpCharacterScreen()

This character is to be used to request documentation on a screen. You can enter any character, left-aligned.

It is recommended to use this character only for the call of screen help. The documentation request is automatically recognized by the generated program

Note: If the Generated language specified in the Library Definition tab is COBOL II or 85, the tests generated in F8150 to detect the characters for documentation request are carried out on the first character of the field only. They are not carried out on the whole field as it is the case for standard COBOL.

For the environments which authorize the use of PF keys, you can have a specific PF key to call the documentation associated with the screen.

Depending on the type of COBOL to generate, some specificities are added:

Returns:

getInitialCharacter

java.lang.String getInitialCharacter()

This field indicates the default initial value for the variable Data Elements called in the Screen.

This initial value is set in the program associated with the Screen.

Returns:

getInputColorAttribute

ColorAttributeValues getInputColorAttribute()

Color attribute of input fields presents on Screen.

Returns:

getInputIntensityAttribute

IntensityAttributeValues getInputIntensityAttribute()

Intensity attribute of input fields presents on Screen.

Returns:

getInputPresentationAttribute

PresentationAttributeValues getInputPresentationAttribute()

Presentation attribute of input fields presents on Screen.

Returns:

getLabelColorAttribute

ColorAttributeValues getLabelColorAttribute()

Color attribute of labels presents on Screen.

Returns:

getLabelIntensityAttribute

IntensityAttributeValues getLabelIntensityAttribute()

Intensity attribute of labels presents on Screen.

Returns:

getLabelPresentation

LabelPresentationValues getLabelPresentation()

The values of this field correspond to the association between the Data Element and the presentation characteristics for these labels (left-aligned...).

At the Screen level, it is used to override the selection made at the Dialog level.

There are four possible labels:

Returns:

getLabelPresentationAttribute

PresentationAttributeValues getLabelPresentationAttribute()

Presentation attribute of labels presents on Screen.

Returns:

getMapType

MapTypeValues getMapType()

In this field, you have the variant of the TP monitor for the generated Screen.

Returns:

getProgramExternalName

java.lang.String getProgramExternalName()

The name entered here is the name of the file generated from this instance. The generated file name can then differ from the instance name.

Returns:

getScreenColumnNumber

int getScreenColumnNumber()

This field indicates the number of columns per Screen. This number must range between 1 and 80 inclusive. The default value is 80 at the Dialog level.

The format (number of lines and number of columns) specifies the overall dimensions of the Screen.

When Screen 'X' calls Screen 'Y', the size taken by Screen 'Y' is the size specified on its Definition tab. The relative positioning of the Data Element immediately following the called Screen therefore depends on the format of the called Screen.

Returns:

getScreenLineNumber

int getScreenLineNumber()

This field indicates the number of lines per Screen. This number must range between 1 and 62 inclusive. The Default value is 24 at the Dialog level.

Returns:

getTabs

int getTabs()

This field indicates the number of tabulation points per line. The default value is 1 at the Dialog level. The maximum number authorized is 50.

It is used to automatically position the Data Elements on the screen. The tabulation points are the invisible points on the screen, which divide each line into equal parts.

Each Data Element for which no absolute positioning is indicated is automatically moved to the next available tabulation point.

Returns:

getTransactionCode

java.lang.String getTransactionCode()

This field corresponds to:

Returns: