Skip to content

Release ID Variables

Release ID variables are sets of global-level variables created and set by the global administrator. An application administrator can associate one of these release ID variable sets with an application. These variables are available to file tailoring for all batch jobs submitted for an application. You can define up to 54 variables under each release ID.

Caution

If you define more than 54 release ID variables, only 54 are kept and only 53 are available during processing. The 54th variable, if defined, will have a null value during processing. No warning is issued.

The original intent of release ID variables was to make it easy to change release numbers for system libraries by including release version variables in system data set names used in ChangeMan ZMF skeletons. Customers have found many ways to use release ID variables to add flexibility to their custom skeletons.

Caution

Use caution when designing skeleton customization around release ID variables. These variables and values must be entered and maintained by hand in the ChangeMan ZMF instance that you use to manage components in your production environment. As a more reliable alternative, consider coding variables in skeleton CMN$$VAR. You can manage a skeleton like CMN$$VAR with ChangeMan ZMF, which will guarantee that what you test is what you install in production.

Release ID variables are defined and updated in the Maintain option of the ChangeMan ZMF Skeleton Maintenance facility.

Accessing Maintain Release ID Variables

Display the Maintain Release ID Variables panel using one of these two methods.

  • Access the Skeleton Maintenance Options panel directly by typing =A.G.S.M and pressing Enter,

    or

  • Follow these steps to access the Maintain Release ID Variables panel using ChangeMan ZMF menus:

    1. On the Primary Option Menu, select option A Admin.

    2. On the Administration Options menu, select option G Global.

    3. On the Global Administration Options menu, select option S Skeletons. The Skeleton Maintenance Options menu (CMN3DSKL) is displayed.

    CMN3DSKL        Skeleton Maintenance Options
    Option ===>
    
    M   Maintain    Maintain skeleton release variables
    A   Assist      File tailoring assistance of skeleton procedures
    

    d. On the Skeleton Maintenance Options menu, select option M Maintain.

    The Maintain Release ID Variables panel (CMN3DSM0) is displayed.

    CMN3DSM0 Maintain Release Id Variables
    Option ===>
    
    blank Display release id list   D Delete release id
        R Rename release id         S Select release id
    
    Release id . . . . . (Blank for list; required for options S,R,D)
    New release id . . . (If option R selected)
    Enter "/" to select option
        / Confirm delete (if option D selected)
    

...

This table describes the fields on the Maintain Release ID Variables panel.

Field Description
Option Type one of the following options, or leave the Option line blank and type a line command next to a component name.
S   Select the release ID typed in the Release ID field.
R   Rename the release ID typed in the Release ID field using the new name typed in the New Release ID field.
D   Delete the release ID typed in the Release ID field.
blank   Display the Release ID List panel where you use line commands to take action against existing release IDs.
C   Cancel entries on this panel and return to the previous panel. (Long form: CANCEL)
RELEASE ID Type a 1-4 character release ID when Option S, R, or D is selected.
NEW RELEASE ID Type a new name for a release ID when Option R is selected.
CONFIRM DELETE Type Y or N to determine whether a confirmation panel is displayed before ChangeMan ZMF deletes a release ID.
Y   Display the Confirm Delete panel before a release ID is physically deleted.
N   Delete a release ID without displaying the Confirm Delete panel.

Creating a New Release ID

Follow these steps to create a new release ID and new release ID variables.

  1. On the Maintain Release Id Variables panel (CMN3DSM0):

    1. Type S in the Option line.

    2. Type a 1-4 character name in the Release id field. The name cannot start with a number.

    CMN3DSM0 Maintain Release Id Variables
    Option ===>  s
    
    blank Display release id list   D Delete release id
    R Rename release id         S Select release id
    
    Release id . . . .v8r1  (Blank for list; required for options S,R,D)
    New release id . . .    (If option R selected)
    
    Enter "/" to select option
        / Confirm delete (if option D   selected)
    

    ...

  2. Press Enter to display the releaseID - Skeleton Variables panel (CMN3DSM2).

    CMN3DSM2    V8R1 - Skeleton Variables           Row 1 to 21 of 21
    Command ===>                Scroll ===> CSR
    
    Release id description: Test Release number 1
    
        Variable    Description     Value
    ___ ________    ___________     __________    
    ___ ________    ___________     __________    
    ___ ________    ___________     __________    
    
    ******************************* Bottom of data ********************************
    

    ...

    This table describes the fields on the releaseID - Skeleton Variables panel.

    Field Description
    Command Type one of the following commands with the appropriate parameter, or leave the command line blank and type a line command next to a release ID variable.
    LOCATE variable  Locate a variable. (Abbreviation: L)
    SAVE  Save changes on this panel. (Abbreviation: S)
    COPY releaseID  Copy an existing release ID variable list to this list. (Abbreviation: CO)
    REFRESH  Refresh the variable list from the package master. (Abbreviation: R)
    CANCEL  Cancel updates on this panel. (Abbreviation: CA)
    Release id description Type a description for this release ID.
    Line Command Type one of the following line commands.
    I  Insert a line
    R  Repeat a line
    D   Delete a line
    Variable Type a variable name to be used in ISPF skeletons. Do not precede the name with ampersand (&) unless you intend for the ampersand to be part of the variable name.
    Description Type a description of the variable.
    Value Type a 1-32 character value for the variable. If you need a longer variable value, such as a long data set name, you can string two variables together in skeleton code.

    ...

  3. On the releaseID - Skeleton Variables panel, type a Release id description and type information in the Variable, Description, and Value fields for each new variable.

  4. Press PF3 to save the new release ID.

