Dialog Complement tab

In this tab, you enter the information common to all of the Screens of the Dialog, and data related to the physical environment of the transaction.

The following information is common to all the Screens:
  • The characteristics of the communication common area that conveys the information between the Screens of the Dialog
  • The code of the first Screen. This Screen is displayed when the transaction is started
  • The characteristics of the error message file of the Dialog
Information can be entered in this tab, regardless of the type of TP monitor in use.

Other options are selected according to the environment and TP monitor in use at the site.

More than one value can be entered in the Options field. They must be separated by a space. When the Screen is generated, warnings point out erroneous parameters, if any.

Common area

The communication common area constitutes the area of exchange between the various Screens of the Dialog.

Data Structure
By default, no common area is indicated and this field is titled No common area selected yet.

To specify the Data Structure that constitutes the common area, click Modify and select a Data Structure in the selection box.

This Data Structure stores the information that is common to all of the Screens of a Dialog and the necessary Segment access keys.

If the selected Data Structure consists of more than one Segment, the Segments are redefined in the LINKAGE SECTION (WORKING-STORAGE SECTION if appropriate).

Complementary length
You must specify a number if the length of the common area exceeds 100 characters.
The length of the common area (5-xxnn-LENGTH in the generated programs) is determined by the combined lengths of the following elements:
  • The Screen code (6 characters)
  • A common area Data Structure
  • A field that stores the access keys of the Segments in display
  • Technical information (not apparent)
When you calculate this length, you must take into account the following facts:
  • The length that corresponds to the access keys of each Segment in display is calculated by category.
    Example: If a Segment is used in the screen-top, repetitive, and screen-bottom categories, the length of the keys is calculated as follows:
    • The length of the key for the screen-top category
    • + twice the length of the key for the repetitive category
    • + the length of the key for the screen-bottom category
  • If the MDT-OFF option or, for the BULL multiscreen variant and UNISYS A series, the DYNPRT option is specified in this tab, you must take into account the length of the longest Screen Segment of the Dialog to calculate the key length.
PSB or Subschema code
This field is reserved for DL/1 database Segments.

The PCB name of the error message file (external name) must belong to the PSB.

For HP3000, you must specify the ALLBASE/SQL Database Block code for a monitor generation with a database connection.
First Screen of the Dialog
Here you indicate the code of the first Screen of the transaction.
According to the type of code to generate, the specifications of this field vary:
  • For CICS, if no first Screen is specified, the common area of each Screen of the Dialog is generated in the WORKING-STORAGE SECTION.

    If a first Screen is specified, the common area of each Screen of the Dialog is generated in the LINKAGE SECTION. However, for the first Screen, it is generated in the WORKING-STORAGE SECTION.

  • For IMS, a monitor program is generated. It calls the selected Screen at the beginning of a Dialog and calls it again at the end of the Dialog. The external names of the first Screen and of its corresponding program must have been previously defined in the Screen Definition.

    The code is required, even when the MONITOFF option is indicated.

  • For GCOS7 and GCOS8, this field is only used with multiterminal type transactions.
  • For DEC/VAX, MICRO FOCUS, and HP3000, a branching monitor is generated. This monitor branches to the Screen at the beginning of the conversation.
  • For UNISYS-A, this field is used for the multiterminal type transactions.
  • For UNISYS-2200, this field is not used.
Options
Enter the options and separate them with blanks. All these options can also be entered in the -GO Lines of the -G Lines tab.
Note: A synonym is sometimes associated with some options. This way, you can enter all the necessary options.
Table 1 shows the Options on standard Dialogs and Screens. Table 2 shows the Options on Client Dialogs and Screens. Table 3 shows the Options on Business Components. Table 4 shows the Additional options on Business Components in a single-view development. Table 5 shows the Options on Communication Monitors. Table 6 shows the Options on Folders. Table 7 shows the Options on Initialization and Termination Business Components.
Table 1. Options on standard Dialogs and Screens. This table presents the options that can be indicated on standard Dialogs and Screens. If the options are entered at the Dialog level, they become the default options of the Screens.
Values Meaning
ATTRE UNISYS 2200: Definition of the default attributes at the Screen level.
ATTRIB UNISYS 2200: The display of the attributes dynamically specified (Reverse video and Blink) is kept. This option applies to F7020.

