IP_ADDR_MASK_PAIR

Required? Yes
Keyword Type String
Field Length 1–256
Multiples Allowed? No, only one for each TN5250_FILTER keyword
   IP_ADDR_MASK_PAIR = (
      @TYPE = STRINGKEYWORD
      @FIELD_LENGTH = 1, 256
      @REQUIRED = 1
   )
The IP_ADDR_MASK_PAIR parameter specifies one of the following:
  • The domain name to which you wish to restrict host resources (LUs)
  • The host name to which you wish to restrict host resources (LUs)
  • The source IP address and subnet mask of the TCP/IP workstation(s) to which you wish to restrict host resources (LUs). The IP address and the subnet mask values are separated by a comma. Only those clients matching the IP address and subnet mask combination are granted access to the list of resources represented by this filter

Whether the value you specify is a domain name, host name, or IP address and subnet mask is determined by the CLIENT_ID_TYPE parameter.

The value is a 1- to 256-byte character string.

This parameter is required.

If you wish to restrict host resources to a specific workstation, specify that workstation's IP address and the subnet mask of 255.255.255.255. If you wish to restrict host resources to all workstations in a particular IP subnetwork, such as a local office LAN, specify one of the workstation IP addresses and a subnet mask to identify the IP address values that are significant for identifying the subnetwork. For example, to restrict host resources for all workstations in the subnet 9.57.0.0, you might specify a source IP address of 9.57.126.4 and a subnet mask of 255.255.0.0. If you specify a specific IP address and full subnet mask (filtering for a specific workstation), that workstation is granted access to the first available host resource, whether it be an explicit LU or an LU from a pool of LUs. If the filter is designated for workstations on a particular subnetwork, these workstations are only granted use of available host resources from pool definitions in this filter; no use of explicit LUs is granted. Ordering of host LUs and host LU pools in the filter list is important. The order implies the ordering of workstations' access to host resources. In other words, if the first LU or pool on the list is in use, access is granted to the next resource on the list. All LUs from within a pool must be in use before the pool is considered in use.

If a full subnet mask is specified (255.255.255.255), host resources are being chosen for use by the specific workstation whose address is specified. If a partial subnet mask is specified (such as 255.0.0.0), any workstation from the subnetwork (identified by the significant fields of the IP address as specified by the subnet mask) may have access to host resources specified in the filter.

If you specify an IP address of 0.0.0.0 and a subnet mask of 0.0.0.0, all workstations that do not match another filter entry are allowed access to the specified resources.