Richiesta Open(SSCP)

  • Articolo

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;  
};

Members

nxtqptr
Puntatore all'intestazione del buffer successiva.

hdrept
Puntatore al primo elemento 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 Note.

srci
Indice di origine.

destl
Località di destinazione.

destp
Partner di destinazione.

desti
Indice di destinazione.

ophdr.openqual
Qualificatore APERTO 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 Note.

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

ophdr.opresid
Identificatore di risorsa.

ophdr.icreditr
Riservato.

ophdr.icredits
Riservato.

ophdr.opninfo1
Riservato.

ophdr.opnpad1
Tipo forza aperto. Per altre informazioni, vedere Note.

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 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 di blocchi ottenute da Dynamic Access Module (DMOD). Per altre informazioni, vedere Note.

dataru[37]

Opzione di recapito segmento.

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

Distribuire segmenti ur (0x01)

dataru[38]

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

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 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 Note.

Commenti

  • 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 di destinazione deve essere impostato sul nome o sul nome del pool lu tratto dal record utente 3270 (riempito a destra con spazi ASCII se meno di 10 caratteri).

  • Un'applicazione LUA usa il valore P di origine LUAPROD (0x1D). Ciò è indipendente 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 definito 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) riceve il controllo corrispondente al codice di senso non è supportato per questa 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 nel nodo locale nella richiesta Open(SSCP). Viene generato dal nome della destinazione nel primo elemento.

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

  • Il campo tipo di interfaccia dell'applicazione definisce se la suddivisione in blocchi ur viene usata dal nodo locale all'applicazione. Questo può essere necessario se vengono usate unità ur di grandi dimensioni. Per altre informazioni sulla suddivisione in blocchi FMI, vedere Pacing e Chunking.

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

  • L'opzione di recapito segmento specifica se il nodo locale deve recapitare segmenti di UR all'applicazione non appena vengono ricevuti o devono assemblare l'intera unità ur prima di recapitarle all'applicazione. Il recapito segmento consente all'applicazione di aggiornare la schermata dell'utente non appena vengono ricevuti i dati, noti come ombreggiatura delle finestre, che possono causare una risposta percepita più veloce. Per altre informazioni, vedere Distribuzione segmento. Questa opzione è necessaria solo quando viene usata la suddivisione in blocchi. È incluso in questo messaggio in modo che il nodo locale possa calcolare i valori di credito di blocchi iniziali nella connessione PLU (Primary Logic Unit) corrispondente. L'opzione deve comunque essere impostata sulla risposta Open(PLU). L'impostazione specificata in tale messaggio eseguirà l'override di quella specificata qui se si verifica un conflitto. In questo caso, i valori di credito iniziali potrebbero non essere adatti.

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

  • Se l'elemento è più breve di (s+34) byte, Microsoft® Host Integration Server presuppone che non venga eseguito alcun blocco luA e nessuna suddivisione in blocchi. Ciò 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 questo metodo per identificare uno spazio di presentazione specifico 3270 a cui fa riferimento una funzione HLLAPI. Viene anche definito 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.