MQINQ-Attributs d'objet Inquire

L'appel MQINQ renvoie un tableau d'entiers et un ensemble de chaînes de caractères contenant les attributs d'un objet.

Les types d'objet suivants sont valides:
  • Gestionnaire de files d'attente
  • File d'attente
  • Liste de noms
  • Définition de processus

Syntaxe

MQINQ (Hconn, Hobj, SelectorCount, Selectors, IntAttrCount, IntAttrs, CharAttrLength, CharAttrs, CompCode, Reason )

Paramètres

Hconn
Type: MQHCONN -entrée

Ce descripteur représente la connexion au gestionnaire de files d'attente. La valeur de Hconn a été renvoyée par un appel MQCONN ou MQCONNX précédent.

Sur les applications z/OS® for CICS® , l'appel MQCONN peut être omis et la valeur suivante peut être spécifiée pour Hconn :
MQHC_DEF_HCONN
Descripteur de connexion par défaut.
HOBJ
Type: MQHOBJ -entrée

Ce descripteur représente l'objet (de tout type) avec les attributs requis. Le descripteur doit être renvoyé par un appel MQOPEN précédent qui a spécifié l'option MQOO_INQUIRE .

SelectorCount
Type: MQLONG -entrée

Nombre de sélecteurs fournis dans le tableau Selectors . Il s'agit du nombre d'attributs à renvoyer. Zéro est une valeur valide. Le nombre maximal autorisé est 256.

Sélecteurs
Type: MQLONG x SelectorCount -entrée

Il s'agit d'un tableau de sélecteurs d'attribut SelectorCount ; chaque sélecteur identifie un attribut (entier ou caractère) avec une valeur obligatoire.

Chaque sélecteur doit être valide pour le type d'objet que Hobj représente, sinon l'appel échoue avec le code achèvement MQCC_FAILED et le code anomalie MQRC_SELECTOR_ERROR.

Dans le cas particulier des files d'attente:
  • Si le sélecteur n'est pas valide pour les files d'attente de n'importe quel type, l'appel échoue avec le code achèvement MQCC_FAILED et le code anomalie MQRC_SELECTOR_ERROR.
  • Si le sélecteur s'applique uniquement aux files d'attente de types autres que le type de l'objet, l'appel aboutit avec le code achèvement MQCC_WARNING et le code anomalie MQRC_SELECTOR_NOT_FOR_TYPE.
  • Si la file d'attente interrogée est une file d'attente de cluster, les sélecteurs valides dépendent de la manière dont la file d'attente a été résolue ; voir Remarques sur l'utilisation pour plus de détails.
Vous pouvez spécifier des sélecteurs dans n'importe quel ordre. Les valeurs d'attribut qui correspondent à des sélecteurs d'attribut de type entier (sélecteurs MQIA_* ) sont renvoyées dans IntAttrs dans l'ordre dans lequel ces sélecteurs apparaissent dans Selectors. Les valeurs d'attribut qui correspondent à des sélecteurs d'attribut de caractère (sélecteurs MQCA_* ) sont renvoyées dans CharAttrs dans l'ordre dans lequel ces sélecteurs se produisent. Les sélecteurs MQIA_* peuvent être imbriqués avec les sélecteurs MQCA_* ; seul l'ordre relatif au sein de chaque type est important.
Remarque :
  1. Les sélecteurs d'attribut de type entier et caractère sont alloués dans deux plages différentes ; les sélecteurs MQIA_* résident dans la plage MQIA_FIRST à MQIA_LASTet les sélecteurs MQCA_* dans la plage MQCA_FIRST à MQCA_LAST.

    Pour chaque plage, les constantes MQIA_LAST_USED et MQCA_LAST_USED définissent la valeur la plus élevée acceptée par le gestionnaire de files d'attente.

  2. Si tous les sélecteurs MQIA_* apparaissent en premier, les mêmes numéros d'élément peuvent être utilisés pour adresser les éléments correspondants dans les tableaux Selectors et IntAttrs .
  3. Si le paramètre SelectorCount a pour valeur zéro, il n'est pas fait référence à Selectors . Dans ce cas, l'adresse de paramètre transmise par les programmes écrits en assembleur C ou S/390 peut être null.

Les attributs qui peuvent être renseignés sont répertoriés dans les tableaux suivants. Pour les sélecteurs MQCA_* , la constante qui définit la longueur en octets de la chaîne résultante dans CharAttrs est fournie entre parenthèses.

Les tableaux qui suivent répertorient les sélecteurs, par objet, dans l'ordre alphabétique, comme suit:
  • Tableau 1 MQINQ sélecteurs d'attributs pour les files d'attente
  • Tableau 2 MQINQ sélecteurs d'attributs pour les listes de noms
  • Tableau 3 MQINQ sélecteurs d'attributs pour les définitions de processus
  • Tableau 4 MQINQ sélecteurs d'attributs pour le gestionnaire de file d'attente
