7.114 SET_REF

Note: Usage options

The SET_REF command is used to assign a component reference to a variable that has been defined with a dynamic reference in the DEFINE_COM statement. With a dynamic reference, an instance of a component is created only when a reference to it is assigned with the SET_REF command.

Beware of using long object names (i.e. Names) with this command.
SET_REF Com(#MyObject) To(*CREATE_AS #MyFormWithLongNames) works with long names.
SET_REF Com(#MyObject) To(*CREATE_FROM #MyFormWithLongNames) doesn't work as it is runtime and long names are not available.

Also See

7.114.1 SET_REF Parameters

7.114.2 SET_REF Examples

7.74 IF_REF


                                                                                                    Required                                                                                 

       SET_REF ----- COM  --------- Variable name|variable name--------->                                                                                

                      >-- TO  ------------ Reference expression ----------------->                                                                                 

                      >-- CONTEXT  ---- *DEFAULT  ---------------------------->       
                                                    *OWNER                                    
                                                    *MODULE                                   
                                                    *NEW                                      
                                                    *NAMED ---- #Variable                                                                                               

                     >-- COM_ERROR-- *ABORT --------------------------------|       
                                                   *IGNORE                                   
                                                   *SET_NULL