Skip to content

Specifying Component Description, Procedures, and Security

Use the Component option of Application Administration to define and update optional facilities for a component.

  • Component general description - 48 lines of free-form text containing information about the component.

  • Designated compile procedure - The language, compile procedure, and other build options that must be used to stage, recompile, or relink a component.

  • Component level security - List of userids or security entities that are allowed to check out or stage a component.

The data you specify for these three facilities is stored in component history by component name and library type.

To access these component-level facilities, select option C Component on the Update Application Administration Options panel, and the application - Component Options panel (CMNCMPA0) is displayed.

CMNCMPA0                      DEMX - Component Options 
Option ===> __________________________________________________________________

G   General         General description information
P   Procedures      Designated compile procedures
S   Security        Security information

Defining Component General Descriptions

A component general description consists of up to 48 lines of free-form text stored on the component master for a component name and library type.

Note

A component general description and component general information are the same thing. Most application administration panels use the word information, and package panels use description.

This description can be created and updated through the Component General Information function in application administration. The information can also be created and updated in change packages if the library type is defined with the Checkout Component Description parameter set to Yes.

To create or update a component information description in application administration, follow these steps:

  1. Select option G General on the application - Component Options panel to display the application - Component General Information panel (CMNGENA1).

    CMNGENA1                DEMX - Component General Information 
    Option ===> ______________________________________________________________
    
    Library type . . ___    (Blank for list)
    
    1  Baseline      Select from baseline libraries
    2  Package Master Process existing component information records
    
  2. Type a library type (CLS in this case), or leave the Library Type field blank to display the Library Type Selection List panel where you can choose a library type.

  3. If you select option 1 Baseline on the application - Component General Information panel, the application Baseline Library List panel (CMNGENA2) shows you a list of components in the baseline library for the specified library type (CLS).

    {: .small-text-size }

    CMNGENA2                 DEMX Baseline Library List                 Row 1 to 9 of 9 
    Command ===> ____________________________________________________ Scroll ===> CSR 
    
    Baseline library:   CMNTP.S8.V813.BASE.DEMX.CLS
    Library type:       CLS
    
       Name     Status  vv.mm   Created     Changed     Time    Size    Init    User
     _ ACPCPY00         01.01   2008/09/08  2008/09/08  14:14   000023  000023  WSER239 
     _ ACPCPY1A         03.01   2002/05/07  2010/02/21  10:29   000004  000001  WSER239
     _ ACPCPY1B         03.01   2002/05/07  2010/02/21  10:29   000003  000001  WSER239
     _ ACPCPY1C         03.01   2002/05/07  2010/02/21  10:30   000003  000001  WSER239
     _ ACPCPY1X         03.01   2002/05/07  2010/02/21  10:30   000003  000001  WSER239
     _ ACPCPY2A         02.01   2002/05/07  2010/02/21  10:30   000004  000001  WSER239
     _ ACPCPY2B         02.01   2002/05/07  2010/02/21  10:30   000003  000001  WSER239
     _ ACPCPY2X         02.01   2002/05/07  2010/02/21  10:31   000003  000001  WSER239 
     _ ACPCPY3A         02.01   2002/05/07  2010/02/21  10:31   000004  000001  WSER239 
    ******************************** Bottom of data ***********************************
    
    • Type line command S to create or update a component general description.

    • Type line command D to delete the component general description.

  4. If you select option 2 Package Master on the application - Component General Information panel, the Component Information List panel (CMGENA5) shows you a list of component general descriptions that have been created previously.

    CMNGENA5 --------- DEMZ - Component Information List ------ Row 1 to 1 of 1 
    Command ===> _____________________________________________ Scroll ===> CSR
    
        Name                                                     Type 
      _ ACPCPY00                                               + CLS 
    **************************** Bottom of data *******************************
    
    • Type line command S to update a component general description.

    • Type line command D to delete the component general description.

  5. When you select a component on one of the list panels, the application - Component General Description panel (CMNGENA3) is displayed.

    CMNGENA3       DEMZ - Component General Description      Row 1 to 21 of 21 
    Command ===> ____________________________________________ Scroll ===> CSR
    
    Component:      ACPCPY00                                              +
    Library type:   CLS
    
        Description
    ___ ACPCPY00 general purpose component
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    ___ ______________________________________________________________________
    **************************** Bottom of data ******************************
    

    Type text in the lines provided. Use line commands I (insert), R (repeat), and D (Delete).

  6. Press PF3 to exit the application - Component General Description panel and update the component general description. You are returned to previous the selection list panel where the ISPF short message INFORMATION CHANGED is displayed, and the Status of the member is CHANGED. The ISPF long message is CMN5640I - ACPCPY00's general information record has been changed.

Defining Designated Compile Procedures

Designated compile procedures can completely eliminate variation in build processing for components before they are installed into production, and designated compile procedures can eliminate variation in development build processing as well. See Designated Compile Procedures.

