Format
>>-+-MODIFY-+--procname,---------------------------------------->
'-F------'
>--+-DEBug,Level=debug_level-----------------------------------------------------------------------------+-><
+-DISplay,-+-DEBug----------------------------------------------------------------------------------+-+
| | .-,SUMMARY-. .-,MAX=100--. | |
| +-DNS-+------------------+-+--------------------------------+-+----------+-+-----------+-+ |
| | '-,DNSID=dns_label-' '-,ZONES--+--------------------+-' '-,DETAIL--' +-,MAX=*----+ | |
| | '-,ZONEID=zone_label-' '-,MAX=recs-' | |
| | .-,SUMMARY-. .-,MAX=100--. | |
| '-GWM--+-----------------------------------+--+----------+--+-----------+----------------' |
| '-,GROUPS--+----------------------+-' '-,DETAIL--' +-,MAX=*----+ |
| '-,GROUPID=group_label-' '-,MAX=recs-' |
'-REFRESH---------------------------------------------------------------------------------------------'
Parameters
- procname
- The member name of the cataloged procedure that is used to start
the automated domain name registration application.
- DEBug,Level=debug_level
- Changes the automated domain name registration application debug
level. See Automated domain name registration
application (EZBADNR) configuration file in the z/OS Communications Server: IP Configuration
Reference for details on valid automated domain name
registration application debug levels.
- DISplay,DEBug
- Displays the automated domain name registration application debug
level including the active individual logging levels.
- DISplay,DNS[,DNSID=dns_label][,SUMMARY][,MAX=recs]
- Displays a summary of Domain Name System (DNS) information for
the name server specified by the dns_label value
or for all configured name servers. All configured name servers are
displayed if the DNSID parameter is not specified. If the DNSID parameter
is specified, the dns_label value must match
the dns_label value used on one of the dns
statements in the automated domain name registration application configuration
file. See the following summary DNS information:
The number of name servers displayed is limited by the MAX=recs parameter.
The default value is 100. If MAX=* is specified, then all name servers
are displayed.
- DISplay,DNS[,DNSID=dns_label],DETAIL[,MAX=recs]
- Displays detailed DNS information for the name server specified
by the dns_label value or for all configured
name servers. All configured name servers are displayed if the DNSID
parameter is not specified. If the DNSID parameter is specified, the dns_label value
must match the dns_label value used on one
of the dns statements in the automated domain name registration application
configuration file. See the following detailed DNS information:
- DNS label
- DNS status
- DNS IP address and port
- Number of zones defined
- Number of zones active
The number of name servers displayed is limited by the MAX=recs parameter.
The default value is 100. If MAX=* is specified, then all name servers
are displayed.
DISplay,DNS[,DNSID=dns_label],ZONES[,ZONEID=zone_label][,SUMMARY][,MAX=recs]
- Displays a summary of zone information for the zone specified
by the zone_label value or for all zones.
- All zones are displayed if DNSID and ZONEID parameters are not
specified.
- All zones under a specific configured name server are displayed
if the DNSID parameter is specified and the ZONEID parameter is not
specified.
- If the DNSID parameter is specified, the dns_label value
must match the dns_label value used on one
of the dns statements in the automated domain name registration application
configuration file.
- If ZONEID and DNSID parameters are specified, the zone_label value
must match the zone_label value on one of
the zone parameters on the dns statement with label dns_label in
the automated domain name registration application configuration file.
- If the ZONEID parameter is specified and the DNSID parameter is
not specified, the zone_label value must
match the zone_label value on one of the
zone parameters that is on one of the dns statements in the automated
domain name registration configuration file. Only information about
the zone specified by the ZONEID parameter and the name server that
contains the zone is displayed.
See the following summary zone information: - DNS label
- DNS status
- Zone information
For each zone the following information is displayed:
The number of zones displayed is limited by the MAX=recs parameter.
When this maximum is reached, no more zones or name servers are displayed.
The default value is 100. If MAX=* is specified, then all zones
are displayed.
- DISplay,DNS[,DNSID=dns_label],ZONES[,ZONEID=zone_label],DETAIL[,MAX=recs]
- Displays detailed zone information for the zone specified by the zone_label value
or for all zones.
- All zones are displayed if DNSID and ZONEID parameters are not
specified.
- All zones under a specific configured name server are displayed
if the DNSID parameter is specified and the ZONEID parameter is not
specified.
- If the DNSID parameter is specified, the dns_label value
must match the dns_label value on one of
the dns statements in the automated domain name registration application
configuration file.
- If the ZONEID and DNSID parameters are specified, the zone_label value
must match the zone_label value on one of
the zone parameters on the dns statement with label dns_label in
the automated domain name registration application configuration file.
- If the ZONEID parameter is specified and the DNSID parameter is
not specified, the zone_label value must
match the zone_label value on one of the
zone parameters that is on one of the dns statements in the automated
domain name registration application configuration file. Only information
about the zone specified by the ZONEID parameter and the name server
that contains the zone is displayed.
See the following detailed zone information: - DNS label
- DNS status
- DNS IP address and port
- Number of zones defined
- Number of zones active
- Zone information
For each zone, the following information is displayed: - Zone label
- Zone status
- Status timestamp
- Domain suffix
- TSIG flags
- DNS resource record information
For each DNS resource record, the following information is displayed: - Label
- Status
- TTL
- Class
- Type
- IP address
- GWM label
- Group label
- Last update timestamp
The number of zones displayed is limited by the MAX=recs parameter.
The default value is 100. If MAX=* is specified, then all zones
are displayed.
- DISplay,GWM[,SUMMARY]
- Displays a summary of the Global Workload Manager (GWM) information.
See the following summary GWM information:
- DISplay,GWM,DETAIL
- Displays detailed GWM information. See the following detailed
GWM information:
- GWM label
- GWM status
- Status timestamp
- GWM IP address and port
- Host (local) IP address
- Universally unique identifier (UUID)
- Update interval
- Last update timestamp
- DISplay,GWM,GROUPS[,GROUPID=group_label][,SUMMARY][,MAX=recs]
- Displays a summary of group information for the group specified
by the group_label value or for all groups.
All groups are displayed if the GROUPID parameter is not specified.
If the GROUPID parameter is specified, the group_label value
must match the host_group_label value on
one of the host_group statements or the server_group_label value
on one of the server_group statements in the automated domain name
registration application configuration file. See the following summary
group information:
- GWM label
- GWM status
- Group information
For each group, the following information is displayed:
The number of groups displayed is limited by the MAX=recs parameter.
The default value is 100. If MAX=* is specified, then all groups
are displayed.
- DISplay,GWM,GROUPS[,GROUPID=group_label],DETAIL[,MAX=recs]
- Displays detailed group information for the group specified by
the group_label value or for all groups.
All groups are displayed if the GROUPID parameter is not specified.
If the GROUPID parameter is specified, the group_label value
must match the host_group_label value on
one of the host_group statements or the server_group_label value
on one of the server_group statements in the automated domain name
registration application configuration file.
See the following
detailed group information:
- GWM label
- GWM status
- Status timestamp
- GWM IP address and port
- Host (local) IP address
- Universally unique identifier (UUID)
- Update interval
- Last update timestamp
- Group information
For each group, the following information is displayed:
- Group label
- Group name
- Group type
- DNS label
- Zone label
- Member information
For each member, the following information is displayed:
- Member hostname (if available)
- IP address information
For each member IP address, the following information is displayed:
- IP address and port
- Protocol, if the member is part of a server group. Protocol is
not displayed if the member is part of a host group.
- Status
- Flags
- Update count
The number of groups displayed is limited by the MAX=
recs parameter.
The default value is 100. If MAX=* is specified, all groups are
displayed.
- REFRESH
- Initiates a dynamic reconfiguration using the configuration file
defined in the cataloged procedure that is used to start the automated
domain name registration application. This causes the automated domain
name registration application to resynchronize all dynamic DNS zones
with the modified configuration. DNS records representing prior configuration
elements existing in the previous configuration are removed.
While
the new configuration file is being processed, the existing debug
level is used, regardless of how it was set (using the last configuration
file or with the MODIFY DEBUG command). After the new configuration
file has been successfully processed, the value specified on the debug_level
statement of the new configuration file takes effect. If the debug_level
statement is not specified in the new configuration file, the debug
level defaults to a level of 7 (ERROR, WARNING, EVENT). If the new
configuration file contains errors that cause it to be rejected, the
debug level that was in effect prior to the dynamic reconfiguration
is used.
Rule: When
you update the arm_element_suffix statement, perform the following
steps to ensure that the ADNR application is able to automatically
restart:
- Add the new element name to the ARM policy and add or change the
arm_element_suffix value in the ADNR configuration file.
- Refresh the ADNR application.
- Optionally, remove the old element name from the ARM policy.
Example 1: The MODIFY DISPLAY DNS command
summarizes all name servers that are managed by the automated domain
name registration application.
F ADNR,DIS,DNS
EZD1254I DNS SUMMARY
DNS LABEL : DNS2
DNS STATUS : ACTIVE
DNS LABEL : DNS7
DNS STATUS : DELETING
2 of 2 RECORDS DISPLAYED
- DNS LABEL
- The DNS label configured in the automated domain name registration
application configuration file on the dns statement.
- DNS STATUS
- The status of the DNS server. The following list shows the possible
values:
- ACTIVE
- The automated domain name registration application is operating
under normal conditions.
- DELETED
- The automated domain name registration application has successfully
deleted the name server and its subordinate zones from its configuration
following a MODIFY REFRESH command. The automated domain name registration
application is waiting for zones under other name servers to be deleted.
- DELETING
- The automated domain name registration application is in the process
of deleting the subordinate zones and resource records.
- INITIAL
- The automated domain name registration application has not yet
started managing data for the name server. This occurs while the
automated domain name registration application is initializing or
shortly after dynamic reconfiguration has begun.
- SHUTTING_DOWN
- The automated domain name registration application is terminating.
Example 2: The MODIFY DISPLAY DNS DETAIL
command provides details for all name servers that are managed by
the automated domain name registration application.
F ADNR,DIS,DNS,DETAIL
EZD1254I DNS DETAIL
DNS LABEL : DNS2
DNS STATUS : ACTIVE
DNS IPADDR..PORT: 2001:DB8:10::81:2:2..53
ZONES DEFINED : 2
ZONES ACTIVE : 2
DNS LABEL : DNS7
DNS STATUS : DELETING
DNS IPADDR..PORT: 10.81.7.7..53
ZONES DEFINED : 1
ZONES ACTIVE : 0
2 of 2 RECORDS DISPLAYED
- DNS LABEL
- The DNS label configured in the automated domain name registration
application configuration file on the dns statement.
- DNS STATUS
- The DNS server status.
- DNS IPADDR..PORT
- The remote IP address and port of the name server.
- ZONES DEFINED
- The number of zones defined using the zone parameter on the dns
statement.
- ZONES ACTIVE
- The number of active zones.
Example 3: The MODIFY DISPLAY DNS ZONES
command supplies zone summary information for all name servers that
are managed by the automated domain name registration application.
F ADNR,DIS,DNS,ZONES
EZD1254I DNS ZONE SUMMARY
DNS LABEL : DNS2
DNS STATUS : ACTIVE
ZONE LABEL : ZONE2
ZONE STATUS : SYNCHRONIZED
ZONE LABEL : ZONE3
ZONE STATUS : SYNCHRONIZED
DNS LABEL : DNS7
DNS STATUS : SHUTTING_DOWN
ZONE LABEL : ZONE7
ZONE STATUS : DELETING
3 of 3 RECORDS DISPLAYED
- DNS LABEL
- The DNS label configured in the automated domain name registration
application configuration file on the dns statement.
- DNS STATUS
- The DNS server status.
- ZONE LABEL
- The zone label configured in the automated domain name registration
application configuration file using the zone parameter on the dns
statement.
- ZONE STATUS
- The status of the zone. The following list shows the possible
values:
- DELETED
- The zone managed by the automated domain name registration application
has been terminated.
- DELETING
- The zone managed by the automated domain name registration application
is being terminated. A zone delete is in progress.
- INITIAL
- The automated domain name registration application has not yet
started managing data for the zone. This occurs while the automated
domain name registration application is initializing, or shortly after
dynamic reconfiguration has begun.
- NOT_RESPONSIVE_ZONE_UPDATE_PENDING
- The zone managed by the automated domain name registration application
is not responsive. Dynamic update probes are periodically sent to
the zone in this state until one is successful.
- NOT_RESPONSIVE_ZONE_XFER_PENDING
- The zone managed by the automated domain name registration application
is not responsive. A zone transfer is in progress.
- RESYNCH_ZONE_UPDATE_PENDING
- The zone managed by the automated domain name registration application
is being resynchronized. A zone update is in progress. Resynchronization
occurs during initialization or dynamic reconfiguration of the automated
domain name registration application.
- RESYNCH_RECONCILE_PENDING
- The zone managed by the automated domain name registration application
is being resynchronized. A reconcile of the zone is in progress.
Resynchronization occurs during initialization or dynamic reconfiguration
of the automated domain name registration application. A zone can
remain in this state indefinitely if one of the following condition
is true:
- The GWM is not active
- No groups are defined to the automated domain name registration
application
- No groups reference the zone
- RESYNCH_ZONE_XFER_PENDING
- The zone managed by the automated domain name registration application
is being resynchronized. A zone transfer is in progress. Resynchronization
occurs during initialization or dynamic reconfiguration of the automated
domain name registration application.
- SHUTTING_DOWN
- The automated domain name registration application is terminating.
- SYNCHRONIZED
- The automated domain name registration application is in synch
with the name server and is able to update the zone.
Example 4: The MODIFY DISPLAY DNS ZONES
DETAIL command supplies zone detail information about all name servers
that are managed by the automated domain name registration application.
F ADNR,DIS,DNS,ZONES,DETAIL
EZD1254I DNS ZONE DETAIL
DNS LABEL : DNS2
DNS STATUS : ACTIVE
DNS IPADDR..PORT: 2001:DB8:10::81:2:2..53
ZONES DEFINED : 2
ZONES ACTIVE : 2
ZONE LABEL : ZONE2
ZONE STATUS : SYNCHRONIZED
DOMAIN SUFFIX : ZONE2.MYCORP.COM
ZONE TIMESTAMP : 04/27/2005 12:31:16
TSIG FLAGS : TRANSFER UPDATE
DNS RR LABEL : FTP
DNS RR STATUS : PRESENT
TTL : 2147483647
CLASS : IN
TYPE : AAAA
RDATA : 2001:0DB8:10::81:2:2
GWM LABEL : GWM1
GROUP LABEL : FTP_GROUP
LAST UPDATE : 04/27/2005 05:25:21
ZONE LABEL : ZONE3
DOMAIN SUFFIX : ZONE3.MYCORP.COM
ZONE STATUS : SYNCHRONIZED
ZONE TIMESTAMP : 04/27/2005 05:25:22
TSIG FLAGS :
DNS RR LABEL : FTP3
DNS RR STATUS : UPDATE-ADD_IN_PROGRESS
TTL : 0
CLASS : IN
TYPE : A
RDATA : 10.81.3.3
GWM LABEL : GWM1
GROUP LABEL : FTP_GROUP
LAST UPDATE : 04/27/2005 04:17:31
DNS RR LABEL : FTP3
DNS RR STATUS : NOT_PRESENT
TTL : 86400
CLASS : IN
TYPE : AAAA
RDATA : 2001:DB8:10::81:3:3
GWM LABEL : GWM1
GROUP LABEL : FTP_GROUP
LAST UPDATE : 04/27/2005 04:17:33
DNS LABEL : DNS7
DNS STATUS : SHUTTING_DOWN
DNS IPADDR..PORT: 10.81.7.7..53
ZONES DEFINED : 1
ZONES ACTIVE : 0
ZONE LABEL : ZONE7
DOMAIN SUFFIX : ZONE7.MYCORP.COM
ZONE STATUS : DELETING
ZONE TIMESTAMP : 04/27/2005 02:54:00
TSIG FLAGS :
DNS RR LABEL : FTP7
DNS RR STATUS : UPDATE-DEL_IN_PROGRESS
TTL : 86400
CLASS : IN
TYPE : AAAA
RDATA : 2001:DB8:10::81:7:7
GWM LABEL : GWM1
GROUP LABEL : HOST_GROUP
LAST UPDATE : 04/27/2005 03:10:15
3 of 3 RECORDS DISPLAYED
- DNS LABEL
- The DNS label configured in the automated domain name registration
application configuration file on the dns statement.
- DNS STATUS
- The DNS server status.
- DNS IPADDR..PORT
- The remote IP address and port of the name server.
- ZONES DEFINED
- The number of zones defined using the zone parameter on the dns
statement.
- ZONES ACTIVE
- The number of active zones.
- ZONE LABEL
- The zone label configured in the automated domain name registration
application configuration file using the zone parameter on the dns
statement.
- ZONE STATUS
- The status of the zone. The following list shows the possible
values:
- DELETED
- The zone managed by the automated domain name registration application
has been terminated.
- DELETING
- The zone managed by the automated domain name registration application
is being terminated. A zone delete is in progress.
- INITIAL
- The automated domain name registration application has not yet
started managing data for the zone. This occurs while the automated
domain name registration application is initializing, or shortly after
dynamic reconfiguration has begun.
- NOT_RESPONSIVE_ZONE_UPDATE_PENDING
- The zone managed by the automated domain name registration application
is not responsive. A zone update is in progress.
- NOT_RESPONSIVE_ZONE_XFER_PENDING
- The zone managed by the automated domain name registration application
is not responsive. A zone transfer is in progress.
- RESYNCH_ZONE_UPDATE_PENDING
- The zone managed by the automated domain name registration application
is being resynchronized. A zone update is in progress. Resynchronization
occurs during initialization or dynamic reconfiguration of the automated
domain name registration application.
- RESYNCH_RECONCILE_PENDING
- The zone managed by the automated domain name registration application
is being resynchronized. A reconcile of the zone is in progress.
Resynchronization occurs during initialization or dynamic reconfiguration
of the automated domain name registration application. A zone can
remain in this state indefinitely if one of the following condition
is true:
- The GWM is not active
- No groups are defined to ADNR
- No groups reference the zone
- RESYNCH_ZONE_XFER_PENDING
- The zone managed by the automated domain name registration application
is being resynchronized. A zone transfer is in progress. Resynchronization
occurs during initialization or dynamic reconfiguration of the automated
domain name registration application.
- SHUTTING_DOWN
- The automated domain name registration application is terminating.
- SYNCHRONIZED
- The automated domain name registration application is synchronized
with the name server and is able to update the zone.
- DOMAIN SUFFIX
- The domain suffix of the zone for which the name server is authoritative.
- ZONE TIMESTAMP
- The timestamp in UTC format specifying when the DNS server reached
the status indicated by the ZONE STATUS value.
- TSIG FLAGS
- An indication of whether DNS transactions are signed. The following
list shows the possible flag values:
- TRANSFER
- DNS transfers are signed.
- UPDATE
- DNS updates are signed.
If no flags are displayed, then DNS transactions
are not signed.
- DNS RR LABEL
- The DNS resource record label.
- DNS RR STATUS
- The DNS resource record status. The following list shows the possible
status values:
- NOT_PRESENT
- The DNS resource record is not currently present in the name server.
This indicates that the host or application is not available for one
of the following reasons:
- The IP address was not found by the GWM.
- The IP address was found by the GWM but an application was not
found to be listening on the specific port.
- The host or application has been quiesced.
- PRESENT
- The DNS resource record is currently present in the name server.
This indicates that the host or application is available.
- UPDATE-ADD_IN_PROGRESS
- The DNS resource record is being added to the name server.
- UPDATE-DEL_IN_PROGRESS
- The DNS resource record is being deleted from the name server.
- REPLACE_IN_PROGRESS
- The DNS resource record is being replaced as a result of a TTL
change.
- TTL
- The time to live value in seconds associated with this DNS record
in the name server.
- CLASS
- The DNS record class always has the value INTERNET, which is
abbreviated as IN.
- TYPE
- The DNS record type. Possible values are:
- A
- Designates IPv4.
- AAAA
- Designates IPv6.
- RDATA
- The DNS record data.
- RDATA is an IPv4 address when TYPE is A.
- RDATA is an IPv6 address when TYPE is AAAA.
- GWM LABEL
- The GWM label configured in the automated domain name registration
application configuration file on the gwm statement.
- GROUP LABEL
- The group label configured in the automated domain name registration
application configuration file on the host_group statement or the
server_group statement.
- LAST UPDATE
- The timestamp, in UTC format, specifying the most recent update
by ADNR for this DNS record; N/A is displayed if ADNR has never sent
an update for this record to the name server.
Example 5: The MODIFY DISPLAY GWM command
summarizes the state of the GWM.
F ADNR,DIS,GWM
EZD1254I GWM SUMMARY
GWM LABEL : GWM1
GWM STATUS : GWM_ACTIVE
1 of 1 RECORDS DISPLAYED
- GWM LABEL
- The GWM label configured in the automated domain name registration
application configuration file on the gwm statement.
- GWM STATUS
- The status of the GWM advising the automated domain name registration
application. Possible values are:
- CONNECTED
- The automated domain name registration application is connected
to the GWM.
- CONVERGENCE_PENDING
- The automated domain name registration application is waiting
a fixed period of time for information about all configured groups
to be returned from the GWM.
- DISCONNECTED
- The automated domain name registration application is not connected
to the GWM.
- GETWEIGHTS_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP GetWeights response message from the GWM.
- GWM_ACTIVE
- The state of the GWM after it has exited the CONVERGENCE_PENDING
state. This is the normal steady state of the GWM. When the GWM is
in this state, all changes in the status of any configured group are
received by the automated domain name registration application and
forwarded to the appropriate name servers. The GWM remains in this
state until there is a configuration change or until either the GWM
or the ADNR application is stopped.
- PRE_REG_DEREGISTRATION_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP DeRegistration response message from the GWM as a result
of GWM communication initialization.
- REGISTRATION RSP_PENDING
- The automated domain name registration application is waiting
for a SASP Registration response message from the GWM.
- SETLBSTATE RSP_PENDING
- The automated domain name registration application is waiting
for a SASP SetLoadBalancerState response message from the GWM.
- SHUTTING_DOWN
- The automated domain name registration application is terminating.
Example 6: The MODIFY DISPLAY GWM DETAIL
command provides details about the GWM.
F ADNR,DIS,GWM,DETAIL
EZD1254I GWM DETAIL
GWM LABEL : GWM1
GWM STATUS : GWM_ACTIVE
GWM TIMESTAMP : 04/27/2005 12:32:01
GWM IPADDR..PORT: 10.81.1.1..3860
LOCAL IPADDR : 10.81.4.4
UUID : UUID1
UPDATE INTERVAL : 60
LAST UPDATE : 04/27/2005 01:05:03
1 of 1 RECORDS DISPLAYED
- GWM LABEL
- The GWM label configured in the automated domain name registration
application configuration file on the gwm statement.
- GWM STATUS
- The status of the GWM advising the automated domain name registration
application. Possible values are:
- CONNECTED
- The automated domain name registration application is connected
to the GWM.
- CONVERGENCE_PENDING
- The automated domain name registration application is waiting
a fixed period of time for information about all configured groups
to be returned from the GWM.
- DISCONNECTED
- The automated domain name registration application is not connected
to the GWM.
- GETWEIGHTS_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP GetWeights response message from the GWM.
- GWM_ACTIVE
- The state of the GWM after it has exited the CONVERGENCE_PENDING
state. This is the normal steady state of the GWM. When the GWM is
in this state, all changes in the status of any configured group are
received by the automated domain name registration application and
forwarded to the appropriate name servers. The GWM remains in this
state until there is a configuration change or until either the GWM
or the automated domain name registration application is stopped.
- PRE_REG_DEREGISTRATION_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP DeRegistration response message from the GWM as a result
of GWM communication initialization.
- REGISTRATION RSP_PENDING
- The automated domain name registration application is waiting
for a SASP Registration response message from the GWM.
- SETLBSTATE RSP_PENDING
- The automated domain name registration application is waiting
for a SASP SetLoadBalancerState response message from the GWM.
- SHUTTING_DOWN
- The automated domain name registration application is terminating.
- GWM TIMESTAMP
- The timestamp in UTC format specifying when the GWM reached the
status indicated by the GWM STATUS value.
- GWM IPADDR..PORT
- The remote IP address and port of the GWM.
- LOCAL IPADDR
- The local IP address that the automated domain name registration
application used to connect to the GWM.
- UUID
- The universally unique identifier that the automated domain name
registration application used to connect to the GWM.
- UPDATE INTERVAL
- The GWM's update interval in seconds. See the appropriate GWM
documentation for more information.
- LAST UPDATE
- The timestamp, in UTC format, specifying the most recent update
(SASP SendWeights message) received from the GWM; N/A is displayed
if the GWM has not sent the automated domain name registration application
an update since the connection to the GWM became active.
Example 7: The MODIFY DISPLAY GWM GROUPS
command supplies group summary information about the GWM.
F ADNR,DIS,GWM,GROUPS
EZD1254I GWM GROUP SUMMARY
GWM LABEL : GWM1
GWM STATUS : GWM_ACTIVE
GROUP LABEL : FTP_GROUP
GROUP NAME : FTP.ZONE2.MYCORP.COM
GROUP LABEL : HOST_GROUP
GROUP NAME : HOST7.ZONE7.MYCORP.COM
2 of 2 RECORDS DISPLAYED
- GWM LABEL
- The GWM label configured in the automated domain name registration
application configuration file on the gwm statement.
- GWM STATUS
- The status of the GWM advising the automated domain name registration
application. Possible values are:
- CONNECTED
- The automated domain name registration application is connected
to the GWM.
- CONVERGENCE_PENDING
- The automated domain name registration application is waiting
a fixed period of time for information about all configured groups
to be returned from the GWM.
- DISCONNECTED
- The automated domain name registration application is not connected
to the GWM.
- GETWEIGHTS_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP GetWeights response message from the GWM.
- GWM_ACTIVE
- The state of the GWM after it has exited the CONVERGENCE_PENDING
state. This is the normal steady state of the GWM. When the GWM is
in this state, all changes in the status of any configured group are
received by the automated domain name registration application and
forwarded to the appropriate name servers. The GWM remains in this
state until there is a configuration change or until either the GWM
or the automated domain name registration application is stopped.
- PRE_REG_DEREGISTRATION_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP DeRegistration response message from the GWM as a result
of GWM communication initialization.
- REGISTRATION RSP_PENDING
- The automated domain name registration application is waiting
for a SASP Registration response message from the GWM.
- SETLBSTATE RSP_PENDING
- The automated domain name registration application is waiting
for a SASP SetLoadBalancerState response message from the GWM.
- SHUTTING_DOWN
- The automated domain name registration application is terminating.
- GROUP LABEL
- The group label configured in the automated domain name registration
application configuration file on the host_group statement or on the
server_group statement.
- GROUP NAME
- The group name registered with the GWM. The group name is defined
in the automated domain name registration application configuration
file using the host_group_name parameter on the host_group statement
or the server_group_name parameter on the server_group statement concatenated
to the domain_suffix of the zone identified by the dns and zone parameters
on the host_group statement or the server_group statement.
Example 8: The MODIFY DISPLAY GWM
GROUPS DETAIL command supplies group detail information about the
GWM.
F ADNR,DIS,GWM,GROUPS,DETAIL
EZD1254I GWM GROUP DETAIL
GWM LABEL : GWM1
GWM STATUS : GWM_ACTIVE
GWM TIMESTAMP : 04/27/2005 12:32:01
GWM IPADDR..PORT: 10.81.1.1..3860
LOCAL IPADDR : 10.81.4.4
UUID : UUID1
UPDATE INTERVAL : 60
LAST UPDATE : 04/27/2005 01:05:03
GROUP LABEL : FTP_GROUP
GROUP NAME : FTP.ZONE2.MYCORP.COM
GROUP TYPE : SERVER
DNS LABEL : DNS2
ZONE LABEL : ZONE2
MEMBER HOSTNAME:
IPADDR..PORT : 2001:0DB8:10::81:2:2..21
PROTOCOL : TCP
AVAIL : YES
FLAGS :
UPDATE COUNT : 2
MEMBER HOSTNAME: FTP3
IPADDR..PORT : 10.81.3.3..621
PROTOCOL : TCP
AVAIL : NO
FLAGS : NOTARGETSYS NOTARGETAPP
UPDATE COUNT : 3
IPADDR..PORT : 2001:DB8:10::81:3:3..621
PROTOCOL : TCP
AVAIL : YES
FLAGS :
UPDATE COUNT : 5
GROUP LABEL : HOST_GROUP
GROUP NAME : HOST7.ZONE7.MYCORP.COM
GROUP TYPE : HOST
DNS LABEL : DNS7
ZONE LABEL : ZONE7
MEMBER HOSTNAME:
IPADDR : 10.81.7.7
AVAIL : YES
FLAGS :
UPDATE COUNT : 1
MEMBER HOSTNAME: HOST5V6
IPADDR : 2001:DB8:10::81:7:7
AVAIL : NO
FLAGS : NOTARGETSYS NOTARGETHOST
UPDATE COUNT : 1
2 of 2 RECORDS DISPLAYED
- GWM LABEL
- The GWM label configured in the automated domain name registration
application configuration file on the gwm statement.
- GWM STATUS
- The status of the GWM advising the automated domain name registration
application. Possible values are:
- CONNECTED
- The automated domain name registration application is connected
to the GWM specified.
- CONVERGENCE_PENDING
- The automated domain name registration application is waiting
a fixed period of time for information about all configured groups
to be returned from the GWM.
- DISCONNECTED
- The automated domain name registration application is not connected
to the GWM.
- GETWEIGHTS_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP GetWeights response message from the GWM.
- GWM_ACTIVE
- The state of the GWM after it has exited the CONVERGENCE_PENDING
state. This is the normal steady state of the GWM. When the GWM is
in this state, all changes in the status of any configured group are
received by the automated domain name registration application and
forwarded to the appropriate name servers. The GWM remains in this
state until there is a configuration change or until either the GWM
or the automated domain name registration application is stopped.
- PRE_REG_DEREGISTRATION_RSP_PENDING
- The automated domain name registration application is waiting
for a SASP DeRegistration response message from the GWM as a result
of GWM communication initialization.
- REGISTRATION RSP_PENDING
- The automated domain name registration application is waiting
for a SASP Registration response message from the GWM.
- SETLBSTATE RSP_PENDING
- The automated domain name registration application is waiting
for a SASP SetLoadBalancerState response message from the GWM.
- SHUTTING_DOWN
- The automated domain name registration application is terminating.
- GWM TIMESTAMP
- The timestamp in UTC format specifying when the GWM reached the
status indicated by GWM STATUS.
- GWM IPADDR..PORT
- The remote IP address and port of the GWM.
- LOCAL IPADDR
- The local IP address that the automated domain name registration
application used to connect to the GWM.
- UUID
- The universally unique identifier that the automated domain name
registration application used to connect to the GWM.
- UPDATE INTERVAL
- The GWM's update interval in seconds. See the appropriate GWM
documentation for more information.
- LAST UPDATE
- The timestamp in UTC format specifying the most recent update
(SASP SendWeights message) received from the GWM.
- GROUP LABEL
- The group label configured in the automated domain name registration
application configuration file on the host_group statement or on the
server_group statement.
- GROUP NAME
- The group name registered with the GWM. The group name is defined
in the automated domain name registration application configuration
file using the host_group_name parameter on the host_group statement
or the server_group_name parameter on the server_group statement concatenated
to the domain_suffix of the zone identified by the dns and zone parameters
on the host_group statement or the server_group statement.
- GROUP TYPE
- The group type. Possible values are:
- HOST
- Indicates a host group.
- SERVER
- Indicates a server group.
- DNS LABEL
- The DNS label configured in the automated domain name registration
application configuration file on the dns statement.
- ZONE LABEL
- The zone label configured in the automated domain name registration
application configuration file using the zone parameter on the dns
statement.
- MEMBER HOSTNAME
- The optional member hostname is defined
in the automated domain name registration application configuration
file using the member host_name parameter on the host_group statement
or the server_name parameter on the server_group statement.
- IPADDR[..PORT]
- The IP address and port on which the application can be reached.
The port is not displayed when the GROUP TYPE value is HOST.
- PROTOCOL
- The protocol the application is using. The protocol value is
either TCP or UDP. The protocol is not displayed when GROUP TYPE
is HOST.
- AVAIL
- Indicates whether or not the member is available in the sysplex.
- FLAGS
- Indicates which flags are currently set. Flag values are:
- NOTARGETAPP
- The GWM found the IP address but did not find an available server
application using the IP address, port, and protocol. When the GWM
is the z/OS® Load Balancing
Advisor, this can indicate that the application member has been quiesced
by the Agent.
- NOTARGETHOST
- The GWM found the IP address but the host is not available. When
the GWM is the z/OS Load Balancing
Advisor, this indicates that the system member has been quiesced by
the Agent.
- NOTARGETSYS
- The GWM did not find the IP address.
No flags are displayed when the AVAIL value is YES.
- UPDATE COUNT
- The number of times the availability of this IP address, which
is associated with the preceding MEMBER HOSTNAME value, has changed.