STRHOSTQRY

La commande Démarrer l'interrogation d'hôte (STRHOSTQRY), ou son alias HOST, est un utilitaire simple permettant d'effectuer des recherches DNS (Domain Name System). Elle sert normalement à convertir des noms en adresses IP et inversement. The Start HOST Query (STRHOSTQRY) command, or its alias HOST, is a simple utility for performing Domain Name System (DNS) lookups. It is normally used to convert names to IP addresses and vice versa.

Restrictions:

• Vous devez posséder le droit d'exécution (*X) sur les répertoires du chemin d'accès du fichier de sortie. You must have execute (*X) authority to the directories in the path of the output file.
• Vous devez posséder le droit d'écriture (*W) sur le fichier de sortie s'il existe déjà. You must have write (*W) authority to the output file if it already exists.
• Vous devez posséder les droits de lecture, d'écriture et d'exécution (*RWX) sur le répertoire parent du fichier de sortie si celui-ci n'existe pas encore. You must have read, write and execute (*RWX) authority to the output file's parent directory if the output file does not already exist.

Paramètres

Nom de requête (HOSTNAME)Query name (HOSTNAME)

Indique le nom que vous souhaitez faire rechercher par le serveur DNS (Domain Name System). Il peut également s'agir d'une adresse IPv4 en notation décimale à points ou d'une adresse IPv6 délimitée par des deux-points ; dans ce cas, HOST effectue par défaut une recherche inversée pour cette adresse. Specifies the name that you want the Domain Name System (DNS) server to look up. It can also be a dotted-decimal IPv4 address or a colon-delimited IPv6 address, in which case HOST will by default perform a reverse lookup for that address.

Ce paramètre est obligatoire. This is a required parameter.

domain-name

Indiquez un nom de domaine valide. Specify a valid domain name.

internet-address

Indiquez une adresse IPv4 ou IPv6 valide. Specify a valid IPv4 or IPv6 address.

Type de requête (TYPE)Query type (TYPE)

Indique le type de la requête. Le type par défaut est *A. La liste des types de requête pris en charge évolue avec le temps et tous les serveurs ne prennent pas en charge tous les types existants. Cette liste présente quelques types de requête courants par commodité et n'est pas exhaustive. Si le type de requête souhaité ne figure pas dans cette liste, vous pouvez tout de même entrer une chaîne de caractères représentant ce type de requête. Si le type est inconnu de cette version de BIND, la requête devient par défaut une requête *A avec les résultats correspondants éventuels. Specifies the type of the query. The default type is *A. The list of supported query types changes with time, and not all servers support all the types that exist. This list provides some common query types for convenience and is not a complete list. If you do not see a query type you want in this list, you can still type in a character string that represents that query type. If the type is unknown by this BIND version, the query will default to an *A query with any corresponding results.

*A

Enregistrement d'adresse IPv4. Il s'agit de la chaîne de caractères 'a'. IPv4 Address record. This is the character string 'a'.

*AAAA

Enregistrement d'adresse IPv6. Il s'agit de la chaîne de caractères 'aaaa'. IPv6 address record. This is the character string 'aaaa'.

*ANY

Tout enregistrement de ressource. Il s'agit de la chaîne de caractères 'any'. Any resource record. This is the character string 'any'.

*AXFR

Transfert de zone. Il s'agit de la chaîne de caractères 'axfr'. Zone transfer. This is the character string 'axfr'.

*CNAME

Enregistrement de nom canonique. Renvoie la liste des alias du véritable nom d'hôte (canonique), s'il en existe. Il s'agit de la chaîne de caractères 'cname'. Canonical name record. Returns a list of aliases for the true (canonical) host name, if any exist. This is the character string 'cname'.

*MX

Enregistrement d'échangeur de courrier. Il s'agit de la chaîne de caractères 'mx'. Mail exchange record. This is the character string 'mx'.

*NS