CICS®: The dynamic modification of the presentation attributes is taken into account. This option applies to F7020.

BREAKDATE Breaks down date Data Elements.

The date Data Elements is broken down into elementary Data Elements upon generation.

You can also inhibit this option by entering BREAKDATE=NO if it was set to YES at the Library level.

This breakdown is effective in the following entities:
  • In Programs, on the elementary Data Elements of the Segments that are called in the Call of Data Structures (-CD Lines tab) and in the work areas.
  • In Dialogs and Screens, on the elementary Data Elements of the Segments that are called in the Dialog Complement tab, in the -CS Lines tab and in the work areas.
  • On the Data Elements that are called in the work areas.

    If you indicate the BREAKDATE=YES option, the Data Elements that are defined with a date format are generated as elementary fields that correspond to the year, month, and day. It also contains a separator if a separator is included in the date format

    Example of a date defined with an M-type format (MM/DD/YYYY):

    10 ffnn-date.
     11 ffnn-date-MMX.
      12 ffnn-date-MM PICTURE 99.
     11 ffnn-date-S1  PICTURE X.
     11 ffnn-date-DDX.
      12 ffnn-date-DD PICTURE 99.
     11 ffnn-date-S2  PICTURE X.
     11 ffnn-date-YYX.
      12 ffnn-date-YY PICTURE 9(4).
Notes:

A date is broken down only if the generated COBOL level of the date field is lower than or equal to 47.

If a VALUE has been entered, it is generated in the group field.

Any additional information (such as a VALUE) must be entered on the same line as the Data Element call on I, E, or S-type lines in the work areas. If a continuation line has been specified, the date is not broken down.

The Data Elements that are called in SQL Segments cannot be broken down, except if these SQL Segments are DB2® Segments and if the DESCR=ALL option is entered on the DB2 Database Block.

Since host variables cannot be group fields, the elementary fields are generated under a redefined group field in the following way: ffnn-date-BRK REDEFINES ffnn-date.

CSSA Memorizes all the SSAs upon a generated access to a database. This option is valid for all the Screens of a Dialog.

When this option is specified, all the Screens in the Dialog must be recompiled because the length of the communication area is increased.

CVISION GCOS6: Downloads the standard validations (presence validation, numeric validation, formatting of the initialization character) onto the CVISION screen manager, thus improving performances.
DCPROC Generates the DECLARE CURSOR of DB2, NONSTOP SQL, and DATACOM tables in the PROCEDURE DIVISION, FOC function.

If this option is not specified, the DECLARE CURSOR is generated in the WORKING-STORAGE SECTION.

DFHAID IBM® CICS: Initializes the PF key table with the content of DFHAID.
DYNAM Calls Pactables Tables with a dynamic call.
DYNPRT Specifies the recognition of the variable field protection in the DE-AT table (position 5) and the automatic processing of the protection in F7020.

Enter an F in position 5 of the DE-AT table for the Data Element. The Data Element then becomes protected and is received by the program (nature F).

This option is unavailable with the IBM 36, UNISYS A series variant (SDF format).

F10 Processes each category (top, bottom, repetitive), if the category contains at least one variable field or access to a Segment.
FOR Formats the generated COBOL lines. The DATA DIVISION lines are left-aligned, the PROCEDURE DIVISION lines are not aligned and there is one COBOL command per line.

This option can be entered on the Library Definition tab. In this case, the Dialog is generated in formatted COBOL even if the FOR option is not explicitly entered at this level.

With this option, up to 150 lines are possible in a COBOL paragraph (between two periods).
Warning: This option still exists but is no longer maintained
HEXVAL UNISYS A: Generates fields with an HEXADECIMAL value in PIC XX.
HLPI Generates the file access with the HLPI interface.
HLPVAL The values to be checked (indicated in the -D Lines of a Data Element) are sent to the error messages file. It is true even if this check has been removed from the Screen in which the Data Element is called.
HPRT Calls the documentation that is associated with the protected fields (P or F type). It includes the documentation of the Data Element and the associated Texts and comments in the Screen -GC Lines section.

