Previous Topic Next topic Print topic


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.


Application Has Specific Attribute

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 this specific COMPOPT attribute is not defined in the AWM model the following rules apply for PL/I:

Note: The usage of the properties MFProp_RemoteSyntaxCheckOptions and MFProp_RemotePLISyntaxCheckOptions is deprecated but still supported for compatibility reasons.

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.

Previous Topic Next topic Print topic