MODIFY command: Automated domain name registration application (EZBADNR)

Use the MODIFY command to control the automated domain name registration (ADNR) application from the operator's console.

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:

DNS label
DNS status

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:

Zone label
Zone status

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:

GWM label
GWM status

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:

Group label
Group name

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

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

RESYNCH_RECONCILE_PENDING

The GWM is not active
No groups are defined to ADNR
No groups reference the zone

RESYNCH_ZONE_XFER_PENDING

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

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.