Relating items to the change request


You can relate outages, incidents, infrastructure changes, known errors, and configuration items to a change request. You can relate only those items that are affected by the change request to a change request. For example, when you create a change request to format the assets in your organization, you can relate all the assets that need to be formatted.

When you relate an item to a change request, all the related items are also automatically related to the change request. For example, when you relate an outage to a change request, all the configuration items that relate to the outage are also automatically related to the change request.

When you create a change request that affects the assets or CIs of your organization, you can relate these assets to the change request. For these assets, you can then create an outage record to note when there would be a scheduled or unscheduled downtime for those assets. For example, when you create a change request to format machines, you can relate all those machines to the change request. You can then create an outage record for these machines.

When defining a relationship between a CI and a change request, the following options are available:

  • Related to—Relates the item or request to the change request.
  • Upgrades—Upgrades the item or items as part of the change request process.
  • Repairs—Repairs the items or items as part of the change request process.
  • Impacts—Impacts the item as part of the change request process.
  • Moves—Moves an item from one location to another location as part of the change request process.
  • Installs—Installs the item as part of the change request process.
  • Removes—Removes an item from the location as part the change request process.
  • Changes—Changes items as part of the change request process.

These options are for information purposes, which can be used while reporting based on the organizational requirements and processes.

 

To relate items to a change request

  1. On the Related Items tab for a change request, or release requests, click Relate existing item.
  2. Specify the related item type, such as Infrastructure change, Work Order, Incident, or Outage.
    (For BMC Helix ITSM: Smart ITonly) When you relate an existing outage to a change request, some filters are applied by default. For example, the system searches for scheduled outages for CIs related to the change request. If you want to search for other outages or for all outages, clear the default filters and add new filters as needed.
  3. Specify search criteria and initiate the search.
    You must specify some search criteria, such as a company name, status value, or keyword. To search for all records, enter the % wildcard character.
  4. Select related items and specify the relationship type.
  5. Click Save.
    The related items are displayed on the Related Items tab. You can view only those items to which you have access. if you click an item to which you do not have access, an error is displayed.

To relate CIs to change requests

  1. Open an existing change request.
  2. On the Configuration items tab, click Relate configuration item to add a related configuration item.
    To relate multiple CIs to the change request, you can search for multiple CIs by using commas to separate them. Select the required search results and click Add.
  3. In the Add configuration items (CIs) window, click Advanced to select the required Filters and Presets.

    Add configuration items_Advanced.jpg
  4. Click Apply filters and then click Save.
    The filters are displayed under the active link on the Activity tab.
  5. Search and select the required CI.

    Important

    You can select only 20 CIs when relating CIs to a change request. Click Select all CIs on page to perform this action.

  6. Select the Association type from the following options:
    • Changes
    • Impacts
    • Installs
    • Moves
    • Related to
    • Removes
    • Repairs
  7. Click Add.

The configuration item is related to the change request.

To create or edit an outage record

An outage is a downtime of an asset or a CI.  An outage can be scheduled or unscheduled. You can make changes to an outage whose Status is Scheduled by making changes directly in the ticket instead of opening the asset form.

Sometimes, after you create the outage record, you might have to make changes to the schedule of the outage. In the Ticket Console, you can make changes to the outage schedule directly in the ticket instead of making changes for each CI by opening the asset form.

You can also use one of the following assignment methods to assign individual outages or outages for multiple CIs to users:

  • Configuration item
  • Cross Referenced Request
  • Manually
  • Automated Routing

Based on the selected method, the Company, Organization, Support Group, and Assignee fields are populated.

Important

If you are assigning outages for multiple CIs simultaneously, you cannot use the Configuration item and Automated Routing options.

You create a change request to install the latest anti-virus software on all the laptops in the IT department on a Friday. But you have been requested to install the anti-virus software on a non-working day to avoid an outage on a working day. You update the availability details of all the laptops at a time in the change request, instead of searching for each laptop from the asset form and updating the availability details.

You create a change request to install the latest anti-virus software on all the laptops in the IT department on a Friday. But you have been requested to install the anti-virus software on a non-working day to avoid an outage on a working day. You update the availability details of all the laptops at a time in the change request, instead of searching for each laptop from the asset form and updating the availability details.

Before you begin

