Richiesta Open(SSCP)

Il messaggio di richiesta Open(SSCP) passa dall'applicazione al nodo. Viene usato con una connessione SSCP (System Services Control Point).

Sintassi

struct Open(SSCP) Request {  
    PTRBFHDR  nxtqptr;  
    PTRBFELT  hdrept;  
    CHAR      numelts;  
    CHAR      msgtype;  
    CHAR      srcl;  
    CHAR      srcp;  
    INTEGER   srci;  
    CHAR      destl;  
    CHAR      destp;  
    INTEGER   desti;  
    CHAR      ophdr.openqual;  
    CHAR      ophdr.opentype;  
    CHAR      ophdr.appltype;  
    CHAR      ophdr.opluno;  
    INTEGER   ophdr.opresid;  
    INTEGER   ophdr.icreditr;  
    INTEGER   ophdr.icredits;  
    CHAR      ophdr.opninfo1;  
    CHAR      ophdr.opnpad1;  
};   
struct Open(SSCP) Request {  
    PTRBFELT   hdreptr->elteptr;  
    INTEGER    hdreptr->startd;  
    INTEGER    hdreptr->endd;  
    CHAR       hdreptr->trpad;  
    CHAR[268]  hdreptr->dataru;  
};  
struct Open(SSCP) Request {  
    PTRBFELT  hdreptr->elteptr->elteptr;  
    INTEGER   hdreptr->elteptr->startd;  
    INTEGER   hdreptr->elteptr->endd;  
    CHAR      hdreptr->elteptr->trpad;  
    CHAR[268] hdreptr->elteptr->dataru;  
};  

Membri

nxtqptr
Puntatore all'intestazione del buffer successiva.

hdrept
Puntatore al primo elemento del buffer.

numelts
Numero di elementi del buffer (0x02).

msgtype
Tipo di messaggio OPENMSG (0x01).

srcl
Località di origine.

srcp
Partner di origine. Per altre informazioni, vedere Osservazioni.

srci
Indice di origine.

destl
Località di destinazione.

destp
Partner di destinazione.

desti
Indice di destinazione.

ophdr.openqual
Qualificatore OPEN REQU (0x01).

ophdr.opentype
Tipo aperto SSCPSEC (0x01).

ophdr.appltype
Tipo di interfaccia del programma dell'applicazione.

Interfaccia di gestione delle funzioni (FMI) senza suddivisione in blocchi (0x02).

FMI con suddivisione in blocchi (0x82). Per altre informazioni, vedere Osservazioni.

ophdr.opluno
Numero unità logica. Per altre informazioni, vedere Osservazioni.

ophdr.opresid
Identificatore risorsa.

ophdr.icreditr
Riservato.

ophdr.icredits
Riservato.

ophdr.opninfo1
Riservato.

ophdr.opnpad1
Tipo di forza aperto. Per altre informazioni, vedere Osservazioni.

OPEN_TEST (0x00)

OPEN_FORCE (0x01)

Elemento 1

hdreptr–>elteptr
Puntatore all'elemento buffer successivo.

hdreptr-startd>
Inizio dei dati in questo elemento buffer (1).

hdreptr-endd>
Fine dei dati in questo elemento del buffer.

hdreptr-trpad>
Riservato (1 byte).

hdreptr-dataru>
Richiesta dati/unità di risposta (UR), come indicato di seguito:

dataru[0-9]

Nome origine. Deve essere riempito con spazi vuoti.

dataru[10-19]

Nome destinazione. Impostare sull'unità logica (LU) con cui si vuole comunicare.

dataru[20]

Flag Sense 4003.

dataru[21]

Flag Sense 4004.

dataru[22]

Flag Sense 4006.

dataru[23]

Flag Sense 4007.

dataru[24]

Flag Sense 4009.

dataru[25]

Flag Sense 400A.

dataru[26]

Flag Sense 400B.

dataru[27]

Flag Sense 400C.

dataru[28]

Flag Sense 400D.

dataru[29]

Flag Sense 400F.

dataru[30]

Flag Sense 4011.

dataru[31]

Flag Sense 4012.

dataru[32]

Flag Sense 4014.

dataru[33]

Indicatore ad alta priorità.

HIGH (0x01)

LOW (0x02)

dataru[34]

Indicatore supportato dall'applicazione unità logica (LUA).

Supportato (0x01)

Non supportato (0x00)

dataru[35–36]

Dimensioni blocchi ottenute da Dynamic Access Module (DMOD). Per altre informazioni, vedere Osservazioni.

dataru[37]

Opzione di recapito segmento.

Non recapitare segmenti di richiesta/unità di risposta (UR) (0x00)

Fornire segmenti di UR (0x01)

dataru[38]

Identificatore di sessione HLLAPI (High-Level Language Application Programming Interface). Per altre informazioni, vedere Osservazioni.

Elemento 2

