renameprefix

The renameprefix option is used for DATA-GEN.

The renameprefix option specifies the prefix for the subfields that specify the name to be generated for a subfield instead of the name of the subfield itself. The name of the rename subfield is formed by adding the subfield name to the renameprefix value. For example, assume that data structure meeting has a subfield meeting.attendees, and option "renameprefix=name_' was specified in the %DATA options for the DATA-GEN operation. The meeting.name_attendees subfield has the value "Attendees for the meeting". The DATA-GEN operation will pass "Attendees for the meeting" to the generator instead of the name "attendees" when it calls the generator with information for the meeting.attendees. The DATA-GEN operation will not pass any information about the meeting.name_attendees to the generator.

In the subsequent discussion of the "renameprefix" option, subfield meeting.name_attendees is referred to as the renameprefix subfield and meeting.attendees is referred to as the renamed subfield.

Note:
  1. A renameprefix subfield must be character or UCS-2. It cannot be a data structure.
  2. The value of the renameprefix subfield is trimmed of leading and trailing blanks if option "trim=all" is in effect.
  3. A renameprefix subfield cannot be a data structure or an array.
  4. If a subfield has a renameprefix name, but does not meet the rules for a renameprefix subfield, that subfield will be processed normally; it will not be considered to be a renameprefix subfield.
  5. A renamed subfield can be any type of subfield.

For examples of the "renameprefix" option, see Examples of the renameprefix option.