EDItran/CD 4.1 Certificados digitales z/OS Manual de Usuario

Indra. Noviembre de 2006 ECD41USUA.doc.

Indra. La información aquí contenida puede ser objeto de cambios sin previo aviso. Las distintas versiones del producto pueden dar lugar a cambios, adiciones o supresiones de información en este manual. La correspondencia acerca de este manual debe realizarse en la hoja de comentarios aquí incluida y debe ser dirigida a Indra, Producto EDItran, Avda. de Bruselas 35 (Edificio VIO-1), 28108 - Arroyo de la Vega Alcobendas, Madrid.

Comentarios de usuario sobre esta documentación. Exprese, y háganos llegar, su opinión y comentarios acerca de la documentación entregada y así podremos corregirla en las posteriores versiones de este documento. Indra. Producto : EDItran/CD 4.1 z/OS Manual de Usuario Referencia: ECD41USUA.doc Avda. de Bruselas 35 - Arroyo de la Vega - Alcobendas. 28108 MADRID. _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________ _______________________________________________________________________________________________________

Empresa

:

____________________________________________________________________________________

Departamento:

____________________________________________________________________________________

Contacto

:

____________________________________________________________________________________

Dirección :

____________________________________________________________________________________

EDItran/CD 4.1. z/OS. Manual de Usuario.

Indice

1.

INTRODUCCION. .................................................................................................... 1-1

2.

FUNCIONALIDAD DE EDITRAN/FF-CD................................................................. 2-1

3.

REQUISITOS PARA LA UTILIZACION DE EDITRAN/CD EN Z/OS. ..................... 3-1

4.

MODO DE FUNCIONAMIENTO. ............................................................................. 4-1 4.1. Previo a emisión.........................................................................................................................................4-2 4.1.1. PASO00..............................................................................................................................................4-2 4.1.2. PASO01. PGM ZTBFBEFF...............................................................................................................4-2 4.1.3. PASO02. PGM ZTBFBE12. ..............................................................................................................4-4 4.1.4. PASO A1P .........................................................................................................................................4-4 4.1.5. Pasos alarmas y abend (si hay estadísticas)........................................................................................4-5 4.1.6. Pasos adicionales................................................................................................................................4-5 4.2. Posterior a recepción.................................................................................................................................4-6 4.2.1. PASO A4P .........................................................................................................................................4-6 4.2.2. PASO ZTBGLFE ...............................................................................................................................4-6 4.2.3. PASORT ............................................................................................................................................4-6 4.2.4. PASO01. PGM ZTBFBEFF...............................................................................................................4-6 4.2.5. PASO02. PGM ZTBFBR12. ..............................................................................................................4-8

5.

FUNCIONES INVOCADAS DESDE JCL DE APLICACIÓN. .................................. 5-1

6.

EJEMPLO DE PROCEDIMIENTO DE FIRMA. ....................................................... 6-1

7.

PARAMETRIZACIONES EDITRAN/G..................................................................... 7-1

8.

CODIGOS DE ERROR EDITRAN/CD. .................................................................... 8-1

9.

INSTALACIÓN EDITRAN/CD.................................................................................. 9-1

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. i.1

EDItran/CD 4.1. z/OS. Manual de Usuario.

1.

INTRODUCCION.

EDItran/FF permite administrar y realizar un control del circuito de firmas con certificados digitales, en definitiva realiza la gestión de firma de ficheros. Contiene una interfaz gráfica en el monitor de teleproceso. Se sirve de los servicios de EDItran/CD. EDItran/CD es el módulo de criptografía con certificados digitales. Existen varias formas de funcionamiento en EDItran/FF y EDItran/CD. •

EDItran/FF corriendo íntegramente en z/os. o EDItran/CD se realiza en z/OS, parte USS (UNIX SYSTEM SERVICES) . o EDItran/CD se realiza en z/OS, con máquina IBM. (no desarrollada API EDItran).

•

EDItran/FF y EDItran/CD residen en máquinas WINDOWS-UNIX (ver esta opción en manual EF41USUA). Esta opción requiere la utilización de apis auxiliares desde z/OS para enlazar con dichas máquinas. En este documento se describe la relación entre:

•

