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À APPC. Gli utenti di 5250 emulatori, in particolare, devono usare l'estensione GetAPPCConfig di Windows.
Nota
A causa della natura dell'architettura client/server, l'implementazione del verbo DISPLAY in Host Integration Server contiene differenze importanti rispetto a IBM Extended Services for OS/2 versione 1.0 (IBM ES per OS/2 versione 1.0) in base alla quale è basata.
Nota
Per le applicazioni che usano il verbo APPC DISPLAY in IBM ES per os/2 versione 1.0 e che non usano le estensioni host integration server per enumerare tutti i server e le connessioni attive, Host Integration Server sceglierà in modo casuale una connessione DISPLAY predefinita, a meno che non sia stata configurata una connessione DISPLAY predefinita specifica in SNA Manager. Questa connessione viene usata come base per tutte le richieste DISPLAY . Per informazioni sulla specifica della connessione DISPLAY predefinita, vedere Guida di Host Integration Server.
La struttura seguente descrive il blocco di controllo verbo usato dal verbo DISPLAY verbo.
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;
Members
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 del VCB, fino all'inizio dei puntatori di informazioni. Questo parametro e il parametro num_sections devono essere impostati su valori specifici a seconda del formato richiesto. Vedere le note riportate di seguito per informazioni dettagliate.
buffer_len
Parametro fornito. Specifica la lunghezza (da 0 a 6535 byte) del buffer dati visualizzato passato.
buffer_ptr
Parametro fornito. Fornisce l'indirizzo del buffer dati visualizzato 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. Vedere le note riportate di seguito per informazioni dettagliate.
display_len
Parametro restituito. Fornisce il numero totale di byte usati che vengono 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 sono 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 rete attive, sui propri partner e sulle relative modalità. I valori consentiti sono AP_YES e AP_NO.
am_info
Parametro fornito. Specifica se vengono richieste informazioni su Attach Manager nel TP definito. I valori consentiti sono AP_YES e AP_NO.
Nota
Questa opzione non è supportata da Host Integration Server e questo parametro deve essere impostato su AP_NO.
tp_info
Parametro fornito. Specifica se vengono richieste informazioni sui provider di servizi di configurazione attivi e sulle conversazioni attive. I valori consentiti sono AP_YES e AP_NO.
Nota
Questa opzione non è supportata da Host Integration Server e questo parametro deve essere impostato su 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 sono 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.
Nota
Questa opzione non è supportata da Host Integration Server e questo parametro deve essere impostato su AP_NO.
sys_def_info
Parametro fornito. Specifica se vengono richieste informazioni sul lu, i nomi dei nodi e i 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à LU 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 Gestione collegamento nel buffer dei dati.
Nota
Questa opzione non è supportata da Host Integration Server.
tp_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni tp nel buffer dei dati.
Nota
Questa opzione non è supportata da Host Integration Server.
sess_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sulla sessione nel buffer dei dati.
link_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni di 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 dei dati.
Nota
Questa opzione non è supportata da Host Integration Server.
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 dei dati.
lu_def_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sulla definizione lu locale nel buffer dei dati.
plu_def_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sulla definizione lu del partner nel buffer dei dati.
mode_def_info_ptr
Parametro restituito. Indica l'indirizzo dell'inizio delle informazioni sulla definizione della modalità nel buffer dei 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 restituiti
AP_OK
Codice restituito primario; il 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 TPs ha rilevato un ABEND.
AP_COMM_SUBSYSTEM_NOT_LOADED
Codice restituito primario; Impossibile caricare o terminare un componente richiesto 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 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 all'APPC durante l'elaborazione di una chiamata APPC dal TP locale. Il codice restituito dal sistema operativo viene restituito tramite il secondary_rc. Viene visualizzato nell'ordine di scambio di byte Intel. Se il problema persiste, consultare l'amministratore di sistema.
Commenti
DISPLAY identifica un'unità LU solo per alias. 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 rispetto a quello previsto.
Per restituire correttamente il verbo DISPLAY , è 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 ha assunto 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 è abbastanza 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 segue:
Se il valore buffer_len è minore del valore area_needed restituito da APPC e la lunghezza necessaria è minore di 64 kilobyte (KB), aumentare le dimensioni del buffer di visualizzazione in modo uguale o maggiore del valore area_needed .
Se il valore area_needed è maggiore di 64 KB, è possibile scegliere di richiedere singolarmente ogni sezione di informazioni. In alternativa, è possibile seguire questa procedura:
Elaborare le sezioni delle informazioni con informazioni complete, il cui numero totale visualizzato corrisponde al numero effettivo totale.
Scegliere un sottoinsieme delle sezioni informazioni richieste che contengono informazioni incomplete e ripubblicare il verbo che richiede tali sezioni di informazioni.
Ripetere i passaggi a e b in base alle esigenze.
Nota
Se una singola sezione delle 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, poiché 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:
| Formato NS/2 | Formato IBM EE | Formato NS/2 (solo Windows) | Formato IBM EE (solo Windows) | |
|---|---|---|---|---|
| init_sect_len | 50 | 44 | 52 | 48 |
| num_sections | 16 | 9 | 16 | 9 |
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 di Host Integration Server
Differenze in base al tipo di informazioni