Informations sur le serveur de noms (serveur DNS) de la zone. Il s'agit de la chaîne de caractères 'ns'. Name server (DNS server) information for the zone. This is the character string 'ns'.

*PTR

Enregistrement de pointeur. Renvoie un nom pour une adresse IP. Il s'agit de la chaîne de caractères 'ptr'. Pointer record. Returns a name for an IP address. This is the character string 'ptr'.

*SOA

Enregistrement de début d'autorité. Il s'agit de la chaîne de caractères 'soa'. Start of authority record. This is the character string 'soa'.

*SRV

Sélection d'emplacement de services. Il s'agit de la chaîne de caractères 'srv'. Services location selection. This is the character string 'srv'.

*TXT

Enregistrement de texte. Il s'agit de la chaîne de caractères 'txt'. Text record. This is the character string 'txt'.

Classe de requête (CLASS)Query class (CLASS)

Indique le groupe de protocoles des informations. Specifies the protocol group of the information.

*IN

La classe Internet. The Internet class.

*CH

The CHAOS class. The server provides some helpful diagnostic information through a number of built-in zones under the CHAOS class.

version

If your BIND server named.conf has the 'version' option configured, then you can query for it using the CHAOS class. This is the version the server should report via a query of the name 'version.bind' with type TXT, class CHAOS. The default is the real version number of this server.

HOST   HOSTNAME('version.bind')  TYPE(*TXT)  CLASS(*CH)

hostname

If your BIND server named.conf has the 'hostname' option configured, then you can query for it using the CHAOS class. This is the hostname the server should report via a query of the name 'hostname.bind' with type TXT, class CHAOS. This defaults to the hostname of the machine hosting the name server. The primary purpose of such queries is to identify which of a group of anycast servers is actually answering your queries.

STRHOSTQRY   NAME('hostname.bind')  TYPE(*TXT)  CLASS(*CH)

server-id

If your BIND server named.conf has the 'server-id' option configured, then you can query for it using the CHAOS class. This is the ID of the server should report via a query of the name 'ID.SERVER' with type TXT, class CHAOS. The primary purpose of such queries is to identify which of a group of anycast servers is actually answering your queries. The default server-id is none.

HOST   HOSTNAME('ID.SERVER')  TYPE(*TXT)  CLASS(*CH)

*HS

La classe MIT Athena Hesiod. Hesiod, développé par le MIT Project Athena, est un service d'information reposant sur BIND. Son but est de fournir des informations sur les utilisateurs, les groupes, les systèmes de fichiers accessibles par le réseau, les printcaps et le service de courrier dans toute une installation. En d'autres termes, il contient des données arbitraires stockées sous forme de chaînes de texte. Les requêtes qui utilisent la classe HS extraient des données stockées sous forme d'enregistrements de ressource TXT. Vous ne pouvez pas indiquer de serveurs racine pour la classe Hesiod (généralement ceux du MIT) dans votre liste de serveurs de noms racine. The MIT Athena Hesiod class. Hesiod, developed by MIT Project Athena, is an information service built upon BIND. Its intent is to furnish information about users, groups, network-accessible file systems, printcaps, and mail service throughout an installation. In other words, it holds arbitrary data stored as text strings. Queries that use the HS class retrieve data stored as TXT Resource Records. You cannot specify root servers for the Hesiod class (generally the ones at MIT) in your list of root name servers.

*ANY

Interroge n'importe quelle classe. Il s'agit d'une requête générique. Query any class. This is a wildcard query.

Serveur de noms de domaine (DMNNAMSVR)Domain name server (DMNNAMSVR)

Indique le nom ou l'adresse IP du serveur DNS que HOST utilisera comme serveur en cours pour la session d'interrogation. Vous pouvez indiquer n'importe quel serveur DNS auquel votre réseau TCP/IP a accès. Specifies the name or the IP address of the DNS server that HOST will use as its current server for the query session. You can specify any DNS server to which your TCP/IP network has access.

