Program part properties vary by whether the program
is called or main and, if main, by whether the program is of type basic, textUI,
or VGWebTransaction. The properties are as follows:
- @DLI
- This complex property lets you specify the call interface, PSB, and PCBs
for an EGL program that uses a DL/I database. For more information and details
about the fields you can change in this property, see @DLI.
- alias = "alias"
- A string that is incorporated into the names of generated output. If you
do not set the alias property, the program-part
name is used instead.
The alias property
is available in any program.
- allowUnqualifiedItemReferences = no, allowUnqualifiedItemReferences
= yes
- Specifies whether to allow your code to omit container and substructure
qualifiers when referencing items in structures.
The allowUnqualifiedItemReferences property
is available in any program.
- Consider the following record part, for example:
Record aRecordPart type basicRecord
10 myItem01 CHAR(5);
10 myItem02 CHAR(5);
end
The following variable is based on that part:
myRecord aRecordPart;
If you accept the default value of
allowUnqualifiedItemReferences (
no),
you must specify the record name when referring to myItem01, as in this assignment:
myValue = myRecord.myItem01;
If you set the property
allowUnqualifiedItemReferences to
yes,
however, you can avoid specifying the record name:
myValue = myItem01;
It is recommended that you accept the default value, which
promotes a best practice. By specifying the container name, you reduces ambiguity
for people who read your code and for EGL.
EGL uses a set of rules to
determine the area of memory to which a variable name or item name refers.
For details, see References to variables and constants.
- handleHardIOErrors = yes, handleHardIOErrors
= no
- Sets the default value for the system variable VGVar.handleHardIOErrors.
The variable controls whether a program continues to run after a hard error
has occurred on an I/O operation in a try block. The default value
for the property is yes, which sets the variable to 1.
Code that
was migrated from VisualAge® Generator may not work as before unless
you set handleHardIOErrors to no, which sets
the variable to 0.
This property is available in any program. For other
details, see VGVar.handleHardIOErrors and Exception handling.
- includeReferencedFunctions = no, includeReferencedFunctions
= yes
- Indicates whether the program contains a copy of each function that is
neither inside the program nor in a library accessed by the program.
The includeReferencedFunctions property is
available in any program.
- The default value is no, which means that you
can ignore this property if you are fulfilling the following practices at
development time, as is recommended:
- Place shared functions in a library
- Place non-shared functions in the program
If you are using shared functions that are not in a library, generation
is possible only if you set the property includeReferencedFunctions to yes.
- inputForm = "formName"
- Identifies a form that is presented to the user before the program logic
runs, as described in Input form.
The inputForm property
is available only in main text UI programs.
- inputUIRecord = VGUIRecord
- Identifies a VGUI record that a VGWebTransaction program receives from
a user's Web-page submission.
Two cases apply:
- The Web page was presented by a show statement
with a returning clause; and the user submitted
the Web page to fulfill the intent of that statement.
- Alternatively, a show statement with a returning clause
was not involved; nevertheless, the user clicked a Web-page button or hypertext
link to invoke an EGL program and to submit VGUI record data to that program.
The name of a given field in the VGUI record on the Web page must
have the same name and type as the corresponding field in the record identified
by the property inputUIRecord.
Data is not
placed in the
inputUIRecord property in these cases:
- A show statement invokes the program with a
set of arguments instead of with a VGUI record; or
- The Web page was presented by a converse statement;
and the user submitted the Web page to return to the next statement in the
same program.
The inputUIRecord property is available
only in VGWebTransaction programs.
For additional details, see show.
- inputRecord = "inputRecord"
- Identifies a global, basic record that a program automatically initializes
and that may receive data from a program that uses a transfer statement
to transfer control. For additional details, see Input record.
The inputRecord property
is available in any main program.
- localSQLScope = yes, localSQLScope
= no
- Indicates whether identifiers for SQL result sets and prepared statements
are local to the program, as is the default. If you accept the value yes,
different programs can use the same identifiers independently.
If you specify no,
the identifiers are shared throughout the run unit. The identifiers created
in the current code are available elsewhere, although other code can use localSQLScope
= yes to block access to those identifiers. Also, the current
code may reference identifiers created elsewhere, but only if the other code
was already run and did not block access.
The effects of sharing SQL
identifiers are as follows:
- You can open a result set in one program and get rows from that set in
another
- You can prepare an SQL statement in one program and run that statement
in another
The localSQLScope property is available
in any program.
- msgTablePrefix = "prefix"
- Specifies the first one to the four characters in the name of the DataTable
that is used as the message table for the program. The other characters in
the name correspond to one of the national language codes listed in DataTable
part in EGL source format.
The msgTablePrefix property
is available in any basic, textUI, or VGWebTransaction program. For other
details on messages that are used in a VGWebTransaction program, see the topic
for build descriptor option msgTablePrefix.
PageHandlers do not
use a message table, but use a JavaServer Faces message resource. For details
on that resource, see the description of the msgResource property
in PageHandler part in EGL source format,
- segmented = no, segmented = yes
- Indicates whether the program is segmented, as explained in Segmentation.
The value is always set to yes in VGWebTransaction programs, and
the default is no in main text UI programs.
The property is not valid in other types of programs.
- throwNrfEofExceptions = no, throwNrfEofExceptions
= yes
Specifies whether a soft error causes an exception to be thrown. The
default is no. For background information, see Exception handling.