In the help program, the screen flow is as follows: first the help on the variable Data Elements, then the help on the protected Data Elements (in the order of the -CE Lines tab).

IMSME Generates the multiscreen variant for IMS™.
INDEXS DL/1: Generates the Segment access through secondary indexes.

This option is not compatible with the NOP58 option if the target Segment code is different from the source Segment code and if the source Segment is not generated in the PSB field.

LOGMES With the CICS multiterminal and MICRO FOCUS variants, this option generates a logical message. This message manages both the screen display and the sending of messages to the communication monitor. This monitor is selected with the MONIT option (if it is not a default value in the variant).

AS400 and IMS: This option is used only for the internet.

LPAGE or LPA Manages the LOGICAL PAGING in implicit mode (with PA1 function key) or in explicit mode (with a logical paging operator on the Screen -CE Lines tab).

The LPAGE option is available with a monitor, a submonitor, or with MONITOFF.

With the MONITOFF option, paging applies to the same Screen only.

With a monitor or submonitor, paging applies to several Screens if the Screen codes are entered on the Dialog work areas.
Note: If submonitors are used, all the Screens that constitute a paging group must be in the same submonitor.

The LPAGE and SWAP options are not compatible. If they are both indicated, only the LPAGE option is recognized.

MONIT IBM CICS and UNISYS A Series: Generation with a monitor.
MONITOFF or MOFF IMS: One transaction code per Dialog Screen and no monitor generation.

MONITOFF and NOTRAC are incompatible. If both are entered, only the MONITOFF option is recognized.

NOATTR IMS: Generates the protected fields in the MOD without their attributes (ATTR=YES). This option is valid for all the Screens of a Dialog.
NOLOCK AS400: Reads the Segments without update. It adds the WITH NO LOCK clause in the read function when the file is open in OPEN I-O.

This option does not work if several Segments of a same file are accessed, some with update, some without, because READ WITH NO LOCK removes the preceding lock.

NOOCF The OCF variable is not set to value 1 upon the first program run (no F0160 function).
NOOPEN MICRO FOCUS and DEC: Optimizes the opening of the HE file (help file backup), the LE, OU, EM (error messages) files, and the CONNECT to ORACLE.
NOOPENB HP3000, TURBOIMAGE: Stops the opening of the TURBOIMAGE database. The OPEN is not generated in the program.
NOPSB Limits the Segment generation.

In each Screen, only the Segments in use and their hierarchical parents are generated. In the monitor and submonitors, the PSB field is no longer generated and is not sent to the Screens.

NORPT No automatic processing of repeated Data Elements.
NOSAV With DEC/VAX, GCOS7, MICRO FOCUS, ICL, IBM 36 and 38, and BOS/TP: Avoids generating the description of, and the physical access to the HE help file.
NOSDERR UNISYS 2200: Recognizes the ERMSG Data Element in the message, which therefore is not sent by the SEND ERROR clause.
NOTRAC IMS: The transaction code is not generated in the MID of the first Screen of the Dialog.
OCF The OCF variable is set to value 1 upon the first program run (current default value).
OFF The programs and maps of the Dialog are generated with option MDT-OFF (default value for GCOS7 FORMS).
ON Default value (except for GCOS7 FORMS). The programs and maps of the Dialog are generated with the MDT-ON option.
PACSQL Recognizes the data that is entered in the Segment -GG Lines for the SQL statements.
PSBINIT CICS-DL/1 Screen with monitor option: Used for the connection to the PSB and its termination (SCHEDULE PSB and TERMINATE) on the submonitor and not on each Screen.
REFER or REF Generates the list of all the Data Elements that are used in a Dialog. This list is formatted as comments in the WORKING-STORAGE SECTION. It includes the following Data Elements:
  • Data Elements from the Segments that are called in the -CS Lines,
  • Data Elements from the Segments that are called in the work areas, on F-type lines,
  • Data Elements that are directly called in the work areas on I-, E-, or S- type lines,
  • Data Elements that are directly called in the -CE Lines.
REPET or RPT Validation, transfer, and positioning of the attributes for the variable fields that are repeated horizontally or vertically.

