Informazioni sul collegamento attivo
Le informazioni sul collegamento attivo vengono fornite nella struttura link_info_sect , come definito di seguito.
Sintassi link_info_sect
typedef struct link_info_sect {
unsigned long link_init_sect_len;
unsigned short num_links;
unsigned short total_links;
} LINK_INFO_SECT;
Membri
link_init_sect_len
Lunghezza della sezione iniziale delle informazioni sul collegamento attivo, incluso questo parametro, fino al primo gruppo di sovrapposizioni di collegamenti. La lunghezza non include sezioni di informazioni precedenti.
num_links
Numero di collegamenti attivi restituiti dal verbo DISPLAY nel buffer del programma. Questo è il numero di volte in cui il gruppo di sovrapposizione dei collegamenti viene ripetuto.
total_links
Numero totale di collegamenti attivi. Questo numero corrisponde al numero restituito nel membro num_links tranne quando APPC contiene più informazioni sui collegamenti attivi rispetto a quanto possa essere inserito nel buffer fornito, nel qual caso questo numero è maggiore.
Per ogni collegamento attivo, viene fornita una struttura link_overlay per il collegamento attivo, come definito di seguito.
Sintassi link_overlay
typedef struct link_overlay {
unsigned long link_entry_len;
unsigned char link_id[12];
unsigned long dlc_name[8];
unsigned char adapter_num;
unsigned char dest_addr_len;
unsigned char dest_addr[32];
unsigned char inbound_outbound;
unsigned char state;
unsigned char deact_link_flag;
unsigned char reserv3;
unsigned short num_sessions;
unsigned short ru_size;
unsigned short reserv4;
unsigned char adj_fq_cp_name[17];
unsigned char adj_node_type;
unsigned char reserv5;
unsigned char cp_cp_sess_spt;
unsigned char conn_type;
unsigned char ls_role;
unsigned char line_type;
unsigned char tg_number;
unsigned long eff_capacity;
unsigned char conn_cost;
unsigned char byte_cost;
unsigned char propagation_delay;
unsigned char user_def_1;
unsigned char user_def_2;
unsigned char user_def_3;
unsigned char security;
unsigned char reserv6;
} LINK_OVERLAY;
Definito da IBM ES per OS/2 versione 1.0
Membri
link_entry_len
Dimensioni di questa voce di collegamento.
link_id
Nome della stazione di collegamento logico locale (EBCDIC).
dlc_name
Nome DLC (Data Link Control) impostato su uno dei seguenti:
ETHERAND
IBMTRNET
IBMPCNET
SDLC
TWINAX (non supportato da Host Integration Server)
X25DLC
adapter_num
Numero di adattatore utilizzato da questo collegamento per connettersi al nodo adiacente.
dest_addr_len
Lunghezza dell'indirizzo dell'adattatore di destinazione.
dest_addr
Indirizzo dell'adattatore di destinazione.
inbound_outbound
Direzione del collegamento. I valori possibili sono:
AP_OUTBOUND
Il collegamento è in uscita.
AP_INBOUND
Il collegamento è in ingresso.
state
Stato del collegamento. Lo stato del collegamento può essere uno dei seguenti:
AP_CONALS_PND
Il processo di attivazione del collegamento è stato avviato ma la negoziazione XID non è stata avviata.
AP_XID_PND
La negoziazione XID è in corso.
AP_CONTACT_PND
La negoziazione XID è stata completata, ma la risposta finale del DLC non è stata ricevuta.
AP_CONTACTED
Il collegamento è completamente funzionante.
AP_DISC_PND
È stata inviata una richiesta di disconnessione del collegamento al DLC.
AP_DISC_RQ
L'operatore ha richiesto che il collegamento sia disconnesso.
deact_link_flag
Disattivare il collegamento logico.
reserv3
Un campo riservato.
num_sessions
Numero di sessioni attive.
ru_size
Dimensioni UR.
reserv4
Un campo riservato.
adj_fq_cp_name
Cp_name completo nel nodo adiacente.
adj_node_type
Tipo di nodo adiacente (NN, EN o LEN).
cp_cp_sess_spt
Specifica se il collegamento supporta le sessioni CP-CP.
conn_type
Indica se il protocollo di attivazione della sessione segue le regole per un lu indipendente o un lu dipendente. Il tipo di connessione può essere uno dei seguenti:
AP_HOST_SESSION
Per i protocolli LU dipendenti, l'lu della workstation è definita dipendente dall'host, l'lu host invia la richiesta di attivazione della sessione (BIND) e ogni lu workstation può supportare una sola sessione alla volta.
AP_PEER_SESSION
Per i protocolli LU indipendenti, un lu può inviare un'associazione e può avere più sessioni a partner diversi o sessioni parallele allo stesso lu partner.
AP_BOTH_SESSION
Le connessioni possono supportare unità dinamiche dipendenti e indipendenti.
ls_role
Specifica il ruolo della stazione di collegamento.
line_type
Tipo di riga.
tg_number
Numero del gruppo di trasmissione.
eff_capacity
Capacità effettiva di trasmissione con velocità di bit più elevata supportata.
conn_cost
Costo relativo per tempo di connessione tramite questo collegamento.
byte_cost
Costo relativo della trasmissione di un byte tramite collegamento.
propagation_delay
Indica la quantità di tempo per la lunghezza del collegamento da parte del segnale. Impostare su uno dei valori seguenti:
AP_PROP_DELAY_MINIMUM
AP_PROP_DELAY_LAN
AP_PROP_DELAY_TELEPHONE
AP_PROP_DELAY_PKT_SWITCHED_NET
AP_PROP_DELAY_SATELLITE
AP_PROP_DELAY_MAXIMUM
user_def_1
Caratteristiche TG definite dall'utente.
user_def_2
Caratteristiche TG definite dall'utente.
user_def_3
Caratteristiche TG definite dall'utente.
security
Valore di sicurezza per questo collegamento. Impostare su uno dei valori seguenti:
AP_SEC_NONSECURE
AP_SEC_PUBLIC_SWITCHED_NETWORK
AP_SEC_UNDERGROUND_CABLE
AP_SEC_SECURE_CONDUIT
AP_SEC_GUARDED_CONDUIT
AP_SEC_ENCRYPTED
AP_SEC_GUARDED_RADIATION
reserv6
Un campo riservato.
Restituito da Host Integration Server
Membri
link_entry_len
Dimensioni di questa voce di collegamento.
link_id
Nome connessione.
dlc_name
Il nome del DLC è impostato su uno dei seguenti:
IBMTRNET
SDLC
X25DLC
adapter_num
Numero di adattatore utilizzato da questo collegamento per connettersi al nodo adiacente. Impostare sempre su zero.
dest_addr_len
Lunghezza dell'indirizzo dell'adattatore di destinazione.
dest_addr
Indirizzo dell'adattatore di destinazione.
inbound_outbound
Direzione del collegamento. I valori possibili sono:
AP_OUTBOUND
Il collegamento è in uscita.
AP_INBOUND
Il collegamento è in ingresso.
state
Stato del collegamento. Lo stato del collegamento può essere uno dei seguenti:
AP_CONALS_PND
Il processo di attivazione del collegamento è stato avviato ma la negoziazione XID non è stata avviata.
AP_XID_PND
La negoziazione XID è in corso.
AP_CONTACT_PND
La negoziazione XID è stata completata, ma la risposta finale del DLC non è stata ricevuta.
AP_CONTACTED
Il collegamento è completamente funzionante.
AP_DISC_PND
È stata inviata una richiesta di disconnessione del collegamento al DLC.
AP_DISC_RQ
L'operatore ha richiesto che il collegamento sia disconnesso.
deact_link_flag
Disattivare il collegamento logico.
num_sessions
Numero di sessioni attive.
ru_size
Dimensioni UR.
adj_fq_cp_name
Cp_name completo nel nodo adiacente. Impostare sempre su spazi EBCDIC.
adj_node_type
Tipo di nodo adiacente. Impostare sempre su AP_LEN.
cp_cp_sess_spt
Specifica se il collegamento supporta le sessioni CP-CP. Impostare sempre su AP_NO.
conn_type
Indica se il protocollo di attivazione della sessione segue le regole per un lu indipendente o un lu dipendente. Il tipo di connessione può essere uno dei seguenti:
AP_HOST_SESSION
Per i protocolli LU dipendenti, l'lu della workstation è definita dipendente dall'host, l'lu host invia la richiesta di attivazione della sessione (BIND) e ogni lu workstation può supportare una sola sessione alla volta.
AP_PEER_SESSION
Per i protocolli LU indipendenti, un lu può inviare un'associazione e può avere più sessioni a partner diversi o sessioni parallele allo stesso lu partner.
ls_role
Specifica il ruolo della stazione di collegamento.
line_type
Tipo di riga.
tg_number
Numero del gruppo di trasmissione. Impostare sempre su zero.
effective_capacity
Capacità effettiva di trasmissione con velocità di bit più elevata supportata. Impostare sempre su zero.
conn_cost
Costo relativo per tempo di connessione tramite questo collegamento. Impostare sempre su zero.
byte_cost
Costo relativo della trasmissione di un byte tramite collegamento. Impostare sempre su zero.
propagation_delay
Indica la quantità di tempo per il segnale per la lunghezza di viaggio del collegamento. Questo parametro è sempre impostato su AP_PROP_DELAY_MAXIMUM.
user_def_1
Caratteristiche TG definite dall'utente. Impostare sempre su zero.
user_def_2
Caratteristiche TG definite dall'utente. Impostare sempre su zero.
user_def_3
Caratteristiche TG definite dall'utente. Impostare sempre su zero.
security
Valore di sicurezza per questo collegamento. Impostare sempre su AP_SEC_NONSECURE.