> 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/ibm-editran-v5.3-cics-en/installation/definition-of-files-in-cics.md).

# Definition of files in CICS

Below are listed the Profile, Log, and editran Trace files, with the appropriate parameters for CEDA.

ℹ️ It has been detected that if high string, databuffer, and indexbuffer values are defined (simultaneous accesses), sometimes the information is not fully updated in the files until some time later; that is, the information is not always on disk, so if we do a repro of the trace, for example, the appropriate records might not appear. Writes to trace, profile, and log should also not be simultaneous. In the case of profiles this is obvious, but in the case of trace and log, it is because there is a control record which must be updated before the data records. Disk updates are automatic in the case of closing and opening the file to CICS, which is precisely what is done with the buffers when events are notified from batch processes to CICS. In the case of matrix buffers, therefore, the normal situation will be to have a greater number of simultaneous accesses.

The files to define are (see FCTCEDA\* members):

* Statistics: ZTBEFPE, ZTBEFAL, ZTBEFMP, ZTBEFMT, ZTBEFMH.
* EDITRAN/G: ZTBGFLO, ZTBGFES, ZTBGFPE.
* EDITRAN/P: ZTBPFLO, ZTBPFTR, ZTBPFPE.
* Key management: ZTBPFGC.
* Buffers. As many Buffer files as necessary will have to be defined.

Definitions in CICS (excluding buffers) 

```
File(ZTBEFAL ) Vsa Clo Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EGDC.ZTBE.ZTBEFAL                         )
File(ZTBEFMH ) Vsa Ope Ena Rea         Bro         Sha     
       Dsn( KI.EGDC.ZTBE.ZTBEFMH                         )
File(ZTBEFMP ) Vsa Ope Ena Rea         Bro         Sha     
       Dsn( KI.EGDC.ZTBE.ZTBEFMP                         )
File(ZTBEFMT ) Vsa Ope Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EGDC.ZTBE.ZTBEFMT                         )
File(ZTBEFPE ) Vsa Clo Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EGDC.ZTBE.ZTBEFPE 
File(ZTBFFLO ) Vsa Clo Ena Rea         Bro         Sha    
       Dsn( KI.EIDC.ZTBG.ZTBFFLOG                        )
File(ZTBFFPE ) Vsa Clo Ena Rea Upd Add Bro Del     Sha    
       Dsn( KI.EIDC.ZTBG.ZTBFFPER                        )
File(ZTBGFES ) Vsa Ope Ena Rea         Bro         Sha     
       Dsn( KI.EIDC.ZTBG.ZTBGFEST                        )
File(ZTBGFLO ) Vsa Ope Ena Rea         Bro         Sha     
       Dsn( KI.EIDC.ZTBG.ZTBGFLOG                        )
File(ZTBGFPE ) Vsa Ope Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EIDC.ZTBG.ZTBGFPER                        )
File(ZTBGFQF ) Vsa Ope Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EIDC.ZTBG.ZTBGFQF                         )
File(ZTBPFLO ) Vsa Ope Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EGDC.ZTBP.ZTBPFLO                         )
File(ZTBPFPE ) Vsa Ope Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EGDC.ZTBP.ZTBPFPE                         )
File(ZTBPFTR ) Vsa Ope Ena Rea Upd Add Bro Del     Sha    
       Dsn( KI.EGDC.ZTBP.ZTBPFTR                         )
Fil(ZTBPFGC ) Vsa Ope Ena Rea Upd Add Bro Del     Sha     
       Dsn( KI.EGDC.ZTBP.ZTBPFGC                         )
 
```

 Files in editran: 

