How to code the name attribute

The first nonblank item on the line is the name attribute followed by the value of the name attribute, which is enclosed in single quotation marks.

At least one blank must separate the name attribute from the value for the name attribute. The value of the name attribute is an AE-title.

The format of the value for the name attribute can vary. The actual value to be used is determined by the manager or agent application program.

Multiple entries with the same value for the name attribute can exist in the directory definition file when all attributes under entries with that name value are different.

The following examples show how to specify the value for the name attribute. The value stands for an instance of CMIP services.
  • The name of CMIP services on a particular network-qualified CP or SSCP name. An ampersand causes the line to continue.
    name '1.3.18.0.2.4.6=NETA;2.9.3.2.7.4=(name SSCP1A);&
    1.3.18.0.2.4.12=OSISMASE'
    The name consists of object identifiers and values. Object identifier 1.3.18.0.2.4.6 means the SNA network node name:
    • ISO has assigned 1.3.18 to IBM®.
    • IBM has assigned 0.2.4.6 to mean a SNA network node name.
    The other object identifiers are similarly assigned:
    • Object identifier 2.9.3.2.7.4 means a SNA node name, either a CP or an SSCP name.
    • Object identifier 1.3.18.0.2.4.12 means the application entity title (AE-title). Generally, the AE-title refers to CMIP services, which is always OSISMASE for VTAM®.
  • A network-qualified CP or SSCP name by itself:
    name '1.3.18.0.2.4.6=NETA;2.9.3.2.7.4=(name SSCP1A)'

    A trailing wildcard character ('*') can be used in the CP or SSCP name to indicate that the rule matches any network-qualified CP or SSCP name with the specified netid and a CP or SSCP name that matches up through the wildcard character and has zero or more characters after it. If the wild card is specified, it must be the last character in the CP or SSCP name.

    For example, the following name attribute rules match NETA.SSCP2B:
    1. name '1.3.18.0.2.4.6=NETA;2.9.3.2.7.4=(name S*)'
    2. name '1.3.18.0.2.4.6=NETA;2.9.3.2.7.4=(name SSSC*)'
    3. name '1.3.18.0.2.4.6=NETA;2.9.3.2.7.4=(name SSSCP2*)'
    4. name '1.3.18.0.2.4.6=NETA;2.9.3.2.7.4=(name SSSCP2B*)'
    5. name '1.3.18.0.2.4.6=NETA;2.9.3.2.7.4=(name SSSCP2B)'

    If an exact match is specified, such as 5 in the previous example, it will be selected, even if there are one or more wildcard rules which match, such as 1, 2, 3, and 4 in the previous example.

    If more than one exact match is specified, it is indeterminate which exact match will be selected by CMIP Services.

    If no exact match is specified and multiple wildcard matches are specified, it is indeterminate which wildcard match will be selected by CMIP Services.

  • A network name by itself:
    name '1.3.18.0.2.4.6=NETA'
  • Global match, which matches any name:
    name '*'