If you choose to designate compiling procedures for the application's components, any user who wants to freeze a change package with the selected component must stage with the procedures entered on the panel (force level 2). If you designate a compiling procedure with force level 1, ChangeMan ZMF allows staging with alternate procedures during package development. However, the final stage (before you attempt to freeze) should be performed with the designated compile procedure for each component.

Follow these steps to define a designated compile procedure for a component or a group of components.

  1. Select Option P on the Component Information Option panel and press Enter. The Application - Designated Compile Procedures panel is displayed.

    CMNDCPA1                DEMX - Designated Compile Procedures 
    Option ===> ______________________________________________________________
    
    blank List defined procedures           C Change/add component procedures 
        D Delete component procedures
    
    Component name . . . . . _____________________________________________ + 
                                    (Full name or pattern; blank for list) 
    Library type . . . . . . ______ (Blank for list) 
    Compile procedure  . . . ______ (Blank for list) 
    Language name  . . . . . ______ (Blank for list) 
    Compile parms  . . . . . ____________________________________
    Binder parms . . . . . . ____________________________________
    Force level  . . . . . . ______ (1-Before Freeze only, 2-Always required)
    
    Enter "/" to select option 
      _ Db2 processing 
      _ Display more option panels
      _ Mixed case
    

    The following table describes the fields on the application - Designated Compile Procedures panel (CMNDCPA1).

    Field Description
    Option C - Change an existing designated procedure definition
    A - Add a new designated procedure definition
    D - Delete a designated procedure definition
    Blank - List existing component procedures
    Component name To add a new component or change an existing component, enter C on the command line and enter the component name or a pattern (e.g. PR* ). Enter D on the command line to delete the designated procedure for the component entered. The C and D options are not available in browse mode. If the command line is blank this field can be masked (e.g. PR* ). NOTE: When you add or delete a designated procedure, a * wildcard in the component name is considered part of the designated procedure name.
    However, when you use this panel to filter a list of designated procedures on the application - Designated Compile Procedures panel, a * is considered a wildcard character for the search.
    Library type Enter the component library type. Leave this field blank to display a Library Type selection list. If the command line is blank this field can be masked (e.g. SR*).
    Compile procedure Enter the designated compile procedure for the component. Leave this field blank for a selection list. If the command line is blank this field can be masked (e.g. CMN*). If the command line is blank, and both Component Name and Library Type fields are not masked, this field is ignored.
    Language name Enter the language name of the component. Leave this field blank for a Language Name selection list. Must match language on procedure above. If the command line is blank this field can be masked (e.g. PL*). If the command line is blank, and both Component Name and Library Type fields are not masked, this field is ignored.
    Compile parms Enter any extra compile parms as needed (defaults are hardcoded in the compile skeleton for the specified procedure).
    Binder parms Enter any extra binder parms as needed (defaults are hard coded in the link edit skeleton for the specified procedure).
    Force level
    1 - Component is to be compiled with this procedure only on the last compile prior to Freezing the package. Interim compiles may use other procedures. This is the default.
    2 - All compiles of this component must use the designated procedure.
    Db2 processing Indicates whether or not a Db2 pre-process or co-process is to be invoked during the compile. If the command line is blank, and both Component Name and Library Type fields are not masked, this field is ignored.
    Display more option panels Select to specify user options, or omit to bypass options. The User Options panel allows you to pass variables to your file tailored compile skeleton.
    Mixed case By default, all fields are folded to upper case. However, if 'Mixed Case' option is set to YES then the component name is left as is. Whichever case you enter will then be processed.

    ...

  2. You can use the application - Designated Compile Procedures panel to:

    • Define a new designated compile procedure - Choose option C, complete the panel fields, and press Enter.

    • Update an existing designated compile procedure - Choose option C, update the desired panel fields, and press Enter.

    • Delete an existing designated compile procedure - Choose option D, type the Component Name and Library Type fields to match the designated procedure you want to delete, and press Enter.

    • Produce a full or filtered list of existing designated compile procedures - Leave the option line blank, use the Component Name and Library Type fields as filter criteria (blank, data, or patterns), and press Enter.

  3. If you used the application - Designated Compile Procedures List panel to list existing designated compile procedures, the results are shown on the application - Designated Compile Procedures List panel (CMNDCPA2).

    CMNDCPA2     ACTP - Designated Compile Procedure List      Row 1 to 1 of 1 
    Command ===> ____________________________________________ Scroll ===> CSR
    
      Component     + Language Force    Db2     Compile parms 
      name       Type Proc     option   Proc    Binder parms 
    _ * 
                 SRC  ASM      1        NO      ________________________ CHG 
                    CMNASM                      ________________________
    *************************** Bottom of data *******************************
    
  4. You can use the application - Designated Compile Procedures List panel to:

    • Update an existing designated compile procedure - Overtype the fields shown for the designated procedure and press Enter.

    • Delete an existing designated compile procedure - Type line command D on a designated procedure and press Enter.

    ...

  5. If you use line command S on the application - Designated Compile Procedures List panel, or if you set Other Options to Y on the application - Designated Compile Procedures panel when you create or update a procedure, the User Options panels are displayed for the component. This is the first of up to 4 User Option panel as delivered. Your panels may have been customized.

    CMNUSR01                         User Options Part 1 
    Command ===> _____________________________________________________________
    
        Name: *                                                                  +
        Type: SRC       Language: COBOL2
    
        Compile only . . . . . _        IMS DLITxxx entry . . . _
        CICS precompile  . . . _        Drop include stmts  . . _
        Easytrieve object  . . _        User option 06  . . . . _
        User option 07 . . . . _        User option 08  . . . . _
        User option 09 . . . . _        User option 10  . . . . _
        User option 11 . . . . _        User option 12  . . . . _
        User option 13 . . . . _        User option 14  . . . . _
        User option 15 . . . . _        User option 16  . . . . _
        User option 17 . . . . _        User option 18  . . . . _
        User option 19 . . . . _        User option 20  . . . . _
    
    Enter "/" to select option
      _ Mixed Case
    
  6. Complete the fields on the User Options panel, and press Enter to save your changes.

