VISUALIZZAZIONE

Il verbo DISPLAY restituisce informazioni di configurazione e valori operativi correnti per il nodo SNA.

È consigliabile usare la funzione di estensione Di Windows GetAppcConfig per ottenere informazioni di configurazione del sistema relative alle UNITÀ di configurazione app. Gli utenti di 5250 emulatori, in particolare, devono usare l'estensione Windows GetAPPCConfig .

Nella struttura seguente viene descritto il blocco di controllo verbo utilizzato dal verbo DISPLAY .

Sintassi

  
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;   

Membri

Opcode
Parametro fornito. Specifica il codice dell'operazione verbo, AP_DISPLAY.

reserv2
Un campo riservato, questo valore deve essere impostato su NULL.

Primary_rc
Parametro restituito. Specifica il codice restituito primario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.

Secondary_rc
Parametro restituito. Specifica il codice restituito secondario impostato da APPC al completamento del verbo. I codici restituiti validi variano a seconda del verbo APPC rilasciato. Per questo verbo, vedere Codici restituiti per i codici di errore validi.

init_sect_len
Parametro fornito. Specifica il numero di byte nella sezione iniziale di VCB, fino all'inizio dei puntatori alle informazioni. Questo parametro e il parametro num_sections devono essere impostati su valori specifici a seconda del formato richiesto. Per informazioni dettagliate, vedere le note seguenti.

buffer_len
Parametro fornito. Specifica la lunghezza (da 0 a 65535 byte) del buffer di dati di visualizzazione passato.

buffer_ptr
Parametro fornito. Fornisce l'indirizzo del buffer di dati di visualizzazione che conterrà le informazioni richieste.

num_sections
Parametro fornito. Specifica il numero massimo di sezioni di informazioni che possono essere restituite dal verbo. Questo parametro e il parametro init_sect_len devono essere impostati su valori specifici a seconda del formato richiesto. Per informazioni dettagliate, vedere le note seguenti.

display_len
Parametro restituito. Fornisce il numero totale di byte utilizzati restituiti nel buffer dei dati di visualizzazione.

area_needed
Parametro restituito. Fornisce il numero totale di byte necessari per tutti i dati visualizzati.

sna_global_info
Parametro fornito. Specifica se vengono richieste informazioni globali. I valori consentiti sono AP_YES e AP_NO.

lu62_info
Parametro fornito. Specifica se vengono richieste informazioni su tutte le UNITÀ di elaborazione attive, sui partner e sulle relative modalità. I valori consentiti sono AP_YES e AP_NO.

am_info
Parametro fornito. Specifica se vengono richieste le informazioni di Attach Manager sul tp definito. I valori consentiti sono AP_YES e AP_NO.

tp_info
Parametro fornito. Specifica se vengono richieste informazioni sui TP attivi e sulle conversazioni attive. I valori consentiti sono AP_YES e AP_NO.

sess_info
Parametro fornito. Specifica se vengono richieste informazioni sulle sessioni. I valori consentiti sono AP_YES e AP_NO.

link_info
Parametro fornito. Specifica se vengono richieste informazioni sulle righe logiche SNA attive. I valori consentiti sono AP_YES e AP_NO.

lu_0_3_info
Parametro fornito. Specifica se vengono richieste informazioni sul tipo di unità logiche 0, 1, 2 e 3. I valori consentiti sono AP_YES e AP_NO.

gw_info
Parametro fornito. Specifica se vengono richieste informazioni sul gateway SNA. I valori consentiti sono AP_YES e AP_NO.

x25_physical_link_info
Parametro fornito. Specifica se sono necessarie informazioni X.25. I valori consentiti sono AP_YES e AP_NO.

sys_def_info
Parametro fornito. Specifica se vengono richieste informazioni sulle unità logiche predefinite, sui nomi dei nodi e sui parametri predefiniti per i partner impliciti in ingresso e in uscita. I valori consentiti sono AP_YES e AP_NO.

adapter_info
Parametro fornito. Specifica se vengono richieste informazioni sugli adattatori di comunicazione configurati. I valori consentiti sono AP_YES e AP_NO. Questo parametro deve essere impostato su AP_NO quando viene richiesto il formato NS/2.

lu_def_info
Parametro fornito. Specifica se vengono richieste informazioni sulle unità di archiviazione definite. I valori consentiti sono AP_YES e AP_NO.

plu_def_info
Parametro fornito. Specifica se vengono richieste informazioni sulle unità di elaborazione del partner definite. I valori consentiti sono AP_YES e AP_NO.

mode_def_info
Parametro fornito. Specifica se vengono richieste informazioni sui nodi definiti. I valori consentiti sono AP_YES e AP_NO.

link_def_info
Parametro fornito. Specifica se vengono richieste informazioni sui collegamenti logici definiti. I valori consentiti sono AP_YES e AP_NO.

ms_info
Parametro fornito. Specifica se vengono richieste informazioni sui servizi di gestione. I valori consentiti sono AP_YES e AP_NO. Questo parametro deve essere impostato su AP_NO quando viene richiesto il formato NS/2.

sna_global_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni globali SNA nel buffer dei dati.

lu62_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni LU 6.2 nel buffer dei dati.

am_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni di Attach Manager nel buffer di dati.

tp_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni TP nel buffer di dati.

sess_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni della sessione nel buffer dei dati.

link_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sul collegamento nel buffer dei dati.

lu_0_3_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni lu nel buffer dei dati.

gw_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sul gateway nel buffer dei dati.

