Specifying Terminal Addresses for the requester Variable

Rules Facility Guide › Rules Reference › Specifying Terminal Addresses for the requester Variable

Specifying Terminal Addresses for the requester Variable

The requester variable on the DIAL, LOGON, and STORE rules takes the form of a terminal address. Terminal addresses can identify logical devices (LDEVs), resource IDs, network IDs, IPv4 TN3270 sessions, or real terminals.

When writing DIAL, LOGON, and STORE rules, use the following conventions to specify terminal addresses:

If requester is terminal type	Specify requester terminal address as
Logical device address, real terminal device address, or resource ID	A four–digit hexadecimal address. For example: 01C2 To specify multiple addresses: Use an asterisk to indicate all device addresses. You can also specify a range of addresses. For example: 0093‑009F You must also specify the option LDEV for logical devices; no option is required for real terminal devices. In a Single System Image complex, these terminal addresses might not be unique across all member VM systems. An optional node name on the DIAL, LOGON. And STORE rules may be needed to uniquely specify a particular terminal address.
Network ID	A one–to–eight–character address. For example: WEST0016 Use a single asterisk to specify all addresses. To specify multiple addresses, use the pattern‑matching characters * and %. You must also specify the NETID option.
IPv4 address	An IPv4 address in dotted decimal form. Dotted decimal form is four decimal numbers separated by periods. Each decimal number must be in the range 0 through 255. Leading zeros are not permitted (for example, use 1, not 001). For example: 10.0.89.15 Use a single asterisk to specify all IPv4 addresses. To specify multiple IPV4 addresses, use the pattern‑matching characters * and %. For example: 10.0.%8.* If your network uses subnetting, you can append an address (subnet) mask to the IPV4 address. For more information about masking, see Specifying a Subnet Mask for IPV4 Addresses. You cannot use pattern matching and mask values in the same rule. You must also specify the IPADDR option.
IPv6 address	An IPv6 address is normally written as eight groups of four hexadecimal digits, where each group is separated by a colon. If one or more four digit groups is 0000, then the zeroes may be omitted and replaced with two consecutive colon characters. Any number of consecutive 0000 groups may be reduced to two colon characters, as long as there is only one double colon pair in each IPv6 address. Any leading zeroes in each group of four hexadecimal digits may also be omitted. Use a single asterisk to specify all IPv6 addresses. If your network uses subnet masking, you can append a subnet mask to the IPv6 address. For more information about masking, see Specifying a Subnet Mask in Decimal Notation. You cannot use pattern matching with IPv6 addresses, except for a single asterisk to specify all addresses. You must also specify the IPADDR option.