Tous les sélecteurs sont pris en charge sur toutes les plates-formes IBM® MQ , sauf dans les cas indiqués dans la colonne Note comme suit :
Non z/OS
Pris en charge sur toutes les plates-formes à l'exception de z/OS
z/OS
Pris en charge uniquement sur z/OS
Tableau 1. MQINQ sélecteurs d'attribut pour les files d'attente
Sélecteur Longueur de la zone Description Remarque
MQCA_ALTERATION_DATE MQ_DATE_LENGTH Date de la dernière modification  
MQCA_ALTERATION_TIME MQ_TIME_LENGTH Heure de la dernière modification  
MQCA_BACKOUT_REQ_Q_NAME MQ_Q_NAME_LENGTH Nombre excessif de noms de remise en file d'attente d'annulation  
MQCA_BASE_Q_NAME MQ_Q_NAME_LENGTH Nom de la file d'attente dans laquelle l'alias est résolu  
MQCA_CF_STRUC_NAME MQ_CF_STRUC_NAME_LENGTH Nom de la structure de l'unité de couplage z/OS
MQCA_CLUS_CHL_NAME MQ_CHANNEL_NAME_LENGTH Nom du canal émetteur de cluster qui utilise cette file d'attente comme file d'attente de transmission.  
MQCA_CLUSTER_NAME MQ_CLUSTER_NAME_LENGTH Nom du cluster  
MQCA_CLUSTER_NAMELIST MQ_NAMELIST_NAME_LENGTH Liste de noms de cluster  
MQCA_CREATION_DATE MQ_CREATION_DATE_LENGTH Date de création de file d'attente  
MQCA_CREATION_TIME MQ_CREATION_TIME_LENGTH Heure de création de file d'attente  
MQCA_CUSTOM MQ_CUSTOM_LENGTH Attribut personnalisé pour les nouvelles fonctions  
MQCA_INITIATION_Q_NAME MQ_Q_NAME_LENGTH Nom de la file d'attente d'initialisation  
MQCA_PROCESS_NAME MQ_PROCESS_NAME_LENGTH Nom de la définition de processus  
MQCA_Q_DESC MQ_Q_DESC_LENGTH Description de file d'attente  
MQCA_Q_NAME MQ_Q_NAME_LENGTH Nom de la file d'attente  
MQCA_REMOTE_Q_MGR_NAME MQ_Q_MGR_NAME_LENGTH Nom du gestionnaire de files d'attente éloignées  
MQCA_REMOTE_Q_NAME MQ_Q_NAME_LENGTH Nom de la file d'attente éloignée connue sur le gestionnaire de files d'attente éloignées  
MQCA_STORAGE_CLASS MQ_STORAGE_CLASS_LENGTH Nom de la classe de stockage z/OS
MQCA_TRIGGER_DATA MQ_TRIGGER_DATA_LENGTH Données de déclenchement  
MQCA_XMIT_Q_NAME MQ_Q_NAME_LENGTH Nom de la file d'attente de transmission  
MQIA_ACCOUNTING_Q MQLONG Contrôle la collecte des données comptables pour la file d'attente Non z/OS
MQIA_BACKOUT_THRESHOLD MQLONG Seuil d'annulation  
MQIA_CLWL_Q_PRIORITY MQLONG Priorité de la file d'attente  
MQIA_CLWL_Q_RANK MQLONG Rang de la file d'attente  
MQIA_CLWL_USEQ MQLONG Utilisation des files d'attente éloignées  
MQIA_CURRENT_Q_DEPTH MQLONG Nombre de messages dans la file d'attente  
MQIA_DEF_BIND MQLONG Liaison par défaut  
MQIA_DEF_INPUT_OPEN_OPTION MQLONG Option open-for-input par défaut  
MQIA_DEF_PERSISTENCE MQLONG Persistance par défaut  
MQIA_DEF_PRIORITY MQLONG Priorité par défaut  
MQIA_DEFINITION_TYPE MQLONG Type de définition de file d'attente  
MQIA_DIST_LISTS MQLONG Prise en charge de la liste de diffusion Non z/OS
MQIA_HARDEN_GET_BACKOUT MQLONG Indique si le nombre d'annulations doit être durci  
MQIA_INDEX_TYPE MQLONG Type d'index géré pour la file d'attente z/OS
MQIA_INHIBIT_GET MQLONG Indique si les opérations d'extraction sont autorisées  
MQIA_INHIBIT_PUT MQLONG Indique si les opérations d'insertion sont autorisées  
MQIA_MAX_MSG_LENGTH MQLONG Longueur maximale des messages  
MQIA_MAX_Q_DEPTH MQLONG Nombre maximal de messages autorisés dans la file d'attente  
MQIA_MSG_DELIVERY_SEQUENCE MQLONG Indique si la priorité du message est pertinente  
MQIA_NPM_CLASS MQLONG Niveau de fiabilité des messages non persistants  
MQIA_OPEN_INPUT_COUNT MQLONG Nombre d'appels MQOPEN ayant la file d'attente ouverte pour l'entrée  
MQIA_OPEN_OUTPUT_COUNT MQLONG Nombre d'appels MQOPEN dont la file d'attente est ouverte pour la sortie  
MQIA_PROPERTY_CONTROL MQLONG Attribut de contrôle de propriété  
MQIA_Q_DEPTH_HIGH_EVENT MQLONG Attribut de contrôle pour les événements de longueur élevée de file d'attente Non z/OS
MQIA_Q_DEPTH_HIGH_LIMIT MQLONG Limite supérieure de la longueur de la file d'attente Non z/OS
MQIA_Q_DEPTH_LOW_EVENT MQLONG Attribut de contrôle pour les événements de longueur faible de la file d'attente Non z/OS
MQIA_Q_DEPTH_LOW_LIMIT MQLONG Limite inférieure de la longueur de la file d'attente Non z/OS
MQIA_Q_DEPTH_MAX_EVENT MQLONG Attribut de contrôle du nombre maximal d'événements de longueur de la file d'attente Non z/OS
MQIA_Q_SERVICE_INTERVAL MQLONG Limite pour l'intervalle de service de file d'attente Non z/OS
MQIA_Q_SERVICE_INTERVAL_EVENT MQLONG Attribut de contrôle pour les événements d'intervalle de service de file d'attente Non z/OS
MQIA_Q_TYPE MQLONG Type de file d'attente  
MQIA_QSG_DISP MQLONG Disposition d'un groupe de partage de files d'attente z/OS
MQIA_RETENTION_INTERVAL MQLONG Intervalle de conservation des files d'attente  
MQIA_SCOPE MQLONG Portée de définition de file d'attente Non z/OS
MQIA_SHAREABILITY MQLONG Indique si la file d'attente peut être partagée pour l'entrée  
MQIA_STATISTICS_Q MQLONG Contrôle la collecte des données statistiques pour la file d'attente Non z/OS
MQIA_TRIGGER_CONTROL MQLONG Contrôle du déclenchement  
MQIA_TRIGGER_DEPTH MQLONG Longueur de déclenchement  
MQIA_TRIGGER_MSG_PRIORITY MQLONG Priorité des messages de seuil des déclencheurs  
MQIA_TRIGGER_TYPE MQLONG Type de déclenchement  
MQIA_USAGE MQLONG Utilisation  
Tableau 2. MQINQ sélecteurs d'attribut pour les listes de noms
Sélecteur Longueur de la zone Description Remarque
MQCA_ALTERATION_DATE MQ_DATE_LENGTH Date de la modification la plus récente  
MQCA_ALTERATION_TIME MQ_TIME_LENGTH Heure de l'altération la plus récente  
MQCA_NAMELIST_DESC MQ_NAMELIST_DESC_LENGTH Description de la liste de noms  
MQCA_NAMELIST_NAME MQ_NAMELIST_NAME_LENGTH Nom de l'objet liste de noms  
MQIA_NAMELIST_TYPE MQLONG Type de liste de noms z/OS
MQCA_NAMES MQ_Q_NAME_LENGTH x Number of names in the list Noms dans la liste de noms  
MQIA_NAME_COUNT MQLONG Nombre de noms dans la liste de noms  
MQIA_QSG_DISP MQLONG Disposition d'un groupe de partage de files d'attente z/OS
Tableau 3. MQINQ sélecteurs d'attribut pour les définitions de processus
Sélecteur Longueur de la zone Description Remarque
MQCA_ALTERATION_DATE MQ_DATE_LENGTH Date de la modification la plus récente  
MQCA_ALTERATION_TIME MQ_TIME_LENGTH Heure de l'altération la plus récente  
MQCA_APPL_ID MQ_PROCESS_APPL_ID_LENGTH Identificateur d'application  
MQCA_ENV_DATA MQ_PROCESS_ENV_DATA_LENGTH Données d'environnement  
MQCA_PROCESS_DESC MQ_PROCESS_DESC_LENGTH Description de la définition de processus  
MQCA_PROCESS_NAME MQ_PROCESS_NAME_LENGTH Nom de la définition de processus  
MQCA_USER_DATA MQ_PROCESS_USER_DATA_LENGTH Données utilisateur  
MQIA_APPL_TYPE MQLONG Type d'application  
MQIA_QSG_DISP MQLONG Disposition d'un groupe de partage de files d'attente z/OS
Tableau 4. MQINQ sélecteurs d'attribut pour le gestionnaire de files d'attente
Sélecteur Longueur de la zone Description Remarque
MQCA_ALTERATION_DATE MQ_DATE_LENGTH Date de la modification la plus récente  
MQCA_ALTERATION_TIME MQ_TIME_LENGTH Heure de l'altération la plus récente  
MQCA_CHANNEL_AUTO_DEF_EXIT MQ_EXIT_NAME_LENGTH Nom d'exit de définition de canal automatique  
MQCA_CHINIT_SERVICE_PARM Réservé à l'utilisation par IBM  
MQCA_CLUSTER_WORKLOAD_DATA MQ_EXIT_DATA_LENGTH Données transmises à l'exit de charge de travail du cluster  
MQCA_CLUSTER_WORKLOAD_EXIT MQ_EXIT_NAME_LENGTH Nom de l'exit de charge de travail de cluster  
MQCA_COMMAND_INPUT_Q_NAME MQ_Q_NAME_LENGTH Nom de la file d'attente d'entrée des commandes système  
MQCA_CUSTOM MQ_CUSTOM_LENGTH Attribut personnalisé pour les nouvelles fonctions  
MQCA_DEAD_LETTER_Q_NAME MQ_Q_NAME_LENGTH Nom de la file d'attente de rebut  
MQCA_DEF_XMIT_Q_NAME MQ_Q_NAME_LENGTH Nom de file d'attente de transmission par défaut  
MQCA_DNS_GROUP MQ_DNS_GROUP_NAME_LENGTH Nom du groupe pour l'écouteur TCP qui gère les transmissions entrantes que le groupe de partage de file d'attente doit rejoindre. Le nom s'applique lors de l'utilisation des services de noms de domaine dynamiques Workload Manager. z/OS
MQCA_IGQ_USER_ID MQ_USER_ID_LENGTH Identifiant utilisateur de la file d'attente intra-groupe z/OS
MQCA_INSTALLATION_DESC MQ_INSTALLATION_DESC_LENGTH Description de l'installation associée Non z/OS. Non IBM i
MQCA_INSTALLATION_NAME MQ_INSTALLATION_NAME_LENGTH Nom de l'installation associée au gestionnaire de files d'attente Non z/OS. Non IBM i
MQCA_INSTALLATION_PATH MQ_INSTALLATION_PATH_LENGTH Chemin dans lequel le IBM MQ associé est installé Non z/OS. Non IBM i
MQCA_LU_GROUP_NAME MQ_LU_NAME_LENGTH Nom d'unité logique générique du programme d'écoute d'unité logique 6.2 qui gère les transmissions entrantes pour le groupe de partage de files d'attente à utiliser z/OS
MQCA_LU_NAME MQ_LU_NAME_LENGTH Nom de la LU à utiliser pour la LU sortante6.2 transmissions. Définissez ce nom sur la même LU que celle utilisée par l'écouteur pour les transmissions entrantes. z/OS
MQCA_LU62_ARM_SUFFIX MQ_ARM_SUFFIX_LENGTH Suffixe duSYS1.PARMLIB membreAPPCPM xx , qui nomme le LUADD pour cet initiateur de canal z/OS
MQCA_PARENT MQ_Q_MGR_NAME_LENGTH Nom d'un gestionnaire de files d'attente connecté de manière hiérarchique qui est désigné comme parent de ce gestionnaire de files d'attente  
MQCA_Q_MGR_DESC MQ_Q_MGR_DESC_LENGTH Description du gestionnaire de files d'attente  
MQCA_Q_MGR_IDENTIFIER MQ_Q_MGR_IDENTIFIER_LENGT Identificateur du gestionnaire de files d'attente (H)  
MQCA_Q_MGR_NAME MQ_Q_MGR_NAME_LENGTH Nom du gestionnaire de files d'attente local  
MQCA_QSG_NAME MQ_QSG_NAME_LENGTH Nom du groupe de partage de files d'attente z/OS
MQCA_REPOSITORY_NAME MQ_CLUSTER_NAME_LENGTH Nom du cluster pour lequel le gestionnaire de files d'attente fournit des services de référentiel  
MQCA_REPOSITORY_NAMELIST MQ_NAMELIST_NAME_LENGTH Nom de l'objet liste de noms contenant les noms des clusters pour lesquels le gestionnaire de files d'attente fournit des services de référentiel  
MQCA_TCP_NAME MQ_TCP_NAME_LENGTH Nom du système TCP/IP que vous utilisez z/OS
MQIA_ACCOUNTING_CONN_OVERRIDE MQLONG Remplacer les paramètres de comptabilité Non z/OS
MQIA_ACCOUNTING_INTERVAL MQLONG Fréquence d'écriture des enregistrements comptables intermédiaires Non z/OS
MQIA_ACCOUNTING_MQI MQLONG Contrôle la collecte des informations de comptabilité pour les données MQI Non z/OS
MQIA_ACCOUNTING_Q MQLONG Contrôle la collecte des informations de comptabilité pour les files d'attente Non z/OS
MQIA_ACTIVE_CHANNELS MQLONG Nombre maximum de canaux pouvant être actifs à tout moment z/OS
MQIA_ADOPTNEWMCA_CHECK MQLONG Éléments qui sont vérifiés pour déterminer s’il faut adopter une MCA. La vérification est effectuée lorsqu'un nouveau canal entrant est détecté et porte le même nom qu'un MCA déjà actif. z/OS
MQIA_ADOPTNEWMCA_INTERVAL MQLONG Durée, en secondes, pendant laquelle le nouveau canal attend l'arrêt du canal orphelin Non z/OS
MQIA_ADOPTNEWMCA_TYPE MQLONG Redémarrer automatiquement une instance orpheline d'un MCA d'un type de canal particulier lorsqu'une nouvelle demande de canal entrant correspondant aux paramètres AdoptNewMCACheck est détectée z/OS
MQIA_AUTHORITY_EVENT MQLONG Attribut de contrôle des événements de droits d'accès Non z/OS
MQIA_BRIDGE_EVENT MQLONG Attribut de contrôle pourIMS événements de pont z/OS
MQIA_CHANNEL_AUTO_DEF MQLONG Attribut de contrôle pour la définition de canal automatique Non z/OS
MQIA_CHANNEL_AUTO_DEF_EVENT MQLONG Attribut de contrôle pour les événements de définition de canal automatique Non z/OS
MQIA_CHANNEL_EVENT MQLONG Attribut de contrôle pour les événements de canal  
MQIA_CHINIT_ADAPTERS MQLONG Nombre de sous-tâches d'adaptateur à utiliser pour le traitementIBM MQ appels z/OS
MQIA_CHINIT_DISPATCHERS MQLONG Nombre de répartiteurs à utiliser pour l'initiateur du canal z/OS
MQIA_CHINIT_TRACE_AUTO_START MQLONG S'il faut démarrer automatiquement la trace de l'initiateur de canal z/OS
MQIA_CHINIT_TRACE_TABLE_SIZE MQLONG Taille de l'espace de données de trace (en Mo) de l'initiateur du canal z/OS
MQIA_CLUSTER_WORKLOAD_LENGTH MQLONG Longueur de la charge de travail du cluster.  
MQIA_CLWL_MRU_CHANNELS MQLONG Nombre de canaux les plus récemment utilisés pour l'équilibrage de charge de cluster  
MQIA_CLWL_USEQ MQLONG Utilisation des files d'attente éloignées  
MQIA_CODED_CHAR_SET_ID MQLONG Identificateur de jeu de caractères codés  
MQIA_COMMAND_EVENT MQLONG Attribut de contrôle pour les événements de commande  
MQIA_COMMAND_LEVEL MQLONG Niveau de commande pris en charge par le gestionnaire de files d'attente  
MQIA_CONFIGURATION_EVENT MQLONG Attribut de contrôle pour les événements de configuration Non z/OS
MQIA_DEF_CLUSTER_XMIT_Q_TYPE MQLONG Type de file d'attente de transmission par défaut à utiliser pour les canaux émetteurs de cluster.  
MQIA_DIST_LISTS MQLONG Prise en charge de la liste de diffusion Non z/OS
MQIA_DNS_WLM MQLONG Indique si le programme d'écoute TCP qui gère les transmissions entrantes pour le groupe de partage de file d'attente s'enregistre auprès de Workload Manager for Dynamic Domain Name Services. z/OS
MQIA_EXPIRY_INTERVAL MQLONG Intervalle entre les analyses des messages expirés z/OS
MQIA_GROUP_UR MQLONG Attribut de contrôle indiquant si les unités de récupération GROUP sont activées pour ce gestionnaire de files d'attente. L'unité GROUP de disposition de récupération est uniquement disponible si le gestionnaire de files d'attente est membre d'un groupe de partage de file d'attente. z/OS
MQIA_IGQ_PUT_AUTHORITY MQLONG Autorité de mise en file d'attente intra-groupe z/OS
MQIA_INHIBIT_EVENT MQLONG Attribut de contrôle pour les événements d'interdiction Non z/OS
MQIA_INTRA_GROUP_queuing MQLONG Prise en charge des files d'attente intra-groupe z/OS
MQIA_LISTENER_TIMER MQLONG Intervalle de temps (en secondes) entreIBM MQ tente de redémarrer l'écouteur si APPC ou TCP/IP échoue. z/OS
MQIA_LOCAL_EVENT MQLONG Attribut de contrôle pour les événements locaux Non z/OS
MQIA_LOGGER_EVENT MQLONG Attribut de contrôle pour les événements d'interdiction Non z/OS
MQIA_LU62_CHANNELS MQLONG Nombre maximum de canaux pouvant être actuels ou de clients pouvant être connectés à l'aide de la LU6.2 protocole de transmission z/OS
MQIA_MSG_MARK_BROWSE_INTERVAL MQLONG Intervalle de temps (en millisecondes) après lequel le gestionnaire de files d'attente peut supprimer automatiquement une marque des messages de navigation.
Attention: Vous ne devez pas définir cette valeur en dessous de la valeur par défaut de 5000.
  
