DISPLAY

Le verbe DISPLAY retourne des informations de configuration et des valeurs de fonctionnement actuelles pour le nœud SNA.

Il est recommandé d’utiliser la fonction d’extension Windows GetAppcConfig pour obtenir des informations de configuration système relatives aux unités logiques APPC. Les utilisateurs d’émulateurs 5250, en particulier, doivent utiliser l’extension Windows GetAPPCConfig .

La structure suivante décrit le bloc de contrôle de verbe utilisé par le verbe DISPLAY .

Syntaxe

  
struct display {  
    unsigned short  opcode;  
    unsigned char   reserv2[2];  
    unsigned short  primary_rc;  
    unsigned long   secondary_rc;  
    unsigned long   init_sect_len;  
    unsigned long   buffer_len;  
    unsigned char FAR * buffer_ptr;  
    unsigned long  num_sections;  
    unsigned long  display_len;  
    unsigned long  area_needed;  
    unsigned char  sna_global_info;  
    unsigned char  lu62_info;  
    unsigned char  am_info;  
    unsigned char  tp_info;  
    unsigned char  sess_info;  
    unsigned char  link_info;  
    unsigned char  lu_0_3_info;  
    unsigned char  gw_info;  
    unsigned char  x25_physical_link_info;  
    unsigned char  sys_def_info;  
    unsigned char  adapter_info;  
    unsigned char  lu_def_info;  
    unsigned char  plu_def_info;  
    unsigned char  mode_def_info;  
    unsigned char  link_def_info;  
    unsigned char  ms_info;  
    struct sna_global_info_sect FAR * sna_global_info_ptr;  
    struct lu62_info_sect FAR * lu62_info_ptr;  
    struct am_info_sect FAR * am_info_ptr;  
    struct tp_info_sect FAR * tp_info_ptr;  
    struct sess_info_sect FAR * sess_info_ptr;  
    struct link_info_sect FAR * link_info_ptr;  
    struct lu_0_3_info_sect FAR * lu_0_3_info_ptr;  
    struct gw_info_sect FAR * gw_info_ptr;  
    struct x25_physical_link_info_sect FAR * x25_physical_link_info_ptr;  
    struct sys_def_info_sect FAR * sys_def_info_ptr;  
    struct adapter_info_sect FAR * adapter_info_ptr;  
    struct lu_def_info_sect FAR * lu_def_info_ptr;  
    struct plu_def_info_sect FAR * plu_def_info_ptr;  
    struct mode_def_info_sect FAR * mode_def_info_ptr;  
    struct link_def_info_sect FAR * link_def_info_ptr;  
    struct ms_info_sect FAR * ms_info_ptr;  
} DISPLAY;   

Membres

opcode
Paramètre fourni. Spécifie le code d’opération de verbe, AP_DISPLAY.

reserv2
Champ réservé, cette valeur doit être définie sur NULL.

primary_rc
Paramètre retourné. Spécifie le code de retour principal défini par APPC à l’achèvement du verbe. Les codes de retour valides dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

secondary_rc
Paramètre retourné. Spécifie le code de retour secondaire défini par APPC à l’achèvement du verbe. Les codes de retour valides dépendent du verbe APPC émis. Pour connaître les codes d’erreur valides de ce verbe, consultez Codes de retour.

init_sect_len
Paramètre fourni. Spécifie le nombre d’octets dans la section initiale du VCB, jusqu’au début des pointeurs d’informations. Ce paramètre et le paramètre num_sections doivent être définis sur des valeurs spécifiques en fonction du format demandé. Pour plus d’informations, consultez les remarques ci-dessous.

buffer_len
Paramètre fourni. Spécifie la longueur (0 à 65535 octets) de la mémoire tampon de données d’affichage passée.

buffer_ptr
Paramètre fourni. Fournit l’adresse de la mémoire tampon de données d’affichage qui contiendra les informations demandées.

num_sections
Paramètre fourni. Spécifie le nombre maximal de sections d’informations qui peuvent être retournées par le verbe. Ce paramètre et le paramètre init_sect_len doivent être définis sur des valeurs spécifiques en fonction du format demandé. Pour plus d’informations, consultez les remarques ci-dessous.

display_len
Paramètre retourné. Fournit le nombre total d’octets utilisés qui sont retournés dans la mémoire tampon de données d’affichage.

area_needed
Paramètre retourné. Fournit le nombre total d’octets nécessaires pour toutes les données affichées.

sna_global_info
Paramètre fourni. Spécifie si des informations globales sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

lu62_info
Paramètre fourni. Spécifie si des informations sur toutes les unités logiques actives, leurs partenaires et leurs modes sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

