address-block (nrcmd)					address-block (nrcmd)


NAME
    address-block - Defines a contiguous block of IP address space

SYNOPSIS
    address-block <address/mask-length> create[<attribute>=<value> ...]
    address-block <address/mask-length> delete 
    address-block list
    address-block listnames
    address-block <name> show
    address-block <name> get <attribute>
    address-block <name> set <attribute>=<value> [<attribute>=<value> ...]
    address-block <name> unset <attribute>

DESCRIPTION
    An address block is an aggregate of IP addresses based on a
    power-of-two address space. For example, the 192.168.0.0/16 address
    block includes 65536 (2^16) addresses.  
        
    Address blocks can be further divided into child address blocks and
    subnets. For example, you might want to divide the 192.168.0.0/16
    address block further into four child address blocks: 192.168.0.0/17,
    192.168.64.0/17, 192.168.128.0/17, and 192.168.192.0/17. A subnet is
    used to designate a leaf node of the address space that will not be
    further subdivided.

    Address blocks are used as a management tool to group and report on
    address space usage. The owner and region properties on an address
    block or its parent can be used to constrain user access to address
    space reports.
    
EXAMPLES
    nrcmd> address-block 192.168.0.0/16 create

STATUS

SEE ALSO
    subnet, owner, region

PROPERTIES
  Attributes:

    address[2] (AT_SUBNET, Required, default: <none>)
        Specifies the IP address and mask of the CCM address block,
        which was set at creation. This defines the address range
        of the block. Use the set command to redefine the address.

    description[13] (AT_STRING, Optional, default: <none>)
        Describes how this address block is used.

    forward-zone-name[19] (AT_DNSNAME, Optional, default: <none>)
        Names the forward zone associated with this block.

    owner[6] (AT_OID, Optional, default: <none>)
        Names the owner of this address block. Use the owner field
        to group similarly owned address blocks; to limit administrative
        access; and to track allocation or delegation for ARIN
        reporting purposes.

    parent[1] (AT_OID, Optional, default: <none>)
        Identifies the parent address block.

    region[5] (AT_OID, Optional, default: <none>)
        Names the region associated with this address block. Use the
        region field to group similarly located address blocks and to
        limit administrative access.

    report-state[21] (AT_ENUMINT(), Optional, default: <none>)
        Transient report state of the CCM address block, provided
        to make it easier for ARIN reporting and for clients to
        filter the list of address blocks they display.
            0  available
            1  internal
            2  reallocated
            3  reassigned

    reverse-zone-name[20] (AT_DNSNAME, Optional, default: <none>)
        Names the reverse zone associated with this block.

    sink[12] (AT_OID, Optional, default: <none>)
        Points to either the CCMOwner or CCMCluster for a
        a leaf block delegated to a lower-level sink.
        Delegated AddrBlocks (those with a non-null sink attribute)
        cannot be further split into child address blocks or subnets.

    source[11] (AT_OID, Optional, default: <none>)
        Points to the CCMOwner configuration object representing
        the source for a top-level block allocated from a higher-level
        source.

    type[4] (AT_NAMEREF(1446), Optional, default: <none>)
        Defines an addresss-block type, enabling you to group
        address blocks that share common properties, such as their
        associated scope template. This attribute names a
        CCMAddrSpaceType object that contains more information about
        the type.

    vpn-id[3] (AT_INT, Optional, default: 0)
        Identifies the ID the VPN object used to support multiple
        address spaces, such as in a managed VPN environment.

