ADNR display examples
The displays in this topic use the example configuration described in ADNR configuration example. The numbers in the left margin were added for annotation purposes and are used in the descriptions of the displays. Only a subset of the possible types of displays are shown in this example. For more examples of the MODIFY command for ADNR, see z/OS Communications Server: IP System Administrator's Commands.
The following display shows information about the gwm:
01 F ADNR,DISP,GWM,DETAIL
02 EZD1254I GWM DETAIL
03 GWM LABEL : Z/OS_LBA_ADVISOR
04 GWM STATUS : CONVERGENCE_PENDING
05 GWM TIMESTAMP : 10/19/05 18:32:52
06 GWM IPADDR..PORT: 10.1.5.1..3860
07 LOCAL IPADDR : 10.1.10.11
08 UUID : MYCORP_SYSPLEX_ADNR
09 UPDATE INTERVAL : 60
10 LAST UPDATE : N/A
11 1 OF 1 RECORDS DISPLAYED The following comments refer to the previous display:
- Line 3:
The GWM LABEL field on line 3 is taken from the gwm statement label on line 20 of the example ADNR configuration file. All labels and names in ADNR displays are displayed in uppercase regardless of how they appear in the ADNR configuration file.
- Line 4:
The GWM STATUS on line 4 is CONVERGENCE_PENDING, which is a transient state meaning that the ADNR host_group and server_group information has successfully been registered with the GWM, and ADNR is waiting for a timer to expire before updating the name servers with information from this GWM.
- Line 5:
The GWM TIMESTAMP field on line 5 shows the date and time when the most recent update of the GWM STATUS field occurred.
- Line 6:
The GWM IPADDR..PORT field shows the IP address and port of the GWM. These values are taken from the gwm_id keyword of the gwm statement on line 22 of the example configuration file.
- Line 7:
The LOCAL IPADDR field is the source IP address that ADNR uses when communicating with the GWM. The value of 10.1.10.11 was taken from the host_connection_addr keyword on line 23 of the example configuration file
. - Line 8:
The UUID field value on line 8 is taken from the uuid statement on line 3 of the example configuration file.
- Line 9:
The update interval of 60 seconds is determined by GWM configuration. For the z/OS® Load Balancing Advisor, this value is determined by the Advisor's update_interval statement.
- Line 10:
The LAST UPDATE field on line 10 shows the most recent date and time that status information was received from the GWM on any of the sysplex resources that ADNR registered with the GWM. The value
N/Aindicates that no status updates have been received yet. - Line 11:
The number of records displayed on line 11 indicates the number of GWMs actually displayed. Currently, this value is always 1, because only one GWM is supported.
The following display was created after the convergence timer expired. The GWM's status changes to GWM_ACTIVE on line 4. Any status updates from the GWM will now be reflected in the name servers, provided that the name servers are reachable and configured correctly.
01 F ADNR,DISP,GWM,DETAIL
02 EZD1254I GWM DETAIL
03 GWM LABEL : Z/OS_LBA_ADVISOR
04 GWM STATUS : GWM_ACTIVE
05 GWM TIMESTAMP : 10/19/05 18:34:55
06 GWM IPADDR..PORT: 10.1.5.1..3860
07 LOCAL IPADDR : 10.1.10.11
08 UUID : MYCORP_SYSPLEX_ADNR
09 UPDATE INTERVAL : 60
10 LAST UPDATE : 10/19/05 18:35:29
11 1 OF 1 RECORDS DISPLAYEDThe following display summary shows the host groups and server groups that were defined:
01 F ADNR,DISP,GWM,GROUPS
02 EZD1254I GWM GROUP SUMMARY
03 GWM LABEL : Z/OS_LBA_ADVISOR
04 GWM STATUS : GWM_ACTIVE
05 GROUP LABEL : PRODUCTION_SYSPLEX
06 GROUP NAME : PRODPLEX
07 GROUP LABEL : TN3270_GROUP
08 GROUP NAME : ZTELNET
09 GROUP LABEL : FTP_GROUP
10 GROUP NAME : ZFTP
11 3 OF 3 RECORDS DISPLAYEDThe following comments refer to the previous display:
- Lines 3 and 4:
Lines 3 and 4 show the same information as the DETAIL display.
- Lines 5, 7, and 9:
The GROUP LABEL fields on lines 5, 7, and 9 show the labels of the groups that were defined to ADNR on lines 26, 76, and 108, respectively, in the example ADNR configuration file.
- Lines 6, 8, and 10:
The GROUP NAME fields on lines 6, 8, and 10 show the names from the host_group_name or server_group_name keywords on lines 29, 81, and 113, respectively, of the example ADNR configuration file.
- Line 11:
The number of records displayed on line 11 indicates the number of groups actually displayed. When the number of groups defined exceeds the MAX parameter value (or the default of 100) of the MODIFY ADNR,DISPLAY command, the difference between the numbers on this line indicates the number of groups that were omitted from the display as a result of the MAX parameter value.
The following display shows the details of one group, and demonstrates how a label can be used in a display command:
01 F ADNR,DISP,GWM,GROUPS,GROUPID=PRODUCTION_SYSPLEX,DETAIL
02 EZD1254I GWM GROUP DETAIL
03 GWM LABEL : Z/OS_LBA_ADVISOR
04 GWM STATUS : GWM_ACTIVE
05 GWM TIMESTAMP : 10/20/05 13:15:19
06 GWM IPADDR..PORT: 10.1.5.1..3860
07 LOCAL IPADDR : 10.1.10.11
08 UUID : MYCORP_SYSPLEX_ADNR
09 UPDATE INTERVAL : 60
10 LAST UPDATE : 10/20/2005 13:17:21
11 GROUP LABEL : PRODUCTION_SYSPLEX
12 GROUP NAME : PRODPLEX
13 GROUP TYPE : HOST
14 DNS LABEL : NETWORK_NAME_SERVER
15 ZONE LABEL : MVSPLEX.MYCORP.COM_ZONE
16 MEMBER HOSTNAME:
17 IPADDR : 10.1.1.22
18 AVAIL : YES
19 FLAGS :
20 UPDATE COUNT : 1
21 IPADDR : 10.1.10.22
22 AVAIL : YES
23 FLAGS :
24 UPDATE COUNT : 1
25 IPADDR : 10.1.1.1
26 AVAIL : YES
27 FLAGS :
28 UPDATE COUNT : 1
29 IPADDR : 10.1.10.1
30 AVAIL : YES
31 FLAGS :
32 UPDATE COUNT : 1
33 MEMBER HOSTNAME: SYSA
34 IPADDR : 10.1.1.22
35 AVAIL : YES
36 FLAGS :
37 UPDATE COUNT : 1
38 IPADDR : 10.1.10.22
39 AVAIL : YES
40 FLAGS :
41 UPDATE COUNT : 1
42 MEMBER HOSTNAME: SYSB
43 IPADDR : 10.1.1.1
44 AVAIL : YES
45 FLAGS :
46 UPDATE COUNT : 1
47 IPADDR : 10.1.10.1
48 AVAIL : YES
49 FLAGS :
50 UPDATE COUNT : 1
51 1 OF 1 RECORDS DISPLAYEDThe following comments refer to the previous display:
- Lines 3–10:
Lines 3 through 10 show information described in previous display examples.
- Line 11:
The GROUP LABEL field on line 11 matches the value on the GROUPID keyword on the MODIFY DISPLAY command.
- Line 13:
The GROUP TYPE field on line 13 indicates that this group was defined as a host_group versus a server_group.
- Line 14:
The DNS LABEL field on line 14 is the label referenced by the dns keyword on line 30 of the example ADNR configuration file, which indicates which name server is to be updated with the information from this group.
- Line 15:
The ZONE LABEL field on line 15 is the label referenced by the zone keyword on line 31 of the example ADNR configuration file, which indicates which zone in the name server is to be updated with the information from this group.
- Line 16:
The MEMBER HOSTNAME field on line 16 is blank, indicating that this is the unnamed member for this group. Because an unnamed member was not explicitly configured for this group, this member represents the virtual unnamed member that is created for you.
- Lines 17, 21, 25, and 29:
The IPADDR values on lines 17, 21, 25, and 29 represent the IP addresses that are automatically added to the unnamed member. These four addresses represent the union of all IP addresses coded in all members of this group.
- Lines 18, 22, 26, and 30:
The AVAIL flags on lines 18, 22, 26, and 30 all indicate that the GWM has reported these resources as available. For IPADDRs in a host group such as this, this means the Agent owning these IP addresses is active and these addresses exist in a home list in the sysplex.
- Lines 19, 23, 27, and 31:
The FLAGS field for each of the IP addresses on lines 19, 23, 27, and 31 is empty. If the AVAIL flags were NO for any of these IP addresses, the FLAGS field would give an indication as to why. For a list of the possible flags that can appear for the MODIFY command for ADNR, and their explanations, see z/OS Communications Server: IP System Administrator's Commands.
- Lines 20, 24, 28, and 32:
The UPDATE COUNT fields on lines 20, 24, 28, and 32 indicate the number of times that the availability status, as sent from the GWM, has changed for these IP addresses.
- Lines 33 and 42:
The MEMBER HOSTNAME fields on lines 33 and 42 represent the named members that were configured in the group at lines 36 and 45 of the example ADNR configuration file. Only the IP addresses explicitly coded to these members appear in the display of these members, in contrast to the unnamed member. The remainder of the fields in these named members are equivalent to the information displayed in the unnamed member.
The following display shows information about the name server that ADNR is updating:
01 F ADNR,DISP,DNS,DETAIL
02 EZD1254I DNS DETAIL
03 DNS LABEL : NETWORK_NAME_SERVER
04 DNS STATUS : ACTIVE
05 DNS IPADDR..PORT: 10.1.10.55..53
06 ZONES DEFINED : 1
07 ZONES ACTIVE : 0
08 1 OF 1 RECORDS DISPLAYEDThe following comments refer to the previous display:
- Line 3:
The DNS LABEL field value NETWORK_NAME_SERVER is taken from the dns statement on line 5 of the example configuration file. For an explanation of all of the DNS states displayed on the MODIFY command for ADNR, see z/OS Communications Server: IP System Administrator's Commands.
- Line 5:
The DNS IPADDR..PORT field value of 10.1.10.55..53 indicates that ADNR communicates with a name server at address 10.1.10.55 on port 53. This IP address and port are taken from the dns_id keyword on line 8 of the example configuration file.
- Line 6:
The ZONES DEFINED field on line 6 indicates that there is one zone configured under this dns statement in the ADNR configuration file.
- Line 7:
The ZONES ACTIVE field on line 7 indicates that the zone defined under this dns statement cannot yet be updated by ADNR. In a steady state environment, the number of active zones should match the number of defined zones. If the numbers do not match, this could be an indication of a configuration problem, a network problem, or the zone could be in the middle of the resynchronization process. For more information on the resynchronization process, see Operating ADNR.
- Line 8:
The number of records displayed on line 8 indicates the number of DNSs actually displayed. When the number of DNSs defined exceeds the MAX parameter value (or the default of 100) of the MODIFY ADNR,DISPLAY command, the difference between the numbers on this line indicates the number of DNSs that were omitted from the display as a result of the MAX parameter value.
The following display shows summary information about the zones that ADNR is updating:
01 F ADNR,DISP,DNS,ZONES,SUMMARY
02 EZD1254I DNS ZONE SUMMARY
03 DNS LABEL : NETWORK_NAME_SERVER
04 DNS STATUS : ACTIVE
05 ZONE LABEL : MVSPLEX.MYCORP.COM_ZONE
06 ZONE STATUS : SYNCHRONIZED
07 1 OF 1 RECORDS DISPLAYEDThe following comments refer to the previous display:
- Line 3:
The DNS LABEL field on line 3 indicates that information for a specific name server and its zones immediately follows. The field value is taken from the label on the dns statement on line 5 of the example configuration file. For an explanation of all of the DNS states displayed on the MODIFY command for ADNR, see z/OS Communications Server: IP System Administrator's Commands.
- Line 5:
The ZONE LABEL field on line 5 indicates that information for the indicated zone follows. The value for this field is taken from the label on the zone keyword (line 10 of the example configuration file) of the dns statement.
- Line 6:
The ZONE STATUS field on line 6 shows the state of the zone. The value of SYNCHRONIZED is the expected, steady-state value for a zone. For an explanation of all of the zone states displayed on the MODIFY command for ADNR, see z/OS Communications Server: IP System Administrator's Commands.
- Line 7:
The number of records displayed on line 7 indicates the number of zones actually displayed. When the number of zones defined exceeds the MAX parameter value (or the default of 100) of the MODIFY ADNR,DISPLAY command, the difference between the numbers on this line indicates the number of zones that were omitted from the display as a result of the MAX parameter value.
The following display shows the status of the resource records that ADNR manages in the name server:
001 F ADNR,DISP,DNS,ZONES,DETAIL
002 EZD1254I DNS ZONE DETAIL
003 DNS LABEL : NETWORK_NAME_SERVER
004 DNS STATUS : ACTIVE
005 DNS IPADDR..PORT: 10.1.10.55..53
006 ZONES DEFINED : 1
007 ZONES ACTIVE : 1
008 ZONE LABEL : MVSPLEX.MYCORP.COM_ZONE
009 ZONE STATUS : SYNCHRONIZED
010 DOMAIN SUFFIX : MVSPLEX.MYCORP.COM.
011 ZONE TIMESTAMP : 10/20/05 14:42:05
012 TSIG FLAGS :
013 DNS RR LABEL : PRODPLEX
014 DNS RR STATUS : PRESENT
015 TTL : 60
016 CLASS : IN
017 TYPE : A
018 RDATA : 10.1.1.22
019 GWM LABEL : Z/OS_LBA_ADVISOR
020 GROUP LABEL : PRODUCTION_SYSPLEX
021 LAST UPDATE : 10/20/05 14:42:02
022 DNS RR LABEL : PRODPLEX
023 DNS RR STATUS : PRESENT
024 TTL : 60
025 CLASS : IN
026 TYPE : A
027 RDATA : 10.1.1.1
028 GWM LABEL : Z/OS_LBA_ADVISOR
029 GROUP LABEL : PRODUCTION_SYSPLEX
030 LAST UPDATE : 10/20/05 14:42:02
031 DNS RR LABEL : PRODPLEX
032 DNS RR STATUS : PRESENT
033 TTL : 60
034 CLASS : IN
035 TYPE : A
036 RDATA : 10.1.10.1
037 GWM LABEL : Z/OS_LBA_ADVISOR
038 GROUP LABEL : PRODUCTION_SYSPLEX
039 LAST UPDATE : 10/20/05 14:42:02
040 DNS RR LABEL : PRODPLEX
041 DNS RR STATUS : PRESENT
042 TTL : 60
043 CLASS : IN
044 TYPE : A
045 RDATA : 10.1.10.22
046 GWM LABEL : Z/OS_LBA_ADVISOR
047 GROUP LABEL : PRODUCTION_SYSPLEX
048 LAST UPDATE : 10/20/05 14:42:02
049 DNS RR LABEL : SYSA
050 DNS RR STATUS : PRESENT
051 TTL : 60
052 CLASS : IN
053 TYPE : A
054 RDATA : 10.1.1.22
055 GWM LABEL : Z/OS_LBA_ADVISOR
056 GROUP LABEL : PRODUCTION_SYSPLEX
057 LAST UPDATE : 10/20/05 14:42:02
058 DNS RR LABEL : SYSA
059 DNS RR STATUS : PRESENT
060 TTL : 60
061 CLASS : IN
062 TYPE : A
063 RDATA : 10.1.10.22
064 GWM LABEL : Z/OS_LBA_ADVISOR
065 GROUP LABEL : PRODUCTION_SYSPLEX
066 LAST UPDATE : 10/20/05 14:42:02
067 DNS RR LABEL : SYSB
068 DNS RR STATUS : PRESENT
069 TTL : 60
070 CLASS : IN
071 TYPE : A
072 RDATA : 10.1.1.1
073 GWM LABEL : Z/OS_LBA_ADVISOR
074 GROUP LABEL : PRODUCTION_SYSPLEX
075 LAST UPDATE : 10/20/05 14:42:02
076 DNS RR LABEL : SYSB
077 DNS RR STATUS : PRESENT
078 TTL : 60
079 CLASS : IN
080 TYPE : A
081 RDATA : 10.1.10.1
082 GWM LABEL : Z/OS_LBA_ADVISOR
083 GROUP LABEL : PRODUCTION_SYSPLEX
084 LAST UPDATE : 10/20/05 14:42:02
085 DNS RR LABEL : ZFTP
086 DNS RR STATUS : PRESENT
087 TTL : 60
088 CLASS : IN
089 TYPE : A
090 RDATA : 10.1.1.22
091 GWM LABEL : Z/OS_LBA_ADVISOR
092 GROUP LABEL : FTP_GROUP
093 LAST UPDATE : 10/20/05 14:42:02
094 DNS RR LABEL : ZFTP
095 DNS RR STATUS : PRESENT
096 TTL : 60
097 CLASS : IN
098 TYPE : A
099 RDATA : 10.1.1.1
100 GWM LABEL : Z/OS_LBA_ADVISOR
101 GROUP LABEL : FTP_GROUP
102 LAST UPDATE : 10/20/05 14:42:02
103 DNS RR LABEL : ZTELNET
104 DNS RR STATUS : PRESENT
105 TTL : 60
106 CLASS : IN
107 TYPE : A
108 RDATA : 10.1.1.22
109 GWM LABEL : Z/OS_LBA_ADVISOR
110 GROUP LABEL : TN3270_GROUP
111 LAST UPDATE : 10/20/05 14:42:02
112 DNS RR LABEL : ZTELNET
113 DNS RR STATUS : PRESENT
114 TTL : 60
115 CLASS : IN
116 TYPE : A
117 RDATA : 10.1.1.1
118 GWM LABEL : Z/OS_LBA_ADVISOR
119 GROUP LABEL : TN3270_GROUP
120 LAST UPDATE : 10/20/05 14:42:02
121 DNS RR LABEL : TELNETPRIMARY.ZTELNET
122 DNS RR STATUS : PRESENT
123 TTL : 60
124 CLASS : IN
125 TYPE : A
126 RDATA : 10.1.1.22
127 GWM LABEL : Z/OS_LBA_ADVISOR
128 GROUP LABEL : TN3270_GROUP
129 LAST UPDATE : 10/20/05 14:42:02
130 DNS RR LABEL : TELNETSECONDARY.ZTELNET
131 DNS RR STATUS : PRESENT
132 TTL : 60
133 CLASS : IN
134 TYPE : A
135 RDATA : 10.1.1.1
136 GWM LABEL : Z/OS_LBA_ADVISOR
137 GROUP LABEL : TN3270_GROUP
138 LAST UPDATE : 10/20/05 14:42:02
139 1 OF 1 RECORDS DISPLAYEDThe following comments refer to the previous display:
- Line 12:
The TSIG FLAGS field on line 12 indicates which type of TSIG keys are being used, if any. In this example, the update_key and transfer_key keywords were not specified for the zone under this DNS. If they had been specified, an indicator or indicators would be displayed on this line showing which types of TSIG keys are being used.
- Lines 13, 49, 67, 85, 103, 121, and 130:
The DNS RR LABEL fields indicate the portion of the DNS name of the resource record before the domain suffix is appended. Some unique examples are on lines 13, 49, 67, 85, 103, 121, and 130. Some of these labels can be compound, like TELNETPRIMARY.ZTELNET and TELNETSECONDARY.ZTELNET on lines 121 and 130. Compound labels are created for named members of server groups. The two named members were configured in a server_group statement on lines 87 and 97 of the example ADNR configuration file. The label PRODPLEX on line 13 represents the resource records for the virtual unnamed member of the host_group statement on line 26 of the example ADNR configuration file. The labels SYSA on line 49 and SYSB on line 67 represent the named members of the host group on line 36 and 45 of the example ADNR configuration file. The label ZFTP on line 85 represents the unnamed member of the server group on line 120 of the example ADNR configuration file. The label ZTELNET on line 103 represents the virtual unnamed member of the server group on line 108 of the example ADNR configuration file. The label TELNETPRIMARY.ZTELNET on line 121 represents the named member on line 87 of the example ADNR configuration file, and the label TELNETSECONDARY.ZTELNET on line 130 represents the named member on line 97 of the example ADNR configuration file.
- Line 14:
The fields labeled DNS RR STATUS (for example, line 14) indicate whether or not the resource record is present in the name server. Resource records representing available resources in the sysplex have a value of PRESENT, while resource records representing unavailable resources in the sysplex have a value of NOT_PRESENT.
- Line 15:
The fields labeled TTL (for example, line 15) indicate the time to live value associated with the resource record. For more information, see Near real-time availability information of sysplex resources.
- Line 16:
The fields labeled CLASS (for example, line 16) indicate the resource record class. All ADNR-managed resource records have a class value of IN.
- Line 17:
The fields labeled TYPE (for example, line 17) indicate the resource record type. ADNR-managed resource records are either A for IPv4 addresses or AAAA for IPv6 addresses.
- Line 18:
The fields labeled RDATA (for example, line 18) contain the IPv4 or IPv6 address that is in the resource record.
- Line 19:
The fields labeled GWM LABEL (for example, line 19) match the label of the gwm statement on line 20 of the example ADNR configuration file.
- Line 20:
The fields labeled GROUP LABEL (for example, line 20) indicate the group definition that is responsible for the creation of the resource record. This makes it possible to correlate this resource record with the MODIFY ADNR,DISPLAY,GWM,GROUPS,GROUPID=PRODUCTION_SYSPLEX output to see the GWM data that is related to this resource record.
- Line 21:
The fields labeled LAST UPDATE (for example, line 21) indicate the most recent time that the status of the resource record has changed from PRESENT to NOT_PRESENT, or from NOT_PRESENT to PRESENT.
- Line 139:
The number of records displayed on line 139 indicates the number of zones actually displayed. When the number of zones defined exceeds the MAX parameter value (or the default of 100) of the MODIFY ADNR,DISPLAY command, the difference between the numbers on this line indicates the number of zones that were omitted from the display as a result of the MAX parameter value.