7.0 Creating the Application Object to Apply the Personality

To create an Application object to apply the personality to users’ workstations, you copy the information from an existing Application object.

  1. In ConsoleOne®, right-click the container that you want to create the Application object in, click New, then click Object.

  2. Click Application, then click OK.

  3. Click An Application By Using an Existing Application Object.

  4. Click Next, then browse to and select the Application object you want to duplicate (in this example, the CollectDNA object).

  5. Click Next.

  6. In the Object Name field, type a descriptive name for the new object (ApplyDNA, for example), then click Next.

  7. If necessary, define the system requirements that a workstation must meet before the application is distributed to it, then click Next.

  8. Associate the Application object with the users or workstations that you want to distribute the application to, select the Force Run check box, then click Next.

  9. Review the settings for the Application object, select the Display Details After Creation check box, then click Finish.

  10. Click the Run Options tab, then click Application.

  11. In the Parameters field, type the following:

    %DDNA_ACTION% %DDNA_DATA%\%DDNA_USER%\%DDNA_WS% /T %DDNA_SOURCE%\Templates\%DDNA_TEMPLATE% /X %DDNA_SILENT%
    

    For example, using the sample directories explained above:

    /A \\server1\vol\ddna\data\%DNA_User%\%DDNA_WS% /T \\server1\vol\ddna\templates\mydnatemplate.dtf /X %DDNA_SILENT%
    

    The following example applies the DNA file while the user interface is active:

    /M /A \\server1\vol\ddna\data\%DDNA_User%\%DDNA_WS% /T \\server1\vol\ddna\templates\mydnatemplate.dtf /X %DDNA_SILENT% 
    

    The parameter is the same as the parameter for the CollectDNA Application object except the /D (create the DNA file) switch has been replaced with the /A (apply the DNA file) switch.

    The following table contains information about each switch not defined using an application macro:

    Switch

    Description

    Parameters

    /T

    Uses a template to specify migration settings.

    Template file to use for this migration. Use a UNC path to specify the location.

    /M

    Starts the migration.

    (Optional switch.) /M cannot be used with the /Q switch (silent mode). This switch should be used only in conjunction with the /D switch (to create a DNA file) or with the /A switch (to apply a specified DNA file).

    /X

    Exits Desktop DNA ZENworks Edition when migration is completed (unless an error occurrs).

     

    The following table contains information about each ApplyDNA macro in this parameter.

    Macro

    Value

    Description

    DDNA_ACTION

    /A

    Applies a personality to a workstation. Make sure that this value immediately precedes the argument applying the DNA file you want to apply to the workstation.

    DDNA_DATA

    UNC path to the ddnadata share or directory

    Specifies the directory where the personality file will be copied to or retrieved from

    DDNA_SILENT

    /Q or Empty

    /Q: Silently performs the action

    Empty: Provides a progress dialog box as the action is performed

    NOTE:This macro must be empty if the   /M switch is specified.

    DDNA_SOURCE

    UNC path to the ddnarun share or directory

    Directory where the Desktop DNA executable is located

    DDNA_TEMPLATE

    Template file

    Filename of the template file to use

    DDNA_USER

    %CN%

    Username of the current user

    DDNA_WS

    %DNA_MACHINE_NAME%

    Workstation machine name

  12. Click OK to save the Application object information.