Use this procedure/function to assign the recipient copy count for a particular section, form, or group.
SetRecip (Recipient, Count, Section, Form, Group)
Parameter |
Description |
Recipient |
Enter a valid recipient name for the sections you want to change. |
Count |
Enter the total number of copies of the designated sections that you want this recipient to receive. The default is zero (0). |
Section |
Enter the name of the section you want to locate. The default is the current section. |
Form |
Enter the name of the form that contains the section you specified. The default is the current section. |
Group |
Enter the name of the group that contains the section or form you specified. The default is the current section. |
The system optionally returns one (1) on success or zero (0) on failure.
This procedure lets you specify how many copies of a section should print for a designated recipient. Setting the copy count to zero (0) for a recipient means the section will not print for that recipient.
Unlike other procedures, this one does not strictly apply the hierarchy rules for the section, form, and group, so you can specify a form without naming a section and the procedure will assign the copy count to all sections on that form designated for that recipient. Likewise, if you only specify the group parameter, without section or form, all the sections in that group will receive the new copy count for the designated recipient.
Note | This procedure cannot add a new recipient to a section. Images are predefined for specific recipients. This procedure can only change the copy count of known recipients for any particular section. |
Here are some examples:
Procedure |
Result |
Explanation |
SetRecip ("Insured", 2) |
1 or 0 |
Defaults to the current section. If this section includes Insured as a recipient, that copy count will be assigned 2. |
SetRecip("HOME OFFICE", 1, , "FORM") |
1 or 0 |
Locate FORM in the current group. Assign any section that specifies HOME OFFICE as a recipient the new copy count of one (1). |
© Copyright 2014, Oracle and/or its affiliates. All rights reserved. Legal notices.