You must have the Asset Admin or Asset User permission to edit an outage. For more information, see Asset Management user roles and permissions.

  1. Open an existing ticket, such as a change request.
  2. To create a new outage, on the Related Items tab, complete the following steps:
    1. Select Create Related > Outage.
    2. On the Outages pane, select the CIs for which you want to create an outage.
  3. To edit an existing outage, on the Related Items tab, select the outage.
    Select an outage
  4. ​​​​​​From the Unavailability type list, select whether the CI unavailability is scheduled or unscheduled.
  5. Specify the Description for the outage.
  6. Select the schedule start and end date.
  7. In the Assignment section, select the Assignment method:
    1. Configuration item: The outage is assigned to the support group and assignee based on the assignment of the CI.
    2. Cross-Referenced Request: The outage is assigned to the support group and assignee based on the assignment of the cross-referenced change request.
    3. Manually: Select the support group and assignee manually.
    4. Automated Routing: The outage is assigned to the support group and assignee based on the automated routine that is defined in the CFG:Assignment form.
      Outage assignment​​​​​
  8. Click Save.

To relate impacted services and CIs to the change request

After the impact analysis is completed, you can relate the impacted CIs to the change request or discard the results. CIs found during the impact analysis are shown in a list format with the most impacted services at the top, up to a total of 100 services and CIs. You can select individual services and CIs, or you can select all services or all CIs and relate them to the change request.

The Initiate Impact Analysis option is unavailable if the impact analysis is in progress. If you want to stop an impact analysis that is in progress, use the Abort option. The Abort option is available when the impact analysis is in progress.

  1. Open a change request.
  2. Click More > Initiate Impact Analysis.

    Tip

    If you want to perform other tasks on other screens while the impact analysis runs, click Close in the Impacted CIs dialog box. You can open the Impacted CIs dialog box later to view the impact analysis results by opening the change request and clicking Show more on the impact analysis status message.

    ChangeImpactAnalysisBanner.png

  3. In the Impacted CIs dialog box, on the List view tab, select the CIs you want to relate.
    AsyncImpactAnalysis_False.png
  4. Click Relate.
  5. On the confirmation message, click Yes.

To exclude CIs with a Delete status from your search

You can search for CIs that are in Delete status from change requests. If you do not want the system to search for CIs in Delete status, you must select the check boxes for the statuses that you want to search, and clear the Delete check box. By default, in the search result the system displays CIs in all statuses including the Delete status.

To restore a CI that is in Delete status, when you create or edit change requests, on the CI tab, perform the advanced search and select the Delete check box to search for CIs in Delete status. From the search result, relate the change request with multiple CIs that are in Delete status to track configuration changes made to the CIs.

To create a related item

  1. On the Related Items tab for the incident, work order, problem, known error, or change request, create a related ticket, such as a Related Incident or Related Work Order. For an incident or a change request, you can also create a Related Outage. In PWA screens, for a change request, you can use a template to create a related change request.
    A new ticket opens in draft mode with some information pre-populated from the original ticket. Outages created from change requests require specific information.
  2. Update the new item as needed and save it.
    Relationships between the items appear in Related Items. The original ticket has a Created relationship that links to the new item, and the new item has a Created by relationship that links to the original ticket.
    In Smart IT, if you select Relationship type as Duplicate of when relating an incident to another, you can select only one incident in the table. However, in Progressive Web App incident screens, when you relate an existing incident as a duplicate, you can select multiple incidents but on clicking Save, you are asked to specify an incident only.

Information copied to a related ticket

The following minimum information is copied to the related incident, problem, known error, work order, or change request:

  • Customer and Customer Company
  • Summary
  • Notes
  • Affected Service
  • Priority

 

Instructions for classic interfaces

View instructions for classic Smart IT

To edit an outage record

  1. Open an existing ticket. For example, open a change request.
  2. Click on the Related Items tab.
    image-2023-4-25_12-14-18.png
  3. Select the the outage record that you want to edit and click Edit.
  4. Edit the fields that you want to change. For example, there is a change in the availability of the asset that relates to the change request. So, you edit Scheduled start date+ and Scheduled End date+.
  5. Click Save.

To relate impacted services and CIs to the change request

