To configure VSC

This section describes the steps that you must take before you can start using VSC.

To configure VSC

To configure VSC you must take the following steps:

Schritt 1. Install VSC

Before you can use VSC, you must generate the basic VSC settings.

  1. Start the Install VSC (tlvsc1201m000) session.
  2. Specify the name and description for the base verification code.
  3. Click Finish.

The session executes the following actions:

  • Generates the base verification code.
  • Links your package combination to the base verification code.
  • Links the default verification filter ("VSC Filter Installation") to the base verification code.
  • Generates the coding standards for the LN software components, based on the official LN Software Coding Standards (SCS).
Schritt 2. Change the VSC password

The VSC password is used to limit the access to various administrative VSC sessions. The end-user sessions are not password protected.

During the installation the VSC password is automatically set to "vsc". It is recommended to change this password immediately after the installation.

To change the VSC password:

  1. Start the Change Password VSC (tlvsc0291s000) session.
  2. Enter the old password.
  3. Enter the new password twice and click Change Password.
Schritt 3. Optional - Maintain the coding standards

The LN Software Coding Standards (SCS) is a set of standards that define how each software component type must be coded.

When you install VSC, these standards are generated in your LN environment.

You can maintain these standards via the Coding Standards (tlvsc1150m000) session. Use this session only if you want to modify or extend the standards that were generated during the installation. For example, if you want to add new coding standard for a new type of session that you developed.

Schritt 4. Optional - Create additional verification codes

During the installation of VSC, one base verification code is generated.

Optionally, you can add additional verification codes, for example if you want to perform additional checks, or if you want to test software components that belong to different package combinations.

You can add verification codes in the Verification Codes (tlvsc1500m000) session.

Schritt 5. Optional - Link additional package combinations to the verification code(s)

During the installation of VSC, one package combination is linked to the base verification code. To perform checks on components in other package combinations, you can link additional package combinations to the base verification code.

To link package combinations to a verification code:

  1. Start the Verification Codes (tlvsc1500m000) session.
  2. Select the verification code to which you want to link a package combination, and on the Zusatzoptionen menu click Package Combinations vs Verification Codes. The Package Combinations vs Verification Codes (tlvsc1501m000) session starts.
  3. Add the desired package combinations.

Note: You can also start the Package Combinations vs Verification Codes (tlvsc1501m000) session directly from the menu browser.

Schritt 6. Define Verification Filter(s)

During the installation of VSC, one generic verification filter is linked to the base verification code. This filter defines the checks that are executed to verify all software components in all packages. Depending on the filter settings, the checks in the generic filter can generate two types of warnings:

  • "Filtered to Handle" warnings. You must handle these warnings immediately. You must either solve or accept these filtered warnings.
  • "Non-filtered" warnings that you do not have to handle immediately.

Optionally, you can define one or more specific verification filters. You can use a specific filter to reduce the number of "FiItered to Handle" warnings for a specific package, module or VRC. Each specific filter is derived from the generic filter, and therefore executes exactly the same checks as the generic filter. In a specific filter, you can indicate for each check whether you want to generate "FiItered to Handle" warnings or "Non-filtered" warnings.

Define a specific verification filter

To add a specific filter to a verification code:

  1. Start the Verification Codes (tlvsc1500m000) session.
  2. Select the verification code to which you want to link the filter, and on the Zusatzoptionen menu click Verification Filters. The Verification Filters (tlvsc2510m000) session starts.
  3. Click New to add a filter. The Verification Filter Defaults (tlvsc2110m000) details session starts.
  4. Specify the package, module, or package VRC for which the filter is intended.
  5. Specify a priority filter and a category filter.
  6. Indicate for which checks you want to generate "Non-filtered" warnings. Points of attention:
    • A specific filter executes exactly the same checks as the generic filter. Therefore the session automatically selects the corresponding check boxes.
    • To generate non-filtered warnings for a particular check, you must clear the corresponding check box.
    • Note: you cannot disable checks, or add extra checks in a specific filter. If you select a check, which is not present in the generic filter, VSC ignores this check.

For more information, refer to the online session help.

Note: You can also start the Verification Filters (tlvsc2510m000) session directly from the menu browser.

Schritt 7. Define Source Analyze Codes

You can link one or more source analyze codes to a verification filter. Source analyze codes are used to perform user-defined checks on scripts such as UI scripts, DLLs and DALs. Each source analyze code is linked to an expression text and to a warning message. The expression text contains a search pattern, which is used to find errors.

To create a source analyze code:

  1. Start the Source Analyze Codes (tlvsc3511m000) session.
  2. Click New. The Source Analyze Codes (tlvsc3111m000) details session starts.
  3. Specify the properties for the new source analyze code, such as the message ID, the rule ID, the warning message, and the category.
  4. Click Edit Text to start the text editor.
  5. Enter the expression text. The expression text must contain a search pattern, which is used to find errors.
  6. Close the text editor and save the new source analyze code.

Note: For more information, refer to Source Analyze Codes.

Schritt 8. Link Source Analyze Codes to the generic verification filter

To make sure that the checks defined in a source analyze code's expression are executed, you must link the source analyze code to the generic verification filter.

To link source analyze codes to the generic verification filter:

  1. Start the Verification Filters (tlvsc2510m000) session and double-click the generic verification filter. The Verification Filter Defaults (tlvsc2110m000) session starts.
  2. Go to the Scripts tab and click Analyze Codes. The Source Analyze Codes per Verification Filter (tlvsc2512m000) session starts.
  3. Use the check boxes to enable/disable the desired source analyze codes for the generic verification filter.
    • Note: VSC executes the enabled source analyze codes not only for the generic verification filter, but also for all specific verification filters.
Schritt 9. Optional: Modify Source Analyze Codes for specific verification filters

The source analyze codes that are enabled for the generic verification filter, are also executed for all specific verification filters.

In a specific filter, you can indicate for each source analyze code whether you want to generate:

  • "FiItered to Handle" warnings, or
  • "Non-filtered" warnings that you do not have to handle immediately.

To specify that VSC must generate "Non-filtered" warnings:

  1. Start the Verification Filters (tlvsc2510m000) session and double-click a specific verification filter. The Verification Filter Defaults (tlvsc2110m000) session starts.
  2. Go to the Scripts tab.
  3. Take one of the following steps:
    • Clear the Analyze Codes check box. As a result VSC generates "Non-filtered" warnings for all enabled source analyze codes.
    • To make sure that VSC generates non-filtered warnings for only a part of the source analyze codes, click Analyze Codes. The Source Analyze Codes per Verification Filter (tlvsc2512m000) session starts. Clear the check boxes for the source analyze codes for which VSC must generate "Non-filtered" warnings.

Note: you cannot add extra source analyze codes in a specific filter. If you select an analyze code, which is not enabled in the generic filter, VSC ignores this analyze code.