SEND MAP

Descrizione

SEND MAP invia i dati di uscita a un terminale.

Quando si utilizza il comando SEND MAP con una qualsiasi delle opzioni ALARM, FREEKB, FRSET, HONEOM, L40, L64, L80, o PRINT, vedere BMS macro DFHMDI per una descrizione della priorità dell'opzione.

Consultare Macro BMS per la definizione della mappa.

Opzioni

ACCUM

specifica che questo comando è uno dei numerosi comandi utilizzati per creare un messaggio logico. Il messaggio logico viene completato da un comando SEND PAGE o cancellato da un comando PURGE MESSAGE.

ACTPARTN (nome)

specifica il nome (1-2 caratteri) della partizione da attivare. L'attivazione di una partizione sposta il cursore nella partizione specificata e sblocca la tastiera per la partizione specificata.

Questa opzione viene ignorata se il terminale di destinazione non supporta le partizioni o se non è stata impostata alcuna partizione dell'applicazione.

Allarme

specifica che è necessario attivare la funzione di allarme acustico 3270. Per le unità logiche che supportano FMH (eccetto le unità logiche interattive e batch), ALARM indica a BMS di impostare l'indicatore di allarme in FMH.

Quando si utilizza l'opzione ALLARME, fare riferimento a Macro BMS DFHMDI per una descrizione della priorità dell'opzione.

ALTERNATE

imposta il terminale per utilizzare la dimensione dello schermo ALTERNATE.

CURSOR (valore - dati)

specifica l'ubicazione in cui il cursore 3270 o 3604 deve essere restituito al completamento di un comando SEND MAP.

Il valore dei dati deve essere un valore binario halfword che specifica la posizione del cursore rispetto a zero; l'intervallo di valori che è possibile specificare dipende dalla dimensione dello schermo utilizzato. Se non viene specificato alcun valore di dati, viene assunto il posizionamento del cursore simbolico.

Questa opzione sovrascrive qualsiasi opzione IC dell'operando ATTRB di DFHMDF. Se si sta utilizzando ACCUM, viene utilizzato il valore più recente di CURSOR specificato per posizionare il cursore.

Il valore specificato nell'opzione CURSOR deve essere positivo. Un valore negativo porta a risultati imprevedibili.

SOLO dati

specifica che devono essere scritti solo i dati del programma applicativo. È necessario specificare i caratteri dell'attributo (solo 3270) per ogni campo nei dati forniti. Se il byte dell'attributo nei dati forniti dall'utente è impostato su X'00 ', il byte dell'attributo sullo schermo non viene modificato. Tutti i dati o gli attributi predefiniti dalla mappa vengono ignorati.

DEFAULT

imposta il terminale per utilizzare la dimensione di schermo DEFAULT.

ERASE

specifica che il buffer della stampante dello schermo o la partizione devono essere cancellati e il cursore viene riportato nell'angolo in alto a sinistra dello schermo. (Questa opzione è valida solo per 3270 o 8775 e per la visualizzazione della tastiera 3604.)

La prima operazione di output in qualsiasi transazione, o in una serie di transazioni pseudoconversazionali, deve sempre specificare ERASE. Per le transazioni collegate a schermi o stampanti 3270, a meno che non vengano esplicitamente sovrascritte dall'opzione DEFAULT o ALTERNATE, ciò garantisce anche che venga selezionata la dimensione di schermo corretta, come definito per la transazione dall'opzione SCRNSIZE nella definizione RDO PROFILE.

ERASEAUP

specifica che prima che venga visualizzata questa pagina di emissione, tutte le ubicazioni di caratteri non protetti nella partizione o l'intera schermata devono essere cancellate. (Questa opzione è valida solo per 3270 e 8775.)

FMHPARM (nome)

specifica il nome (1-8 caratteri) della mappa esterna da utilizzare. Questa opzione si applica solo a 3650 unità logiche con formattazione esterna.

FORMFEED