MQIA_MAX_CHANNELS MQLONG Nombre maximum de canaux pouvant être actuels (y compris les canaux de connexion au serveur avec les clients connectés) z/OS
MQIA_MAX_HANDLES MQLONG Nombre maximal de descripteurs  
MQIA_MAX_MSG_LENGTH MQLONG Longueur maximale des messages  
MQIA_MAX_PRIORITY MQLONG Priorité maximum  
MQIA_MAX_UNCOMMITTED_MSGS MQLONG Nombre maximal de messages non validés dans une unité de travail  
MQIA_OUTBOUND_PORT_MAX MQLONG AvecMQIA_OUTBOUND_PORT_MIN , définit la plage de numéros de port à utiliser lors de la liaison des canaux sortants z/OS
MQIA_OUTBOUND_PORT_MIN MQLONG AvecMQIA_OUTBOUND_PORT_MAX , définit la plage de numéros de port à utiliser lors de la liaison des canaux sortants z/OS
MQIA_PERFORMANCE_EVENT MQLONG Attribut de contrôle pour les événements de performances Non z/OS
MQIA_PLATFORM MQLONG Plateforme sur laquelle réside le gestionnaire de files d'attente  
MQIA_PROT_POLICY_CAPABILITY MQLONG Indique si les fonctions de sécurité de Advanced Message Security sont disponibles pour un gestionnaire de files d'attente.  
MQIA_PUBSUB_MAXMSG_RETRY_COUNT MQLONG Nombre de tentatives de traitement d'un message de commande ayant échoué sous le point de synchronisation  
MQIA_PUBSUB_MODE MQLONG Indique si le moteur de publication / abonnement et l'interface de publication / abonnement en file d'attente sont en cours d'exécution. Les applications de publication ou d'abonnement à l'aide de l'interface de programmation d'application requièrent le moteur de publication / abonnement. Les files d'attente surveillées par l'interface de publication / abonnement en file d'attente requièrent l'exécution de l'interface de publication / abonnement en file d'attente.  
MQIA_PUBSUB_NP_MSG MQLONG Indique s'il faut supprimer (ou conserver) un message d'entrée non distribué  
MQIA_PUBSUB_NP_RESP MQLONG Contrôle le comportement des messages de réponse non livrés.  
MQIA_PUBSUB_SYNC_PT MQLONG Indique si seuls les messages persistants (ou tous les messages) sont traités sous le point de synchronisation  
MQIA_QMGR_CFCONLOS MQLONG Spécifie l'action à entreprendre lorsque le gestionnaire de files d'attente perd la connectivité à la structure d'administration ou à toute structure CF avec CONLOSFC mis àASQMGR z/OS
MQIA_RECEIVE_TIMEOUT MQLONG Durée approximative pendant laquelle un canal TCP/IP attend de recevoir des données, y compris des pulsations, de son partenaire, avant de revenir à l'état inactif. La valeur est numérique, qualifiée parMQIA_RECEIVE_TIMEOUT_TYPE . z/OS
MQIA_RECEIVE_TIMEOUT_MIN MQLONG Temps minimum pendant lequel un canal TCP/IP attend de recevoir des données, y compris des pulsations, de son partenaire, avant de revenir à l'état inactif z/OS
MQIA_RECEIVE_TIMEOUT_TYPE MQLONG Durée approximative pendant laquelle un canal TCP/IP attend de recevoir des données, y compris des pulsations, de son partenaire, avant de revenir à l'état inactif. MQIA_RECEIVE_TIMEOUT_TYPEest le qualificatif appliqué àMQIA_RECEIVE_TIMEOUT . z/OS
MQIA_REMOTE_EVENT MQLONG Attribut de contrôle pour les événements distants Non z/OS
MQIA_SECURITY_CASE MQLONG Cas des profils de sécurité z/OS
MQIA_SSL_EVENT MQLONG Attribut de contrôle pour les événements de canal  
MQIA_SSL_FIPS_REQUIRED MQLONG Utiliser uniquement des algorithmes certifiés FIPS pour la cryptographie  
MQIA_SSL_RESET_COUNT MQLONG Nombre de réinitialisations de la clé TLS  
MQIA_START_STOP_EVENT MQLONG Attribut de contrôle pour les événements d'arrêt de démarrage Non z/OS
MQIA_STATISTICS_AUTO_CLUSSDR MQLONG Contrôle la collecte des informations de surveillance des statistiques pour les canaux émetteurs de cluster  
MQIA_STATISTICS_CHANNEL MQLONG Contrôle la collecte des données statistiques pour les canaux  
MQIA_STATISTICS_INTERVAL MQLONG Fréquence d'écriture des données de surveillance des statistiques Non z/OS
MQIA_STATISTICS_MQI MQLONG Contrôle la collecte des informations de surveillance des statistiques pour le gestionnaire de files d'attente Non z/OS
MQIA_STATISTICS_Q MQLONG Contrôle la collecte des données statistiques pour les files d'attente Non z/OS
MQIA_SYNCPOINT MQLONG disponibilité des points de synchronisation  
MQIA_TCP_CHANNELS MQLONG Nombre maximum de canaux pouvant être actuels ou de clients pouvant être connectés à l'aide du protocole de transmission TCP/IP z/OS
MQIA_TCP_KEEP_ALIVE MQLONG S'il faut utiliser la fonction TCP KEEPALIVE pour vérifier que l'autre extrémité de la connexion est toujours disponible z/OS
MQIA_TCP_STACK_TYPE MQLONG Si l'initiateur du canal peut utiliser uniquement l'espace d'adressage TCP/IP spécifié dans TCPNAME ou peut éventuellement se lier à n'importe quelle adresse TCP/IP sélectionnée. z/OS
MQIA_TRACE_ROUTE_RECORDING MQLONG Contrôle l'enregistrement des informations de trace-itinéraire z/OS
MQIA_TREE_LIFE_TIME MQLONG Durée de vie des rubriques non administratives inutilisées  
MQIA_TRIGGER_INTERVAL MQLONG Intervalle de déclenchement  
IntAttrCount
Type: MQLONG -entrée