Maintaining an Existing Release ID

Follow these steps to maintain an existing release ID.

  1. On the Maintain Release Id Variables panel, press Enter to display the Release Id List panel (CMN3DSM1).

    CMN3DSM1 Release Id List Row 1 to 1 of 1
    Command ===>            Scroll ===> CSR
    
    Id  New     Changed     User    Description  Request
    V8R1    2015/02/24 00:58    USER015     Test Release number 1
    ******************************* Bottom of data ********************************
    

    ...

    This table describes fields on the Release Id List panel.

    Field Description
    Command Type one of the following commands with the appropriate parameters, or leave the command line blank and type a line command next to a release ID.
    LOCATE releaseID  Locate a variable. (Abbreviation: L)
    SELECT releaseID  Select the specified release ID for edit. (Abbreviation: S)
    CLEAR releaseID releaseID  Clear the previous request for the specified release ID. (Abbreviation: CL)
    DELETE releaseID  Delete the specificed release ID.
    REFRESH  Refresh the Release Id List panel from the package master. (Abbreviation: REF)
    RENAME oldreleaseID, newreleaseID  Rename the specified old release Id to a specified new name (Abbreviation: REN)
    CANCEL  Cancel updates on this panel. (Abbreviation: CA)
    Line Command Type one of the following line commands.
    S  Select a Release ID for edit
    R  Rename the release ID to the new name specified in the New field.
    D   Delete the release ID
    C  Clear the request made for this Release ID.
    Id Displays the release ID.
    New Type a new release ID name when the R line command or the RENAME command is used.
    Changed Displays the last date and time the release ID was changed.
    User Displays the TSO ID of the person who created the release ID or changed it last.
    Description Displays the release ID description.
    Request Displays the request made on this panel that will be processed when you exit from the panel. If you cancel these requests are not processed.

    ...

  2. Using commands with parameters typed in the Command line, or using line commands types on a release ID row, specify the action required for each release ID and the press Enter. The requested action appears in the Request field on the Release ID List panel. Clear a request with the CLEAR command or the C line command.

  3. When you are satisfied with the information in the Request column, press PF3 to exit the panel and execute the requests.

    If you requested a Select for a release ID, the releaseID - Skeleton Variables panel is displayed when you exit. This table describes the fields on the releaseID - Skeleton Variables panel.

    Field Description
    Command Type one of the following commands with the appropriate parameter, or leave the command line blank and type a line command next to a release ID variable.

    LOCATE variable  Locate a variable. (Abbreviation: L)
    SAVE  Save changes on this panel. (Abbreviation: S)
    COPY releaseID  Copy an existing release ID variable list to this list. (Abbreviation: CO)
    REFRESH  Refresh the variable list from the package master. (Abbreviation: R)
    CANCEL  Cancel updates on this panel. (Abbreviation: CA)
    Release id description Type a description for this release ID.
    Line Command Type one of the following line commands.
    I  Insert a line
    R  Repeat a line
    D   Delete a line
    Variable Type a variable name to be used in ISPF skeletons. Do not precede the name with ampersand (&) unless you intend for the ampersand to be part of the variable name.
    Description Type a description of the variable.
    Value Type a 1-32 character value for the variable. If you need a longer variable value, such as a long data set name, you can string two variables together in skeleton code.

    ...

  4. On the releaseID - Skeleton Variables panel, make the additions and changes you want, then press PF3 to save the updated release ID values.

Associating a Release ID with an Application

To make release ID variables available for file tailoring, you must associate the release ID with an application by specifying the release ID in Application Administration parameters.

Follow these steps to add a release ID to an application.

  1. Display the application Parameters - Part 1 of 3 panel by typing =A.A.1 and pressing Enter. As an alternative, you can use the ChangeMan ZMF menu hierarchy to reach the panel:

    1. On the Administration Options panel, select Option A Application.

    2. On the Update Application Administration Options panel, input the application you want to modify, and select Option 1 Parms.

    The application Parameters - Part 1 of 4 panel (CMNGLP01) is displayed.

    CMNGLP01 ACTP Parameters - Part 1 of 4
    Command ===>
    
    Application description . . . .     ACTP Accounts Payable (Base ZMF)
    Skeleton release id . . . . . .         (* for list)
    Normal business hours: from . . 0001
                             to . . 2300
    Audit level . . . . . . . . . . 4   (0,1,2,3,4,5)
    Checkout enforcement rule . . . 1   (1,2,3)
    Entity check if rule 2 . . . . .
    Staging restriction level . . . 1   (1,2,3)
    Entity check if level 2 . . . .
    Promotion/demotion rule . . . . 0   (0,1,2,3,4)
    Cmnaudrc entity check . . . . .
    Audit package lock . . . . . . . ALWAYS     (Always/Never/Optional)
    Component unlock entity . . . . CMPULENT
    Enter "/" to select option
        / Allow temporary packages
          Disallow concurrent checkout
          Allow checkout to personal lib
          Overlay prior staged module
          Validate version during staging    
    

    ...

  2. Type a release ID in the Optional Skeleton Release ID field, or use * for a list to select from.

  3. Repeatedly press Enter to cycle through all application Parameters panels until you are returned to the Update Application Administration Options panel.