After the impact analysis is completed, you can relate the impacted CIs to the change request or to discard the results. CIs found during the impact analysis are shown in a list format with the most impacted services at the top, up to a total of 100 services and CIs. You can select individual services and CIs, or you can select all services or all CIs and relate them to the change request.

Click Relate All from the alert on the change request to relate all services and CIs to the change request without viewing the results, as shown in the following figure:

relate all from alert.png

Alternatively, click Conduct Impact Analysis from the alert to display the impact analysis results in graphical format. The graph displays all CIs and services that are related to the change request at the top, as starting nodes. Impacted CIs and services at the end of the relationship chain are shown along the bottom. Impacted services and CIs in the middle of the relationship chain are shown in blue boxes that you can expand or collapse by double-clicking, or by using the Expand all and Collapse all buttons near the top of the display.

You can open the Icon Guide in the universal client to view descriptions of the icons used for different types of CIs in the impact analysis.

icon guide.png

Click each service or CI individually to select it. Optionally, select the Box Selection control and drag your mouse over a group of CIs and services to mark all of them as selected. Click Clear Selection to deselect all services and CIs. You can use various display options to explore the impacted services and CIs. For example, you can zoom in and out, toggle to full screen mode, choose portrait or landscape layout, or manually drag CIs on the screen to optimize the view. Click the Recenter icon to restore the original display after zooming or manually dragging CIs.

box selection.png

Select Relate All at the bottom of the display to relate all impacted services, CIs, or both to the change request. For individually selected services and CIs, click Relate Selected.

select cis and services.png

View instructions for Mid Tier

To unrelate CIs from change requests

  1. In the Show Related field on the Relationships tab of the Change form, select Configuration Item.
  2. Select the required configuration item to unrelate, and then click Remove.

To view configuration items related to a change request

You can view the configuration information from the Relationships tab of the Change form.

Select the configuration item from the Show Related list, and then click View. The Asset Management Configuration Information form appears that displays the details of the configuration.

Important

You cannot define a new configuration item on the Relationships tab. Use the Functions > Manage CIs on the Change Management console to define new CIs. For more information, see Creating-a-CI.

To view the impact of CIs on change requests

You can relate configuration items to change requests, based on a simulated impact analysis generated by the Atrium Impact Simulator tool. Additional workflow in Change Management lets you use Atrium Impact Simulator functionality to predict how a change to the availability of a CI affects other CIs and services. For example, you could run a simulation in Atrium Impact Simulator to learn what devices and applications in the network are affected if you take a specific server offline due to scheduled maintenance or lease returns.

Atrium Impact Simulator is transparently integrated into other BMC applications as an integral part of their workflow. From Change Management, Atrium Impact Simulator exposes only the features required for the user, simplifying the user experience. For more information, see Atrium Impact Simulator analysis for change requests.

Important

The Impact Analysis functionality is not available on the Relationships tab of the Release form.

  1. Open the change request, and then click the Relationships tab.
  2. Relate at least one CI to the request.
    You can layer multiple requests for different types of CIs and add to the impacted list. You can use any Relationship Type except Impacts.
  3. In the Relationships tab, click Impact Analysis.

    Important

    The Impact Analysis button is enabled only for CIs that belong to Production Data Set (PDS). For more information on PDS, see Relating CIs to alternate datasets.

    The Atrium Impact Simulator opens.

    Impact Simulation_Results in table_20.02.01.jpg

  4. Click Simulate Impact to run the simulation.
    In the Simulation Progress dialog box, you can click the Cancel button to stop a long running simulation (if needed).
  5. Click the Results in Table tab.
    A list of impacted CIs are listed and also the number of results is displayed in the header bar.
  6. To relate the results to the change request, you can perform the following actions:

    Important

    Running an impact simulation does not relate the results automatically to the change record. You must click Execute to select the results that should be related.

    Action

    Result

    Set the Relate column to Yes or No.

    By default, the change results are defaulted to Yes to relate. Using the Relate column, you can individual toggle the action to No or Yes for granular control. These can be set as a group, by using the Execute option.

    Show Only Services (click to toggle)

    Lists only the impacted service CIs in the view.

    This action has no effect on relating.

    Show All Results (click to toggle)

    Lists all the impacted CIs in the view.

    This action has no effect on relating.

    Pick list and Execute button

    Modifies the relate options. They provide a quick way to select groups of CIs to relate or unrelate. You can select from the following options:

    • Relate All—Relates all CIs and services from the change request.
    • Unrelate All—Unrelates all CIs and services from the change request.
    • Relate All Services—Relates only services to the change request.
    • Unrelate All Services—Unrelates only services from the change request.
    • Relate Selected—Based on the CIs or services you pick, relates them to the change request.
    • Unrelate Selected—Based on the CIs or services you pick, unrelates them from the change request.

    Click Report

    Runs a report that exports all the fields in the simulation. This report can export all fields that are in the new .csv file or any subset of them.

    The report file, which is attached to the change request, provides a history that can be referenced in the future.

    Click Cancel

    Exits the window without make any changes.

  7. Click Save to create the CI relationship between the change request and the selected CIs.
    The CIs are now displayed in the Relationships tab. Work information is created for the change request with the attached simulation .csv file.

    Important

    The hour glass icon on the Atrium Impact Simulator keeps spinning even if the impact stimulation is completed. In this case, you need to click the hour glass icon on the screen to stop it.

  8. Click Close