When a repeated field is used in a Segment access, you must indicate the number of repeated uses in the Segment call of the Screen.

SQLALL or SQA SQL: All the table columns are listed in the Segment access commands:
(SELECT ALL COLDELCOn, ...  
        INTO   :FFNN-DELCOn)
SQLCA or SQC SQL: The INCLUDE SQLCA statement is generated in the WORKING-STORAGE SECTION if one or more DB2 or NONSTOP SQL Segments are called in the Screen (-CS Lines tab, Organization = S, Q, or N).
SQLIND or SQI The presence indicators are generated for the Data Element before it is updated or displayed.
SQLREF or SQR The indicators are generated for the new V-FFnn-DELCO structure. Cross-references are then automatically managed.
SSMON The PSB of the submonitor that each Screen belongs to is recognized. One PSB is then generated for each submonitor instead of one PSB for all the Screens in the Dialog (see the -GG Lines).
SWAP IMS: Option to be used with a monitor or submonitor.

The code of the Screen to branch to through a function key is indicated in the MFS map. In each map, a 10-character FUNC field is generated and includes the PF key value and the external name of the next Screen to branch to.

For End-Of-Conversation, the external name of the Screen must not be entered.

When using deferred branching, or setting OPER with the PF key, the external name is that of the generated map.

The FUNC field is processed in the monitor or submonitor.

The SWAP option improves performance as it avoids loading the program which processes the branching.

Note: If the MONITOFF or LPAGE option is selected, the SWAP option is not taken into account.
TMF TANDEM: With this option, the transactional mode is recognized by the generation of BEGIN-TRANSACTION and END-TRANSACTION in the requesters and of BEGIN-WORK and COMMIT-WORK orders in the Pacweb communication monitor.
TS CICS: The communication area is managed outside the LINKAGE SECTION. This area is described in WORKING and saved in TEMPORARY STORAGE by default. In addition, if MDTOFF and call of the help function, the Screen is saved in only one area.
TZVAR BULL: With this option, the reception and display areas are used in case of error.
ZNUM The transfer of the numeric fields to the message (F8145) is conditioned by the fact that no error was encountered (SCR-ER = 0).
Table 2. Options on Client Dialogs and Screens. This table presents the options that can be indicated on Client Dialogs and Screens. If the options are entered at the Dialog level, they become the default options of the Screens.
Values Meaning
CALLSPG Option possible on a Client Monitor or Server Monitor.

Call type used by the Client or Server Monitors to call the associated Clients or Servers. The default value is CALL.

If there is no Client Monitor, it is the call type of the Server by the Client.

CALLTYPE Option possible on a Client Monitor, Server Monitor, Communication Monitor, Business Component, or Folder.

Call type of the Server by the Client.

For CICS, the 2 following values are possible: LINK and CALL.

FORMAT Format of the Logical View Data Elements.

With the INTERNAL value, the Data Elements that are called in the Logical View are generated with their internal format and their usage is recognized.

With the EXTENDED option, the format of the Data Elements is computed. Their usage is ignored and replaced by the DISPLAY usage. For signed numeric Data Elements, it is replaced by the SIGN IS LEADING usage.

INICHECK Check of the Data Element presence.

Option for a TUI client Dialog.

A buffer for the Data Element presence is generated and initialized to P (absent Data Element). When Data Elements are transferred (F30 function), the host variable indicator of each Data Element actually transferred is set to N. The transfers for display are also conditioned by the Data Element presence.

INITSERV Call of an Initialization and Termination Business Component (IT type).

A free reference is set when you indicate an Initialization and Termination Business Component.

Content assist is available on this field, as shown by the symbol content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

LGCOMZS Option possible on a Client Monitor or Server Monitor.

Length of the communication area between the Client and Server Monitors.

Its value must be 5 characters long (default: 32000).

LTHENATT Length of the backup area of the DE-ATT table (default: 2000).
LTHREPET Length of the backup area of the repetitive category (default: 1000).
LTHSCREEN Length of the backup area of the screen message (default: 6000).
NOMAP Generates or does not generate the map, according to the value of the option in the Dialog and the Screen.

