CICS Manual do Usuário - ADDRESS

ADDRESS

Obtém acesso as áreas de armazenamento CICS.

Sintaxe

Condição: INVREQ

Nota:: COMMAREA is not supported for COBOL programs.

Descrição

ADDRESS gets access to the following areas:

The communication area that is available to the invoked program (COMMAREA)
The common work area (CWA)
The EXEC interface block (EIB)
The terminal user area (TCTUA)
The transaction work area (TWA)

Opções:

COMMAREA(ptr-ref)

Specifies a pointer reference that is to be set to the address of the communication area (COMMAREA) that is available to the currently-running program.
CICS uses this area to pass information between application programs.
If a COMMAREA does not exist, CICS sets the pointer reference to the null value.
Refer to Null values.
C or C++ functions must use ADDRESS COMMAREA to get the address of the communication area because this address is not passed as an argument to a C or C++ main function.
COBOL programs receive the COMMAREA as a parameter, and programs must contain a definition of a data area to allow access.
For more information, see the TXSeries for Multiplatforms Application Programming Guide.

CWA(ptr-ref)

Specifies a pointer referencethat is to be set to the address of the common work area (CWA).
This area makes information available to applications that are running in a single region.
If a CWA does not exist, CICS sets the pointer reference to the null value.
Refer to Null values.

EIB(ptr-ref)

Specifies a pointer reference that is to be set to the address of the EIB.

You must use this option to get addressability to the EIB in application routines other than the first one that is started by CICS (where addressability to the EIB is provided automatically).

C or C++ functions must use ADDRESS EIB to get the address of the EIB because this address is not passed as an argument to a C or C++ main function.

If you want access to the EIB, you must code an ADDRESS EIB command at the beginning of each application, for example:
```
     EXEC CICS 
          ADDRESS EIB(dfheiptr)
     END-EXEC
```
This applies to any commands that include RESP or RESP2 options.
See the TXSeries for Multiplatforms Application Programming Guide for more information.

TCTUA(ptr-ref)

Specifies a pointer reference that is to be set to the address of the terminal user area (TCTUA) for the principal facility, and not for any alternate facility that has possibly been allocated.
Use this area to pass information between application programs, but only if the same terminal is associated with the application programs that are involved (which can be in different tasks).
If a TCTUA does not exist, CICS sets the pointer reference to the null value.
Refer to Null values.

TWA(ptr-ref)

Specifies a pointer reference that is to be set to the address of the transaction work area (TWA).
Use this area to pass information between application programs, but only if they are in the same task.
If a TWA does not exist, CICS sets the pointer reference to the null value.
Refer to Null values.

Condições:

INVREQ

Occurs if ADDRESS TCTUA was executed on a server side of a DPL program.
Default action: Terminates the task abnormally.

Informação relacionadas

TXSeries for Multiplatforms Application Programming Guide