Contents: | Main | Chapter | See Also: | Getting Started Manual | Advanced User Manual |
You can use this entry point to make a copy of a form. All blocks used on the form are copied and a new form that uses the new blocks is created.
In the following illustration, CLONE^DDS is used to make a copy of the XUEDIT CHARACTERISTICS form of the NEW PERSON file:
>D CLONE^DDS CLONE FORM FROM WHAT FILE: NEW PERSON Select FORM to clone: ?? Choose from: XUEDIT CHARACTERISTICS #1 12/06/90 File #200 XUEXISTING USER #2 12/12/90 File #200 Select FORM to clone: XUEDIT CHARACTERISTICS XUEDIT CHARACTERISTICS #1 12/06/90 File #200
Once you have selected a form to clone, a report that lists the blocks used on the form is printed:
BLOCKS USED ON FORM "XUEDIT CHARACTERISTICS" (IEN #1) Internal Entry Number Block Name ------------ ---------- 1 XUEDIT CHARACTERISTICS HDR 2 XUEDIT CHARACTERISTICS Enter RETURN to continue or '^' to exit:
You must assign names to the new form and blocks you are creating. If the original form and blocks are namespaced - that is, start with the same set of characters - you can choose to give the new form and blocks the same name, but with the namespace replaced with another set of characters. Then, when you are asked to enter new names, names that have the namespace replaced with the set of characters are displayed as defaults:
The new form and blocks must be given unique names. Give the new form and blocks the same names as the original, but a different namespace? YES// Original namespace: XU New namespace: ZZ Enter names for the new form and blocks. Original form name: XUEDIT CHARACTERISTICS New form name: ZZEDIT CHARACTERISTICS Original block name: XUEDIT CHARACTERISTICS HDR New block name: ZZEDIT CHARACTERISTICS HDR Original block name: XUEDIT CHARACTERISTICS New block name: ZZEDIT CHARACTERISTICS
After you have given names to the new form and blocks, you are ready to clone the form as follows:
Ready to clone form? YES Creating new blocks ... ZZEDIT CHARACTERISTICS HDR #71 ZZEDIT CHARACTERISTICS #72 Creating new form ... ZZEDIT CHARACTERISTICS #36 Repointing to new blocks ... Reindexing new form ... DONE! >
NOTE: Be sure to check the properties of the cloned form and blocks for namespaced variables, block references, etc., that may need to be modified manually.
Reviewed/Updated: March 4, 2007