Il s'agit du nombre d'éléments du tableau IntAttrs . Zéro est une valeur valide.

Si IntAttrCount est au moins égal au nombre de sélecteurs MQIA_* dans le paramètre Selectors, tous les attributs entiers demandés sont renvoyés.

IntAttrs
Type: MQLONG x IntAttrCount -sortie

Il s'agit d'un tableau de valeurs d'attribut d'entier IntAttrCount .

Les valeurs d'attribut entières sont renvoyées dans le même ordre que les sélecteurs MQIA_* dans le paramètre Selectors . Si le tableau contient plus d'éléments que le nombre de sélecteurs MQIA_* , les éléments excédentaires restent inchangés.

Si Hobj représente une file d'attente, mais qu'un sélecteur d'attribut ne s'applique pas à ce type de file d'attente, la valeur spécifique MQIAV_NOT_APPLICABLE est renvoyée. Il est renvoyé pour l'élément correspondant dans le tableau IntAttrs .

Si le paramètre IntAttrCount ou SelectorCount a pour valeur zéro, il n'est pas fait référence à IntAttrs . Dans ce cas, l'adresse de paramètre transmise par les programmes écrits en assembleur C ou S/390 peut être null.

CharAttrLength
Type: MQLONG -entrée

Il s'agit de la longueur en octets du paramètre CharAttrs .