The generation of the map also depends on the Generation with map check box in the Screen Definition.

The value NOMAP is equivalent to NOMAP=YES. It inhibits the generation of the map.

The value NOMAP=NO generates the map.

The value of the option in the Dialog is automatically taken into account in the Screen. To keep this value in all the Screens of the Dialog, there is no need to enter this option in all the Screens.

However, to modify the value of the option that is indicated in the Dialog in some Screens, you must indicate it. The two following cases are possible:
  • If the Dialog contains the value NOMAP or NOMAP=YES and if the Screen contains the value NOMAP=NO, the Screen map is generated.
  • If the Dialog contains the value NOMAP=NO and if the Screen contains the value NOMAP or NOMAP=YES, the Screen map is not generated.
NUVERS Version management of the Business Component, the Folder or Folder View proxy, and the TUI Client.

This option is not used in Rational® Programming Patterns.

TERMSERV Call of a Termination Business Component.
Table 3. Options on Business Components. This table presents the options that can be indicated on Business Components. If the options are entered at the Business Component Dialog level, they become the default options of the Business Components. However, some options must be indicated in the Business Components. These cases are mentioned in the table.
Values Meaning
ACCESERR Maximum number of errors on Segment access that can be returned to the Client.

The value is on 3 characters (default value = 001).

CALLSPG Option possible on a Client Monitor or Server Monitor.

Call type used by the Client or Server Monitors to call the associated Clients or Servers. The default value is CALL.

If there is no Client Monitor, it is the call type of the Server by the Client.

CALLTYPE Option possible on a Client Monitor, Server Monitor, Communication Monitor, Business Component, or Folder.

Call type of the Server by the Client.

For CICS, the 2 following values are possible: LINK and CALL.

CHANGE Specific to TUXEDO.

CHANGE=NO (default value): The Business Component is called with the TPNOCHANGE parameter.

CHANGE=NO (default value): The Business Component is called with the TPCHANGE parameter.

You are advised to indicate the same option in the Business Component Dialog and in the Folder Dialog.

CHECKSER Logical View data check.

CHECKSER=NO (default value): The Business Component does not check the Logical View data.

CHECKSER=YES: The Business Component checks the Logical View data.

The VECTPRES and CHECKSER options in the Business Components that call the same Logical Views must be identical.

CONNECT Management of the connections to and the disconnections from relational databases.

CONNECT=YES (default value): The connections and disconnections are generated in the Communication Monitor.

For TUXEDO, the connections and disconnections are generated in the initialization and termination Business Components (SI or ST type). In this case, you must call one of the Table Segments from the database that you want to connect to or disconnect from.

CONNECT=NO (value for TUI applications): The connections and disconnections are generated in the Business Component.

CURSUFF Suffix of cursor names.

CURSUFF=NO: The cursor names are not suffixed.

CURSUFF=YES: The SQL cursor names are suffixed with the corresponding Screen name.

DATAERR Maximum number of errors on the Logical View data that can be sent to the Client.

The value is two-character long. The default value is 01.

Note: The value of this option that is indicated in the Initialization and Termination Business Component must be identical to the value of the option in all the Business Components of the Folder.
FORMAT For graphic applications, you must indicate FORMAT=EXTENDED.
INITSERV Call of an Initialization and Termination Business Component (IT type).

A free reference is set when you indicate an Initialization and Termination Business Component.

Content assist is available on this field, as shown by the symbol content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

LGCOMM Length of the communication area between the following components:
  • Communication Monitor (graphical application) and Business Component,
  • Folder and Business Component,
  • TUI Client or Client Monitor and the Business Component.

This option has a numeric value on 5 characters. It is required if several Business Components are associated with the Dialog.

LGCOMZS Option possible on a Client Monitor or Server Monitor.

Length of the communication area between the Client and Server Monitors.

Its value must be 5 characters long (default: 32000).

LOCATION To implement a Communication Monitor, this option must be indicated in the Folder Dialog, or in the Business Component Dialog if no Folder is specified.

You must enter the Communication Monitor name (on 6 characters), a dash, and the environment name (on 20 characters maximum): LOCATION=FMCODE-ENVIRNAME