specifica che è richiesta una nuova pagina. Per le stampanti e i pannelli 3270, il carattere FORMFEED è posizionato all'inizio del buffer. Il programma applicativo deve quindi garantire che questa posizione del buffer non venga sovrascritta da dati di mappa o di testo. Viene ignorato se il terminale di destinazione non supporta FORMFEED (cioè, l'opzione RDO TYPETERM FORMFEED non è stata utilizzata).

KB GRATUITI

specifica che la tastiera 3270 deve essere sbloccata dopo la scrittura dei dati. Se FREEKB viene omesso, la tastiera rimane bloccata.

Si noti che lo stato di blocco della tastiera viene mantenuto separatamente per ogni partizione su un terminale che supporti partizioni.

Quando si utilizza l'opzione FREEKB, fare riferimento a Opzioni DFHMDI, CTRL per una descrizione della priorità dell'opzione.

FROM (area - dati)

specifica l'area di dati contenente i dati da elaborare. Se questo campo non viene specificato, il nome viene impostato per default sul nome della mappa con suffisso O. Questo include il prefisso a 12 byte generato dall'opzione TIOAPFX=YES sulle definizioni delle mappe BMS DFHMDI e DFHMSD. Tuttavia, si ottengono migliori prestazioni in fase di esecuzione per le mappe utilizzate da singoli tipi di terminale se si specifica il tipo di terminale (anziché ALL). In alternativa, il supporto BMS per i set di mappe dipendenti dal dispositivo può essere bypassato specificando NODDS nell'operando BMS dei parametri di inizializzazione del sistema.

FSET

specifica che i tag di dati modificati (MDT) di tutti i campi attualmente nel buffer 3270 (o partizione) devono essere reimpostati sulla condizione non modificata (ovvero, reimpostazione campo) prima che i dati della mappa vengano scritti nel buffer.

Ciò consente all'operando ATTRB di DFHMDF per la mappa richiesta di controllare lo stato finale dei campi scritti o riscritti in risposta a un comando BMS, se non sono state scritte altre informazioni sull'attributo nella mappa simbolica.

Quando si utilizza l'opzione FRSET, fare riferimento a Macro BMS DFHMDI per una descrizione della priorità dell'opzione.

HONEOM

specifica che deve essere utilizzata la lunghezza della linea di stampa predefinita. Questa lunghezza deve essere uguale a quella specificata utilizzando le opzioni RDO TYPETERM PAGESIZE o ALTPAGE e la stessa della larghezza della piastra della stampante; altrimenti i dati potrebbero non essere formattati correttamente.

Quando si utilizza l'opzione HONEOM, fare riferimento a Macro BMS DFHMDI per una descrizione della priorità dell'opzione.

ULTIMO

Specifica che questa è l'ultima operazione di output per una transazione e, pertanto, la fine di una parentesi. Questa opzione è valida solo per le unità logiche.

LDC (nome)

specifica un mnemonico di 2 caratteri da utilizzare per stabilire il codice unità logica (LDC) da trasmettere nell'FMH all'unità logica. Lo mnemonico identifica una voce LDC definita da una macro DFHTCT TYPE=LDC.

Quando si specifica un LDC, BMS utilizza il tipo di unità, la dimensione della pagina e lo stato della pagina associato al mnemonico LDC per formattare il messaggio. Questi valori vengono presi dalla tabella LDC locale estesa per l'unità logica, se ne ha una. Se l'unità logica ha solo una tabella LDC locale (non estesa), i valori vengono presi dalla tabella LDC del sistema. Il valore numerico di LDC viene ottenuto dalla tabella LDC locale, a meno che non si tratti di una tabella non estesa e il valore non venga specificato, nel qual caso viene preso dalla tabella di sistema.

Se l'opzione LDC viene omessa, viene utilizzato il mnemonico LDC specificato nella macro DFHMSD; vedere Macro BMS DFHMSD. Se anche l'opzione LDC è stata omessa dalla macro DFHMSD, l'azione dipende dal tipo di unità logica, come segue:

Unità logica 3601

