Finding and downloading a code list

You can use the information in this section to search for and download code lists.

About this task

The instructions in this section are useful when you are searching for or downloading a code list to either add or edit values in it.

The Checked out tab displays all code lists that are currently checked out. The Locked tab displays all code lists that are currently locked. Click Filter on the Checked out or Locked tab to further filter the code lists held by users or business alias.

Tip: Company user (user) or company administrator (admin) role users can filter by any user (from their company) that holds a lock or check-out for a code list. If IBM Support holds a lock or check-out, these users can also filter by IBM Services. Only IBM support user (support) and IBM system user (sys admin) roles can view and filter by the IBM Support names.

You can download the most recent code lists, regardless of the status of the code list.

From the side navigation menu, select Company resources > Code lists. Then, on the Code lists page, select a code list to view its details, including previous versions. The Production tab is displayed by default, showing the current code list that is deployed in production and all other versions of the same code list that were created for production.
On the Code list details page, click the CTE tab to view all code list versions that were created for the CTE environment.
Select the version of the code list that you want to view.
In Code list assets, click Production code list CSV file to automatically download the code list that is in production to your default folder. Click CTE code list CSV file to automatically download the code list that is in CTE to your default folder. Code lists are downloaded in CSV file format.

Tip: If no CTE code list CSV file is displayed for a code list version, that indicates that the code list version was checked out but not uploaded to CTE. If no Production code list CSV file is displayed for a code list version, that indicates that the code list version was not deployed to production.

After you download the CSV file, use a text editor or spreadsheet tool to open and edit it. For more information, see Editing a code list.

Important: After you complete your work with the code list, be sure to clean up any data from your local system, as you normally would when you work with a code list.

The search feature in Configuration Hub helps you to narrow down your search results. Use the Search function to filter display results. The search is not case-sensitive, and you can enter any part of the code list name. You can also sort the code lists by clicking the column headers.

The Code lists page includes the following information:

All: Displays a list of all of your company's code lists.
Available: Displays a list of all of your company's code lists that are not locked or checked out.
Checked out: Displays a list of all of your company's code lists that are checked out.
Locked: Displays a list of all of your company's code lists that are locked.
Status: The status of a code list. Possible code list statuses are Work in progress and Final. The status Conflict might occur when an update to the code list is made outside of Configuration Hub.
Code list name: The name of the code list.
Held by: The user who holds a lock or check-out on the code list.
Date last modified: The date on which the code list was last updated.
Production version: The version number of the code list that is deployed in production.
CTE version: The version number of the code list that is deployed in CTE.
Download: Download the code list that is running in production. For CMD code lists, download the initially primed CTE version of the code list. For non-CMD code lists, download the code list that is running in production.
Tip: The code list is downloaded in CSV format to your default folder.
Variant code list flag: A flag is displayed if the code list supports the use of different content in the CTE and production environments.

When you select a code list from the Code lists page, the general details for that code list are displayed.

Live in production: The version of the code list that is deployed in production. Not displayed if the code list is not deployed to production.
Checked out by: The user that currently owns the check-out on the code list. Not displayed if the code list is not checked out.
Reason for check out: The reason provided when the code list was checked out or the check-out was transferred. Not displayed if the code list is not checked out or if a reason was not provided.
Locked by: The user that currently owns the lock on the code list. Not displayed if the code list is not locked.
Reason for lock: The reason provided when the code list was locked. Not displayed if the code list is not locked or if a reason was not provided.
Status: The status of the code list. Possible code list statuses are Work in progress and Final. The status Conflict might be displayed when the Configuration Hub code list was edited externally.
CTE business alias: The CTE business alias that is associated with the code list.
Production business alias: The production business alias that is associated with the code list.
Code list description: The description of the code list. A company administrator (admin) or IBM Support can update the code list description if the code list is not checked out. Not displayed if a description does not exist for the code list.
Code list type: Indicates whether the code list uses the same or different content in the CTE and production environments. A company administrator (admin) or IBM Support can update the type setting for a code list if the code list is not checked out.
Comments about code list type: The comments provided when the code list type was changed. Not displayed if comments do not exist for the code list type.