Defining the Release HLQ and dataset Pattern

The release management high level qualifier and dataset pattern are used in area library dataset names and in the dataset names of working libraries allocated and used for release audit. Area libraries are dynamically allocated for each release. The default format of release area library names is:

HLQ.ReleaseID.AreaID.ApplID.Libtype

The release management high level qualifier is set at the global level for all release area libraries in all releases. You set this parameter once when you first install ERO, and you do not change it.

You can use the release management dataset name pattern to:

  • Omit the ApplID node to allocate a single area library for each library type, combining all applications in the same library.

  • Rearrange order of dataset name nodes after the HLQ node.

The release management high level qualifier and dataset name pattern are established for each release when the release is created. You can change the release management high level qualifier in ERO Global parameters anytime, but existing releases will continue to allocate and use area libraries with the high level qualifier and dataset pattern that was in ERO Global parameters when the release was created.

Grant the started task where ERO runs ALTER access in your security system so that ERO can allocate, reallocate, update, and delete area libraries created with the release management high level qualifier and dataset name pattern.

Note

You must have global administrator authority to set the release high level qualifier or the dataset name pattern.

Follow these steps to define the release high level qualifier and the dataset name pattern:

  1. On the Release Global Administration Options panel CMNRMGAD, choose 1 Parameters and press Enter. The Global Parameters panel CMNRMGA1 is displayed.

    CMNRMGA1                    Global Parameters
Command ===>________________________________________________
High level qualifier . . . . . . . . CMNTP
High level HFS pathname . . . . . . /cmntp_______________________________
Dataset pattern . . . . . . . . . . HRAPL (Default is HRAPL)
                                            H - High Level Qualifier
                                            R - Release Name
                                            A - Release Area Name
                                            P - Release Application Name
                                            L - Release Library Type
                                                (must be last in pattern)
Minimum Audit Level for all Releases . . . .0       (0,1,2,3,4,5)

    Tip

    To jump directly to the Global Parameters panel from anywhere in ChangeMan ZMF, type =A.R.G.1 in the Command or Option line of any panel and press Enter.

    This table describes the fields on the Global Parameters panel.

    Field Description
    High Level Qualifier Type a valid dataset node name that conforms to your local standards for high level qualifiers.
    High Level HFS Pathname Type a valid HFS path name to be used as a prefix for all HFS area directory pathnames.
    Dataset pattern Type a 4- or 5-character dataset pattern for release area libraries. Arrange the letters in the order you want for the nodes in release area dataset names. The default pattern is HRAPL. H High Level Qualifier Required Must be first in pattern R Release Name Required A Release Area Name Required P Release Application Name Optional L Release Library Type Required Must be last in pattern
    Minimum Audit Level for all Releases Type one of the following values to specify a minimum audit level for all releases: Audit is optional. Audit is required and the return code must be less than 20 (audit failure). Audit is required and the return code must be less than or equal to 12 (which indicates that there are out-of-sync errors within the audited area). Audit is required and the return code must be less than or equal to 8 (which indicates that there are out-of-sync errors with respect to next areas/final areas in prior releases/baseline). Audit is required and the return code must be less than or equal to 4 (which indicates that there are no out-of-sync errors but some duplicates exist). Audit is required and the return code must be zero (which indicates that there are no out-of-sync errors or warnings). The value of this field determines the minimum audit level that the release administrator can set for a release, which in turn determines the minimum audit level that an area administrator can set for an area.

    If you omit “P” (Release Application Name) from the dataset pattern, checked in components for all joined applications are combined in a single area library for each library type. See Combined Application Area Libraries for a discussion of the consequences of combining applications in release area libraries.

  2. Press Enter to process. Press PF3 to return to the previous panel.

  3. Define security rules for the release area libraries that will be allocated with the release management high level qualifier and dataset pattern. Grant ALTER access (create, update, delete) to the SERNET started task where ChangeMan ZMF runs.

  4. Define dataset management (SMS) rules for the area libraries that will be allocated with the release management high level qualifier. The rules should be the same as the rules for staging libraries allocated and managed in the base ChangeMan ZMF product.