Setting Component Level Security

Use the Component Level Security facility to create rules that are based on component name and library type that restrict who can check out and stage a component or a group of components that are related by component naming patterns and/or library type patterns.

To create, update, or delete a component level security rule:

  1. On the application - Component Options panel, select Option S and press enter. The application - Component Level Security panel is displayed:

    CMNSECA1                  DEMX - Component Level Security 
    Command ===> _____________________________________________________________
    
    Component . . . . . ____________________________________________________+
                                (Blank for all components) 
    Type  . . . . . . . ___     (Blank for all types)
    
    Enter "/" to select option 
      _ Mixed case
    

    The following table describes the fields on the application - Component Level Security panel:

    Field Description
    Component Enter the name of the component to secure to specific TSO IDs or entities. You may enter a pattern (e.g. PR* ), and all the components in the Baseline library that fit the pattern will be protected. To select from the Package Master list of components which have been protected, leave both fields blank.
    Type Enter the component's library type.
    Mixed case By default, all fields are folded to upper case. However, if 'Mixed case' option is set to YES then the component name is left as is. Whichever case you enter will then be processed.

    ...

    Note

    Component level security rules can be generalized by defining them with patterns in the component name and/or library type. For example, if you create a component level security rule for component name ABC* and library type X*, then the rule applies to all components with names starting in ABC in all library types starting with X.

  2. You can use the application - Component Level Security panel to:

    • Define a new component level security rule - Type a component name or pattern, a library type or pattern, and press Enter. The application - User List panel is displayed where complete the rule.

    • Update an existing component level security rule - Type the component name (which could be a pattern) and library type (which could be a pattern) used in an existing rule and press Enter. The application - User List panel is displayed where you update the rule.

    • List existing rules - Leave the component name blank, type a library type or pattern, and press Enter. The application - Component Level Security List panel is displayed where you can delete a rule or select a rule for update.

  3. If you left the component name blank on the application - Component Level Security panel to list existing component level security rules, and rules are found, the application - Component Level Security List panel is displayed.

    CMNSECA0        DEMX - Component Level Security List       Row 1 to 1 of 1
    Command ===> _____________________________________________ Scroll ===> CSR
    
      Name +                                                       Type 
    _ SECREVOK                                                     JCL
    *************************** Bottom of data *******************************
    
  4. You can use the application - Component Level Security List panel to:

    • Delete a component level security rule - Type D in the line command for a rule and press Enter.

    • Select a component level security rule for update - Type S in the line command for a rule and press Enter. The application - User List is displayed where update the rule.

  5. When you create a new component level security rule or select a rule for update, the application - User List is displayed.

    CMNSECA2                  DEMX - User List                  Row 1 to 3 of 3 
    Command ===> _____________________________________________ Scroll ===> CSR    
    
    Name: SECREVOK                                                           +  
    Type: JCL     
    
                    Entity   
        User        (y/n) 
    ___ USER15__    N 
    ___ USER25__    N   
    ___ USER35__    N  
    **************************** Bottom of data ******************************
    

    The following table describes the fields on the application - User List panel.

    Field Description
    Line command Enter one of the following valid line commands:
    I - Insert a new line
    R - Repeat an existing line
    D - Delete an existing line
    Userid Enter the authorized TSO ID or ENTITY to which checkout or staging will be restricted.
    Entity Enter 'Y' to identify the USERID as a security ENTITY, or enter 'N' (or blank) to identify it as a TSO ID.

    ...

  6. When you are finished with entries on the application - User List, press PF3 to save your changes and return to the previous panel.