Viene utilizzata la prima voce nella tabella LDC locale o locale estesa, se presente. Se non è possibile ottenere un valore predefinito in questo modo, viene utilizzato un valore numerico LDC null (X'00 '). La dimensione della pagina utilizzata è il valore specificato nelle opzioni RDO TYPETERM PAGESIZE o ALTPAGE oppure (1,40) se tale valore non è specificato.

Unità logica LUTYPE4 , unità logica batch o unità logica di interscambio dati batch

La tabella LDC locale non viene utilizzata per fornire un LDC predefinito; invece, il messaggio viene indirizzato alla console dell'unità logica (ovvero, a qualsiasi supporto scelto dall'unità logica per ricevere tali messaggi). Per un'unità logica di interscambio dati batch, ciò non implica l'invio di un LDC in un FMH. La dimensione pagina viene ottenuta nel modo descritto per l'unità logica 3601.

LENGTH (valore dati)

specifica la lunghezza dei dati da formattare come valore binario halfword.

Se l'area dati che invia la mappa è più lunga dei dati da associare, è necessario specificare LENGTH. Questo dovrebbe includere la lunghezza del prefisso a 12 byte generato dall'opzione TIOAPFX=YES sulle definizioni delle mappe BMS DFHMDI e DFHMSD. Tuttavia, si ottengono migliori prestazioni in fase di esecuzione per le mappe utilizzate da singoli tipi di terminale se si specifica il tipo di terminale (anziché ALL). In alternativa, il supporto BMS per i set di mappe dipendenti dal dispositivo può essere bypassato specificando NODDS nell'operando BMS dei parametri di inizializzazione del sistema. Per una descrizione di un limite superiore sicuro, vedere Considerazioni sulla traduzione: Opzioni LENGTH nei comandi EXEC CICS.

L40, L64o L80

specifica la lunghezza della riga per una stampante 3270; un ritorno a capo e un avanzamento riga vengono forzati dopo che 40, 64 o 80 caratteri sono stati stampati su una riga. È probabile che i risultati non siano accettabili se differiscono dalla larghezza della pagina specificata dalle opzioni RDO TYPETERM PAGESIZE o ALTPAGE.

Quando si utilizzano le opzioni, fare riferimento a Macro BMS DFHMDI per una descrizione della priorità delle opzioni.

MAP (nome)

specifica il nome (1-7 caratteri) della mappa da utilizzare.

SOLO

specifica che solo i dati predefiniti della mappa devono essere scritti.

MAPSET (nome)

specifica il nome senza suffissi (1-7 caratteri) della serie di mappe da utilizzare. La serie di mappe deve trovarsi nella libreria del programma CICS® . La serie di mappe può essere definita utilizzando RDO o mediante autoinstallazione del programma quando la serie di mappe viene utilizzata per la prima volta. Se questa opzione non viene specificata, si presume che il nome fornito nell'opzione MAP sia quello della serie di mappe.

Il numero di mappe per mapset è limitato a un massimo di 9 998.

MSR (valore - dati)

specifica il valore dei dati a 4 byte che controlla il lettore di banda magnetica 10/63 collegato a un terminale 8775 o 3643. In DFHMSRCA viene fornita una serie di costanti che consentono di impostare questa area a 4 byte. Per un elenco completo, vedere Costanti del valore di controllo del lettore di slot magnetici (MSR). Questa opzione viene ignorata se non è stata utilizzata l'opzione RDO TYPETERM MSRCONTROL.

NLEOM

Specifica che i dati per una stampante 3270 o un video 3275 con la funzione dell'adattatore della stampante devono essere creati con spazi vuoti e caratteri NL (new - line) e che un carattere EM (end - of - message) deve essere posizionato alla fine dei dati. Man mano che i dati vengono stampati, ogni carattere NL fa sì che la stampa continui sulla riga successiva e il carattere EM termina la stampa.

Questa opzione deve essere specificata nel primo comando SEND MAP utilizzato per creare un messaggio logico. L'opzione viene ignorata se il dispositivo che riceve il messaggio (diretto o instradato) non è uno di quelli menzionati in precedenza.

