Maintain offers you flexibility when naming and referring to procedure components, such as fields, functions, Winform buttons, and stacks. When naming a component, be aware of the following guidelines:
There is no limit on the length of a qualified name, as long as the length of each of its component unqualified names does not exceed 66 characters.
Master File names, and names defined within a Master File (such as names of fields and segments), are subject to standard Master File language conventions, as defined in the Describing Data With WebFOCUS Language manual.
Procedure name length is dependent on the operating system. On the Mainframe, procedure names can be a maximum of eight characters long.
The names of projects and deployment scenarios can also include embedded spaces. (Other types of names cannot include spaces.)
For example, you may give the same name to fields in different segments, data sources, and stacks, and to controls in different Winforms, as long as you prevent ambiguous references by qualifying the names. A data source, a stack, and a Winform used in the same procedure can never have the same name.
Maintain requires that the qualification character be a period (.). The QUALCHAR parameter of the SET command must therefore be set to the default.
If a qualified name cannot fit onto the current line, you can break the name at the end of any one of its components, and continue it onto the next line. The continued name must begin with the qualification character. In the following example, the continued line is indented for clarity:
FOR ALL NEXT ThisIsAVeryLongDataSourceName.ThisIsAVeryLongSegmentName .ThisIsAVeryLongFieldName INTO CreditStack;
You can qualify the names of:
Qualification is important when:
For example, both the Employee and JobFile data sources have a field named JobCode. If you want to issue a NEXT command for the JobCode field in Employee, you would use a qualified field name:
You can qualify a field name with any combination of its data source, segment, and stack names. When including a stack name, you have the option of specifying a particular row in the stack. If you use several qualifiers, they must conform to the following order:
If you refer to a field using a single qualifier, such as Sales in the following example, and the qualifier is the name of both a segment and a stack, Maintain assumes that the name refers to the stack. To refer to the segment in this case, use the data source qualifier.