A free reference is set when you indicate a Communication Monitor.

Content assist is available on this field, as shown by the symbol content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

MONSER Name of the Server Monitor for the TUI mode. By default, there is no Server Monitor.
NULLMNGT Presence management of the Logical View Data Elements.

NULLMNGT=NO (default value): The presence of the Logical View Data Elements is not managed at the proxy level.

NULLMNGT=YES: The presence of the Logical View Data Elements is managed at the proxy level.
Note: If NULLMNGT=YES, then VECTPRES=YES is systematically implemented.
NUVERS Version management of the Business Component, the Folder or Folder View proxy, and the TUI Client.

This option is not used in Rational Programming Patterns.

PACTABLE Name of the Pactables access program to the CICS Business Component.

Default value: PACTABLE

PROCESS Available for TANDEM PATHWAY only. This option can be indicated at the Business Component level only.

Name of the process when the Business Component is called.

15 characters maximum without space. No lowercase and uppercase conversion.

SEGMBUFF This option can be indicated at the Business Component level only.

This option is used for the server buffer. It selects Segments of the Data Structure that defines the server buffer.

For example, if you enter SEGMBUFF=s1s2s3, then s1, s2, and s3 represent the first 2 characters of the Segments.

10 Segments can be selected by this option.

A maximum of 10 SEGMBUFF options can be called in each Business Component.

Selecting the 00 Segment is not necessary. It is systematically generated if it is present in the Data Structure.

By default, all the Segments of the Data Structure are selected.

SERVBUFF Available only with the specification of a Folder.

This option identifies the Data Structure that defines the server buffer.

You indicate SERVBUFF=xx, where xx is the Data Structure on 2 characters.

Some Segments of this Data Structure can be selected in each Business Component with the SEGMBUFF option (SEGMBUFF=s1s2s3 for example).

TRAN Specific to TUXEDO.

TRAN=YES (default value): Use of the transactional mode for the TUXEDO variant.

TRAN=NO: No use of the transactional mode.

VECTPRES Management of the presence of the Logical View Data Elements.

VECTPRES=NO (default value): No management of the presence of the Logical View Data Elements.

VECTPRES=YES: Management of the presence of the Logical View Data Elements.
Note: If CHECKSER=YES, the VECTPRES=YES option is systematically implemented.

Contrary to the NULLMNGT option, this option cannot be used to check the presence of the Data Elements in the proxy.

The VECTPRES and CHECKSER options in the Business Components that call the same Logical Views must be identical.

Table 4. Additional options on Business Components in a single-view development. This table presents the additional options when an application handles only one Logical View and therefore does not include the specification of a Folder. A service manager must be generated (in version 9.6 and higher) for each Business Component that is not integrated into a Folder. This purely technical component manages the facilities that are handled by the Folder when a Folder is specified. To generate it, the LOCATION=FMCODE-ENVIRNAME option must be indicated in the Business Component or in its Dialog. The presence of LOCATION triggers the default recognition of the implicit SRVMGR=YES option.

The options that are entered in the Business Component Dialog become the default options of the Business Components that belong to the Dialog.

Valeurs Signification
ERRLAB Format of the errors that must be returned.

ERRLAB=YES (default): The Communications Monitor retrieves the key, gravity, and error messages that are returned by the Business Component before it sends back the answer to the Client.

ERRLAB=NO: Only the error key is returned. In that case, the error message is locally read by the client application.

ERRSERV Name of the Error Message Server. This option is required.
LOCATION To implement a Communication Monitor, this option must be indicated in the Folder Dialog, or in the Business Component Dialog if no Folder is specified.

You must enter the Communication Monitor name (on 6 characters), a dash, and the environment name (on 20 characters maximum): LOCATION=FMCODE-ENVIRNAME

A free reference is set when you indicate a Communication Monitor.

Content assist is available on this field, as shown by the symbol content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

LOCKMODE Option that specifies the lock type.

The lock process prevents the update of a set of data in order to avoid inconsistency.

If the value is NO (default), no lock is specified.

The PESSIMIST value creates an exclusive appropriation of the instance, which is locked to all other users while it is updated.

