Relationship: Application Options Have Specific Attributes
The relationship Has_Specific_Attribute has the following attributes:
| Attribute | Type | Description |
|---|---|---|
| Name * | String | Attribute name. |
| Value | String | Attribute value. |
This relationship is provided to overwrite software specific attribute values with customer specific values.
The following specific attribute names are supported:
| Attribute name | Description |
|---|---|
| Dialog_Ok_Label | The label of the OK button in all modeled dialogs except ISPF dialog boxes. |
| Dialog_Cancel_Label | The label of the Cancel button in all modeled dialogs except ISPF dialog boxes. |
| ISPF_Ok_Label | The label of the OK button in modeled ISPF dialog boxes. |
| ISPF_Cancel_Label | The label of the Cancel button in modeled ISPF dialog boxes. |
| SYSLIB | SYSLIB is to be used in the
Micro Focus COBOL and PL/I editor to find and download COBOL copybooks or PL/I include files in a z/OS remote edit scenario. Below you
can find more information on how to use this attribute.
It is possible to use variable names as part of the SYSLIB attribute. See Variable References for more information. |
| PROCLIB | PROCLIB is to be used in the
Micro Focus JCL editor to find and download JCL includes in a z/OS remote edit scenario.
It is possible to use variable names as part of the PROCLIB attribute. See Variable References for more information. |
| COMPOPT | A list of
Micro Focus compiler directives to use when background parsing a COBOL or PL/I program opened in theMicro Focus editor. This attribute is only supported in a z/OS remote edit scenario. Below you can find more information on how to use
this attribute.
It is possible to use variable names as part of the COMPOPT attribute. See Variable References for more information. Default value for COBOL: "DIALECT(ENTCOBOL) CICSECM XDB(NOVALIDATE) EXECDLI NOP64" Default value for PL/I: "-margins 1,72 -cics" |
| AUTO_PARSE | Controls whether the background parse process of the
Micro Focus editor is started automatically or only if explicitly called. This attribute is only supported in a z/OS remote edit scenario.
Below you can find more information on how to use this attribute.
It is possible to use a variable name to define the AUTO_PARSE attribute. See Variable References for more information. Default value: true |
| INITIAL_PARSE |
Controls whether the background parse process of the Micro Focus editor is started when a file is opened in the editor. The attribute is only of relevance when the attribute AUTO_PARSE is defined and set to true. This attribute is only supported in a z/OS remote edit scenario. Below you can find more information on how to use this attribute. It is possible to use a variable name to define the INITIAL_PARSE attribute. See Variable References for more information. |
| DIALOG_RETRIEVE_LABEL | The label of the Retrieve button in modeled dialog boxes. |
Full background parsing is available when using the Micro Focus COBOL and PL/I editors to edit a z/OS file remotely. This means that features such as syntax checking, content assist, and program outline are fully supported.
The background parser needs to resolve COBOL copybooks and PL/I includes. To use this feature you need to specify the SYSLIB attribute.
Several SYSLIB locations can be specified by either concatenating the paths with a semicolon (;) or defining several SYSLIB attributes. The COBOL copybooks and PL/I includes are searched in the given locations and their order, from left to right or from top to bottom.
Either fully-qualified MVS data set names or operating system paths, for example, C:\cobol\copybooks can be specified. Operating system paths can point to network resources. z/OS USS paths are currently not supported.
Normally, you can use variable names to specify the SYSLIB attribute and the AWM model ensures that the variables are correctly resolved at run time.
To receive a correct result from the background parser it is important to specify the correct compiler options.
Use the COMPOPT attribute to specify the compiler options.
Normally, you can use variable names to specify the SYSLIB attribute and the AWM model ensures that the variables are correctly resolved at run time.
If the specific attribute COMPOPT is not defined in the AWM model, the following rules apply for COBOL:
- If a property with the identifier MFProp_RemoteSyntaxCheckOptions is defined in the AWM model, its value is used.
- If this property has a specific value at run time, it is used. Otherwise, the default value is used, which is "DIALECT(ENTCOBOL) CICSECM XDB(NOVALIDATE) EXECDLI".
If this specific COMPOPT attribute is not defined in the AWM model the following rules apply for PL/I:
- If a property with the identifier MFProp_RemotePLISyntaxCheckOptions is defined in the AWM model, its value is used.
- If this property has a specific value at run time, it is used. Otherwise, the default value is used, which is "-margins 1,72 -cics".
By default, background parsing for COBOL and PL/I is done automatically during an edit session. If you have defined a compiler option which includes a mainframe precompiler call (this is currently only supported for COBOL) you may want to decide when to execute a full parse of the edited source.
To do this, specify the value false in the AUTO_PARSE attribute.
Normally, you use a variable name to specify the AUTO_PARSE attribute and the AWM model must make sure that this variable is correctly resolved at run time. It is best practice to use the value false only if the COMPOPT attribute contains an option to invoke a mainframe precompiler. If you want the background parse process to start when a file is opened in the editor, you have to specify the application specific attribute INITIAL_PARSE and set it to true.