Conceito
Como já visto a descrição do programa exemplo, o comando SEND MAP envia os dados de um mapa, dentro de um mapset para um terminal.
Formato
| EXEC CICS |
||
| SEND | MAP(nome-do-mapa) |
|
| [MAPSET(nome-do-mapset)] | ||
| [FROM(nome-da-area-de-dados)] | ||
| [MAPONLY] | [DATAONLY] |
||
| [ERASE] | ||
| [ALARM] | ||
| END-EXEC |
| Opções | Descrição |
| MAP | Especifica o nome (de 1 a 7 caracteres) do mapa para saída(output) |
| MAPSET | Especifica o nome (de 1 a 7 caracteres) do mapset que contém o mapa |
| FROM | Especifica o nome da área no mapa simbólico que contém os dados a serem mapeados |
| MAPONLY | Envia apenas as constantes do mapa físico. FROM não é utilizado. |
| DATAONLY | Envia apenas os dados da área especificada em FROM. Nenhuma constante do mapa físico é enviada. Se nem MAPONLY nem DATAONLY forem especificado, tanto as constantes do mapa físico quanto os dados em FROM serão enviados. |
| ERASE | Efetua a limpesa da tela antes do envio dos dados. |
| ALARM | Ativa o alarme sonoro do terminal quando o mapa é enviado. |
Exemplo
| EXEC CICS |
||
| SEND | MAP('INQMAP1') |
|
| MAPSET('INQSET1') | ||
| FROM(INQMAP1O) | ||
| DATAONLY | ||
| END-EXEC |
Considerações
É necessário identificar o mapa e o mapset no comando. Também é necessário utilizar a opção FROM para especificar o nome da área de dados do mapa simbólico que contém os dados a serem enviados para o terminal.
Se apenas estas opções forem codificadas, os dados do mapa simbólico são combinados com os daos do mapa físico e ambos são enviados para a tela.
Para limitar o volume de dados enviados, utilizam-se as opções MAPONLY ou DATAONLY. Na primeira opção apenas os dados do mapa físico são enviados e no segundo, apenas os dados do mapa simbólico são enviados. Normalmente omite-se estas opções quando do envio do primeiro mapa para a tela.
A opção ERASE apaga quaisquer dados existentes na tela do terminal antes que a nova tela seja enviada.
Nos comandos SEND MAP subsequentes codifica-se a opção DATAONLY para que as constantes (literais) da tela não sejam reenviadas e não se codifica a opção ERASE para que estas constantes não sejam apagadas.