am_info
Paramètre fourni. Spécifie si les informations du gestionnaire d’attachement sur le tp défini sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

tp_info
Paramètre fourni. Spécifie si des informations sur les programmes de conversation actifs et les conversations actives sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

sess_info
Paramètre fourni. Spécifie si des informations sur les sessions sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

link_info
Paramètre fourni. Spécifie si des informations sur les lignes logiques SNA actives sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

lu_0_3_info
Paramètre fourni. Spécifie si des informations sur les unités logiques de type 0, 1, 2 et 3 sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

gw_info
Paramètre fourni. Spécifie si des informations sur la passerelle SNA sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

x25_physical_link_info
Paramètre fourni. Spécifie si les informations X.25 sont requises. Les valeurs autorisées sont AP_YES et AP_NO.

sys_def_info
Paramètre fourni. Spécifie si des informations sur la lu par défaut, les noms de nœuds et les paramètres par défaut pour les partenaires implicites entrants et sortants sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

adapter_info
Paramètre fourni. Spécifie si des informations sur les cartes de communication configurées sont demandées. Les valeurs autorisées sont AP_YES et AP_NO. Ce paramètre doit être défini sur AP_NO lorsque le format NS/2 est demandé.

lu_def_info
Paramètre fourni. Spécifie si des informations sur les unités de référence définies sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

plu_def_info
Paramètre fourni. Spécifie si des informations sur les unités de référence partenaires définies sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

mode_def_info
Paramètre fourni. Spécifie si des informations sur les nœuds définis sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

link_def_info
Paramètre fourni. Spécifie si des informations sur les liens logiques définis sont demandées. Les valeurs autorisées sont AP_YES et AP_NO.

ms_info
Paramètre fourni. Spécifie si des informations sur les services de gestion sont demandées. Les valeurs autorisées sont AP_YES et AP_NO. Ce paramètre doit être défini sur AP_NO lorsque le format NS/2 est demandé.

sna_global_info_ptr
Paramètre retourné. Indique l’adresse du début des informations globales SNA dans la mémoire tampon de données.

lu62_info_ptr
Paramètre retourné. Indique l’adresse du début des informations LU 6.2 dans la mémoire tampon de données.

am_info_ptr
Paramètre retourné. Indique l’adresse du début des informations du Gestionnaire d’attachement dans la mémoire tampon de données.

tp_info_ptr
Paramètre retourné. Indique l’adresse du début des informations TP dans la mémoire tampon de données.

sess_info_ptr
Paramètre retourné. Indique l’adresse du début des informations de session dans la mémoire tampon de données.

link_info_ptr
Paramètre retourné. Indique l’adresse du début des informations de lien dans la mémoire tampon de données.

lu_0_3_info_ptr
Paramètre retourné. Indique l’adresse du début des informations lu dans la mémoire tampon de données.

gw_info_ptr
Paramètre retourné. Indique l’adresse du début des informations de passerelle dans la mémoire tampon de données.

x25_physical_link_info_ptr
Paramètre retourné. Indique l’adresse du début des informations X.25 dans la mémoire tampon de données.

sys_def_info_ptr
Paramètre retourné. Indique l’adresse du début des informations par défaut du système dans la mémoire tampon de données.

adapter_info_ptr
Paramètre retourné. Indique l’adresse du début des informations d’adaptateur dans la mémoire tampon de données.

lu_def_info_ptr
Paramètre retourné. Indique l’adresse du début des informations de définition lu locales dans la mémoire tampon de données.

plu_def_info_ptr
Paramètre retourné. Indique l’adresse du début des informations de définition de lu partenaire dans la mémoire tampon de données.

mode_def_info_ptr
Paramètre retourné. Indique l’adresse du début des informations de définition de mode dans la mémoire tampon de données.

link_def_info_ptr
Paramètre retourné. Indique l’adresse du début des informations de définition de lien dans la mémoire tampon de données.

ms_info_ptr
Paramètre retourné. Indique l’adresse du début des informations des services de gestion dans la mémoire tampon de données.

Codes de retour

AP_OK
Code de retour principal ; indique que le verbe s’est exécuté correctement.

AP_PARAMETER_CHECK
Code de retour principal ; le verbe n’a pas été exécuté en raison d’une erreur de paramètre.

AP_DISPLAY_INVALID_CONSTANT
Code de retour secondaire ; la valeur fournie pour NUM_SECTIONS ou INIT_SEC_LEN n’est pas valide.

AP_STATE_CHECK
Code de retour principal ; le verbe n’a pas été exécuté, car il a été émis dans un état non valide.

