Version 6.3.12 for OpenVMS
 —  Editors  —

Creating DDMs

This section describes how to create a DDM by either copying DDMs or creating DDMs directly from the field definitions in a database.

This section covers the following topics:


Copying DDMs

This section describes how to create a new DDM from an existing one.

If you want to copy DDMs between different libraries, database files, and/or hardware platforms, see also Maintaining DDMs in Different Environments.

Predict Installations:

If XREF entries exists for the DDM in the FDIC system file, they will also be copied for the new DDM.

Start of instruction setTo copy a DDM

  1. On the DDM Services screen, choose DDM Maintenance.

    The DDM maintenance window appears with a list of all DDMs available.

  2. In the DDM maintenance window, position the cursor at the DDM you want to copy (in the example below: EMPLOYEES), enter the function code C and press ENTER.

    The Copy DDM to window appears preset to the name of the DDM to be copied as shown in the example below:

     24/09/2004                       DDM Services              Library: SYSTEM        
     10:04:31               V 6.1.1 Pl 9   Software AG 2004     DBID   : 20         
     User: SAG                                                  FNR    : 14         
    +------------------------------------------------------------------------------+
    ¦   Library         DDM Maintenance           Services Profile         Quit    ¦
    +------------------------------------------------------------------------------+
                                    +-------------+                                 
                                    ¦   <CREATE>  ¦                                 
                                    ¦ C EMPLOYEES ¦                                 
                                    ¦   PERSONNEL ¦                                 
                         +----------- Copy DDM to -----------+                      
                         ¦ EMPLOYEES                         ¦                      
                         +-----------------------------------+                      
                                                                
                                                         
                                                 
                                                                                    
     Enter new DDM name
    
  3. In the Copy DDM to window, replace the preset name by a new one and press ENTER.

    The new DDM (here: EMPLOYEES_NEW) is saved as a source and a cataloged object and is added to the list of DDMs:

     24/09/2004                       DDM Services              Library: SYSTEM        
     10:04:31               V 6.1.1 Pl 9   Software AG 2004     DBID   : 20         
     User: SAG                                                  FNR    : 14         
    +------------------------------------------------------------------------------+
    ¦   Library         DDM Maintenance           Services Profile         Quit    ¦
    +------------------------------------------------------------------------------+
                                  +-----------------+                               
                                  ¦   <CREATE>      ¦                               
                                  ¦   EMPLOYEES     ¦                               
                                  ¦   EMPLOYEES_NEW ¦                               
                                  ¦   PERSONNEL     ¦                               
                                  ¦   VEHICLES      ¦                               
                                  +-----------------+                               
                                                                                    
                                                                                    
                                    
                                                                                    
     Select DDM
    

Top of page

<CREATE> from Adabas

This section describes how to create a new DDM from an Adabas database by using the <CREATE> menu option.

Start of instruction setTo create a DDM from an Adabas database

  1. On the DDM Services screen, choose DDM Maintenance.

    The DDM maintenance window appears.

  2. From the top of the DDM maintenance window, choose <CREATE>.

    The Select Database window appears as shown in the example below:

     24/09/2004                       DDM Services              Library: SYSTEM        
     10:04:31               V 6.1.1 Pl 9   Software AG 2004     DBID   :            
     User: SAG                                                  FNR    :            
    +------------------------------------------------------------------------------+
    ¦   Library         DDM Maintenance           Services Profile         Quit    ¦
    +------------------------------------------------------------------------------+
                                  +-----------------+                               
                                  ¦   <CREATE>      ¦                               
                     +------------- Select Database -------------+                  
                     ¦ DBID     1                                ¦                  
                     +-------------------------------------------+                  
                                  ¦   VEHICLES      ¦                               
                                  +-----------------+                               
                                                                          
                                                                                    
                                                                                    
                                                                                    
     Enter database number (0 - 65535 except 255)
    
  3. Enter the database ID (DBID) of the Adabas file for which a DDM is to be created. Valid values are 0 - 65535, except 255. If you enter a 0 (zero), the database ID specified with the Natural profile parameter UDB (see the Parameter Reference documentation) of the Natural parameter file NATPARM is used.

    If the specified DBID identifies an Adabas database, the Create ADABAS DDM window appears:

     24/09/2004                       DDM Services              Library: SYSTEM        
     10:04:31               V 6.1.1 Pl 9   Software AG 2004     DBID   :            
     User: SAG                                                  FNR    :            
    +------------------------------------------------------------------------------+
    ¦   Library         DDM Maintenance           Services Profile         Quit    ¦
    +------------------------------------------------------------------------------+
                                  +-----------------+                               
                                  ¦   <CREATE>      ¦                               
                     +------------ Create ADABAS DDM ------------+                  
                     ¦ FNR      1                                ¦                  
                     ¦ DDM Name                                  ¦                  
                     ¦ Password                                  ¦                  
                     +-------------------------------------------+                  
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
                                                                                    
     Enter file number (1 - 5000)                                                   
    
  4. Enter the file number (FNR) of the database file for which a DDM is to be created (valid values: 1 - 5000) and the name to be assigned to the DDM. If access to the Adabas file is protected, a password is required.

  5. Press ENTER.

    If the specified database and the file are available, the DDM editor is invoked and the fields contained in that database file are read into the editing area.

    If the specified database is not active or cannot be accessed or if the file does not exist, a corresponding error message is issued. Nevertheless, if you press ENTER, you can still open an empty DDM editor screen, enter new field attribute definitions and save the DDM source. However, in this case you cannot check any definitions against the database file description.

  6. If required, edit the DDM: see the section Using the DDM Editor.

  7. After editing, press ESC and, from the MISC menu choose EXIT (with STOW). See also Saving and Cataloging a DDM.

    The syntax of the DDM source is checked and the DDM is saved as a source and a cataloged object.

Top of page