DDFGENERIC

Purpose

The DDFGENERIC control file entry applies to base AON functions.

Use the DDFGENERIC control file entry to define which AON message processing fields are to be used for the DDFADD generic value. DDFADD is used in the DDF panel and DDF tree definitions. By defining a generic DDF entry, you can group DDF notifications as appropriate for your environment.

The DDFGENERIC control file entry is required to implement DDF.

This statement applies to base AON functions.

Syntax

DDFGENERIC

where:

func.: Defines the function. The period is required to separate the func and field parameters.
field: Specifies the field to be compared.
VALUE: Defines the field values that match this DDFGENERIC statement.
OTHER: Specifies the default value used if the LEVELUP parameter or value is not found.
LEVELUP: Specifies the EZLTREE level at which to display the resources matching this DDFGENERIC statement.

Usage notes

When AON issues a notification, each field in the ENVIRON DDF,DDFGENERIC entry is compared with the DDFGENERIC entries. If AON finds a DDFGENERIC definition for an ENVIRON DDF,DDFGENERIC field, it compares the value in the ENVIRON DDF,DDFGENERIC field with the data in the VALUE parameter of the DDFGENERIC entry. If AON finds a match, it uses the DDFGENERIC value. If AON does not find a match, it uses the value in the OTHER parameter of the DDFGENERIC entry. If OTHER is not defined for this field, no value is saved for the field in DDF.
If the ENVIRON DDF,DDFGENERIC field is defined under a specific component and under AON, the component-specific definition is used first, then the general definition is used. A message can be saved for every match found.

Examples

In the following example, a DDF tree is defined in the EZLTREE member. Refer to this tree when reviewing the following DDFGENERIC examples.

/*   NETWORK : CNM01                                                 */
1 CNM01
  2 SYSTEM
    3 GATEWAY
    3 GROUPS
      4 CALIF
        5 LA
        5 SANFRAN
        5 SANDIEGO
      4 NEWYORK
      4 ATLANTA
    3 OPID
      4 OPER1
    3 NETWORK
      4 RESOURCE
      4 SNA
        5 SA
          6 NCP
          6 LINE
          6 LINKSTA
          6 CDRM
          6 CDRSC
          6 PU
          6 LU
          6 SESSION
          6 APPL
          6 ERR
        5 APPN
          6 CP
          6 EN
        5 X25
          6 X25MCH
          6 X25PU
      4 TCPIP
        5 IP390
          6 SP
          6 HOST
          6 ROUTER
          6 INFC
          6 LINK
          6 NAMESERV
          6 PORT
          6 TN3270

The definitions in the following example of a DDFGENERIC entry cause a PU to be saved on the DDF PU screen:
```
DDFGENERIC AON.RESTYPE,VALUE=(NCP,LINE,LINKSTA,PU,LU,CDRM,CDRSC,APPL),
           OTHER=RESOURCE,LEVELUP=NETWORK
DDFGENERIC RESTYPE,VALUE=(GATEWAY),LEVELUP=SYSTEM
```
If a resource type other than those listed is found, it is saved on the DDF RESOURCE panel, which is defined by the OTHER keyword. LEVELUP=NETWORK causes AON resources to be deleted at the NETWORK level. If a resource type was saved under different generics, all instances are deleted. The LEVELUP definition shows a higher level in the DDF tree than any of the elements under the VALUE parameter.