hdreptr–>elteptr–>elteptr
Puntatore all'elemento buffer successivo (NIL).

hdreptr–>elteptr–>startd
Inizio dei dati in questo elemento buffer (1).

hdreptr–>elteptr–>endd
Fine dei dati in questo elemento del buffer.

hdreptr–>elteptr–>trpad
Riservato.

hdreptr–>elteptr–>dataru
UR dati, come indicato di seguito:

dataru[0]

Stringa ASCII che identifica l'emulatore 3270. Per altre informazioni, vedere Osservazioni.

Osservazioni:

• Il messaggio di richiesta Open(SSCP) è costituito da un'intestazione del buffer e da due elementi del buffer.

• Il valore L di origine, i valori LPI (Locality Partner Index) di destinazione e il nome di origine sono riservati.

• Per un emulatore 3270, il valore P di origine deve essere impostato su S3PROD (0x12), che identifica l'applicazione come emulatore 3270. Il nome della destinazione deve essere impostato sul nome lu o sul nome del pool ricavato dal record utente 3270 (riempito con spazi ASCII con un numero inferiore di 10 caratteri).

• Un'applicazione LUA usa il valore P di origine LUAPROD (0x1D). Indipendentemente dal valore dell'indicatore supportato luA, che seleziona la variante LUA dell'FMI.

• Il SNS4003 per SNS4014 campi, insieme all'indicatore ad alta priorità, viene indicato nel testo come blocco di controllo delle informazioni di connessione SSCP (CICB). Per altre informazioni, vedere Apertura della connessione SSCP. Un valore di 0x00 indica che il controllo del flusso di dati (DFC) di ricezione corrispondente al codice sense non è supportato per questo lu. Un valore di 0x01 indica che è supportato. Si noti che i controlli di invio corrispondenti vengono sempre eseguiti indipendentemente da questi valori.

• Il numero lu viene usato internamente solo nel nodo locale nella richiesta Open(SSCP). Viene generato dal nome di destinazione nel primo elemento.

• Il campo tipo di forza aperta viene usato quando si individuano le risorse in più server e per l'attivazione automatica delle connessioni quando l'applicazione vuole usare un'unità lu per la quale la connessione è inattiva. L'applicazione non deve impostare questo flag. Viene usato da DL-BASE. Per informazioni dettagliate, vedere Apertura della connessione SSCP.

• Il campo tipo di interfaccia del programma dell'applicazione definisce se la suddivisione in blocchi ur viene usata dal nodo locale all'applicazione. Questa operazione può essere necessaria se si usano UR di grandi dimensioni. Per altre informazioni sulla suddivisione in blocchi FMI, vedere Pacing e Chunking.

• Il campo dimensione blocco (in dataru[35]) è un valore intero.

• L'opzione di recapito dei segmenti specifica se il nodo locale deve recapitare segmenti di UR all'applicazione non appena vengono ricevuti o devono assemblare intere UR prima di recapitarle all'applicazione. Il recapito segmento consente all'applicazione di aggiornare lo schermo dell'utente non appena vengono ricevuti i dati, noti come ombreggiatura della finestra, che può comportare una risposta percepita più veloce. Per altre informazioni, vedere Recapito segmento. Questa opzione è obbligatoria solo quando viene usata la suddivisione in blocchi. Viene incluso in questo messaggio in modo che il nodo locale possa calcolare i valori di credito dei blocchi iniziali nella connessione PLU (Primary Logical Unit) corrispondente. L'opzione deve comunque essere impostata nella risposta Open(PLU). Se si verifica un conflitto, l'impostazione specificata in tale messaggio sostituirà quella specificata qui. In questo caso, i valori di credito iniziali potrebbero non essere adatti.

• L'indicatore LUA supportato specifica se l'applicazione usa la variante LUA dell'fmi.

• Se l'elemento è più breve di (s+34) byte, Microsoft® Host Integration Server non presuppone luA e nessuna suddivisione in blocchi. In questo modo si garantisce la compatibilità con le versioni precedenti del software del nodo locale in cui queste opzioni non erano disponibili.

• L'identificatore di sessione HLLAPI è un singolo carattere ASCII che identifica la sessione di visualizzazione 3270 a cui si applica Open(SSCP). HLLAPI usa questa opzione per identificare uno spazio di presentazione 3270 specifico a cui fa riferimento una funzione HLLAPI. Viene anche definita da 3270 come nome breve della sessione o da HLLAPI come identificatore dello spazio di presentazione (identificatore PS). Se l'emulatore 3270 non supporta gli identificatori di sessione, questo campo deve essere impostato su zero.

• Il secondo elemento contiene una stringa ASCII che è possibile usare per identificare il tipo di emulatore 3270. Questa stringa verrà registrata nel file di log di controllo dal DL-BASE del client e può essere visualizzata anche nelle tracce. I campi iniziali e finali devono essere configurati per definire i limiti di questa stringa.