                                                                atrbt_set
Chapter 11 Attribute Operations

The user may invoke the atrbt_set command to cause a specified action to occur
with a designated string for all of the attributes of objects in the specified
set on the current, active map.

atrbt_set
 
    Performs action on all attributes in named set.

         atrbt_set s action attr

    Causes the specified action with attribute string attr to occur to all
    objects in set s.

    If $++ is imbedded within the attribute string, it will be replaced with a
    5 character string (xxxxx) which is a whole number >= 0.  Each time an
    attribute containing the $++ string is assigned, the value is incremented.
    The initial value can be reset any time by using the plus_plus command.
    ___________________________________________________________________________
    Options/arguments:

         s         Set number, where:
                   0 - 31, inclusive, are valid set numbers
         action    Action code, where:
                   0 =  Replace all attributes w/single new one. 
                   1 =  Replace/set 1st attribute, leave others. 
                   2 =  Replace/set 2nd attribute, leave others. 
                   3 =  Insert new 1st attribute, increment others by one.
                   4 =  Prefix 1st existing attribute. 
                   5 =  Suffix 1st existing attribute. 
                   6 =  Add a new (additional) last attribute. 
                   7 =  Remove ALL attributes for one object.
                   8 =  Prefix 2nd existing attribute.
                   9 =  Suffix 2nd existing attribute.
         attr      Attribute string (maximum 30 characters long)
    ___________________________________________________________________________
    Note that the following special variable sequences are allowed:
    ___________________________________________________________________________
    $record

    This special attribute variable is converted to the object record  number
    when the attribute is assigned.  For example: if the attribute  string
    entered by the user is 'abc$record' and is assigned using atrbt_dig,
    atrbt_rec, atrbt_serial, or atrbt_set to object 123, then the attribute
    assigned is 'abc123'.
    ___________________________________________________________________________
    $serial

    This special attribute variable is converted to the object serial number
    when the attribute is assigned. For example: if the attribute string
    entered by the user is 'ab$serialzz' and is assigned using atrbt_dig,
    atrbt_rec, atrbt_serial, or atrbt_set to an object with a serial number of
    999, then the attribute assigned is 'ab999zz'.
    ___________________________________________________________________________

    ___________________________________________________________________________
    $++

    This special attribute variable is replaced by a 5 digit integer which can
    be initialized using the plus_plus command.  Each time an attribute is
    stored using the $++ variable substring, the internal value is incremented
    by 1.
    ___________________________________________________________________________
    Example(s);

    To assign the attribute XYZZY to the objects found in set 12 of the
    current, active map, enter:

         atrbt_set 12 3 XYZZY
     
    To suffix the existing attributes of the segments found in set 7 of the
    current, active map with the characters GY7, enter:
     
         atrbt_set 7 5 GY7
    ___________________________________________________________________________
    See also:

              atrbt_dig, atrbt_record, atrbt_serial, plus_plus
    ___________________________________________________________________________
