CICS Manual do Usuário - RECEIVE MAP

RECEIVE MAP

Recebe dados digitados em uma área de um programa aplicativo.

Nota:: Voce pode omitir INTO ou SET somente se o valor do MAP (mapa) for uma literal.

Descrição:

A posição do cursor após o RECEIVE MAP é colocada em EIBCPOSN, e o terminal attention identifier (AID) é colocado em EIBAID.
Se dados devem ser recebidos, deve-se especificar opção INTO ou SET.
Se o RECEIVE foi emitido somente para detectar o attention identifier (AID), pode-se omitir tanto o INTO quanto o SET.

Para maiores informações a respeito do Basic Mapping Support (BMS), veja TXSeries for Multiplatforms Application Programming Guide.

See Appendix E, Defining BMS mapsets, maps, and fields for the map definition m acros.

Opções:

ASIS

Specifies that lowercase characters in the input data stream are not translated to uppercase; this allows the current task to receive a message that contains both uppercase and lowercase data.
This option has no effect on the first RECEIVE command of a transaction, or if the screen contains data before a transaction is initiated.
For example, if a transaction that is initiated by another transaction begins by receiving data that was originally output by that transaction, and the Terminal Definitions (WD) or Transaction Definitions (TD) specify uppercase translation (UCTranFlag attribute set to yes), it cannot suppress uppercase translation on the data.
This data is read and translated in preparation for the next task, and the first RECEIVE command in that task retrieves the translated data.

FROM(data-area)

Indica a área de dados que contém os dados a serem mapeados. Isto deve incluir o prefixo de 12 bytes gerado pelo parâmetro TIOAPFX=YES das macros DFHMDI e DFHMSD.

INTO(data-area)

Indica o nome da área onde os dados devem ser colocados.

Se não for especificado, o nome default, no cobol, é o nome do mapa sufixado da letra I.

No C or C++, os defaults são:
```
&mapname.mapnamei
```
onde mapname é o nome do mapa (map).
Veja INTO e SET para maiores informações de como usar estas opções.

LENGTH(data-value)

Indica o tamanho da área (colocado em uma half-word - 16-bit binários).
Não deve ser maior que o tamanho especificado no parâmetro FROM, mas o LENGTH deve incluir os 12 bytes de prefixo gerados pelo TIOAPFX=YES nas macros DFHMDI e DFHMSD.

MAP(name)

Specifies the name of the map that is to be used.
The name can be up to seven characters long.
If the MAP value is not a literal, SET or INTO is required.
The reason for this is that, if SET or INTO are not specified, the INTO data-area is defaulted from the map name.

MAPSET(name)

Specifies the unsuffixed name of the mapset that is to be used.
The name can be up to seven characters long.
The mapset must reside in a CICS maps directory, and must have an entry in the Program Definitions (PD) with the ProgType attribute set to map.
If the MAPSET option is not specified, the name that is given in the MAP option is assumed to be that of the mapset.

SET(ptr-ref)

Specifies a pointer reference that is to be set to the address of the mapped data.
This pointer reference is valid until the next advanced program-to-program communications (APPC) or terminal control command, or the end of task.
An APPC conversation allows a program to send data to, and receive data from, a program that is running in a remote system.
Programming that uses APPC conversations is called Distributed Transaction Programming (DTP).
For guidance information about DTP, refer to the TXSeries for Multiplatforms Intercommunication Guide.
See INTO and SET for more information about using this option.

TERMINAL

Indica que os dados de entrada devem ser lidos do terminal que originou a transação.
TERMINAL é default quando FROM e LENGTH não são especificados.

Exemplos:

     EXEC CICS RECEIVE           
          INTO (WS-ATIV-ENTRADA)  
          LENGTH (WS-LEN-RECEIVE)   
     END-EXEC.                                           

     EXEC CICS RECEIVE              
          MAP('PRINC')         
          MAPSET('TABMTRJ')    
          INTO(PRINCI)         
     END-EXEC

Condições:

INVMPSZ

Ocorre se o mapa é grande demais para o terminal.
Ação pré-definida: a task terminada anormalmente.

INVREQ

Occurs for the following conditions, depending on the options that are specified on the RECEIVE MAP command:
- A RECEIVE MAP command is issued in a task that is not associated with a terminal.
- An attempt was made to issue an EXEC CICS RECEIVE MAP command from a remotely linked-to program.
- A remotely linked-to program attempted to execute a RECEIVE MAP command that refers to the principal facility.
Ação pré-definida: Terminates the task abnormally.

MAPFAIL

Occurs if the data that is to be mapped has a length of zero or does not contain a Set-Buffer-Address (SBA) sequence.
This condition arises if a program issues a RECEIVE MAP command to which the terminal operator responds by pressing one of the following:
- The CLEAR key
- Any PA key
- ENTER without entering data
- Any PF key without entering data.
Ação pré-definida: Terminates the task abnormally.

Related Information