HOST extrait des informations à partir de serveurs DNS. Il a besoin d'un serveur DNS actif auquel envoyer ses requêtes. Si vous n'indiquez pas de serveur DNS avec DMNNAMSVR au démarrage de l'outil, il tentera de définir l'un des serveurs suivants comme serveur DNS par défaut pour la session : HOST retrieves information from DNS servers. It needs an active DNS server to send its queries to. If you do not specify a DNS server with DMNNAMSVR when you start the tool, it will attempt to set one of the following as its default DNS server for the session:

1. Le serveur DNS que votre système est configuré pour utiliser (*CFG), ou DNS server your system is configured to use (*CFG), or
2. Le serveur DNS qui s'exécute sur votre système local. The DNS server that is running on your local system.

*CFG

Utilise le serveur DNS actuellement désigné pour être utilisé par ce système. Ces adresses Internet de serveur peuvent être consultées en demandant l'invite de la commande Modifier le domaine TCP/IP (CHGTCPDMN) et en examinant les valeurs affichées pour le paramètre INTNETADR. Use the DNS server that is currently designated for use by this system. These server internet addresses can be seen by prompting the Change TCP/IP Domain (CHGTCPDMN) command and looking at the values shown for the INTNETADR parameter.

server-domain-name

Indiquez le nom d'un serveur DNS. Specify the name of a DNS server.

server-internet-address

Indiquez l'adresse IP d'un serveur DNS. Specify the IP address of a DNS server.

Afficher les enregistrements SOA (SOA)Display SOA records (SOA)

Indique s'il faut ou non imprimer les enregistrements SOA du nom de zone à partir de tous les serveurs de noms faisant autorité répertoriés pour cette zone. La liste des serveurs de noms est définie par les enregistrements NS trouvés pour la zone. Specifies whether or not to print the SOA records for zone name from all the listed authoritative name servers for that zone. The list of name servers is defined by the NS records that are found for the zone.

*NO

N'imprimez pas les enregistrements SOA. Do not print SOA records.

*YES

Tentez d'imprimer les enregistrements SOA. Attempt to print SOA records.

Répertorier tous les hôtes (AXFR)List all hosts (AXFR)

Indique s'il faut ou non faire effectuer par HOST un transfert de zone pour la zone indiquée dans le paramètre HOSTNAME. Un transfert de zone consiste à renvoyer toutes les informations de domaine de la zone. HOST affichera les enregistrements NS, PTR et d'adresse (A/AAAA). Specifies whether or not to make HOST perform a zone transfer for zone specified in the HOSTNAME parameter. A zone transfer is when all domain information in the zone is returned. HOST will display the NS, PTR and address records (A/AAAA).

*NO

N'effectuez pas de transfert de zone. Do not perform a zone tranfer.

*YES

Effectuez un transfert de zone. Perform a zone transfer.

Utiliser le domaine IP6.INT (IP6INT)Use IP6.INT domain (IP6INT)

Indique s'il faut ou non qualifier la recherche inversée pour qu'elle porte sur la zone ip6.int et non sur la zone ip6.arpa. Specifies whether or not to qualify the reverse lookup to be in the ip6.int zone and not the ip6.arpa zone.

*NO

La recherche inversée normale dans la zone ip6.arpa sera effectuée. The normal ip6.arpa zone reverse lookup will be performed.

*YES

Une recherche inversée d'adresse IPv6 dans la zone ip6.int sera effectuée. Cette zone est obsolète, mais peut encore être nécessaire pour interroger les préfixes du réseau fédérateur IPv6. An IPv6 address reverse lookup in the ip6.int zone will be performed. This zone is deprecated, but may still be required to query IPv6 backbone prefixes.

Récursivité souhaitée (SETRDFLAG)Recursion desired (SETRDFLAG)