CharAttrLength doit être au moins égale à la somme des longueurs des attributs de caractères demandés (voir Sélecteurs ). Zéro est une valeur valide.

CharAttrs
Type: MQCHAR x CharAttrLength -sortie

Il s'agit de la mémoire tampon dans laquelle les attributs de caractère sont renvoyés, concaténés. La longueur de la mémoire tampon est indiquée par le paramètre CharAttrLength .

Les attributs de caractère sont renvoyés dans le même ordre que les sélecteurs MQCA_* dans le paramètre Selectors . La longueur de chaque chaîne d'attribut est fixe pour chaque attribut (voir Sélecteurs ) et la valeur qu'elle contient est remplie à droite avec des blancs si nécessaire. Vous pouvez fournir une mémoire tampon plus grande que nécessaire pour contenir tous les attributs de caractères demandés et le remplissage. Les octets au-delà de la dernière valeur d'attribut renvoyée restent inchangés.

Si Hobj représente une file d'attente, mais qu'un sélecteur d'attribut ne s'applique pas à ce type de file d'attente, une chaîne de caractères composée entièrement d'astérisques (*) est renvoyée. L'astérisque est renvoyé comme valeur de cet attribut dans CharAttrs.

Si le paramètre CharAttrLength ou SelectorCount a pour valeur zéro, il n'est pas fait référence à CharAttrs . Dans ce cas, l'adresse de paramètre transmise par les programmes écrits en assembleur C ou S/390 peut être null.