Se viene utilizzata questa opzione, l'aggiornamento del buffer e la modifica dell'attributo dei campi precedentemente scritti nel buffer non sono consentiti. CICS include l'opzione ERASE con ogni scrittura sul terminale.

Il carattere NL occupa una posizione di buffer. Un numero di posizioni buffer, equivalente al valore delle opzioni RDO TYPETERM PAGESIZE o ALTPAGE, per tale terminale, non è disponibile per i dati. Ciò può causare il ritorno a capo dei dati nel buffer; se ciò si verifica, è necessario ridurre il valore PAGESIZE o ALTPAGE.

L'opzione NLEOM sovrascrive l'opzione ALARM se quest' ultima è presente.

NOFLUSH

specifica che CICS non cancella le pagine al completamento ma restituisce il controllo al programma (avendo impostato la condizione OVERFLOW in EIBRESP).

OUTPARTN (nome)

specifica il nome (1-2 caratteri) della partizione a cui devono essere inviati i dati. Questa opzione viene ignorata se il terminale non supporta le partizioni o se non è presente alcuna partizione dell'applicazione associata al terminale. Se esiste una partizione dell'applicazione impostata e l'opzione OUTPARTN viene omessa, i dati vengono inviati alla partizione denominata dall'operando PARTN delle definizioni di mappa DFHMSD o DFHMDI. Se le mappe non vengono utilizzate o se non esiste alcun operando PARTN, l'output viene inviato alla prima partizione nella serie di partizioni.

Impaginazione

Specifica che i dati di emissione non devono essere inviati immediatamente al terminale, ma devono essere collocati nella memoria temporanea e visualizzati in risposta ai comandi di paginazione immessi dall'operatore del terminale.

Se la PAGING è specificata con un prefisso REQID utilizzato per le code di storage temporaneo definite come recuperabili, CICS fornisce il ripristino dei messaggi per i messaggi logici se il task ha raggiunto un punto di sincronizzazione.

STAMPA

Specifica che un'operazione di stampa deve essere avviata su una stampante 3270 o su una 3275 con il dispositivo dell'adattatore della stampante o che i dati su un LUTYPE2 (3274/76 o 3790) devono essere stampati su una stampante assegnata dall'unità di controllo. Se questa opzione viene omessa, i dati vengono inviati al buffer della stampante ma non vengono stampati.

Quando si utilizza l'opzione PRINT, fare riferimento a Macro BMS DFHMDI per una descrizione della priorità dell'opzione.

REQID (nome)

Specifica un prefisso di 2 caratteri da utilizzare come parte di un identificativo di storage temporaneo per il recupero dei messaggi di CICS . È possibile specificare solo un prefisso per ogni messaggio logico. Il prefisso predefinito è **.

Il ripristino del messaggio BMS viene fornito per un messaggio logico solo se l'opzione PAGING è specificata nei comandi BMS SEND e se è stato raggiunto il punto di sincronizzazione.

SET (rif - ptr)

specifica il puntatore da impostare sull'indirizzo dei dati di immissione o emissione.

L'opzione SET specifica che le pagine completate devono essere restituite al programma di applicazione. Il puntatore viene impostato sull'indirizzo di un elenco di pagine completate.

Il programma applicativo riacquista il controllo immediatamente dopo il comando SEND MAP (se la pagina corrente non è stata ancora completata) oppure all'etichetta specificata in un comando HANDLE CONDITION RETPAGE, se la pagina è stata completata.

Se viene specificato TIOAPFX=YES nella definizione della mappa, il puntatore restituito contiene l'indirizzo del prefisso TIOA. I dati utente iniziano all'offset X'0C' dall'inizio del prefisso TIOA.

TERMINAL

specifica che i dati di output devono essere inviati al terminale che ha originato la transazione.

WAIT

specifica che il controllo non deve essere restituito al programma applicativo fino a quando l'operazione di emissione non è stata completata.