<table data-header-hidden><thead><tr><th width="134.1480712890625"></th><th width="105.28399658203125"></th><th width="101.3333740234375"></th><th width="162.654296875"></th><th width="85.53076171875"></th><th></th></tr></thead><tbody><tr><td>Product</td><td>File</td><td>Initial JCL</td><td>Description</td><td>Type</td><td>Include in procedures</td></tr><tr><td>editran/EA Alarms</td><td>ZTBEFAL</td><td>ZTBEJIAL</td><td>Alarm log</td><td>Relative</td><td>All.</td></tr><tr><td>editran/EA Alarms</td><td>ZTBEFPE</td><td>ZTBEJIPE</td><td>Alarm profile</td><td>KSDS</td><td>All.</td></tr><tr><td>editran/EA Statistics</td><td>ZTBEFMT</td><td>ZTBEJIMT</td><td>Transmission session statistics</td><td>KSDS</td><td>All.</td></tr><tr><td>editran/EA Statistics</td><td>ZTBEFMP</td><td>ZTBEJIMP</td><td>Presentation session statistics</td><td>KSDS</td><td>All.</td></tr><tr><td>editran/EA Statistics</td><td>ZTBEFMH</td><td>ZTBEJIMH</td><td>Historical statistics</td><td>Relative</td><td>All.</td></tr><tr><td><p>editran/FF</p><p>Signature</p></td><td>ZTBFFLO</td><td>ZTBFJILO</td><td>USS Signature Log</td><td>Relative</td><td>Before sending and after receiving</td></tr><tr><td><p>editran/FF</p><p>Signature</p></td><td>ZTBFFPE</td><td>ZTBFJIPE</td><td>USS Signature Profile</td><td>KSDS</td><td>Before sending and after receiving</td></tr><tr><td>editran/G</td><td>ZTBGFES</td><td>ZTBGJIES</td><td>G statuses</td><td>KSDS</td><td>All.</td></tr><tr><td>editran/G</td><td>ZTBGFLO</td><td>ZTBGJILO</td><td>G LOG</td><td>Relative</td><td>All.</td></tr><tr><td>editran/G</td><td>ZTBGFPE</td><td>ZTBGJIPE</td><td>G profiles</td><td>KSDS</td><td>All.</td></tr><tr><td>editran/G</td><td>ZTBGFQF</td><td>ZTBGJIQF</td><td>File queues</td><td>KSDS</td><td>Before sending and after sending</td></tr><tr><td>editran/G</td><td>ZTBGFTCO</td><td>ZTBGJITC</td><td>Conversion tables</td><td>Flat file</td><td>Before sending and after receiving. Not defined for CICS</td></tr><tr><td>editran/GC</td><td>ZTBPFGC</td><td>ZTBPJIGC</td><td>Key management</td><td>KSDS</td><td><p>Requires RSA and DES.</p><p>Before sending and after receiving.</p><p>Has special procedures for TELEGC</p></td></tr><tr><td>editran/P</td><td>ZTBPFLO</td><td>ZTBPJILO</td><td>P LOG</td><td>Relative</td><td>NO</td></tr><tr><td>editran/P</td><td>ZTBPFPE</td><td>ZTBPJIPE</td><td>P profiles</td><td>KSDS</td><td>All</td></tr><tr><td>editran/P</td><td>ZTBPFTR</td><td>ZTBPJITR</td><td>P TRACE</td><td>Relative</td><td>NO</td></tr><tr><td>editran</td><td>BUFFER</td><td>ZTBPJITD</td><td>Excii or unattended buffer</td><td>KSDS</td><td>NO (dynamic allocation)</td></tr><tr><td>editran</td><td>BUFFER</td><td>ZTBPJITE</td><td>Specific buffer</td><td>KSDS</td><td>NO (dynamic allocation)</td></tr><tr><td>editran</td><td>BUFFER</td><td>ZTBPJITM</td><td>Matrix buffer</td><td>KSDS</td><td>NO (dynamic allocation)</td></tr></tbody></table>

## Creation of VSAM files

Below are some examples of the definition of all the VSAM files used by editran:

* Definition of the editran/P Profiles file (ZTBPFPE): See JCL ZTBPJIPE
* Definition of the editran/P Log file (ZTBPFLO): See JCL ZTBPJILO
* Definition of the editran/P Trace file (ZTBPFTR): See JCL ZTBPJITR
* Definition of the editran/P and G exchange key management file (ZTBPFGC): See JCL ZTBPJIGC
* Definition of the editran/G Profiles file (ZTBGFPER): See JCL ZTBGJIPE
* Definition of the editran/G Log file (ZTBGFLOG): See JCL ZTBGJILO
* Definition of the editran/G States file (ZTBGFEST): See JCL ZTBPJIES
* Buffer files (there are several types):
  * Specific Buffer (shr 2 3). This file is created automatically by the Application Interface in the pre-issue/receipt stage. See JCL ZTBPJITE.
    * RECORDS(): The number of records will be specified in the presentation session of the application interface (editran) and the secondary will be set to one quarter of the primary.
    * RECORDSIZE(): The record length will be the transmission length used and specified in the editran transmission session plus the key (36). E.g. 252+36=276 or 4050+36=4074.
  * Matrix Buffer (shr 3 3). This file must be created physically. See JCL ZTBPJITM.
    * RECORDS(): The number of records will be specified by the administrator according to the volume of transmissions carried out. If it does not exist, editran defines it, taking as the basis for file space allocation the sum of the number of records assigned to each of the transmission sessions associated with the presentation session.
    * RECORDSIZE(): The record length will be the transmission length used and specified in the editran transmission session plus the key (36). E.g. 252+36=276 or 4050+36=4074.
  * The Buffers of the rest of the types must be physically defined before starting the editran processes. For EXCI, see JCL ZTBPJITD.


---

# 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/ibm-editran-v5.3-cics-en/installation/definition-of-files-in-cics.md?ask=<question>&goal=<endgoal>
```

`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.