ScreenMan API

CLONE^DDS

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