To view CI relationships by using BMC Atrium Explorer

BMC Atrium Explorer displays configuration items (CIs) and their relationships to other CIs within CMDB, thereby enabling you to improve the accuracy of change planning by locating the CI. For more information, seeExploring asset relationships in the Asset Management documentation or Working with CIs and relationships in the CMDB online documentation.

  1. On the Change form, select Functions > Time Segments > Configuration Item (CI).
  2. In the CI Advanced Search dialog box, search for a CI.
  3. From the CI Search Results table, select a CI, and then click Explore CI.
  4. From the list of related CIs that are displayed, select the filter to limit the data that is displayed in the relationship viewer. 
    The relationship image is reloaded with the selected data.

To relate CIs from alternate datasets

When you open the Change form, different datasets are available when relating CIs to a change request:

  • Personal Preference Change Data Set (CDS)—When you open the Change form, the personal preference change dataset is loaded as a global setting from your application preference settings. If this setting is blank, the production dataset is loaded from the AST:AppSettings form. For more information, see Setting-application-preferences-and-options.
  • Production Data Set (PDS)—If there is no CDS, the PDS is loaded as the global setting. The PDS value is taken from the Dataset field on the AST:AppSettings form.
  • Alternate Data Set (ADS)—Field on the Change form on the Relationships tab that enables you to select a different dataset other than the CDS or PDS.

    Important

    For more information about datasets, see To configure Asset management settings in the Asset Management documentation.

You must understand the following restrictions if you use an alternate dataset when relating CIs:

Configuration items

Alternate Data Set field

Dataset preference

Result

If there are no CIs related to the change

Empty

CDS

You can select the Alternate Data Set as needed. After you start working on the change request, the setting of the ADS is the dataset that you selected last.

If there are no CIs related to the change

Empty

PDS

Production Data Set is used.

Important: An empty Alternate Data Set field is equivalent to using the Production Data Set.

If CIs are related to the change

Selected

Not applicable

Alternate Data Set field is locked. If you relate a CI with the Alternate Data Set, you must save the change to save the Alternate Data Set.

Important: There is no database rollback on the relationships.

If all related CIs are removed

Editable

Whatever the last value is

When all the related CIs are removed, the Alternate Data Set field becomes editable. If you clear the Alternate Data Set field when it is editable, the dataset is Production Data Set.

Important

  • The CDS is the default value, and is used only if ADS is set to CDS when you relate a CI. If you choose PDS, you must clear the Alternate Data Set field.
  • When the status of the change request moves to Closed, the change is locked for everyone except the change master. Only the change master can make modifications to a change request in the Closed status, including adding and removing relationships. For the change master, the Alternate Data Set field behaves the same way as when the relationship is not locked.
  1. In the Relationships tab, select a dataset from the Alternate Data Set list, for example, BMC Asset.
    Depending on the applications installed, you might see the following options:
    • BMC Asset
    • BMC Configuration Import
    • BMC Sample Dataset
    • BMC.ASSET.SANDBOX 
      alternate-dataset_61516_516.gif
  2. From the the CI Relationships Search dialog box, search for and relate CIs from the alternate dataset.
  3. Save the change request.