Limited supportBMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.BMC recommends upgrading to the latest version of the product. To see documentation for that version, see DASD MANAGER PLUS for DB2 13.1.

Editing Service properties

Use this procedure to edit the Service properties, including EXEC, DD and template syntax program details. You can edit properties for user created Services only. You can browse BMC required Service properties, but you cannot edit them.

  1. On the DASD MANAGER PLUS Main Menu, select Services and press Enter.

  2. From the Services Menu panel, in the Service field, type the name of a Service, select Edit a Service Properties, and press Enter.

    Important

    As an alternative method, you can access the List Services panel from the Services Menu panel to edit service properties.

    1. On the Services Menu panel, enter a wild card character in the Service field and press Enter.
    2. On the Service List panel, type P next to a service and press Enter.

    Edit Service Properties panel

    DEAE ------------------------- Edit Service Properties ------------------------
     Command ===>                                                                   
                                                                                   
     Type Service data. Then press End.                                             
                                                                                   
     Service  . . : IKJEFT01                  Owner  . . . . . : RDAPKM             
     Type . . . . . PROGRAM                   Vendor . . . . . : USR                
     Program Name . IKJEFT01  (for EXEC PGM=) Updated by . . . : RDAPKM             
     APF  . . . . . Y    (Y/N APF authorized) Date last updated: 2022-03-04-11.09.55
     Attach key . . 8        (1-8 Attach key)                                       
     Program Parm .                                                                 
                  .                                                                 
     Description  .                                                                 
                  .                                                                 
                                                                                   
     Select edit option. Then press Enter.                                          
     Program Details . .   1. DD statements                                         
                           2. Syntax Template

  3. On the Edit Service Properties panel, enter information into the following fields, and then press Enter:

    Field name

    Description

    Type

    Documentation field, describes the type of service

    Example

    PROGRAM, REPORT, COPY, LOAD, and so on

    Program Name

    Program name as it appears in the JCL in the PGM= keyword

    APF

    Indicates whether the program must run APF authorized

    Attach Key

    Indicates the key to use during the attach

    Program Parm

    Parameter information as it appears in the JHCL in the PARM= keyword

    The parameter list can contain symbolic variables.

    Description

    Description of the service

    Program Details

    Available edit options

    For this task, select 1 (DD statements).

    The DD Statement List panel is displayed.

    DEAE  ----------------------- DD Statement List ---------      Row 1 to 2 of 2
    Command ===>                                                  Scroll ===> CSR  
                                                                                  
    Service: XL01COPY                                                              
                                                                                  
    For user-defined services, enter all DDs needed. For BMC and DB2 utilities, the
    standard DDs are defined in the JCL Options file and in the Service Syntax, and
    this list only contains special case DD additions.                             
                                                                                  
    C =Create   D =Delete   E =Edit   L =Like   A =After  B =Before  M =Move       
                                                                     More:       >
    Act Name      Type      Dataset Name                                           
    ******************************** Top of data **********************************
        XLO1DD01  INFILE    RDAPKM.TEST.INFILE1                                    
        XLO1DD01  INFILE    RDAPKM.TEST.INFILE2                                    
    ******************************* Bottom of data ********************************

  4. Enter DD statements as needed.

    Important

    For BMC Software required services, this list contains only additional DD statements that are not in the JCL product options file (POF) or syntax options.

    Do not add DD statements for BMC Software required services.

    Do not add a DD statement for the input (such as SYSIN). The syntax DD is named as part of the service syntax definition. The syntax DD is allocated to a job entry subsystem (JES) input stream for standard JCL. The syntax DD is allocated to a temporary data set if you run it in worklist format under AEXEMAIN.

  5. (optional) To edit DD statements, perform the following steps:

    1. Type E in the Act column next to the line item to be edited.The Edit DD Statement panel is displayed.

      DEAE ---------------------------- Edit DD Statement ---------------------------
      Command ===>                                                                   
      Type DD Statement data. Then press End.                                        
                                                                                    
      Service  . . : XL01COPY                                                        
      DD name  . . : XLO1DD01                                                        
      Type . . . . . INFILE   (INFILE, OUTFILE, REPORT, PGMLIB)                      
      Data set name  RDAPKM.TEST.INFILE1                                             
      Description  .                                                                 
                                                                                    
      DD Statement text (free-form)                                                  
       //   DISP=SHR                                                                 
                                                                                    
                                                                                    
      Restart DD Statement text (free-form)                                          
       //   DISP=OLD

    2. On the Edit DD Statement panel, type information into the following fields:

      In this field

      Enter this information

      DD name

      ddname, which can contain symbolic variables

      Important

      For DDNAMES defined for the USERDEF Service, you must edit the JCL to add the procstep to the DDNAME as follows:

      //procstep.ddnameDD

      Type

      • Use INFILE for input.
      • Use OUTFILE for output file name

      • Use REPORT for message output.

        For the automation component, the type is always allocated to SYSOUT=*.

        For AEXEMAIN, the type must be a data set. AEXEMAIN copies it to AEXPRINT. If the ddname is SYSPRINT, the standard temporary SYSPRINT is used under AEXEMAIN and this SYSPRINT is ignored.

      • Use PGMLIB for program library name.

        For the automation component or AEXEMAIN, the library is TASKLIB.

        For Standard JCL, the library is STEPLIB.

      DSN

      Data set name, which can contain symbolic variables

      If the data set is a PDS, you can supply a member name. The member name can contain symbolic variables.

      Restart DD Statement text

      JCL control card names (which can contain symbolic variables) to include in the DD statements

      The control cards generate as comments for generation from DASD MANAGER PLUS. With the automation component, the control cards generate on a restart.

      Do not use DSN= in the text because DASD MANAGER PLUS generates it automatically.

    3. Press END to save your changes and return to the Edit Service Properties panel (see the figure, Edit Service Properties panel, above).

  6. Edit the Syntax Template as follows:

    1. In the Program Details field, type 2 (Syntax Template). If your user-defined service has syntaxes already defined, the Syntax List panel is displayed, skip to Step 7.If your user-defined service does not have syntaxes defined, the Create Service Syntax panel is displayed.

      DEAE -------------------------- Create Service Syntax -------------------------
       Command ===>                                                                   
                                                                                     
       Press Enter to continue updating syntax options.                               
                                                                                     
       Service  . . . . : XL01COPY                                                    
       Syntax . . . . . .                                                             
       Owner  . . . . . . RDAPKM                                                      
       DDName . . . . . .                                                             
                                                                                     
       Description  . . .

    2. Enter the following information, and then press Enter to enter syntax text:

      In this field

      Enter this information

      Syntax

      Name of the selected service syntax

      Owner

      Authorization ID of the user who created the service syntax

      DDName

      JCL data definition to be allocated during execution of the service

      The DDName must conform to standard DD naming conventions.

      Description

      Short explanation to help identify the service syntax

      An edit session for the syntax text is displayed.

      EDIT       RDAPKM.T0291600.$04MAR16.$123259.$2854408            Syntax created
      Command ===>                                                  Scroll ===> CSR  
      ****** ***************************** Top of Data ******************************
      ''''''  DSN SYSTEM(&SSID)
      ''''''  -DISPLAY DATABASE(&DBNAME) SPACE(&SPNAME) LIMIT(*

    3. Enter syntax in column 2 and then press END to save your changes.

      Important

      JCL Execution does not execute SQL commands in worklist format. BMCTRIG must generate SQL commands in standard JCL format.

      The syntax for user-defined services can contain symbolic variables. For more information see the table of supported symbolic variables in User-defined programs or services.

    If your user defined service has at least syntax already defined, the Syntax List panel is displayed. You can also access this panel by editing an entry on the Action Services List panel.

  7. From the Service Syntax List panel, create or edit service syntax.

    DEAE ---------- Service Syntax List ------- ---------         Row 1 to 1 of 1  
     Command ===>                                                  Scroll ===> CSR  
                                                                                   
     Service . . . : XL01COPY                                                      
     Default Syntax: UX0189                                                        
                                                                                  
     Select an option or change Display filter. Then press Enter. To change        
     the default syntax, select another syntax with the 'F' option.                
                                                                                  
     B =Browse      C =Create         D =Delete       E =Edit   L =Like            
     P =Properties  A =Action Impact  V =View Syntax  F =Set default syntax        
                                                                                  
     Display filter                                                                
       Owner.Name . . . %.%                                                        
                                                                      More:   -   >
     Act Dflt Name                                      Owner     Description      
           Y  UX0189                                    RDAPKM                     
     ******************************* Bottom of data ******************************

    To limit your search criteria, edit the Owner.Name under Display filter. (The default value, %.%, specifies all syntaxes for the service.)

  8. (optional) In the Act field, type F to set the default syntax for the Service.When a Service is added to a Service Action on the Service Action List panel, the default syntax is automatically set for that service. You can override the default from the Service Action List panel.

    For more information, see Editing-Service-Syntax.



 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*