The OPTIMIST value locks the instance upon the update request and compares the initial image of the instance with its current image in the database. If they are identical, the update is accepted.

PAGEMODE Option that specifies the paging mode.

The NOEXTEND value (default) is specified to page forward and backward through a predefined population. Each paging operation that is requested by the Client component runs a read request and its result replaces the result of the previous read.

The EXTEND value is specified to page forward through a predefined population. The result of each paging is added to the previous read result. The reading of the previous pages is then handled by the graphic client.

SRVMGR Option for the generation of a second COBOL source code that corresponds the service manager. This purely technical component generates the facilities that are generated by the Folder when a Folder is specified.

By default, the SRVMGR=YES option is implicit in the Business Components and their Dialog if the LOCATION option is present. The service manager is then generated by default. The service manager name comes from the Service manager external name field in the Business Component Definition tab. If this name is not specified, the service manager name is the Business Component name.

You indicate SRVMGR=NO in any Business Component that does not require the generation of a service manager.

Table 5. Options on Communication Monitors. This table presents the options that can be indicated on Communication Monitors. If the options are entered at the Communication Monitor Dialog level, they become the default options of the Communication Monitors.
Values Meaning
BASE Relational database code.

This option is required if a relational table is a component of the Folder, even if it is only the work file.

The value BASE=THREAD is reserved for UNISYS 2200 to indicate an SFS organization.

BASELOC Location of the relational database.

This option is required if the relational database code is specified.

The possible values are LOCAL (default) and REMOTE.

CALLTYPE Option possible on a Client Monitor, Server Monitor, Communication Monitor, Business Component, or Folder.

Call type of the Server by the Client.

For CICS, the 2 following values are possible: LINK and CALL.

SERVBUFF Specification of the Data Structure that defines the server buffer.

You enter SERVBUFF=xx, where xx is the Data Structure on 2 characters.

Note: The same option must be entered in the Business Component Dialog of the Folder.
WAITINT Option specific to MQ Series. and TCP/IP Socket on MVS™/CICS.

Waiting time, in seconds, between two queries.

Default value for WebSphere® MQ = 0001.

Default value for TCP/IP Socket on MVS/CICS = 1800.

WAITINT1 Option specific to MQ Series.

Waiting time, in seconds, before the first request starts (default value = unlimited).

This default value can be modified by entering a four-character number.

WORKFILB This option is mandatory.

Database Block for a work file with an H organization or external name for a work file with a V organization.

For IBM CICS - VSAM, enter the DDNAME on 1 to 8 positions.

For GCOS8, the input depends on the blocking type:
  • For a blocking by characters, enter the external name on 4 characters (generated in the SELECT clause) and blocking on the last four characters (generated in the FD clause).
  • For a blocking by record, enter the external name on 5 characters and blocking on the last three characters.
The two parts of the external name, each on 2 characters, are separated by a dash.

For the other variants, enter the logical name, generated in the SELECT clause.

WORKFILS This option is mandatory.

Segment that is associated with the work file.

WORKFILO This option is mandatory.
Organization of the work file that is used by the Communication Monitor:
  • V: Sequential indexed
  • H: Relational
  • W: Working
Table 6. Options on Folders. This table presents the options that can be indicated on Folders. If the options are entered at the Folder Dialog level, they become the default options of the Folders.
Values Meaning
CALLTYPE Option possible on a Client Monitor, Server Monitor, Communication Monitor, Business Component, or Folder.

Call type of the Server by the Client.

For CICS, the 2 following values are possible: LINK and CALL.

CHANGE Specific to TUXEDO.

CHANGE=NO (default value): The Business Component is called with the TPNOCHANGE parameter.

CHANGE=NO (default value): The Business Component is called with the TPCHANGE parameter.

You are advised to indicate the same option in the Business Component Dialog and in the Folder Dialog.

ERRLAB Format of the errors that must be returned.

ERRLAB=YES (default): The Communications Monitor retrieves the key, gravity, and error messages that are returned by the Business Component before it sends back the answer to the Client.

ERRLAB=NO: Only the error key is returned. In that case, the error message is locally read by the client application.