Indique s'il faut ou non définir l'indicateur Recursion Desired (RD) dans la requête. Cela devrait signifier que le serveur de noms qui reçoit la requête ne tentera pas de résoudre le nom. Cela permet à HOST d'imiter le comportement d'un serveur de noms en effectuant des requêtes non récursives et en s'attendant à recevoir, en réponse à ces requêtes, des réponses qui sont généralement des renvois vers d'autres serveurs de noms. Specifies whether or not to set the Recursion Desired (RD) flag in the query. This should mean that the name server receiving the query will not attempt to resolve name. This enables HOST to mimic the behaviour of a name server by making non-recursive queries and expecting to receive answers to those queries that are usually referrals to other name servers.

*YES

Positionne l'indicateur RD. Set the RD flag.

*NO

Ne positionne pas l'indicateur RD. Do not set the RD flag.

Protocole réseau (PROTOCOL)Network protocol (PROTOCOL)

Indique s'il faut utiliser TCP ou UDP lors de l'envoi des demandes au serveur. Specified whether to use TCP or UDP when sending requests to the server.

*UDP

Utilise UDP pour envoyer la requête. Toutefois, TCP est automatiquement sélectionné pour les requêtes qui l'exigent, telles que les demandes de transfert de zone (AXFR). Use UDP to send the query. However, TCP will be automatically selected for queries that require it, such as zone transfer (AXFR) requests.

*TCP

Utilise TCP pour envoyer la requête. Use TCP to send the query.

Afficher les informations de débogage (DEBUG)Show debug information (DEBUG)

Indique s'il faut ou non activer le mode de débogage. Lorsque le mode de débogage est activé, davantage d'informations sont affichées sur le paquet envoyé au serveur et sur la réponse obtenue. Specifies whether or not to turn debugging mode on. More information is displayed about the packet sent to the server and the resulting answer when debugging mode is on.

*NO

Désactivez les messages de débogage. Turn off debugging messages.

*YES

Activez les messages de débogage. Turn on debugging messages.

Version IP (IPVSN)IP Version (IPVSN)

Indique s'il faut limiter la requête aux réseaux IPv4 ou IPv6. Specifies whether to limit the query to IPv4 or IPv6 networks.

*ALL

Ne limite pas les requêtes à IPv4 ou IPv6. Do not limit queries to IPv4 or IPv6.

*IPV4ONLY

Envoie les requêtes uniquement par les interfaces réseau IPv4. Only send queries out IPv4 network interfaces.

*IPV6ONLY

Envoie les requêtes uniquement par les interfaces réseau IPv6. Only send queries out IPv6 network interfaces.

Nombre de points (NBRDOTS)Number of dots (NBRDOTS)

Indique le nombre de points (caractères point) qui doivent figurer dans un nom de domaine pour qu'il soit considéré comme absolu. Les noms comportant moins de points sont interprétés comme des noms relatifs et sont recherchés dans les domaines répertoriés dans le paramètre DMNSCHLIST. Specifies the number of dots (period characters) that have to appear in a domain name for it to be considered absolute. Names with fewer dots are interpreted as relative names and will be searched for in the domains listed in the DMNSCHLIST parameter.

1

Si le nom de domaine contient un point, il est considéré comme un nom absolu. If the domain name contains one dot it is considered an absolute name.

0-10

Indiquez le nombre de points qui doivent figurer dans un nom de domaine pour que celui-ci soit considéré comme un nom absolu. Specify the number of dots that must be in a domain name for the domain name to be considered to be an absolute name.

Délai d'attente de la requête (TIMEOUT)Query timeout (TIMEOUT)

Indique l'intervalle de délai d'attente, en secondes, pour une réponse. Specifies the timeout interval, in seconds, to wait for a response.

5

Un délai d'attente de 5 secondes est utilisé. A timeout value of 5 seconds is used.

1-100

Indiquez une valeur de délai d'attente valide, en secondes. Specify a valid timeout value in seconds.

Nouvelle tentative UDP (UDPNBRRTY)UDP retry (UDPNBRRTY)

