> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/copy-of-privado-editran-v5.3-cics/definicion-y-gestion-de-ficheros-tampones/definiciones-cics.md).
# Definiciones CICS
Para que exista conexión entre regiones (conexión EXCI), debe codificarse en la DFHSIT el parámetro: IRCSTRT = YES o una vez abierto el CICS teclear CEMT SET IRC OPEN.
## Definición del fichero
La definición al CICS del fichero tampón es la siguiente:
```
CEDC View File( ZTBPFEE )
File : ZTBPFEE
Group : FCTZTB
DEScription :
VSAM PARAMETERS
DSNAme : KI.EGDC.ZTBP.ZTBPFEE
Password : PASSWORD NOT SPECIFIED
Lsrpoolid : None 1-8 | None
DSNSharing : Allreqs Allreqs | Modifyreqs
STRings : 050 1-255
Nsrgroup :
REMOTE ATTRIBUTES
REMOTESystem :
REMOTEName :
RECORDSize : 1-32767
Keylength : 1-255
INITIAL STATUS
STAtus : Enabled Enabled | Disabled | Unenabled
Opentime : Firstref Firstref | Startup
DIsposition : Share Share | Old
BUFFERS
DAtabuffers : 00051 2-32767
Indexbuffers : 00050 1-32767
DATATABLE PARAMETERS
Table : No No | Cics | User
Maxnumrecs : 16-16777215
DATA FORMAT
RECORDFormat : F V | F
OPERATIONS
Add : Yes No | Yes
BRowse : Yes No | Yes
DELete : Yes No | Yes
REAd : Yes Yes | No
Update : Yes No | Yes
AUTO JOURNALLING
JOurnal : No No | 1-99
JNLRead : None None | Updateonly | Readonly | All
JNLSYNCRead : No No | Yes
JNLUpdate : No No | Yes
JNLAdd : None None | Before | AFter | ALl
JNLSYNCWrite : Yes Yes | No
RECOVERY PARAMETERS
RECOVery : None None | Backoutonly | All
Fwdrecovlog : No No | 1-99
BAckuptype : Static Static | Dynamic
SECURITY
RESsecnum : 00 0-24 | Public
```
El parámetro “STRings” es importante según el tipo de tampón utilizado.
A los tampones Específicos, Matriciales SHR (3,3) y Públicos solo accede una transacción a la vez por tanto STRings puede tener valor 1.
Para los tampones Matriciales (shr (2,3)), Desatendidos y tipo EXCI el número de transacciones que concurren en el mismo puede ser tan alto como sesiones lo tengan definido, por tanto, el parámetro STRings ha de estar adecuadamente dimensionado.
Los parámetros “Databuffers” e “Indexbuffers” han de estar en consonancia con el parámetro “STRings”.
También es importante tener en cuenta el parámetro “EAS” en la definición del CICS al VTAM, que indica el número de transacciones concurrentes que se permiten en dicho CICS.
## Conexión EXCI
A los tampones de tipo EXCI se accede mediante transacciones CICS, tanto en editran/P como en editran/G. Para acceder desde editran/G a dichos tampones se utiliza la interfaz EXCI que posibilita la invocación de una transacción CICS desde el Batch.
Para ello es preciso definir una conexión EXCI genérica para las acciones que se resuelven en una sola petición y otra específica para las que necesitan mantener la conexión establecida en el transcurso de un tratamiento repetitivo o por lotes.
Además, es necesario definir la transacción invocada desde batch, así como el programa asociado a dicha transacción.
### Conexión genérica
Se utiliza cuando la función a realizar se completa en una sola llamada al módulo CICS.
**Connection**
```
CEDC View Connection( EXG1 )
Connection : EXG1
Group : TCTEXCI
DEscription : EXCI GENERIC CONNECTION 1
CONNECTION IDENTIFIERS
Netname :
INDsys :
REMOTE ATTRIBUTES
REMOTESYSTem :
REMOTEName :
REMOTESYSNet :
CONNECTION PROPERTIES
ACcessmethod : IRc Vtam | IRc | INdirect | Xm
PRotocol : Exci Appc | Lu61 | Exci
Conntype : Generic Generic | Specific
SInglesess : No No | Yes
DAtastream : User User | 3270 | SCs | STrfield | Lms
RECordformat : U U | Vb
Queuelimit : No No | 0-9999
Maxqtime : No No | 0-9999
OPERATIONAL PROPERTIES
AUtoconnect : No No | Yes | All
INService : Yes Yes | No
SECURITY
SEcurityname :
ATtachsec : Local Local | Identify | Verify | Persistent
| Mixidpe
BINDPassword : PASSWORD NOT SPECIFIED
BINDSecurity : No No | Yes
Usedfltuser : No No | Yes
RECOVERY
PSrecovery : Sysdefault | None
```
**Session**
```
CEDC View Sessions( SESSEXG1 )
Sessions : SESSEXG1
Group : TCTEXCI
DEscription : EXCI GENERIC SESSIONS 1
SESSION IDENTIFIERS
Connection : EXG1
SESSName :
NETnameq :
MOdename :
SESSION PROPERTIES
Protocol : Exci Appc | Lu61 | Exci
MAximum : 000 , 000 0-999
RECEIVEPfx : EG
RECEIVECount : 050 1-999
SENDPfx :
SENDCount : 1-999
SENDSize : 04096 1-30720
RECEIVESize : 04096 1-30720
SESSPriority : 000 0-255
Transaction :
OPERATOR DEFAULTS
OPERId :
OPERPriority : 000 0-255
OPERRsl : 0 0-24,...
OPERSecurity : 1 1-64,...
PRESET SECURITY
USERId :
OPERATIONAL PROPERTIES
Autoconnect : No No | Yes | All
INservice : Yes
Buildchain : Yes Yes | No
USERArealen : 000 0-255
IOarealen : 04096 , 04096 0-32767
RELreq : No No | Yes
DIscreq : No No | Yes
NEPclass : 000 0-255
RECOVERY
RECOVOption : Sysdefault Sysdefault | Clearconv | Releasesess
| Uncondrel | None
RECOVNotify : None None | Message | Transaction
```
### Conexión específica
Se utiliza cuando la conexión se ha de mantener durante varias llamadas al módulo CICS. Por ejemplo, un proceso de carga de una sesión en el tampón de emisión.
**Conection**
```
CEDC View Connection( EXE1 )
Connection : EXE1
Group : TCTEXCI
DEscription : EXCI SPECIFIC CONNECTION 1
CONNECTION IDENTIFIERS
Netname : BATCZTBG
INDsys :
REMOTE ATTRIBUTES
REMOTESYSTem :
REMOTEName :
REMOTESYSNet :
CONNECTION PROPERTIES
ACcessmethod : IRc Vtam | IRc | INdirect | Xm
PRotocol : Exci Appc | Lu61 | Exci
Conntype : Specific Generic | Specific
SInglesess : No No | Yes
DAtastream : User User | 3270 | SCs | STrfield | Lms
RECordformat : U U | Vb
Queuelimit : No No | 0-9999
Maxqtime : No No | 0-9999
OPERATIONAL PROPERTIES
AUtoconnect : No No | Yes | All
INService : Yes Yes | No
SECURITY
SEcurityname :
ATtachsec : Local Local | Identify | Verify | Persistent
| Mixidpe
BINDPassword : PASSWORD NOT SPECIFIED
BINDSecurity : No No | Yes
Usedfltuser : No No | Yes
RECOVERY
PSrecovery : Sysdefault | None
```
**Session**
```
CEDC View Sessions( SESSEXE1 )
Sessions : SESSEXE1
Group : TCTEXCI
DEscription : EXCI SPECIFIC SESSIONS 1
SESSION IDENTIFIERS
Connection : EXE1
SESSName :
NETnameq :
MOdename :
SESSION PROPERTIES
Protocol : Exci Appc | Lu61 | Exci
MAximum : 000 , 000 0-999
RECEIVEPfx : EE
RECEIVECount : 050 1-999
SENDPfx :
SENDCount : 1-999
SENDSize : 04096 1-30720
RECEIVESize : 04096 1-30720
SESSPriority : 000 0-255
Transaction :
OPERATOR DEFAULTS
OPERId :
OPERPriority : 000 0-255
OPERRsl : 0 0-24,...
OPERSecurity : 1 1-64,...
PRESET SECURITY
USERId :
OPERATIONAL PROPERTIES
Autoconnect : No No | Yes | All
INservice : Yes
Buildchain : Yes Yes | No
USERArealen : 000 0-255
IOarealen : 04096 , 04096 0-32767
RELreq : No No | Yes
DIscreq : No No | Yes
NEPclass : 000 0-255
RECOVERY
RECOVOption : Sysdefault Sysdefault | Clearconv | Releasesess
| Uncondrel | None
RECOVNotify : None None | Message | Transaction
```
El parámetro RECEIVECount ha de estar dimensionado de acuerdo al número de conexiones que puedan existir en un momento determinado.
### Transacción
La transacción se asocia a un programa propio del sistema (DFHMIRS) que gestiona las solicitudes EXCI.
```
CEDC View TRANSaction( ZTBG )
TRANSaction : ZTBG
Group : TCTEXCI
DEscription :
PROGram : DFHMIRS
TWasize : 00000 0-32767
PROFile : DFHCICSA
PArtitionset :
STAtus : Enabled Enabled | Disabled
PRIMedsize : 00000 0-65520
TASKDATALoc : Below Below | Any
TASKDATAKey : User User | Cics
STOrageclear : No No | Yes
RUnaway : System System | 0-2700000
SHutdown : Disabled Disabled | Enabled
ISolate : Yes Yes | No
REMOTE ATTRIBUTES
DYnamic : No No | Yes
REMOTESystem :
REMOTEName :
TRProf :
Localq : No | Yes
SCHEDULING
PRIOrity : 001 0-255
TClass : No No | 1-10
TRANClass : DFHTCL00
ALIASES
Alias :
TASKReq :
XTRanid :
TPName :
:
XTPname :
:
:
RECOVERY
DTimout : 0010 No | 1-6800
INdoubt : Backout Backout | Commit | Wait
RESTart : No No | Yes
SPurge : Yes No | Yes
TPUrge : Yes No | Yes
DUmp : Yes Yes | No
TRACe : Yes Yes | No
COnfdata : Yes No | Yes
SECURITY
RESSec : No No | Yes
CMdsec : No No | Yes
Extsec : No
TRANSec : 01 1-64
RSl : 00 0-24 | Public
```
### Profile de la transacción
```
CEDC View PROFile( DFHCICSA )
PROFile : DFHCICSA
Group : DFHSTAND
DEscription :
Scrnsize : Default Default | Alternate
Uctran : No No | Yes
MOdename :
PRIntercomp : No No | Yes
JOURNALLING
Journal : No No | 1-99
MSGJrnl : No No | INPut | Output | INOut
PROTECTION
MSGInteg : No No | Yes
Onewte : No No | Yes
PROtect : No No | Yes
Chaincontrol : No No | Yes
PROTOCOLS
DVsuprt : All All | Nonvtam | Vtam
Inbfmh : All No | All | Dip | Eods
RAq : No No | Yes
Logrec : No No | Yes
RECOVERY
Nepclass : 000 0-255
RTimout : No No | 1-7000
```
### Programas
Se han de definir el asociado a la transacción (DFHMIRS) y el que accede al fichero tampón invocado desde los procesos batch (ZTBPOI40)
* **DFHMIRS**
```
CEDC View PROGram( DFHMIRS )
PROGram : DFHMIRS
Group : SWHISC
DEscription : CICS Function Shipping Mirror Program
Language : Assembler CObol | Assembler | Le370 | C | Pli
| Rpg
RELoad : No No | Yes
RESident : No No | Yes
USAge : Normal Normal | Transient
USElpacopy : No No | Yes
Status : Enabled Enabled | Disabled
RSl : 00 0-24 | Public
Cedf : Yes Yes | No
DAtalocation : Below Below | Any
EXECKey : Cics User | Cics
REMOTE ATTRIBUTES
REMOTESystem :
REMOTEName :
Transid :
EXECUtionset : Fullapi Fullapi | Dplsubset
```
* **ZTBPOI40**
```
CEDC View PROGram( ZTBPOI40 )
PROGram : ZTBPOI40
Group : PPTZTB
DEscription :
Language : CObol CObol | Assembler | Le370 | C | Pli
| Rpg
RELoad : No No | Yes
RESident : No No | Yes
USAge : Normal Normal | Transient
USElpacopy : No No | Yes
Status : Enabled Enabled | Disabled
RSl : 00 0-24 | Public
Cedf : Yes Yes | No
DAtalocation : Any Below | Any
EXECKey : User User | Cics
REMOTE ATTRIBUTES
REMOTESystem :
REMOTEName :
Transid :
EXECUtionset : Fullapi Fullapi | Dplsubset
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.editran.onesait.com/documentacion-editran/copy-of-privado-editran-v5.3-cics/definicion-y-gestion-de-ficheros-tampones/definiciones-cics.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.