AP_DISPLAY_INFO_EXCEEDS_LEN
Code de retour secondaire ; les informations DISPLAY retournées ne s’intègrent pas dans la mémoire tampon.

AP_INVALID_DATA_SEGMENT
Code de retour secondaire ; le segment contenant la mémoire tampon de données est trop petit pour la longueur des données spécifiée.

AP_COMM_SUBSYSTEM_ABENDED
Code de retour principal ; indique l’une des situations suivantes :

Le nœud utilisé par cette conversation a rencontré un ABEND.

La connexion entre le TP et le type de nœud 2.1 a été interrompue (une erreur LAN).

Le SnaBase sur l’ordinateur des fournisseurs de services a rencontré un ABEND.

AP_COMM_SUBSYSTEM_NOT_LOADED
Code de retour principal ; indique qu’il n’a pas été possible de charger un composant requis ou d’y mettre fin lors du traitement du verbe. Par conséquent, la communication n’a pas pu être établie. Contactez l’administrateur système pour mettre en place une action corrective.

AP_INVALID_VERB_SEGMENT
Code de retour principal ; indique que le bloc de contrôle de verbe s’étend au-delà de la fin du segment de données.

AP_STACK_TOO_SMALL
Code de retour principal ; indique que la taille de la pile de l’application est trop petite pour exécuter le verbe. Augmentez la taille de pile de votre application.

AP_UNEXPECTED_DOS_ERROR
Code de retour principal ; indique que le système d’exploitation a retourné une erreur à APPC lors du traitement d’un appel APPC à partir du programme transactionnel local. Le code de retour du système d’exploitation a été retourné via secondary_rc. Il apparaît dans l’ordre Intel avec permutation d’octets. Si le problème persiste, consultez l’administrateur système.

Notes

DISPLAY identifie une lu par un alias seul. Si le même alias lu local est utilisé plusieurs fois dans un domaine (à des fins de sauvegarde ou à d’autres fins) et que cet alias lu est spécifié via DISPLAY, le verbe peut passer à une unité lu différente de celle prévue.

Pour que le verbe DISPLAY retourne correctement, une connexion spécifique doit être définie dans la boîte de dialogue Verbe d’affichage du programme SNA Manager. IBM a initialement défini le verbe DISPLAY avec le produit IBM OS/2 Extended Edition qui supposait une seule connexion. Toutefois, étant donné que Host Integration Server prend en charge plusieurs connexions, la connexion spécifique associée au verbe DISPLAY doit être configurée.

Le verbe DISPLAY nécessite une mémoire tampon fournie par l’utilisateur pour le retour des informations système. Si la mémoire tampon n’est pas assez grande, APPC retourne le code de retour AP_DISPLAY_INFO_EXCEEDS_LEN, ainsi que la taille réellement nécessaire au moment de la requête (dans le paramètre area_needed ). Voici une stratégie possible pour l’utilisation de ce verbe :

• Si la valeur buffer_len est inférieure à la valeur area_needed retournée par APPC et que la longueur requise est inférieure à 64 kilo-octets (Ko), augmentez la taille de la mémoire tampon d’affichage à une valeur égale ou supérieure à la valeur area_needed .

• Si la valeur area_needed est supérieure à 64 Ko, vous pouvez choisir de demander chaque section d’informations individuellement. Vous pouvez également effectuer les étapes suivantes :

  1. Traitez les sections d’informations avec des informations complètes, dont le nombre total affiché est égal au nombre total réel.

  2. Choisissez un sous-ensemble des sections d’informations que vous avez demandées qui contient des informations incomplètes, puis rééditez le verbe demandant ces sections d’informations.

  3. Répétez les étapes a et b si nécessaire.

  Notes

  Si une section d’informations individuelles est supérieure à 64 Ko, vous ne pouvez pas obtenir toutes les informations demandées auprès d’APPC.

  Le verbe DISPLAY ne doit pas être exécuté à partir de threads différents du même processus, car il n’est pas thread-safe.

  Le verbe DISPLAY retourne AP_DISPLAY_INVALID_CONSTANT si les valeurs suivantes ne sont pas définies pour les paramètres fournis pour init_sect_len et num_sections :

Le AP_DISPLAY_INVALID_CONSTANT est également retourné lorsque les paramètres suivants ne sont pas définis correctement :

• reserv2 doit avoir la valeur NULL.

• am_info doit être défini sur AP_NO.

• tp_info doit être défini sur AP_NO.

• adapter_info doit être défini sur AP_NO si le format NS/2 est demandé.

• ms_info doit être défini sur AP_NO si le format NS/2 est demandé.

Voir aussi

Extensions de Host Integration Server
Différences par type d’informations