Indique le nombre de nouvelles tentatives des requêtes UDP auprès du serveur DNS en cours avant de tenter des requêtes TCP. Specifies the number of times to retry UDP queries to the current DNS server before attempting TCP queries.

2

Deux nouvelles tentatives UDP seront effectuées. Elles s'ajoutent à la requête initiale. Two UDP retries will be used. This is in addition to the initial query.

0-100

Indiquez le nombre de nouvelles tentatives UDP. Vous n'avez normalement besoin de réessayer une requête que 3 à 5 fois. Specify the number of UDP retries. You normally only need to retry a query 3 to 5 times.

Fichier de sortie (TOSTMF)Output file (TOSTMF)

Indique le nom d'un fichier STREAM dans lequel toute la sortie de la commande est écrite. Specifies the name of a stream file where all command output is written.

*STDOUT

Toute la sortie de la commande est dirigée vers l'unité de sortie standard (normalement l'écran). All command output goes to the standard output device (normally the display).

chemin-d'accès

Indiquez le chemin d'accès d'un fichier STREAM dans lequel la sortie doit être écrite. Specify the path name for a stream file where output should be written.

Exemples

Exemple 1 : Recherche de l'adresse Internet d'un nom de domaine Example 1: Looking Up Internet Address for Domain Name

STRHOSTQRY  HOSTNAME(ibm.com)

Cette commande tente de trouver des informations sur le domaine 'aol.com'. Cela comprend les enregistrements A et MX, bien que la sortie soit mise en forme dans un style différent de celui des autres outils d'interrogation (par exemple DIG). Un exemple de sortie de cette requête peut ressembler à ceci : This command attempts to find information about the domain 'aol.com'. This includes A and MX records, althought the output is formatted in a different style than other query tools (e.g. DIG). Sample output from this query might look like this:

Using domain server:
Name: 9.5.176.200
Address: 9.5.176.200#53
Aliases:
aol.com has address 64.12.50.151
aol.com has address 205.188.142.182
aol.com mail is handled by 15 mailin-01.mx.aol.com.
aol.com mail is handled by 15 mailin-02.mx.aol.com.
aol.com mail is handled by 15 mailin-03.mx.aol.com.
aol.com mail is handled by 15 mailin-04.mx.aol.com.

Exemple 2 : Recherche avec transfert de zone Example 2: Lookup with a Zone Transfer

HOST   HOSTNAME(i5os.ibm.com)  AXFR(*YES)

Cette commande tente d'effectuer un transfert de zone. Un exemple de sortie de cette requête peut ressembler à ceci : This command attempts to do a zone transfer. Sample output from this query might look like this:

Using domain server:
Name: 10.0.1.100
Address: 10.0.1.100#53
Aliases:
i5os.ibm.com name server MYDNS1.IBM.COM.
i5os.ibm.com name server MYDNS2.IBM.COM.
i5os.ibm.com has address 10.0.1.100
i5os.ibm.com has address 10.0.2.200
box1.i5os.ibm.com has address 10.0.2.201
box2.i5os.ibm.com has address 10.0.2.202

Cette commande tente d'effectuer le même transfert de zone, mais échoue car l'utilisateur n'est pas autorisé à effectuer des transferts. Un exemple de sortie de cette requête peut ressembler à ceci : This command attempts to do the same zone transfer, but fails because the user is not authorized to do transfers. Sample output from this query might look like this:

Using domain server:
Name: 10.0.1.100
Address: 10.0.1.100#53
Aliases:
Host i5os.ibm.com not found: 9(NOTAUTH)
; Transfer failed.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

DNS0013

Erreur lors du traitement des paramètres de la commande. Error processing command parameters.

DNS0065

L'option 33 de i5/OS est requise mais n'est pas installée. Option 33 of i5/OS is required, but is not installed.

TCP7124

Le programme &1 de la bibliothèque &2, de type *PGM, s'est terminé anormalement. Program &1 in library &2 type *PGM ended abnormally.