CompCode
Type: MQLONG -sortie
Code achèvement:
MQCC_OK
Achèvement réussi.
MQCC_WARNING
Avertissement (achèvement partiel).
MQCC_FAILED
Echec de l'appel.
Motif
Type : MQLONG - sortie
Si CompCode est MQCC_OK:
MQRC_NONE
( 0, X'000') Aucune raison de signaler.
Si CompCode est MQCC_WARNING:
MQRC_CHAR_ATTRS_TOO_SHORT
( 2008, X'7D8') Espace insuffisant pour les attributs de caractères.
MQRC_INT_ATTR_COUNT_TOO_SMALL
( 2022, X'7E6') Espace insuffisant pour les attributs de type entier.
MQRC_SELECTOR_NOT_FOR_TYPE
( 2068, X'814') Sélecteur non applicable au type de file d'attente.
Si CompCode est MQCC_FAILED:
MQRC_ADAPTER_NOT_AVAILABLE
( 2204, X'89C') Adaptateur non disponible.
MQRC_ADAPTER_SERV_LOAD_ERROR
( 2130, X'852') Impossible de charger le module de service de l'adaptateur.
MQRC_API_EXIT_ERROR
( 2374, X'946') L'exit d'API a échoué.
MQRC_API_EXIT_LOAD_ERROR
( 2183, X'887') Impossible de charger l'exit d'API.
MQRC_ASID_MISMATCH
( 2157, X'86D') Les ID espace adresse principal et principal sont différents.
MQRC_CALL_IN_PROGRESS
( 2219, X'8AB') Appel MQI entré avant la fin de l'appel précédent.
MQRC_CF_STRUC_FAILED
( 2373, X'945') Echec de la structure de l'unité de couplage.
MQRC_CF_STRUC_IN_USE
( 2346, X'92A') Structure d'unité de couplage en cours d'utilisation.
MQRC_CHAR_ATTR_LENGTH_ERROR
( 2006, X'7D6') Longueur des attributs de caractères non valide.
MQRC_CHAR_ATTRS_ERROR
( 2007, X'7D7') Chaîne d'attributs de caractères non valide.
MQRC_CICS_WAIT_FAILED
( 2140, X'85C') Demande d'attente rejetée par CICS.
MQRC_CONNECTION_BROKEN
( 2009, X'7D9') La connexion au gestionnaire de files d'attente a été perdue.
MQRC_CONNECTION_NOT_AUTHORIZED
( 2217, X'8A9') Non autorisé pour la connexion.
MQRC_CONNECTION_STOPPING
( 2203, X'89B') Arrêt de la connexion.
MQRC_HCONN_ERROR
( 2018, X'7E2') Descripteur de connexion incorrect.
MQRC_HOBJ_ERROR
( 2019, X'7E3') Descripteur d'objet non valide.
MQRC_INT_ATTR_COUNT_ERROR
( 2021, X'7E5') Nombre d'attributs de type entier non valide.
MQRC_INT_ATTRS_ARRAY_ERROR
( 2023, X'7E7') Tableau d'attributs d'entier non valide.
MQRC_NOT_OPEN_FOR_INQUIRE
( 2038, X'7F6') File d'attente non ouverte pour interrogation.
MQRC_OBJECT_CHANGED
( 2041, X'7F9') La définition d'objet a été modifiée depuis son ouverture.
MQRC_OBJECT_DAMAGED
( 2101, X'835') Objet endommagé.
MQRC_PAGESET_ERROR
( 2193, X'891') Erreur lors de l'accès à l'ensemble de données de l'ensemble de pages.
MQRC_Q_DELETED
( 2052, X'804') File d'attente supprimée.
MQRC_Q_MGR_NAME_ERROR
( 2058, X'80A') Le nom du gestionnaire de files d'attente est incorrect ou inconnu.
MQRC_Q_MGR_NOT_AVAILABLE
( 2059, X'80B') Le gestionnaire de files d'attente n'est pas disponible pour la connexion.
MQRC_Q_MGR_STOPPING
( 2162, X'872') Arrêt du gestionnaire de files d'attente.
MQRC_RESOURCE_PROBLEM
( 2102, X'836') Ressources système disponibles insuffisantes.
MQRC_SELECTOR_COUNT_ERROR
( 2065, X'811') Nombre de sélecteurs non valide.
MQRC_SELECTOR_ERROR
( 2067, X'813') Sélecteur d'attribut non valide.
MQRC_SELECTOR_LIMIT_EXCEEDED
( 2066, X'812') Nombre de sélecteurs trop élevé.
MQRC_STORAGE_NOT_AVAILABLE
( 2071, X'817') Mémoire disponible insuffisante.
MQRC_SUPPRESSED_BY_EXIT
( 2109, X'83D') Appel supprimé par le programme d'exit.
MQRC_UNEXPECTED_ERROR
( 2195, X'893') Une erreur inattendue s'est produite.