Se WAIT non è specificato, il controllo ritorna al programma applicativo quando l'operazione di emissione è stata avviata. Un successivo comando di immissione o emissione (controllo terminale, BMS o interscambio dati batch) fa in modo che il programma applicativo attenda fino al completamento del comando precedente.

Condizioni

Alcune delle seguenti condizioni possono verificarsi in combinazione. Se ne ricorre più di uno, solo il primo viene passato al programma applicativo.

57 IGREQCD

si verifica quando viene effettuato un tentativo di eseguire un comando SEND MAP dopo che è stato ricevuto un comando di controllo del flusso di dati SIGNAL con un codice RCD (request change direction) da un'unità logica LUTYPE4 .

Azione predefinita: terminare il task in modo anomalo.

39 IGREQID

si verifica se il prefisso specificato nell'opzione REQID è diverso da quello stabilito da una precedente opzione REQID o per impostazione predefinita per questo messaggio logico -REQID (**).

Azione predefinita: terminare il task in modo anomalo.

41 INVLDC

si verifica se il mnemonico LDC specificato non è incluso nell'elenco LDC per l'unità logica.

Azione predefinita: terminare il task in modo anomalo.

38 INVMPSZ

si verifica se la mappa specificata è troppo ampia per il terminale o se un comando HANDLE CONDITION OVERFLOW è attivo e la mappa specificata è troppo lunga per il terminale.

Azione predefinita: terminare il task in modo anomalo.

65 INVPARTN

si verifica se la partizione specificata non è definita nella serie di partizioni associata al programma applicativo.

Azione predefinita: terminare il task in modo anomalo.

16 INVREQ

Valori RESP2:

200

Il comando non è consentito per un programma server DPL (distributed program link).

si verifica (RESP2 non impostato) anche nelle seguenti situazioni:

• I dati di testo vengono emessi nella stessa partizione o LDC dei dati mappati mentre è attivo un messaggio logico BMS. Se né le partizioni né i LDC sono in uso, i dati di testo vengono emessi sullo stesso messaggio logico dei dati mappati.
• Un comando SEND MAP separato con l'opzione ACCUM viene emesso sul terminale che ha originato la transazione durante la creazione di un messaggio logico instradato.
• Viene emesso un comando SEND MAP per una mappa senza specifiche di campo specificando l'opzione FROM senza l'opzione DATAONLY.
• Durante l'elaborazione dell'eccedenza, i dati vengono inviati a un LDC diverso da quello che ha causato l'eccedenza di pagina.
• Le partizioni sono in uso, l'opzione OUTPARTN non è stata codificata nel comando SEND MAP, ma l'operando PARTN è stato codificato nella definizione della serie di mappe. Se la condizione si verifica, suggerisce che le diverse versioni della serie di mappe hanno valori PARTN differenti e che il suffisso dedotto per la partizione non è lo stesso del suffisso della serie di mappe caricata.
• Un comando SEND MAP con l'opzione DATAONLY viene emesso con un'area dati, fornita dall'utente, che risiede sopra la linea 16MB . Ma la lunghezza di questa area dati non è più lunga del prefisso TIOA.

Azione predefinita: terminare il task in modo anomalo.

40 ECCEDENZA

si verifica se i dati mappati non rientrano nella pagina corrente. Questa condizione viene generata solo se è attivo un comando HANDLE CONDITION OVERFLOW.

Azione predefinita: ignorare la condizione.

32 RETPAGE

si verifica se l'opzione SET è specificata e una pagina completata è pronta per tornare al programma applicativo.

Azione predefinita: restituire il controllo al programma applicativo nel punto immediatamente successivo al comando BMS SEND MAP.

35 TSIOERR

si verifica se si verifica un errore di input / output della memoria temporanea non recuperabile.

Azione predefinita: terminare il task in modo anomalo.

03 WRBRK

si verifica se un comando SEND MAP viene interrotto dall'operatore del terminale che preme il tasto ATTN. Si applica solo al terminale di comunicazione 2741 e solo se l'interruzione di scrittura è supportata per CICS.

Azione predefinita: ignorare la condizione.