> 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/migration-to-v5.3-phase-1/migration-from-any-phase-of-editran-v5.2.md). # Migration from any phase of Editran v5.2 ## ZTBMJM53 The following JCL ZTBMJM53 is provided, which has the following content: ```cobol //KI63A23A JOB (EGDC,KIT,,99),'ZTBMJM53',MSGCLASS=H,CLASS=A, // MSGLEVEL=1,NOTIFY=&SYSUID //*-------------------------------------------------------------------- //* VERSION MIGRATION FROM 5.2 TO VERSION 5.3.1 //* UPDATE OF REMOTES IN VERSION 4.1 //* UPDATE OF SESSIONS WITH CRYPTOGRAPHY 2.2 //******************************************************************* //BORRADO EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DELETE (KI.EIDC.ZTBG.ZTBGFPER.V530) PURGE //* //DEFPERF EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE CLUSTER - (NAME(KI.EIDC.ZTBG.ZTBGFPER.V530) – VOL(DES805) - LOG(NONE) - NOREUSE - REC (4000 50) - FREESPACE(25 25) - RECORDSIZE(3000 3000) - SHAREOPTIONS(2 3) - KEYS(27 0) - INDEXED ) - DATA - (NAME(KI.EIDC.ZTBG.ZTBGFPER.V530.DATA)) - INDEX - (NAME(KI.EIDC.ZTBG.ZTBGFPER.V530.INDEX)) //* //REPRO1 EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=H //ENTRADA DD DSN=KI.EIDC.ZTBG.ZTBGFPER,DISP=SHR //SALIDA DD DSN=KI.EIDC.ZTBG.ZTBGFPER.V530,DISP=SHR //SYSIN DD * REPRO INFILE(ENTRADA) OUTFILE(SALIDA) //******************************************************************* //BORRADO EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DELETE (KI.EGDC.ZTBP.ZTBPFPE.V530) PURGE //* //DEFPERF EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE CLUSTER - (NAME(KI.EGDC.ZTBP.ZTBPFPE.V530) - VOL(DES805) - LOG(NONE) - NOREUSE - REC (3000 50) - FREESPACE(25 25) - RECORDSIZE(2500 2500) - SHAREOPTIONS(2 3) - KEYS(34 0) - INDEXED ) - DATA - (NAME(KI.EGDC.ZTBP.ZTBPFPE.V530.DATA)) - INDEX - (NAME(KI.EGDC.ZTBP.ZTBPFPE.V530.INDEX)) //* //REPRO2 EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=H //ENTRADA DD DSN=KI.EGDC.ZTBP.ZTBPFPE,DISP=SHR //SALIDA DD DSN=KI.EGDC.ZTBP.ZTBPFPE.V530,DISP=SHR //SYSIN DD * REPRO INFILE(ENTRADA) OUTFILE(SALIDA) //* //* EDITRAN 5.3. //* UPDATE OF REMOTES IN VERSION 4.1 //* UPDATE OF SESSIONS WITH CRYPTOGRAPHY 2.2 //* UPDATE OF THE PARAMETER REQUEST DOWNLOAD ACKNOWLEDGMENT (Y/N) //*-------------------------------------------------------------------- //* A C-CONSULTATION OR M-MODIFICATION OF //* A SPECIFIC SESSION CAN BE PERFORMED //* THE LOCAL-REMOTE SESSIONS //* THE LOCAL SESSIONS //* ALL SESSIONS //* THROUGH SYSIN //* //* SYSIN FORMAT //* 1.-LLLLLLLLLRRRRRRRRRAAAAAA //* 000099980000099940PRUEBA CONSULTATION/MODIFICATION OF A SESSION //* 000000000000099940PRUEBA CONSULTATION/MODIFICATION BY REMOTE/APPLI //* 000099940TEST QUERY/MODIFICATION BY REMOTE/APLI //* 000000000000000000PRUEBA CONSULTATION/MODIFICATION BY APPLICATION //* TEST QUERY/MODIFICATION BY APPLICATION //* 000099980000099940000000 CONSULTATION/MODIFICATION BY LOCAL-REMOTE //* 000099980000099940 QUERY/MODIFICATION BY LOCAL-REMOTE //* 000000000000099940000000 CONSULTATION/MODIFICATION BY REMOTE //* 000099940 QUERY/MODIFICATION BY REMOTE //* 000099980000000000000000 CONSULTATION/MODIFICATION BY LOCAL //* 000099980 QUERY/MODIFICATION BY LOCAL //* 000000000000000000000000 CONSULTATION/MODIFICATION ALL SESSIONS //* CONSULTATION/MODIFICATION ALL SESSIONS //* 2.-X //* C - CONSULTATION OF THE SESSIONS //* M - MODIFICATION OF THE SESSIONS //*--------------------------------------------------------------------- //*-------------------------------------------------------------------- //PASO1 EXEC PGM=ZTBGBM53 //STEPLIB DD DSN=KI.EIDC.ZTBG.LOAD,DISP=SHR // DD DSN=KI.EGDC.ZTBP.LOAD31,DISP=SHR //ZTBGFPER DD DSN=KI.EIDC.ZTBG.ZTBGFPER.V530,DISP=SHR //ZTBPFPE DD DSN=KI.EGDC.ZTBP.ZTBPFPE.V530,DISP=SHR //EDILIST DD SYSOUT=* //SYSOUT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSDBOUT DD SYSOUT=* //ABENDAID DD SYSOUT=* //SYSCOUNT DD DUMMY //SYSUDUMP DD SYSOUT=* //SYSABOUT DD SYSOUT=* //SYSIN DD * 000000000000000000000000 C /* // **************************** Bottom of Data **************************** ``` By executing program ZTBGBM53, a query or modification of the session(s) we have defined can be performed. * The value of the CRYPTOGRAPHY parameter (Y/N) must be the same in Editran/P and G. If the values are different, the corresponding one in P or in G must be modified so that both are configured identically and cryptography works correctly. * CRYPTOGRAPHIC VERSION = 2.2, it is changed to 3.0, 4.0 depending on the license. * DATA ENCRYPTION ALGORITHM = DES/TD2C, in the G part it is changed to TD3C, in the P part it is removed. * REMOTE VERSION (N.N) less than 5.0, it is changed to 5.0. * DOWNLOAD ACKNOWLEDGMENT different from ‘N’, it is changed to ‘N’. * The CRC value for all sessions is equal to 'S' * The internal session value becomes LOCAL CODE + REMOTE CODE + APPLICATION * Editran/P sessions that are not associated with any Editran/G session are deleted. ## SYSIN The SYSIN format consists of two parameters: ### Presentation session With the following format LLLLLLLLLRRRRRRRRRAAAAAA. Here we will indicate the presentation session(s) to query or modify. This query/modification affects the presentation session and all associated transmission sessions (from now on we will refer to this set as the session). How to specify the fields LLLLLLLLLRRRRRRRRRAAAAAA. ### **Specify all fields.** The query/modification is performed on a specific session. Example: ``` 000099980000099940PRUEBA ``` It checks the following parameters for session 000099980000099940PRUEBA: ### **Specify the fields LLLLLLLLLRRRRRRRRR** The query/modification is performed by local code and remote code. Example: ``` 000099980000099940000000 ``` It checks the following parameters for all sessions with local 000099980 and remote 000099940. ### **Specify the fields LLLLLLLLLAAAAAA** The query/modification is performed by local code and application, for any remote code. Example: ``` 000099980000000000PRUEBA ``` the remote can also be left blank like this: ``` 000099980 PRUEBA ``` It checks the following parameters for all sessions with local code 000099980 and application PRUEBA. ### **Specify only the remote code RRRRRRRRR** The query/modification is performed by remote code and application, for any local code. Example: ``` 000099980000000000000000 ``` the remote code and the application can also be left blank like this: ``` 000099980 ``` It checks the following parameters for all sessions with local 000099980: ### **Specify only the local code LLLLLLLLL** The query/modification is performed by local code. Example: ``` 000099980000000000000000 ``` the remote code and the application can also be left blank like this: ``` 000099980 ``` It checks the following parameters for all sessions with local 000099980: ### **Specify only the remote code RRRRRRRRR** The query/modification is performed by remote code. Example: ``` 000000000000099940000000 ``` the local code and the application can also be left blank like this: ``` 000099940 ``` It checks the following parameters for all sessions with remote 000099940: ### **Specify only the application AAAAAA** The query/modification is performed by application. Example: ``` 000000000000000000PRUEBA ``` the local code and the remote code can also be left blank like this: ``` 000099940 ``` It checks the following parameters for all sessions with remote 000099940: ### Query/Modification. With a 'C' we indicate that it is a query and with an 'M' we indicate that it is a modification Example 1 ```cobol //SYSIN DD * 000099980000099940PRUEBA C ``` Query of presentation session 000099980000099940PRUEBA and all associated transmission sessions. Example 2 ```cobol //SYSIN DD * 000099980000099940PRUEBA M ``` Modification of presentation session 000099980000099940PRUEBA and all associated transmission sessions. ## ZTBGFLIS The output is the same for query or modification. This output has the following header: ``` INDRA EDITRAN PROFILE MIGRATION FROM 5.2 TO 5.3 PAGE 1 EDI V5.2 ========================================== DATE DD/MM/YYYY SESSION/REMOTE/APPLICATION INCIDENT IN PROFILES ------------------------ ----------------------------------------------------------------------------- - ``` First come the presentation sessions, with their corresponding transmission sessions that have to be modified or are modified. Example: ``` INDRA EDITRAN PROFILE MIGRATION FROM 5.2 TO 5.3 PAGE 1 EDI V5.2 ========================================== DATE DD/MM/YYYY SESSION/REMOTE/APPLICATION INCIDENT IN PROFILES ------------------------ ------------------------------------------------------------------------------ 000099980000099940PRTCP4 SESSION/G WITH DATA ENCRYPTION ALGORITHM TD2C INCOMPATIBLE WITH 5.3 IT IS REPLACED BY TD3C 000099980000099940PRTCP6 SESSION/G WITH CRYPTOGRAPHIC VERSION 2.2 INCOMPATIBLE WITH 5.3 THE SESSION WILL NOT WORK UNTIL THE PROFILES ARE CORRECTLY MODIFIED 000099980000099940PRTCP6 SESSION/P OF THE PRESENTATION SESSION 000099980000099940PRTCP6 VERSION 4.1 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 CRYPTOGRAPHIC VERSION 2.2 INCOMPATIBLE WITH 5.3 CHANGED TO 3.0 THE SESSION WILL NOT WORK UNTIL THE PROFILES ARE CORRECTLY MODIFIED REPLACE ? WITH THE SUBSYSTEMS EXCHANGED WITH THE REMOTE 000099980000099940PRTCP7 SESSION/G WITH DATA ENCRYPTION ALGORITHM DES INCOMPATIBLE WITH 5.3 IT IS REPLACED BY TD3C 000099980000099940PRTC11 SESSION/P OF THE PRESENTATION SESSION 000099980000099940PRTC10 VERSION 4.1 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 000099980000099940PRTC12 SESSION/P OF THE PRESENTATION SESSION 000099980000099940PRTC10 VERSION 4.1 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 000099980000099940PRTC13 SESSION/P OF THE PRESENTATION SESSION 000099980000099940PRTC10 VERSION 4.1 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 000099980000099940PRUEBA SESSION/G WITH DOWNLOAD ACKNOWLEDGMENT = R INCOMPATIBLE WITH 5.3. CHANGED TO N 000099980000099940PRUEB1 SESSION/G WITH DOWNLOAD ACKNOWLEDGMENT = X INCOMPATIBLE WITH 5.3. CHANGED TO N ``` Then the applications that have to be modified are listed. Example: ``` INDRA EDITRAN PROFILE MIGRATION FROM 5.2 TO 5.3 PAGE X EDI V5.2 ========================================== DATE DD/MM/YYYY SESSION/REMOTE/APPLICATION INCIDENT IN PROFILES ------------------------ ------------------------------------------------------------------------------ 000000000000000000PRUEBA APP. WITH DOWNLOAD ACKNOWLEDGMENT = R INCOMPATIBLE WITH 5.3. CHANGED TO N 000000000000000000PRUEB1 APP. WITH DOWNLOAD ACKNOWLEDGMENT = X INCOMPATIBLE WITH 5.3. CHANGED TO N 000000000000000000PRUEB6 APP. WITH DOWNLOAD ACKNOWLEDGMENT = INCOMPATIBLE WITH 5.3. CHANGED TO N 000000000000000000PRUEB8 APP. WITH DOWNLOAD ACKNOWLEDGMENT = L INCOMPATIBLE WITH 5.3. CHANGED TO N ``` Then the remotes that have to be modified are listed: Example: ``` INDRA EDITRAN PROFILE MIGRATION FROM 5.2 TO 5.3 PAGE X EDI V5.2 ========================================== DATE DD/MM/YYYY SESSION/REMOTE/APPLICATION INCIDENT IN PROFILES ------------------------ ------------------------------------------------------------------------------ 000000000000099950000000 REMOTE WITH VERSION 4.1 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 000000000000099960000000 REMOTE WITH VERSION 4.1 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 000000000000099970000000 REMOTE WITH VERSION 4.0 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 000000000000099980000000 REMOTE WITH VERSION 4.1 INCOMPATIBLE WITH 5.3. CHANGED TO 5.0 ``` Finally, a summary of the EDITRAN/G sessions, the EDITRAN/P sessions, the applications, and the remotes that are modified or need to be modified appears. ``` INDRA EDITRAN PROFILE MIGRATION FROM 5.2 TO 5.3 PAGE X EDI V5.2 ========================================== DATE DD/MM/YYYY SESSION/REMOTE/APPLICATION INCIDENT IN PROFILES ------------------------ ------------------------------------------------------------------------------ SELECTED EDITRAN/G SESSIONS 000603 SELECTED EDITRAN/P SESSIONS 000412 SELECTED EDITRAN/G REMOTES 000146 SELECTED EDITRAN/G APPL. 000153 ``` ## SYSOUT This output informs about the transmission sessions that do not exist for a specific presentation session and that will be deleted. Example: ``` ZTBGBM53 PRESENTATION SESSION A0009994A000099990PRUJCB DELETED BECAUSE THE TRANSMISSION ONE DOES NOT EXIST ZTBGBM53 PRESENTATION SESSION A00099940000099940CICLIN DELETED BECAUSE THE TRANSMISSION ONE DOES NOT EXIST ``` --- # 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/migration-to-v5.3-phase-1/migration-from-any-phase-of-editran-v5.2.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.