INITSERV Call of an Initialization and Termination Business Component (IT type).

A free reference is set when you indicate an Initialization and Termination Business Component.

Content assist is available on this field, as shown by the symbol content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

LOCATION To implement a Communication Monitor, this option must be indicated in the Folder Dialog, or in the Business Component Dialog if no Folder is specified.

You must enter the Communication Monitor name (on 6 characters), a dash, and the environment name (on 20 characters maximum): LOCATION=FMCODE-ENVIRNAME

A free reference is set when you indicate a Communication Monitor.

Content assist is available on this field, as shown by the symbol content assist in front of the field. To activate it, press Ctrl+Space. A subreference link is automatically created, even if the instance does not exist. From the target instance in the subreference results, you can start a super reference search.

NULLMNGT Presence management of the Logical View Data Elements.

NULLMNGT=NO (default value): The presence of the Logical View Data Elements is not managed at the proxy level.

NULLMNGT=YES: The presence of the Logical View Data Elements is managed at the proxy level.
Note: If NULLMNGT=YES, then VECTPRES=YES is systematically implemented.
PROCESS Available for TANDEM PATHWAY only. This option can be indicated at the Business Component level only.

Name of the process when the Business Component is called.

15 characters maximum without space. No lowercase and uppercase conversion.

TRAN Specific to TUXEDO.

TRAN=YES (default value): Use of the transactional mode for the TUXEDO variant.

TRAN=NO: No use of the transactional mode.

Table 7. Options on Initialization and Termination Business Components. This table presents the options that can be indicated on Initialization and Termination Business Components. If the options are entered at the Dialog level, they become the default options of the Initialization and Termination Business Components.
Values Meaning
ACCESERR Maximum number of errors on Segment access that can be returned to the Client.

The value is on 3 characters (default value = 001).

CALLTYPE Option possible on a Client Monitor, Server Monitor, Communication Monitor, Business Component, or Folder.

Call type of the Server by the Client.

For CICS, the 2 following values are possible: LINK and CALL.

CHANGE Specific to TUXEDO.

CHANGE=NO (default value): The Business Component is called with the TPNOCHANGE parameter.

CHANGE=NO (default value): The Business Component is called with the TPCHANGE parameter.

You are advised to indicate the same option in the Business Component Dialog and in the Folder Dialog.

DATAERR Maximum number of errors on the Logical View data that can be sent to the Client.

The value is two-character long. The default value is 01.

Note: The value of this option that is indicated in the Initialization and Termination Business Component must be identical to the value of the option in all the Business Components of the Folder.
PROCESS Available for TANDEM PATHWAY only. This option can be indicated at the Business Component level only.

Name of the process when the Business Component is called.

15 characters maximum without space. No lowercase and uppercase conversion.

TRAN Specific to TUXEDO.

TRAN=YES (default value): Use of the transactional mode for the TUXEDO variant.

TRAN=NO: No use of the transactional mode.

Error file

Enter the physical characteristics of the error message file. They must be specified to generate the file description and access.

The physical access levels are generated in function F8098. If you want to rewrite these access levels, you must overwrite this function.

Organization
Select the organization of the error message file:
  • blank: None
  • D: DL/1 database Segment

    The description of the error message file and the access to it are automatically generated. In IMS, the description of the error message file is not automatically generated. You must describe it in a Segment called in a hierarchical Database Block.

  • S: DB2 database
  • U: Access by specific code
  • V: Indexed organization
  • Y : UNYSIS 2200 SFS indexed organization

    Segments are declared in FD and the access levels are generated in function F80.

External name
Enter the external name of the error message file. Its value varies according to the type of COBOL code to generate:
  • For IBM CICS - VSAM, enter the DDNAME on 8 characters.
  • For GCOS7 - UFAS, enter the file code on 2 characters.
  • For GCOS8-TP8, enter the external name on the first 4 characters (generated in the SELECT clause) and the blocking factor on the last 4 characters (generated in the FD clause).
  • For any other type of COBOL code, enter is the logical name, which is generated in the SELECT clause.
For DL/1, you must enter the mnemonic code of the PCB. This code must be in the list of PCBs for the PSB of this transaction.

Feedback