Pour plus d'informations sur ces codes, voir Messages et codes anomalie

Remarques sur l'utilisation

  1. Les valeurs renvoyées sont un instantané des attributs sélectionnés. Il n'est pas garanti que les attributs restent les mêmes avant que l'application puisse agir sur les valeurs renvoyées.
  2. Lorsque vous ouvrez une file d'attente modèle, une file d'attente locale dynamique est créée. Une file d'attente locale dynamique est créée même si vous ouvrez la file d'attente modèle pour en savoir plus sur ses attributs.
    Les attributs de la file d'attente dynamique sont en grande partie les mêmes que ceux de la file d'attente modèle au moment de la création de la file d'attente dynamique. Si vous utilisez ensuite l'appel MQINQ sur cette file d'attente, le gestionnaire de files d'attente renvoie les attributs de la file d'attente dynamique et non ceux de la file d'attente modèle. Voir le tableau 1 pour plus de détails sur les attributs de la file d'attente modèle qui sont hérités par la file d'attente dynamique.
  3. Si l'objet demandé est une file d'attente alias, les valeurs d'attribut renvoyées par l'appel MQINQ sont les attributs de la file d'attente alias. Il ne s'agit pas des attributs de la file d'attente de base ou de la rubrique dans laquelle l'alias est résolu.
  4. Si l'objet demandé est une file d'attente de cluster, les attributs pouvant être demandé dépendent de la manière dont la file d'attente est ouverte:
    • Vous pouvez ouvrir une file d'attente de cluster pour interroger plus une ou plusieurs opérations d'entrée, de navigation ou de définition. Pour ce faire, il doit exister une instance locale de la file d'attente de cluster pour que l'ouverture aboutisse. Dans ce cas, les attributs qui peuvent être renseignés sont les attributs qui sont valides pour les files d'attente locales.

      Si la file d'attente de cluster est ouverte pour interrogation sans entrée, exploration ou définition spécifiée, l'appel renvoie le code achèvement MQCC_WARNING et le code anomalie MQRC_SELECTOR_NOT_FOR_TYPE (2068) si vous tentez d'interroger des attributs qui sont valides uniquement pour les files d'attente locales et non pour les files d'attente de cluster.

    • Vous pouvez ouvrir une file d'attente de cluster pour l'interrogation lors de la transmission du nom de gestionnaire de files d'attente de base du gestionnaire de files d'attente connecté.

      Pour ce faire, il doit exister une instance locale de la file d'attente de cluster pour que l'ouverture aboutisse. Si le gestionnaire de files d'attente de base n'est pas transmis, l'appel renvoie le code achèvement MQCC_WARNING et le code anomalie MQRC_SELECTOR_NOT_FOR_TYPE (2068) si vous tentez d'interroger des attributs qui sont valides uniquement pour les files d'attente locales et non pour les files d'attente de cluster.

    • Si la file d'attente de cluster est ouverte pour l'interrogation seule ou pour l'interrogation et la sortie, seuls les attributs répertoriés peuvent être l'objet d'une interrogation. L'attribut QType a la valeur MQQT_CLUSTER dans ce cas:
      • MQCA_Q_DESC
      • MQCA_Q_NAME
      • MQIA_DEF_BIND
      • MQIA_DEF_PERSISTENCE
      • MQIA_DEF_PRIORITY
      • MQIA_INHIBIT_PUT
      • MQIA_Q_TYPE

      Vous pouvez ouvrir la file d'attente de cluster sans liaison fixe. Vous pouvez l'ouvrir avec MQOO_BIND_NOT_FIXED spécifié dans l'appel MQOPEN . Vous pouvez également spécifier MQOO_BIND_AS_Q_DEFet définir l'attribut DefBind de la file d'attente sur MQBND_BIND_NOT_FIXED. Si vous ouvrez une file d'attente de cluster sans liaison fixe, les appels MQINQ successifs de la file d'attente peuvent interroger des instances différentes de la file d'attente de cluster. Toutefois, il est typique que toutes les instances aient les mêmes valeurs d'attribut.

    • Un objet file d'attente alias peut être défini pour un cluster. Etant donné que TARGTYPE et TARGET ne sont pas des attributs de cluster, le processus exécutant un processus MQOPEN sur la file d'attente alias ne connaît pas l'objet dans lequel l'alias est résolu.

      Lors de la MQOPENinitiale, la file d'attente alias se résout en un gestionnaire de files d'attente et en une file d'attente dans le cluster. La résolution de nom se produit à nouveau au niveau du gestionnaire de files d'attente éloignées et c'est ici que le TARGTPYE de la file d'attente alias est résolu.

      Si la file d'attente alias est résolue en alias de rubrique, la publication des messages insérés dans la file d'attente alias a lieu sur ce gestionnaire de files d'attente éloignées.

    Voir Files d'attente de cluster
  5. Vous pouvez demander un certain nombre d'attributs, puis en définir certains à l'aide de l'appel MQSET . Pour programmer une interrogation et une définition efficaces, positionnez les attributs à définir au début des tableaux de sélecteurs. Dans ce cas, les mêmes tableaux avec des effectifs réduits peuvent être utilisés pour MQSET.
  6. Si plusieurs situations d'avertissement se produisent (voir le paramètre CompCode ), le code anomalie renvoyé est le premier de la liste suivante qui s'applique:
    1. MQRC_SELECTOR_NOT_FOR_TYPE
    2. MQRC_INT_ATTR_COUNT_TOO_SMALL
    3. MQRC_CHAR_ATTRS_TOO_SHORT
  7. La rubrique suivante contient des informations sur les attributs d'objet:

Appel C

MQINQ (Hconn, Hobj, SelectorCount, Selectors, IntAttrCount, IntAttrs,
      CharAttrLength, CharAttrs, &CompCode, &Reason);
Déclarez les paramètres comme suit :
MQHCONN  Hconn;           /* Connection handle */
MQHOBJ   Hobj;            /* Object handle */
MQLONG   SelectorCount;   /* Count of selectors */
MQLONG   Selectors[n];    /* Array of attribute selectors */
MQLONG   IntAttrCount;    /* Count of integer attributes */
MQLONG   IntAttrs[n];     /* Array of integer attributes */
MQLONG   CharAttrLength;  /* Length of character attributes buffer */
MQCHAR   CharAttrs[n];    /* Character attributes */
MQLONG   CompCode;        /* Completion code */
MQLONG   Reason;          /* Reason code qualifying CompCode */

Appel COBOL

     CALL 'MQINQ' USING HCONN, HOBJ, SELECTORCOUNT, SELECTORS-TABLE,
                        INTATTRCOUNT, INTATTRS-TABLE, CHARATTRLENGTH,
                        CHARATTRS, COMPCODE, REASON.
Déclarez les paramètres comme suit :
**   Connection handle
 01  HCONN            PIC S9(9) BINARY.
**   Object handle
 01  HOBJ             PIC S9(9) BINARY.
**   Count of selectors
 01  SELECTORCOUNT    PIC S9(9) BINARY.
**   Array of attribute selectors
 01  SELECTORS-TABLE.
  02  SELECTORS        PIC S9(9) BINARY OCCURS n TIMES.
**   Count of integer attributes
 01  INTATTRCOUNT     PIC S9(9) BINARY.
**   Array of integer attributes
 01  INTATTRS-TABLE.
  02  INTATTRS         PIC S9(9) BINARY OCCURS n TIMES.
**   Length of character attributes buffer
 01  CHARATTRLENGTH   PIC S9(9) BINARY.
**   Character attributes
 01  CHARATTRS        PIC X(n).
**   Completion code
 01  COMPCODE         PIC S9(9) BINARY.
**   Reason code qualifying COMPCODE
 01  REASON           PIC S9(9) BINARY.

Appel PL/I

call MQINQ (Hconn, Hobj, SelectorCount, Selectors, IntAttrCount,
           IntAttrs, CharAttrLength, CharAttrs, CompCode, Reason);
Déclarez les paramètres comme suit :
dcl Hconn           fixed bin(31);  /* Connection handle */
dcl Hobj            fixed bin(31);  /* Object handle */
dcl SelectorCount   fixed bin(31);  /* Count of selectors */
dcl Selectors(n)    fixed bin(31);  /* Array of attribute selectors */
dcl IntAttrCount    fixed bin(31);  /* Count of integer attributes */
dcl IntAttrs(n)     fixed bin(31);  /* Array of integer attributes */
dcl CharAttrLength  fixed bin(31);  /* Length of character attributes
                                       buffer */
dcl CharAttrs       char(n);        /* Character attributes */
dcl CompCode        fixed bin(31);  /* Completion code */
dcl Reason          fixed bin(31);  /* Reason code qualifying
                                       CompCode */

Appel d'assembleur de haut niveau

         CALL MQINQ,(HCONN,HOBJ,SELECTORCOUNT,SELECTORS,INTATTRCOUNT,  X
               INTATTRS,CHARATTRLENGTH,CHARATTRS,COMPCODE,REASON)
Déclarez les paramètres comme suit :
HCONN           DS  F      Connection handle
HOBJ            DS  F      Object handle
SELECTORCOUNT   DS  F      Count of selectors
SELECTORS       DS  (n)F   Array of attribute selectors
INTATTRCOUNT    DS  F      Count of integer attributes
INTATTRS        DS  (n)F   Array of integer attributes
CHARATTRLENGTH  DS  F      Length of character attributes buffer
CHARATTRS       DS  CL(n)  Character attributes
COMPCODE        DS  F      Completion code
REASON          DS  F      Reason code qualifying COMPCODE

Appel Visual Basic

MQINQ Hconn, Hobj, SelectorCount, Selectors, IntAttrCount, IntAttrs,
      CharAttrLength, CharAttrs, CompCode, Reason
Déclarez les paramètres comme suit :
Dim Hconn          As Long   'Connection handle'
Dim Hobj           As Long   'Object handle'
Dim SelectorCount  As Long   'Count of selectors'
Dim Selectors      As Long   'Array of attribute selectors'
Dim IntAttrCount   As Long   'Count of integer attributes'
Dim IntAttrs       As Long   'Array of integer attributes'
Dim CharAttrLength As Long   'Length of character attributes buffer'
Dim CharAttrs      As String 'Character attributes'
Dim CompCode       As Long   'Completion code'
Dim Reason         As Long   'Reason code qualifying CompCode'