CA Client Automation - 14.0

PDF
English

How to Create Custom Administrator Message

cla140
cla140
Contents
You can use software delivery to create, define, and associate a text message to a job container, individual jobs (activities within a job container), or both at the time of creating a job container. You can also add the text message for a procedure of a software package.
The message is displayed to the end users during the execution of the associated job container and its jobs. You can use these messages to convey appropriate information to the end users, for example, you can provide the following information in the message:
  • Inform end users about the purpose of the task that is being performed on the target computers.
  • Inform end users about any specific actions that you (as an administrator) want to perform on the target computers before or after the task.
  • Inform end users about any specific actions that they (end users) must perform before or after the task.
  • Include hyperlinks in the messages to direct end users to the appropriate resources for more information.
Specify a Custom Administrator Message
In the DSM Explorer, the option to associate a custom administrator message to a job container and a job is available from multiple locations. The following are the scenarios where you can add a custom administrator message:
  • Creating a software deployment job
  • Editing any software jobs folder
    This task is applicable only for the containers that are in the unsealed state.
  • Creating a software-based policy
  • Editing any software-based policy
    This task is applicable only for the containers that are in the unsealed state.
  • Setting up a job order
  • Creating a software deployment distribution job (Enterprise)
  • Creating a software-based policy (Enterprise)
Follow the standard steps for performing these tasks. The only additional information that you need to provide for the custom administrator message is to enter the message text in the User Message field on the appropriate tabs, such as Jobs, Job Container. Additionally, note that if you enable the Use comment as user message check box on the Procedure tab, the comment information of the Procedure tab is displayed as a default value in the User Message field of the Job tab; when the procedure (or the package including that procedure) is deployed while creating the deployment job.
The User Message field is not available if the individual jobs are intended for the staging purposes and a job container includes only staging jobs (also includes the Staging wizard). You cannot add a custom administrator message in such cases.
The following example procedure explains how you can add a custom administrator message for a new software deployment job. After you create the job, apply the job to a target computer or group of computers.
Example: Specify a Custom Administrator Message for a New Software Deployment Job
While creating a software deployment job, you can add a custom administrator message. You can include the appropriate information in the custom administrator message. The same information is displayed to the end user at the time when the job is scheduled to run on the target computer.
To specify a custom administrator message for a new software deployment job
  1. Navigate to the
    Domain
    , Jobs, Software Jobs folder in the DSM Explorer.
    A list of all the jobs appears.
  2. Right-click the Software Jobs folder, and select New, Software Deployment Job from the context menu.
    The Deploy Software Package wizard opens.
  3. Follow the instructions in the wizard to create a software deployment job.
  4. Select the Open the advanced job settings dialog when the Finish button is pressed option on the Finish screen of the wizard.
  5. Click Finish.
    The Setup Jobs dialog opens.
  6. Enter the appropriate message text in the User Message field on the Job Container tab and the Job tab.
    The Job tab is available under the Jobs tab.
  7. Click OK.
    The custom administrator message is added for the software deployment job.
Customize the Font Face, Style, Color, and Size of Custom Administrator Messages
You can customize the font face, size, style, and color of the custom administrator messages based on your requirements. To do the customization, open the agent.txt file and make necessary updates in the [USER_MESSAGE] section of the file. The agent.txt file is available under the location ..\Program Files\CA\DSM\SD\NLS.
A sample [USER_MESSAGE] section is given below:
[USER_MESSAGE]
; Font face to be used, default is Tahoma
  1 = Tahoma
; Font Size. Specifies the character height. The dialog is not resized due to this setting
  2 = 10
; Font Style. We have to set B for Bold, I for Italics, U for Underline. The dialog is not resized due to this setting
 3 = B
; Following 3 values are for RGB, these values can be used to set the color of the user message
; Value for R
  4 = 0
; Value for G
  5 = 50
; Value for B
  6 = 175
Display of the Custom Administrator Message to the End Users
The DSM Software Delivery Job Check dialog displays the custom administrator message to the end users. The job container message is displayed at the top of the dialog and the job message is displayed at the bottom. In the case of multiple jobs, click the appropriate job to know the associated job message.
Change the Security Settings for the Embedded Network Share Path
If you include a network share path in the job container message or the job message, you must change the local security settings for the network share path to work properly.
To change the security settings for the embedded network share path
  1. Run secpol.msc from the command prompt.
    The Local Security Settings window appears.
  2. Navigate to Security Settings, Local Policies, Security Options.
    A list of security settings appears in the right pane.
  3. Double-click the Network access: Shares that can be accessed anonymously setting.
    The Network access: Shares that can be accessed anonymously dialog appears.
  4. Add the name of the shared folder in the Local Policy setting tab, and click OK.
  5. Double-click the Network access: Restrict anonymous access to Named pipes or shares.
    The Network access: Restrict anonymous access to Named pipes or shares dialog appears.
  6. Select the Disabled option, and click OK.
    The local security settings for the embedded network share path are changed.