Control del circuito de firmas ó gestión de firmas de fichero (EDItran/FF). La administración (interfaz gráfica) está descrita en el manual ED41USUC.

•

Módulo de criptografía con certificados digitales (EDItran/CD), mediante el uso de certificados USS (partición UNIX del z/OS) con OPEN SSL.

•

Para ver la funcionalidad EDItran/CD, en UNIX SYSTEM SERVICES, puede ver el el manual EDItran_zOS_USS.

En este manual se han tratado los siguientes aspectos: ‰

Breve descripción de la funcionalidad de EDItran/CD-FF

‰

Requisitos para la utilización de EDItran/CD en un entorno z/OS

‰

Modo de funcionamiento

‰

Descripción de jcl de adaptación de ficheros de aplicación emitidos o recibidos

‰

Evolución del procedimiento completo de firma, transmisión y verificación de firma de un fichero del MVS.

‰

Parametrización en EDItran/G del MVS.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 1-1

EDItran/CD 4.1. z/OS. Manual de Usuario

2.

FUNCIONALIDAD DE EDItran/FF-CD.

EDItran/FF – EDItran/CD son componentes de la plataforma EDItran que permite la firma de ficheros mediante certificados digitales (personales o de servidor) emitidos por autoridades de certificación (CA). Cada uno de los ficheros de datos (de aplicación). puede firmarse por uno o más firmantes (cada uno con su certificado) generándose: En modo attach, por cada fichero de aplicación, un fichero que contiene los datos del mismo más las firmas de los user firmantes. En modo dettach, por cada fichero de aplicación, tantos ficheros de firma usuarios firmantes haya del mismo.

como

Una vez generadas las firmas, EDItran/ FF da la posibilidad al responsable de la aplicación, de cifrar y de habilitar el envío del fichero y sus firmas asociadas. Una vez recibido/s el/los fichero/s de aplicación, con sus respectivos ficheros de firma asociados, el EDItran/FF del extremo receptor permite verificar cada una de las firmas asociadas al/los fichero/s.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 2-1

EDItran/CD 4.1. z/OS. Manual de Usuario

3.

REQUISITOS PARA LA UTILIZACION DE EDItran/CD en z/OS.

En caso de Certificados z/OS en USS con librerías OPEN SSL, debe disponer de acceso a USS y disponer de licencia EDItran/FF + CD. En todo caso, hay que dar suficiente memoria a los usuarios de jcl (parámetros MAXASSIZE y MAXMMAPAREA). Existen una serie de aspectos a contemplar: •

La aplicación FF en entornos WINDOWS: o Si es de EMISION y el remoto NIF.LOCAL+NIF.REMOTO+APLICACIÓN 000099910000099990TELECA) o Si es de RECEPCION y el remoto NIF.REMOTO+NIF.LOCAL+APLICACIÓN 000099990000099910TELECA)

es

es

un

un

host, se debe EDITRAN/G