x25_physical_link_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni X.25 nel buffer di dati.

sys_def_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni predefinite del sistema nel buffer dei dati.

adapter_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sull'adattatore nel buffer di dati.

lu_def_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sulla definizione lu locale nel buffer di dati.

plu_def_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sulla definizione lu partner nel buffer di dati.

mode_def_info_ptr
Parametro restituito. Indica l'indirizzo delle informazioni di definizione dell'inizio della modalità nel buffer di dati.

link_def_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sulla definizione del collegamento nel buffer dei dati.

ms_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sui servizi di gestione nel buffer dei dati.

Codici di ritorno

AP_OK
Codice restituito primario; verbo eseguito correttamente.

AP_PARAMETER_CHECK
Codice restituito primario; il verbo non è stato eseguito a causa di un errore di parametro.

AP_DISPLAY_INVALID_CONSTANT
Codice restituito secondario; il valore specificato per NUM_SECTIONS o INIT_SEC_LEN non è valido.

AP_STATE_CHECK
Codice restituito primario; il verbo non è stato eseguito perché è stato emesso in uno stato non valido.

AP_DISPLAY_INFO_EXCEEDS_LEN
Codice restituito secondario; le informazioni DISPLAY restituite non rientrano nel buffer.

AP_INVALID_DATA_SEGMENT
Codice restituito secondario; il segmento contenente il buffer di dati è troppo piccolo per la lunghezza dei dati specificata.

AP_COMM_SUBSYSTEM_ABENDED
Codice restituito primario; indica una delle condizioni seguenti:

Il nodo usato da questa conversazione ha rilevato un ABEND.

La connessione tra il tp e il tipo di nodo 2.1 è stata interrotta (errore LAN).

SnaBase nel computer TP ha rilevato un ABEND.

AP_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente necessario durante l'elaborazione del verbo. Pertanto, la comunicazione non poteva avvenire. Contattare l'amministratore di sistema per un'azione correttiva.

AP_INVALID_VERB_SEGMENT
Codice restituito primario; VCB è stato esteso oltre la fine del segmento di dati.

AP_STACK_TOO_SMALL
Codice restituito primario; le dimensioni dello stack dell'applicazione sono troppo piccole per eseguire il verbo. Aumentare le dimensioni dello stack dell'applicazione.

AP_UNEXPECTED_DOS_ERROR
Codice restituito primario; il sistema operativo ha restituito un errore ad APPC durante l'elaborazione di una chiamata APPC dal tp locale. Il codice restituito del sistema operativo viene restituito tramite il secondary_rc. Viene visualizzato nell'ordine di scambio dei byte Intel. Se il problema persiste, rivolgersi all'amministratore di sistema.

Osservazioni:

DISPLAY identifica un lu per alias da solo. Se lo stesso alias LU locale viene usato più volte in un dominio (per il backup o altri scopi) e tale alias LU viene specificato tramite DISPLAY, il verbo può passare a un lu diverso da quello previsto.

Affinché il verbo DISPLAY venga restituito correttamente, è necessario definire una connessione specifica nella finestra di dialogo Visualizzazione verbo del programma SNA Manager. IBM ha originariamente definito il verbo DISPLAY con il prodotto IBM OS/2 Extended Edition che presupponeva una singola connessione. Tuttavia, poiché Host Integration Server supporta più connessioni, è necessario configurare la connessione specifica associata al verbo DISPLAY .

Il verbo DISPLAY richiede un buffer fornito dall'utente per la restituzione delle informazioni di sistema. Se il buffer non è sufficientemente grande, APPC restituisce il codice restituito AP_DISPLAY_INFO_EXCEEDS_LEN, insieme alle dimensioni effettivamente necessarie al momento della richiesta (nel parametro area_needed ). Una possibile strategia per l'uso di questo verbo è la seguente:

• Se il valore buffer_len è minore del valore area_needed restituito da APPC e la lunghezza richiesta è inferiore a 64 kilobyte (KB), aumentare le dimensioni del buffer di visualizzazione su un valore uguale o maggiore del valore area_needed .

• Se il valore area_needed è maggiore di 64 KB, è possibile scegliere di richiedere singolarmente ogni sezione informativa. In alternativa, è possibile seguire questa procedura:

  1. Elaborare le sezioni di informazioni con informazioni complete, il cui numero totale visualizzato corrisponde al numero effettivo totale.

  2. Scegliere un subset delle sezioni di informazioni richieste che contengono informazioni incomplete e riemettere il verbo che richiede tali sezioni.

  3. Ripetere i passaggi a e b in base alle esigenze.

  Annotazioni

  Se una singola sezione di informazioni è maggiore di 64 KB, non è possibile ottenere tutte le informazioni richieste da APPC.

  Il verbo DISPLAY non deve essere eseguito da thread diversi dello stesso processo, perché non è thread-safe.

  Il verbo DISPLAY restituisce AP_DISPLAY_INVALID_CONSTANT se i valori seguenti non sono impostati per i parametri forniti per init_sect_len e num_sections:

Il AP_DISPLAY_INVALID_CONSTANT viene restituito anche quando i parametri seguenti non sono impostati correttamente:

• reserv2 deve essere impostato su NULL.

• am_info deve essere impostato su AP_NO.

• tp_info deve essere impostato su AP_NO.

• adapter_info deve essere impostato su AP_NO se è richiesto il formato NS/2.

• ms_info deve essere impostato su AP_NO se è richiesto il formato NS/2.

Vedere anche

Estensioni host integration server
Differenze in base al tipo di informazioni