definir (ej.

host, se debe EDITRAN/G

definir (ej.

•

La aplicación FF en entorno HOST, es la sesión de presentación EDItran/G. No se distingue si es de emisión-recepción.

•

El nombre de la aplicación EDItran/G, debe coincidir en los 2 extremos.

•

El nombre de los ficheros que genera WINDOWS no puede exceder 44 bytes.

•

El nombre de los ficheros de aplicación MVS en un envío, no puede exceder 36 bytes.

•

En EDItran, no se puede traducir, convertir, etc. Los ficheros de aplicación, serán formateados una vez descargados, ya sea en entorno host como windows, para eliminar separadores, adaptar a otro formato, adaptar a la longitud requerida, traducir, convertir, etc, etc.

•

MVS de momento, no puede enviar ficheros de aplicación VB-VS (ni siquiera a otro MVS) si se cumple alguna de las siguientes: o Si firmas attach. o Si hay criptografía.

•

MVS de momento, no puede recibir ficheros de aplicación de un MVS que sean VB-VS, si se cumple alguna de las siguientes: o Si firmas attach. o Si hay criptografía.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 3-1

EDItran/CD 4.1. z/OS. Manual de Usuario

4.

MODO DE FUNCIONAMIENTO. •

Inicialmente, se accede a interfaz gráfica de EDItran/FF (manual ED41USUC, opción 8), Se da de alta: o Registro de entorno local o Registros de usuarios locales.

•

En el momento que queramos incluir una presentación, dar de alta: o Registos de usuarios remotos (si no estuvieran) o Registro de sesión de presentación o Registro de grupos (locales y remotos). Sólo es necesario, si se desea asociar usuarios a grupos. o Registros de usuarios asociados a la presentación (locales y remotos).

Una vez dado de alta todo lo anterior, se proporciona unos procedimientos standard, a los que se les llama con unos parámetros:

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 4-1

EDItran/CD 4.1. z/OS. Manual de Usuario

4.1.

Previo a emisión.

A modo de ejemplo, se ha creado un procedimiento ZTBFP1C (válido para entidades que quieran utilizar el mismo procedimiento para sesiones FF y sesiones no FF. No obstante, puede sacar pasos fuera. No obstante, los pasos incluídos, pasos que pueden estar fuera del mismo, ya sea porque antes de la carga EDItran se quieran pasar procesos de firma sobre ficheros de aplicación creados en distintos espacios de tiempo, como por otras causas.

4.1.1. PASO00. Copia la lista de ficheros ZTBGFCAR, creada por el usuario, en una lista temportal ZTBFFCA3. En pasos posteriores: Si la sesión no es FF, PASO A1P, tira de ZTBFFCA3 Si la sesión es FF, no será válida la lista de ficheros creada por el usuario (en caso attach se generan y envían otros, en caso dettach se añaden las firmas). En PASO02 se crea la lista definitiva de ficheros a cargar por EDItran (ZTBFFCA3) y PASO A1P, tira de la misma.

4.1.2. PASO01. PGM ZTBFBEFF. Recibe como parámetros: Origen, Función, sesión de presentación ó sesión de transmisión (depende de origen y función), Tipo-envío: (E)misiones, (C)onfirmaciones. Tipo-confirmación (A)ceptada, (R)echazada, (N)inguna. De los parámetros anteriores, le son válidos: o Origen: (O)perador, (E)DItran,(A)jcl aplicación. o Función. En este procedimiento, se tratan las funciones ‘01’ carga y ‘03’ cargaemite. El resto de funciones, hace que el procedimiento acabe con rc=21. o Sesión. Se le pasa la sesión de presentación (origen O-A) ó de transmisión (origen E), en cuyo caso, el programa se encarga se sacar la aplicación EDItran/G asociada. Una vez que este paso lee la sesión de presentación, lee la sesión FF. Si no existe en perfiles, acaba con rc=01 o Tipo envio (E)misión ó (C)onfirmación. Si tipo de envío es Emisión, es necesaria una lista de ficheros ZTBGFCAR o Tipo confirmación. ƒ

Si tipo envio = ‘E’, tipo confirmación = ‘N’.

ƒ

Si tipo envío = ‘C’ tipo confirmación = (A)ceptada, (R)echazada

Los parámetros TIPO ENVIO Y TIPO CONFIRMACION, no existen actualmente en EDItran. Es responsabilidad de la aplicación indicar el mismo, si se trata de una aplicación FF.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 4-2

EDItran/CD 4.1. z/OS. Manual de Usuario

Si usted quiere aprovechar este proc para aplicaciones FF y aplicaciones no FF, puede controlar PASO1 por rc = 01. Además tiene como fichero de entrada ZTBGFCAR (fijo de 80), que es un fichero que contiene la lista de ficheros de aplicación a firmar (creado por la aplicación y de uso frecuente en EDItran). Ejemplo: ****** ***************************** Top of Data ****************************** 000001 KI.EIDA.F01 -R-B-N-F ****** **************************** Bottom of Data ****************************

En caso de que exista la sesión FF, realiza las siguientes acciones. •

Si se trata de confirmaciones, La confirmación, ya sea aceptación ó rechazo, consiste en enviar un fichero, sin cifrar siempre, firmado, que puede contener datos de la propia aplicación. Sólo hay un usuario firmante. Si ZTBGFCAR no contiene datos, significa que la aplicación no quiere enviar datos dentro de ese fichero que se va a enviar. Si existe algún dato en ZTBGFCAR (f.aplicación), se incluirán dentro del fichero de confirmación.

•

Si se trata de emisiones, Este paso, coge los ficheros que vienen en ZTBGFCAR y los trata (firma).

En ambos casos, genera una lista de ficheros de salida temporal ZTBFFCA2, cuyo formato es: Nivel 1 2 2 2

Nombre Area de fichero Nombre físico Filler Formato

Long. 130 44 1 1

Tipo Alfn. Alfn. Alfn. Alfn

2 2 2 2 2 2

Filler Lenguaje original Filler Traducir Filler Compresión

1 1 1 1 1 1

Alfn. Alfn Alfn. Alfn. Alfn. Alfn.

2 2

Filler Tipo file

7 1

Alf. Alfn.

2

Cifrar

1

Alfn

2

Nombre físico al que pertenece

44

Alfn.

2

resto registro

25

Alfn.

Indra. Todos los derechos reservados

Descripción Nombre físico del fichero de aplicación Guión de separación ‘R’ Registro ‘M’ Modificado Guión de separación ‘B’ Binario Guión de separación ‘N’ Guión de separación Indica si el fichero fue cargado con compresión: ‘F’ Comprimido, ‘N’ Sin compresión Area de reserva ‘H’ Habilitación ‘+’ Aceptación ‘-’ Rechazo ‘A’ Aplicación attach ‘D’ Aplicación dettach ‘F’ Firma dettach S/N Indica si va cifrado Pueden ir cifrados los de tipo A-D Sólo rellenar si Nuevo Tipo es ‘A’, ‘D’ ‘F’ Se pondrá el nombre físico de fichero de aplicación de entrada (ZTBGFCAR) Area de reserva

ECD41USUA.doc

04/06/2007

Pag. 4-3

EDItran/CD 4.1. z/OS. Manual de Usuario

Si la aplicación no quiere incluir este paso en el previo a emisión, por ejemplo porque quiere pasar con distintos ficheros de aplicación este paso varias veces antes de cargar, debe tener en cuenta: •

Que cada vez que pase el paso, debe borrar ZTBGFCAR.

•

Que en ZTBFFCA2, se van acumulando las entradas de ZTBGFCAR, por lo que no debe ser temporal y resulta conveniente borrar ZTBFFCA2 una vez que la carga se haya efectuado.

En definitiva, en este paso, se generan: ficheros de confirmación y se firman los ficheros de aplicación.

4.1.3. PASO02. PGM ZTBFBE12. Si PASO01 acaba con rc=01, no existe la presentación en FF, por tanto se puede condicionar este paso a que PASO01 acabe con rc=00. Si paso1 acaba con rc=00, se puede borrar la lista de ficheros que se le va a pasar a EDItran (ZTBFFCA3), puesto que este paso, la va a crear de nuevo a partir de ZTBFFCA2. Recibe los mismos parámetros que el paso 1: Además tiene como fichero de entrada ZTBFFCA2 que es un fichero que contiene la lista de ficheros tratados y formateados en paso 1. Este paso: •

Verifica que no se han producido cambios entre paso 1 y paso 2, y que están todas las firmas, ó confirrmaciones que deberían de estar.

•

En caso de cifrado, se cifran los ficheros.

•

Se genera fichero de habilitación si es el caso.

•

Genera un nuevo fichero de salida cuyo contenido son la lista de ficheros que va a tratar EDItran. Este fichero es ZTBFFCA3 (puede tener el mismo DSNAME al que creó la aplicación, no obstante si quiere conservar aquel, ponga otro nombre).

4.1.4. PASO A1P Es el paso común de EDItran, que coge LISTA DE FICHEROS ZTBFFCA3 y carga. Si se incluyen los pasos anteriores en el proc previo y este proc es común a entidades FF como no FF, hay que contemplar que paso 1 pueda acabar con rc 00 y 01.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 4-4

EDItran/CD 4.1. z/OS. Manual de Usuario

4.1.5. Pasos alarmas y abend (si hay estadísticas) Se mantienen.

4.1.6. Pasos adicionales. Si el usuario quiere mantener común este proc a todas las sesiones, puede incluir pasos adicionales, por ejemplo: •

Borrado al final de ZTBGFCAR, condicionado a que A1P, acabe con rc=00. De esta forma, en la siguiente carga que haga, será con un ZTBGFCAR con distinto contenido.

•

Inclusión de un paso de modificación de estados previo. En caso de que sea una sesión FF y falle A1P, hay que relanzar el procedimiento de nuevo.

•

Algún tipo de sistema que permita funcionar sesiones FF, sesiones no FF con lista de ficheros y sesiones no FF SIN LISTA de ficheros.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 4-5

EDItran/CD 4.1. z/OS. Manual de Usuario

4.2.

Posterior a recepción.

Se ha creado un procedimiento ZTBFP4C (válido para entidades que quieran utilizar el mismo procedimiento para sesiones FF y sesiones no FF. No obstante, puede sacar pasos fuera. Además, en este procedimiento se han incluído pasos que pueden estar fuera del mismo, ya sea porque antes de la carga EDItran se quieran pasar procesos de firma sobre ficheros de aplicación creados en distintos espacios de tiempo.

4.2.1. PASO A4P Es el paso normal de descarga.

4.2.2. PASO ZTBGLFE Genera una lista de ficheros recibida en la descarga. En este proc, se ha catalogado la salida ZTBGFLFE. Si no le interesa la lista descrita, puede añadir un paso al final para borrarla, ó hacerla temporal.

4.2.3. PASORT Ordena la lista anterior en la lista ZTBFFLFT.

4.2.4. PASO01. PGM ZTBFBEFF. Recibe como parámetros: Origen, Función, sesión de presentación ó sesión de transmisión (depende de origen y función), Tipo-envío: (R)ecepciones. Tipoconfirmación (N)inguna. De los parámetros anteriores, le son válidos: o Origen: (O)perador, (E)DItran,(A)jcl aplicación. o Función. En este procedimiento, se tratan las funciones ‘07’ descarga y ‘09’ fin de recepción’. El resto de funciones, hace que el procedimiento acabe con rc=21. o Sesión. Se le pasa la sesión de presentación (origen O-A) ó de transmisión (origen E), en cuyo caso, el programa se encarga se sacar la aplicación EDItran/G asociada. Una vez que este paso lee la sesión de presentación, lee la sesión FF. Si no existe en perfiles, acaba con rc=01 o Tipo envio (R)ecepción. o Tipo confirmación (N)inguna.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 4-6

EDItran/CD 4.1. z/OS. Manual de Usuario

Los parámetros TIPO ENVIO Y TIPO CONFIRMACION, no existen actualmente en EDItran. Es responsabilidad de la aplicación indicar el mismo, si se trata de una aplicación FF. Si usted quiere aprovechar este proc para aplicaciones FF y aplicaciones no FF, puede controlar PASO1 por rc = 01. Además tiene como fichero de entrada ZTBFFLFT (fijo de 130), que es un fichero que contiene la lista ordenada de ficheros descargados. La acaba transformando en otra lista ZTBFFLF2. Las funciones de este paso son: •

Ver si se trata de una confirmación FF ó de datos enviados por la entidad remota.

•

Tratar fichero de habilitación

•

Descifrar

•

Comprobar y extraer las firmas de los ficheros, dejando el fichero de aplicación original.

•

Verificar que están las firmas oportunas y toda la parametrización FF

•

Crea una lista (ZTBFFLF2) de ficheros de aplicación SIN FORMATEAR. El formato de ese fichero ZTBFFLF2

Nivel 1 2 2 2 2

2

Nombre Area de fichero Nombre físico DESCARGADO Filler Fecha-finpresentación Tipo-Fichero cargado

Long. 220 44

Tipo Alfn. Alfn.

1 14

Alfn. Num.

4

Num.

1

Alfn.

2

Lenguaje-datos cargados Compresión

1

Alfn.

2 2

Filler Nombre físico origen

1 44

Alf. Alfn.

2

Bytes fichero original

12

Num.

2 2

Filler Tratado

7 1

Alfn. Alfn.

Indra. Todos los derechos reservados

Descripción Nombre físico del fichero de aplicación descargado por EDItran Guión de separación Fecha-Hora de fin de presentación en formato AAAAMMDDHHMMSS Tipo de fichero cargado ‘FIJO’ ‘VBLE’ ‘VEXP’ ‘BINA’ Lenguaje de los datos cargados: ‘A’: Ascii, ‘E’: Ebcdic, ‘B’:Binario Indica si el fichero fue cargado con compresión: ‘F’ Comprimido, ‘N’ Sin compresión Area de reserva Sólo rellenar si Nuevo Tipo es ‘A’, ‘F’ Se pondrá el nombre físico de fichero de aplicación origen Bytes fichero original, para saber espacio con el que se debe crear fichero final. Area de reserva Para temas internos.

ECD41USUA.doc

04/06/2007

Pag. 4-7

EDItran/CD 4.1. z/OS. Manual de Usuario

2

Tipo file

1

Alfn.

2

Cifrar

1

Alfn

2

Nombre transformado Filler

44

Alfn.

‘H’ Habilitación ‘+’ Aceptación ‘-’ Rechazo ‘A’ Aplicación attach ‘D’ Aplicación dettach ‘F’ Firma dettach S/N Indica si va cifrado Sólo pueden ir cifrados los de tipo A y D Nombre físico del fichero transformado

54

Alfn.

Area de reserva

2

físico

4.2.5. PASO02. PGM ZTBFBR12. Este proceso, entra si PASO01 acaba con RC=00, borra ZTBGFLFE y la crea: •

Si se indica que se formatee la salida, (ADAPTAR FICHEROS = ‘S’), FORMATEA los ficheros de aplicación a lo indicado en perfil FF (lrecl, formato, traducción, saltos de carro, etc).

•

Si se indica que no se formatee la salida, graba en ZTBGFLFE la lista que le llega en ZTBFFLF2.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 4-8

EDItran/CD 4.1. z/OS. Manual de Usuario

5.

FUNCIONES INVOCADAS DESDE JCL DE APLICACIÓN. Puede extraer de los procedimientos los pasos anteriores, creando jcl específicos. Existen 2 jcls ZTBFJEMI Y ZTBFJREC. Puede acceder al almacén o realizar peticiones: Existen 2 jcls ZTBFJALM Y ZTBFJPET.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 5-1

EDItran/CD 4.1. z/OS. Manual de Usuario

6.

EJEMPLO DE PROCEDIMIENTO DE FIRMA. Por ejemplo, si se quiere firmar los ficheros de aplicación KI.EIDA.F01 y KI.EIDA.F02 fijos de 80) por 2 usuarios locales en forma attach, y enviar a un entorno ascii, la aplicación acaba creando un fichero ZTBGFCAR (FB 80), con una lista de ficheros

En entrada, tendrá ZTBGFCAR (80), con la lista que le diga en cada momento la aplicación. Ejemplo: ****** 000001 000002 ******

***************************** Top of Data ****************************** KI.EIDA.F01 -R-B-N-F KI.EIDA.F02 -R-B-N-F **************************** Bottom of Data ****************************

Al entrar PASO 1, se firman ambos y queda una salida: ****** 000001 000002 ******

***************************** Top of Data ****************************** KI.PEPE.F01.ACIP -R-B-N-F ASKI.PEPE.F01 KI.PEPE.F02.ACIP -R-B-N-F ASKI.PEPE.F02 **************************** Bottom of Data ****************************

Al entrar PASO 2, se cifran ambos, se crea el de habilitación y queda como salida a EDItran: ****** 000001 000002 000003 ******

***************************** Top of Data ****************************** KI.PEPE.F01.ACIF -R-B-N-F KI.PEPE.F02.ACIF -R-B-N-F aaaaaaaaaaa.bbb.Ccccccc.Cccc.Cddddddd.HAB -R-B-N-F **************************** Bottom of Data ****************************

El fichero de habilitación lo ha construido con prefijo instalación ff + Alias entorno local (bbb) + nif remoto (ccc...cc) + aplicación EDI/FF (dddddd) + HAB

EDItran de extremo receptor, descargará con los nombres que se le indiquen y creará un fichero de salida con dichos nombres. El Paso 1 posterior, es capaz de reconocer por el nombre de fichero origen, que los 2 primeros descargados del ejemplo anterior son attach con cifrado y el tercero es el de habilitación. Los trata y crea unos intermedios de salida. El paso siguiente, formatea a lrec las salidas anteriores y crea unos nuevos ficheros (especificados en perfil FF) que son los que tratará la aplicación.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 6-1

EDItran/CD 4.1. z/OS. Manual de Usuario

7.

PARAMETRIZACIONES EDItran/G.

Debe tener en cuenta que cuando EDItran/G descarga ficheros, lo hace con arreglo a una nomenclatura: •

Por defecto, (EDItran genera 1-n dsname de ficheros de aplicación en función de los ficheros recibidos y de lo que tenga en el valor FICHERO-UNICORECEPCION.

•

Especificada de una forma fija por el usuario en la sesión de presentación, Dicha especificación, hace que todo lo que se descargue se haga sobre el mismo DSNAME.

•

Especificada con variables por el usuario en la sesión de presentación. Dicha especificación, puede ser que cree 1 ó varios dsnames en función de los ficheros recibidos y de lo que tenga en el valor FICHERO-UNICO-RECEPCION.

Las aplicaciones que tratan los ficheros descargados, conocen de algún modo cuales han sido los dsname descargado. Además, se permite hacer traducción en envío y en recepción. Con la nueva forma de utilización: •

El fichero de aplicación original, es firmado antes de traducir, por tanto el envío del fichero se hace con lenguaje binario. (parámetros LENGUAJE-ORIGINAL-DATOS = ‘B’, TRADUCIR-EN-EMISION=’N’ y no codificar tabla de conversión de emisión).

•

Al descargar, antes de traducir, hay que verificar las firmas, por ello, la descarga ha de hacerse en binario. (parámetros TRADUCIR-EN-RECEPCION=’N’, no codificar tabla conversión recepción).

•

La única opción que hay de que el fichero descargado sea único, es que se reciba de una sesión que cargó un único fichero en modo attach sin habilitación. Además en ese caso, el fichero descargado no podrá ser tratado por las aplicaciones, puesto que habrá que descifralo si es el caso, extraer las firmas y reconvertirlo al formato esperado por las aplicaciones. Por ello, el parámetro FICHERO-UNICORECEPCION = ‘N’ (no ocurre nada en el caso de que sólo se reciba 1 fichero y tengamos puesto ese valor, pero nos sirve para el resto de situaciones).

•

La única opción de que el dsname apuntado por las aplicaciones mantenga el mismo valor y contenido que ahora, sería la opción de recibir ficheros con firma dettach, sin habilitación, sin cifrado y sin tener que traducir ni reconvertir el fichero. No obstante, en ese caso, EDItran/G descargará múltiples ficheros: o Donde antes descargaba (1)fapl-1, (2)fapl-n o Ahora descargará: (1)fapl-1, (2)firma-1 fapl-1, (n)firma-n fapl-1, (n+1) firma-1 fapl-n, (n+n) (firma-n fapl-n)

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 7-1

EDItran/CD 4.1. z/OS. Manual de Usuario

o Lo anterior implica que las aplicaciones deberían conocer exactamente que ficheros debe tratar y cuales no. En el caso de un único fichero de aplicación transmitido, probablemente f-apl-1 sea el primero de los descargados, pero si no hay un único fichero de aplicación transmitido, el segundo fichero de aplicación descargado, no ocupará la segunda posición en la descarga, sino que si por ejemplo hay 3 firmas en cada fichero de aplicación, ocupará la quinta descarga. Para los casos anteriores, además, la nomenclatura del fichero de aplicación descargado sólo puede ser por defecto ó con variables, es decir no se puede poner un dsname fijo. •

En el resto de casos, se van a hacer transformaciones sobre los ficheros descargados. Esas transformaciones, implican que en EDItran/G, la nomenclatura del fichero de aplicación descargado sólo puede ser por defecto ó con variables, es decir no se puede poner un dsname fijo. Además, puesto que la aplicación no va a poder tratarlo, se ponga una nomenclatura INTERMEDIA, es decir, desconocida para la aplicación.

•

Una vez que se pasen los procesos de verificación de firma, descifrado, etc, etc. EDItran/FF, creará (excepto en dettach ya comentado), ficheros con un dsname específico (prefijo sacado de entorno EDItran/FF).

•

Esos ficheros, habría que transformarlos en formato y en nombre a lo conocido por las aplicaciones. Ese dsname sería el que se coloca en perfiles EDItran/FF y no en EDItran/G, por todo ello, lo suyo sería cambiar la actual nomenclatura EDItran/G a EDItran/FF y poner una nueva nomenclatura en EDItran/G. De esa forma las aplicaciones continuarán tratando los mismos ficheros de aplicación que trataban hasta ahora.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 7-2

EDItran/CD 4.1. z/OS. Manual de Usuario

Los parámetros que trata el procedimiento a la hora de generar ficheros intermedios o finales son: .&L0..R&R1..R&R2..A&AP.., donde L0 es alias entorno local, R1-R2 es el remoto y AP es la aplicación Paso descarga G Parámetro EDI/G

Recibe 1 file

Recibe n files iguales características

Recibe n files distintas características

Fich.único recepión = ‘S’

Defecto

ERROR FINAL

ERROR FINAL

Nombre

ERROR FINAL

ERROR FINAL

Nombre

ERROR FINAL

ERROR FINAL

Defecto

Defectos

Defectos

Nombre

ERROR FINAL

ERROR DESCARGA

Nombres

Nombres

Nombres

Nombre = spaces Fich.único recepión = ‘S’ Nombre = fijo Fich.único recepión = ‘S’ Nombre = con variables Fich.único recepión = ‘N’ Nombre = spaces Fich.único recepión = ‘N’ Nombre = fijo Fich.único recepión = ‘N’ Nombre = con variables Defecto es Prefijo instalación EDItran/G + .&L0..R&R1..R&R2..A&AP.. + R0001xx (xx es un número de 01-99). ERROR DESCARGA: Lo da EDItran/G al ver que son ficheros de distintas características. ERROR FINAL.- El proceso de ver la firmas, dará error, pues si juntamos varios ficheros de aplicación y/o firmas en uno solo, no se podrá verificar la firma correctamente. Paso 1 descarga FF Parámetro EDI/FF

Recibe 1 file

Recibe n files iguales características

Recibe n files distintas características

Dettach sin cifrar

EDItran/G

EDItran/G

EDItran/G

Dettach descifrado

Defectos

Defectos

Defectos

Attach final (con-sin cifrado) Defectos

Defectos

Defectos

EDItran/G: Se mantiene el nombre impuesto por EDItran/G en el paso de descarga. Defectos (Dettach sin cifrar, no se crea, se respeta nombre que puso EDItran/G al descargar). •

Dettach ya descifrado: Puntero FF + .&L0..R&R1..R&R2..A&AP.. +.Ann (núm orden)

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 7-3

EDItran/CD 4.1. z/OS. Manual de Usuario

•

Attach al descifrar y desatachar: Puntero FF + .&L0..R&R1..R&R2..A&AP.. +Ann (núm orden)

Paso 2 descarga FF Parámetro EDI/FF

Recibe 1 file

Recibe n files iguales características

Recibe n files distintas características

Nombre = spaces

Defecto

Defecto

Defectos

Nombre = fijo

Nombre

ERROR. El último machaca el anterior

ERROR. El último machaca el anterior

Nombre = con variables

Nombres

Nombres

Nombres

EDItran/FF

EDItran/FF

EDItran/FF

Defecto = PrefijoFF + .&L0..R&R1..R&R2..A&AP.. + R001nn (núm orden)

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 7-4

EDItran/CD 4.1. z/OS. Manual de Usuario

8.

CODIGOS DE ERROR EDItran/CD.

Los distintos códigos de error devueltos por EDItran/CD los puede ver el el manual EDItran_zOS_USS.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag. 8-1

EDItran/CD 4.1. z/OS. Manual de Usuario

9.

Instalación EDItran/CD.

Para instalar el software UNIX de EDItran/CD, se proporciona un fichero comprimido .TAR, que instala automáticamente todos los componentes, directorios y certificados de prueba. Para instalar sus propios certificados, ver la función correspondiente en EDItran_zOS_USS.

Indra. Todos los derechos reservados

ECD41USUA.doc

04/06/2007

Pag.

9-1

BARCELONA Diagonal, 218 3º 08018 BARCELONA BILBAO Henao, 4, 4ºA 48001 BILBAO MADRID Avda. de Bruselas 35 - Arroyo de la Vega - Alcobendas 28108 MADRID SEVILLA Avda. San Francisco Javier, 22, 6º 41018 SEVILLA VALENCIA Colón,60 46004 VALENCIA