IBM Rational Developer for i
Versión: 7.5.0
Gerencia de Sistemas (c) 1
Contenido
Introducción
Iniciar el producto
Abrir la perspectiva Explorador de sistemas remotos
Configurar una conexión con un sistema iSeries y conectarse a un iSeries
Trabajar con miembros fuente
Verificar el código fuente
Compilar el código fuente
Depurar un programa
Depurar un trabajo
Abrir miembro DDS
Crear un proyecto iSeries
Gerencia de Sistemas (c) 2
RDi ¿ Para que nos sirve?
IBM Rational Developer for i (RDi) está diseñado para ayudarle a:
Desarrollar y mantener aplicaciones iSeries mediante el
explorador de sistemas remotos
Desarrollar aplicaciones habilitadas para la Web en iSeries
Crear aplicaciones graficas para iSeries
IBM Rational Developer for i (RDi) es un entorno de desarrollo
integrado creado por la división Rational Software de IBM para el
diseño visual, construcción, pruebas y despliegue de servicios
web, portales y aplicaciones JEE.
volver
Gerencia de Sistemas (c) 3
RDi – Galería de Ayuda y Aprendizaje
Rational Developer for i proporciona una galería de guías de aprendizaje y una galería de ejemplos que permiten al
usuario empezar a trabajar con el producto en el mínimo tiempo posible.
Gerencia de Sistemas (c) 4
RDi – Workbench configurable por rol
Esta plataforma pone a su disposición roles de usuario, que puede
seleccionar en Ventana > Preferencias > General > Aspecto > Capabilities,
que personalizan y simplifican la interfaz de usuario según el rol de
programación. Estas son solo algunas de las prestaciones de Rdi.
Gerencia de Sistemas (c) 5
RDi – Capacidades I
Explorador de sistemas remotos
Se trataLPEX
Editor de una versión de estación de trabajo más flexible y mejorada del
Gestor para el desarrollo de programas (Program Development Manager,
ShellsCon
PDM). y mandatos de ladevista Mandatos remotos
Se trata de el
unexplorador
potente editor sistemas
sensibleremotos y losque
a lenguajes proyectos iSeries,
puede personalizarse.
puede crear ydegestionar
El resaltado símbolosproyectos
del códigodefuente
desarrollo en los
destaca el sistema
diversosiSeries
elementos del
Utilice
desde esta vista
la estación para: Ejecutar
de solicitudes
trabajo basada mandatos en una
en Windows. de shell
Con de
estasmandatos, visualizar
programa. Contiene de especificación tipo SEUherramientas
para RPG y
e interpretar
puede la salida de
conectarse unremoto
programa, especificar datos de entrada en un
DDS que facilitan alaun host
especificación iSeries
de datosyenvercampos
bibliotecas, archivos
sensibles a y
programa, visualizar
miembros y gestionar diversos mandatos y shells desde la misma
columnas. de La iSeries. También
comprobación depuede lanzar
sintaxis y la los compiladores
verificación de host,
de semántica el
local
vista. de estación de trabajo, un verificador de programa y diversos
editor
del código fuente RPG y DDS garantizan una compilación sin errores en un
depuradores,
sistema iSeries. todoSi ello desde
existen el explorador
errores de sistemas
de comprobación, unaremotos.
Lista deEsta
errores
herramienta también
permite localizar admite
y resolver losotros tipos decon
problemas sistemas,
rapidez.como por ejemplo
Las guías de
UNIX(R), Linux y Windows.
programación en línea, la consulta de lenguajes y la ayuda según contexto
facilitan la búsqueda de la información necesaria con sólo una pulsación.
Gerencia de Sistemas (c) 6
RDi –Capacidades II
Verifica Sintaxis
Debugger
El verificador comprueba si existen errores semánticos (de
compilación) en la estación de trabajo para poder garantizar una
Proporciona
Diseñador
compilaciónCODEuna interfazengráfica
sin errores interactiva
el iSeries. Resultaque de facilita
especiallautilidad
depuración
al y
prueba
escribir de los programas
código iSeries. También
sin estar conectado le permite
a un sistema establecer
iSeries. puntos
La ventana
de interrupción
Lista de errores antes de errores
lista los ejecutardetectados
el depurador,
y su insertándolos
gravedad, inserta los
directamente
Es
Screen
mensajes en el directamente
una herramienta
Designer
de error código fuente
de diseño mientras
gráfico
en lo fuente
edita. diseñar
que permite
el código Puede ejecutar
las
y facilita el
lapantallas e
programa,
informes
navegación establecer
visualmente puntos de interrupción
y, a continuación,
por los errores. de línea,
generar códigovigilancia y punto
fuente DDS.
de entrada
Screen de servicio,
Designer permite recorrer
diseñarlas instrucciones
y modificar del programa,
en forma gráfica el
examinar
contenido las variables
de un archivoy de
examinar
pantallalaDDS.
pila de llamadas.
Gerencia de Sistemas (c) 7
Rdi - Iniciar el producto
1. Pulse Inicio en la barra de tareas del escritorio.
2. Seleccione
Todos los Programas > IBM Software Delivery Platform > IBM Rational
Developer for i > IBM Rational Developer for i.
volver
Gerencia de Sistemas (c) 8
Aparecerá un diálogo. En él debe especificar el directorio del
espacio de trabajo en el que residirán los proyectos y otros
recursos tales como carpetas, subcarpetas y archivos que
desarrolle en el entorno de trabajo.
Pulse Aceptar para abrir el entorno de trabajo.
Gerencia de Sistemas (c) 9
Pulse “Entorno de trabajo” para pasar al
escritorio de trabajo.
El término entorno de trabajo hace referencia al entorno de desarrollo del escritorio. El
entorno de trabajo tiene la finalidad de lograr una integración transparente de las
herramientas y una apertura controlada mediante un paradigma común para la creación,
gestión y navegación por los recursos del entorno de trabajo. Cada ventana del entorno de
trabajo contiene una o varias vistas y un editor.
Gerencia de Sistemas (c) 10
RDi - Abrir perspectiva de Explorador de Sistemas
Remotos
Las perspectivas contienen vistas y editores y controlan lo que aparece en
determinados menús y barras de herramientas.
Si no está la perspectiva o no se abre ninguna, pulse
Ventana > Abrir perspectiva > Explorador de
Sistemas Remotos
Busque el nombre de la perspectiva (pestaña Sistemas)
Trabajará en la perspectiva Explorador de Sistemas Remotos del entorno de trabajo. Esta
perspectiva está pensada para que los programadores de iSeries puedan visualizar las
conexiones ya configuradas, crear conexiones nuevas, conectarse a las conexiones ya
definidas y desconectarse de ellas y trabajar con archivos, mandatos, trabajos y archivos
del sistema de archivos integrado de iSeries.
volver
Gerencia de Sistemas (c) 11
Configurar una conexión con Servidor IBM i
Pulse botón derecho sobre IBMi, seleccione Conexión nueva..., para
configurar una conexión con un sistema iSeries.
Objetos de iSeries: Grupo parecido a
PDM que permite el acceso a bibliotecas,
objetos y miembros.
Mandatos de iSeries:
Contiene mandatos predefinidos y permite
crear conjuntos de mandatos, cada uno de
los cuales contiene uno o varios
mandatos utilizados con frecuencia.
Cuando se ejecutan, todos los mandatos
de un conjunto de mandatos se envían al
sistema remoto y se ejecutan, y el
resultado se registra en la vista
Anotaciones de mandatos de iSeries.
Trabajos de iSeries: Permite visualizar
diversos trabajos, agrupados por
atributos de trabajo, y realizar varias
operaciones con ellos.
Se abre el diálogo Conexión nueva. Donde se
especificará la conexión. Pulse Finalizar para
Archivos IFS: Permite explorar carpetas y
definir el sistema. archivos del sistema de archivos
integrado del sistema iSeries remoto.
volver
Gerencia de Sistemas (c) 12
Trabajar con miembros fuente
Pulse el signo +
situado junto a
Trabajar con
miembros .
Pulse el signo + para ver los
Miembros fuente.
volver
Gerencia de Sistemas (c) 13
Trabajar con miembros fuente
Se ha creado el filtro Mi_QRPGLESRC, para mostrar todos los miembros fuente del archivo
YOSIAM/QRPGLESRC.
Puede crear sus propios filtros para cada tipo de miembro fuente (QCMDSRC, QCLSRC,
QDDSSRC, QSQLSRC, QPNLSRC, QPARMLESRC, etc.)
Filtros de miembros
fuente.
Gerencia de Sistemas (c) 14
Trabajar con miembros fuente: visualizar en forma
de Tabla
Pulse con el botón derecho en el archivo
QRPGLESRC y pulse Mostrar en forma
de tabla en el menú emergente.
Vista de los miembros fuente del archivo YOSIAM/QRPGLESRC,
en forma de Tabla.
Gerencia de Sistemas (c) 15
Editar un fuente
En la pestaña Sistemas; pulse
con el botón derecho sobre el
miembro fuente, pulse Abrir con,
seleccione Editor LPEX de
Sistemas Remotos .
El editor puede acceder a los
archivos fuente en la estación de
trabajo o directamente en el sistema
iSeries.
Gerencia de Sistemas (c) 16
Editar un fuente (alternativa)
En la Vista de tabla de iSeries; pulse con
el botón derecho sobre el miembro
fuente, pulse Abrir con, seleccione Editor
LPEX de Sistemas Remotos .
Gerencia de Sistemas (c) 17
Editar
Especificar mandatos SEU
Mueva el cursor al área de números de secuencia
gris situada a la izquierda del área de edición.
Observe que las líneas se han suprimido.
Sobre cualquier número de secuencia, escriba dd.
Desplácese algunas líneas hacia abajo, escriba de
nuevo dd y pulse Intro.
Gerencia de Sistemas (c) 18
Editar – Deshacer y Rehacer cambios realizados
Pulse Editar > Deshacer en el menú del
entorno de trabajo.
Observe que las líneas suprimidas
reaparecen.
Si pulsa Editar > Rehacer en el menú del entorno de trabajo. Observará que las
líneas se suprimen de nuevo.
Gerencia de Sistemas (c) 19
Editar – uso de la ayuda integrada
Sitúe el cursor sobre la palabra EVAL del código fuente ILE RPG.
Presione F1.
La ayuda para el código de
operación EVAL aparece en
una ventana de ayuda. El
texto marcado en azul en la
ventana de ayuda contiene el
enlace a la información
detallada acerca del tema.
Gerencia de Sistemas (c) 20
Editar – F4 Ingreso con parametros de selección
Verá el motor de solicitudes de fuente de iSeries en la parte inferior
del entorno de trabajo. El motor de solicitudes de fuente de iSeries
muestra la línea de especificación dividida en sus campos
individuales.
En la ventana del editor, mueva el cursor a la especificación C en la línea 014715.
Pulse F4. (También puede pulsar Fuente en el menú del entorno de trabajo y, a
continuación, pulsar Solicitud.)
Gerencia de Sistemas (c) 21
Editor – ingreso asistido
Acceder a la ayuda de funciones
Si deseamos emplear una función incorporada en ILE RPG. Teclee % y pulse Control +
Barra espaciadora.
Para trabajar con una función de edición. Teclee %EDIT y pulse Control + Barra espaciadora.
Pulse dos veces sobre Complete los
%editc(numeric:editcode) parámetros de
esta función.
Gerencia de Sistemas (c) 22
Editar – Ayuda sobre operaciones de control
Si desea ejecutar una operación, por ejemplo un ciclo DOW y no recuerda su
formato. Teclee DO y pulse Control + Barra espaciadora.
Complete Factor 1,
presione Enter.
Doble pulsación sobre la
operación seleccionada.
Gerencia de Sistemas (c) 23
Editar – Sangrar fuente
La vista Sangrado de iSeries se muestra en la parte inferior del
entorno de trabajo.
Pulse Fuente > Mostrar sangrado en el menú del entorno de trabajo.
Para visualizar la vista Sangrado de iSeries a
pantalla completa.
Efectúe una doble pulsación en la pestaña
Sangrado de iSeries.
Gerencia de Sistemas (c) 24
Editar – Buscar y sustituir
Pulse Control+Inicio para desplazarse al principio
del miembro fuente.
Sugerencia: Al pulsar Control+Inicio para ir al
principio o Control+Fin para ir al final, se coloca
una marca rápida en la posición del cursor. Esto
Permite volver a esa línea pulsando Alt+Q. Al pulsar
Control+Q se establecerá una marca rápida.
En el campo Buscar, especifique ValidNroSol para buscar el
inicio de una subrutina.
Asegúrese de que el campo Sustituir está en blanco. Este
Pulse Editar>Buscar/ campo se utiliza para la sustitución de texto. El editor
Sustituir en el menú del desplaza la línea activa hasta la línea 21101, que contiene
entorno de trabajo, o pulse el primer término ValidNroSol del miembro fuente.
Control+F. La ventana Pulse Siguiente para ir a la ubicación siguiente de
Buscar/Sustituir aparece en la ValidNroSol.
parte inferior de la ventana del
editor. Al final de esta
ventana, observará que tiene
algunas opciones para
seleccionar; por ejemplo,
buscar sólo en determinadas
columnas, etc.
Deseamos buscar la primera
aparición de ValidNroSol.
Gerencia de Sistemas (c) 25
Editar – Filtrar por serie
El editor permite filtrar o crear subconjuntos del código fuente de forma que sólo se visualicen
las líneas que contienen una serie determinada. El filtrado de líneas facilita y acelera la
búsqueda de líneas sin necesidad de recorrer todo el código fuente.
Ahora, solo se visualizan todas las líneas que contienen la serie PcAsegur.
Efectúe una doble pulsación en la variable PcAsegur en la ventana del editor.
Seleccione Editar > Seleccionado > Filtrar
selección en el menú del entorno de trabajo.
Para visualizar de nuevo todo el código fuente. Pulse Editar > Mostrar todo en el menú
del entorno de trabajo o pulse Control+W. El cursor sigue situado en la misma línea a
la que lo ha movido, aunque ahora se muestran todas las líneas del código fuente.
Gerencia de Sistemas (c) 26
Editar – Filtrar por tipo SQL
El editor permite filtrar líneas en función del tipo de línea.
Pulse con el botón derecho en la ventana del
editor sobre el código fuente.
Pulse Filtrar vista > Sentencias SQL en el
menú emergente.
Se visualizarán todas las líneas con sentencias
SQL.
Para volver a visualizar todo el código fuente, pulse en la ventana del editor con el botón derecho
del ratón y pulse Mostrar todo en el menú emergente.
Gerencia de Sistemas (c) 27
Editar – Filtrar por subrutinas
Pulse con el botón derecho en la ventana del
editor sobre el código fuente.
Pulsecon
Para trabajar Filtrar vistafuente
el código > Subrutinas en el menú
de una subrutina,
expanda emergente.
la declaración de la misma. Presionando
Se visualizarán
el signo +. Por todas las
ejemplo veamos líneas de
el código conlaBEGSR o
subrutina
ENDSR, lo que le permitirá desplazarse
Bus_Autori.
rápidamente hasta la subrutina deseada.
Gerencia de Sistemas (c) 28
Editar esquema miembro fuente
La vista Esquema contiene el programa fuente en una vista de árbol sin las líneas que
contienen la lógica.
El editor de código fuente se pocisiona en la línea donde
se utiliza el campo CEMPRES del registro EMPRODR.
Expanda Archivos.
Expanda el archivo EMPRODF.
Expanda el formato de registro
EMPRODR.
Efectúe una doble pulsación sobre
cualquiera de las entradas de la vista
Esquema.
El editor de código fuente se
posicionará de acuerdo con la
selección realizada.
Gerencia de Sistemas (c) 29
Editar : Mostrar campos de una tabla
En la pestaña Vista de tabla de los campos iSeries,
Pulse dos veces sobre el nombre visualizará los campos del archivo COREGIF.
del archivo (COREGIF).
Pulse Fuente, pulse Mostrar
campos
Si no recuerda el nombre de un campo o sus propiedades al momento de asignar su valor a una variable.
Puede tipear el prefijo del archivo y luego pulsar Control + Barra Espaciadora.
Gerencia de Sistemas (c) 30
Verificar el código fuente
Para invocar
Antes de compilar el código en un sistema iSeries, puedeel verificador
asegurarse de que no existen errores invocando el
verificador de programa. El verificador comprueba si existen errores semánticos (de compilación) en la estación de
trabajo para poder garantizar una compilación sin errores en el sistema iSeries.
Resulta de especial utilidad al escribir código sin estar conectado a un iSeries. Esto puede hacerse gracias a
que el explorador de sistemas remotos ha portado el código de análisis y comprobación de los compiladores del
sistema iSeries a la estación de trabajo.
La vista Lista de errores de iSeries muestra los errores detectados y su gravedad, inserta los mensajes de error
directamente en el código fuente y facilita la navegación por los errores.
Pulse Fuente > Verificar en el menú del Emplear el menú emergente del miembro
entorno de trabajo. fuente en la vista Sistemas remotos.
volver
Gerencia de Sistemas (c) 31
Verificar fuente
Pasados unos segundos, el verificador mostrará una lista de errores de iSeries bajo la ventana del editor.
La lista de errores mostrará:
1. El mensaje de error
2. La gravedad
3. El número de línea
4. La ubicación del código fuente
5. El nombre de la conexión
Puede filtrar los mensajes según estos
niveles de gravedad con el menú de filtro.
Pulse la flecha de la barra de título Lista
de errores de iSeries. Pulse Mostrar
gravedad en el menú emergente.
Gerencia de Sistemas (c) 32
Verificar el código fuente
Arreglar errores: identificar un error
Efectúe una doble pulsación en el error RNF0273.
Volverá automáticamente a la ventana del editor, a la línea en la que se ha producido el error.
Este error se produce por que no están en la lista de bibliotecas; las bibliotecas SRCPSSEG y EMISRC.
Gerencia de Sistemas (c) 33
Verificar el código fuente
Arreglar errores: añadir bibliotecas YOSIAM, SRCPSSEG y EMISRC.
Pulse con el botón derecho sobre Lista de Bibliotecas.
Pulse Añadir entrada de lista de bibliotecas...
Luego en el cuadro de diálogo añada las bibliotecas.
Expanda Lista de Bibliotecas para visualizarlas.
En la pestaña Anotaciones de mandatos de iSeries, situada debajo del
editor de fuente, observará los comandos ejecutados.
Gerencia de Sistemas (c) 34
Verificar el código fuente
Arreglar errores: volvemos a Verificar el fuente
En la pestaña Lista de errores de iSeries vemos
ahora que el mensaje de error nos indica que no se
ha encontrado la definición para el archivo
EMUVEHPADS (pantalla).
Efectuamos una doble pulsación en el error
RNF2120, para volver automáticamente a la
ventana del editor, a la línea en la que se ha
producido el error.
Gerencia de Sistemas (c) 35
Compilar el código fuente de manera remota
Cambiar las preferencias de compilación, a fin de ejecutar la compilación interactiva.
1. Pulse Ventana > Preferencias en el menú del entorno de trabajo.
2. En el panel izquierdo de la ventana Preferencias, expanda Sistemas remotos.
3. Expanda IBM i en Sistemas remotos.
4. Pulse Ejecución de mandato.
5. En el panel derecho de la ventana Preferencias, quite la marca del recuadro de selección
Compilar por lotes.
6. Pulse Aceptar para volver a la perspectiva Explorador de sistemas remotos.
volver
Gerencia de Sistemas (c) 36
Compilar el código fuente de manera remota
Invocar el mandato de compilación.
1. Con el botón derecho del ratón, pulse el miembro fuente EMUVEHPA de QRPGLESRC.
2. Pulse Compilar (con solicitud) > CRTSQLRPGI en el menú emergente. Se abre el diálogo Crear objeto RPG ILE SQL
(CRTSQLRPGI).
3. Pulse Aceptar, luego de examinar los demás parámetros.
La barra de progreso del entorno de trabajo (esquina inferior derecha) indicará la ejecución de la compilación.
Luego aparecerá la lista de errores. Si no está seguro de si la compilación ha sido satisfactoria, puede
examinar las anotaciones de mandatos de iSeries.
Gerencia de Sistemas (c) 37
Depurar un programa
Iniciar el depurador integrado
1. Seleccione el programa ILE RPG a depurar.
2. Pulse la flecha junto al icono de depuración en la barra de herramientas del entorno de
trabajo.
3. Seleccione Depurar configuraciones... en la lista. Se abrirá la ventana Depurar
Configuraciones de lanzamiento de depuración.
En el campo Nombre, escriba el
nombre de programa.
Marque el recuadro de selección
Actualizar archivos de producción.
IndiquePulse
el mandato
la pestaña
paraCómo
iniciariniciar.
la aplicación o pulse
Solicitud. Se abrirá la ventana de llamar a programa
donde podrá indicar los parámetros si es que los
requiere.
Mandato de inicio completo del programa.
Pulse Depurar
Seleccione IBM i: Depurar
aplicación interactiva.
Pulse Configuracion_nueva.
volver
Gerencia de Sistemas (c) 38
Depurar un programa
Iniciar el depurador integrado
Se abrirá la perspectiva Depuración. En caso contrario, puede que vea este mensaje de error.
Significa que el servidor de comunicaciones del explorador de
sistemas remotos se ha cerrado. Diríjase al emulador 5250 y
reinicie el servidor de comunicaciones del explorador de
sistemas remotos siguiendo las instrucciones del mensaje
STRRSESVR NAME(LMADESA). No es necesario cancelar el
mensaje. Se eliminará en cuanto se haya establecido la
conexión entre el servidor de comunicaciones del explorador
de sistemas remotos y la sesión interactiva. Ahora, la
perspectiva Depuración está cargada en el entorno de trabajo.
Ahora que el programa está activo en el sistema iSeries y se ha detenido en la primera sentencia ejecutable, el
depurador muestra el código fuente.
Pulse el botón Recorrer principal en la barra de herramientas de la vista Depurar o pulse la tecla F6. Se
ejecuta la línea seleccionada actualmente, y la ejecución se suspende en la próxima línea ejecutable
(CALL EMUVEHPA, llamada al PGM ILE RPG).
Pulse el botón Recorrer todo en la barra de herramientas de la vista Depurar o pulse la
tecla F5. Se invoca la próxima expresión en la línea seleccionada actualmente que debe
ejecutarse (CALL EMUVEHPA), y la ejecución se suspende en la próxima línea ejecutable
del método invocado. El depurador muestra el código fuente de EMUVEHPA.
Gerencia de Sistemas (c) 39
Depurar – puntos de interrupción
Sólo puede establecer puntos de interrupción en líneas ejecutables. Todas las
líneas ejecutables se visualizan en color azul.
Sitúe el cursor en la línea. Pulse con el botón derecho en cualquier posición de la línea.
Pulse Añadir punto de interrupción en el menú emergente.
Un punto con una marca de selección en el área de prefijo indica que se ha establecido un
punto de interrupción en la línea 218. El área de prefijo es el pequeño margen gris situado
a la izquierda de las líneas de código fuente.
Gerencia de Sistemas (c) 40
Depurar un programa
Establecer puntos de interrupción condicional
Sitúe el cursor en la línea 220. Pulse en la línea con el botón derecho del ratón. Pulse Añadir
punto de interrupción en el menú emergente. Pulse la pestaña Puntos de interrupción en el
panel superior derecho de la perspectiva Depuración. Se abre la vista Puntos de interrupción.
En la vista Puntos de interrupción pulse el punto de interrupción de la línea 220 con el botón derecho del ratón.
Pulse Editar punto de interrupción en el menú emergente. Se abre la ventana Editar un punto de interrupción
de línea.
Pulse el icono Reanudar de la barra de
herramientas de depuración. El programa
empieza a ejecutarse y se detendrá en el primer
punto de interrupción, línea 218.
Pulse de nuevo el icono Reanudar, para que el
programa se ejecute hasta el punto de
interrupción de la línea 220, cuando se cumpla
la condición.
El programa se ejecuta en la sesión de
emulación 5250.
Gerencia de Sistemas (c) 41
Depurar un programa – editar /visualizar variables
En la vista Fuente, efectúe una doble pulsación en la variable. Pulse con el botón derecho.
Pulse Supervisar expresión en el menú emergente. Se abre la vista Supervisores. Otra
manera es dejar el puntero del ratón
sobre una variable durante uno o dos segundos se visualizará su valor en una ventana
emergente.
Gerencia de Sistemas (c) 42
Depurar un trabajo Interactivo
Se abre el cuadro Editar configuración.
Pulse Mis trabajos activos, QINTER, Indique programa a depurar.
seleccione su sesión de trabajo, pulse
Depurar como, pulse Trabajo de IBM i
Visualiza el código a
depurar.
Proceda según lo indicado en
el punto Depurar un
programa
Ejecute la aplicación a
volver
depurar en el iSeries.
Gerencia de Sistemas (c) 43
Abrir un miembro DDS en la vista Sistemas remotos
¿Cómo abrir un miembro de archivo DDS en la vista Sistemas Remotos?
Si ya tiene creado un filtro para los Si no tiene creado un filtro para
miembros fuente QDDSSRC. los miembros fuente QDDSSRC.
1. Expanda el filtro Mi_QDDSSRC 1. Expanda Lista de bibliotecas.
2. Sitúese en el miembro fuente 2. Expanda el archivo QDDSSRC de la
EMUVEHPADS. biblioteca YOSIAM.
3. Sitúese sobre el miembro fuente
EMUVEHPADS
I. Pulse el miembro EMUVEHPADS con el botón derecho del ratón.
II. Pulse Abrir con > Diseñador CODE en el menú emergente.
El miembro EMUVEHPADS se bajará a la estación de trabajo y se
cargará en el diseñador CODE. El diseñador CODE es una herramienta
independiente que no está integrada en el entorno de trabajo.
volver
Gerencia de Sistemas (c) 44
Abrir un miembro DDS en la vista Sistemas remotos
Ha abierto el miembro fuente EMUVEHPADS, en la vista Sistemas Remotos con el diseñador CODE
Lo que está viendo en este
momento es básicamente
una vista de explorador del
código DDS.
La vista de árbol de DDS del
lado izquierdo del diseñador
muestra el código fuente DDS
de la jerarquía de archivos,
registros y palabras clave.
Gerencia de Sistemas (c) 45
Abrir un miembro DDS en la vista Sistemas remotos
Visualizar el árbol de DDS
Para mostrar las palabras clave a nivel de archivo y el registro MAIN en el
árbol de DDS:
1. Expanda la carpeta
<ROMADESA>YOSIAM/QDDSSRC(EMUVEHPADS).
2. Expanda la carpeta de palabras clave de archivo.
3. Expanda el registro MAIN.
4. Expanda la carpeta de palabras clave de registro.
5. Expanda el campo WNMARCA.
Gerencia de Sistemas (c) 46
Abrir un miembro DDS en la vista Sistemas remotos
El Árbol de DDS se halla en la parte izquierda de la ventana del Diseñador CODE.
Esta vista contiene el Fuente de DDS cargado en forma de árbol, en el que se
muestra la jerarquía de los archivos, registros, campos y palabras clave de cada
objeto DDS seleccionado.
El Árbol de DDS muestra los grupos de registros que representan las pantallas o
informes que se están diseñando, están al mismo nivel que el archivo en la
jerarquía.
En esta vista puede crear grupos y copiar o mover claves, palabras clave, campos y
registros.
Si algún objeto DDS contiene un error, el icono que lo representa visualiza una X
de color rojo.
Gerencia de Sistemas (c) 47
Abrir un miembro DDS en la vista Sistemas remotos
Un archivo DSPF o PRTF se organiza del modo siguiente:
+ Archivo
+ Carpeta de palabras clave a nivel de archivo
+ Registro 1
+---+ Carpeta de palabras clave a nivel de registro
+---+ Palabra clave a nivel registro 1
+---+ Carpeta de especificaciones de ayuda
+---+ Especificación de ayuda 1
+---+ Especificación de ayuda 2
+---+ Campo 1
+---+ Palabra clave a nivel de campo 1
+---+ Campo 2
+ Registro 2
+---+ Carpeta de palabras clave a nivel de registro
+---+ Campo 1
+ Grupo 1
+ Registro 1
+ Grupo 2
+ Registro 2
Un archivo PF se organiza del modo siguiente:
+ Archivo
+ Carpeta de palabras clave a nivel de archivo
+ Registro
+---+ Carpeta de palabras clave a nivel de registro
+---+ Carpeta de claves de registro
+---+ Clave 1
+---+ Clave 2
+---+ Clave 3
+---+ Campo 1
+---+ Palabra clave a nivel de campo 1
+---+ Palabra clave a nivel de campo 2
Gerencia de Sistemas (c) 48
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE
En el lado superior derecho del diseñador
se encuentra el Libro de trabajo, con
varias páginas en pestañas diferentes.
El Libro de trabajo es el área del
diseñador CODE donde se diseñan los
archivos de pantalla, impresora o físicos.
En el lado inferior derecho del diseñador
se encuentra el cuaderno de programas
de utilidad. Este cuaderno contiene
varias páginas: DDS seleccionado,
Valores Web (permite especificar
atributos que utiliza la herramienta
WebFacing), Comentarios y Lista de
errores.
Gerencia de Sistemas (c) 49
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE
Para trabajar con el
registro DDS MAIN:
En el árbol de DDS,
pulse el registro MAIN.
La pestaña Detalles
enumera todos los
campos del registro
MAIN y resume algunas
de sus propiedades.
La pestaña DDS
seleccionadas muestra
el código DDS del
registro MAIN.
Gerencia de Sistemas (c) 50
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: diseñar la pantalla DDS
Las páginas de Diseño permiten diseñar las pantallas o informes visualmente mediante una interfaz gráfica de
usuario intuitiva.
La página Diseño muestra el código fuente DDS tal como aparecería en una pantalla (en el caso de los archivos de
pantalla) o en una página impresa (en el caso de los archivos de impresora).
En la página Diseño, puede crear, editar, redimensionar y mover objetos DDS de forma gráfica y sencilla.
La barra de
herramientas situada en
la parte superior del
área de diseño permite
acceder rápidamente a
muchas de las funciones
de edición, así como a la
información relativa al
objeto seleccionado
actualmente.
Puede crear nuevos
registros, campos y
constantes directamente
en la página Diseño
utilizando los pulsadores
de la paleta situados a la
izquierda del área de
diseño o mediante los
menús emergentes.
Gerencia de Sistemas (c) 51
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: crear grupos a partir de registros existentes
Al abrir un miembro fuente mediante el Diseñador CODE , puede crear grupos que se correspondan con la manera
en que se utilizan los registros. En este ejemplo hemos agrupado los registros en los grupos: DATOS (pantallas
Main, MasDatos, PntInfad, InsForm), COSTO (pantalla PntCosto), INFO (pantallas Confirm, Info, Dummy).
Veamos como crear el grupo INFO.
Aparecerá el cuaderno Propiedades de grupo y la página Diseño,
en blanco, correspondiente al grupo SCREEN1.
En el cuaderno Propiedades de grupo, escribimos el nombre INFO
sobre SCREEN1; seleccionamos los registros CONFIRM, INFO y
DUMMY en la lista Disponibles y pulsamos el botón >> .
Desplácese al final del árbol DDS.
Pulse con el botón derecho en el grupo COSTO.
Pulse Insertar grupo en el menú emergente.
Gerencia de Sistemas (c) 52
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: crear grupos a partir de registros existentes
Cierre el cuaderno Propiedades de grupo. Pulse la X de la esquina superior derecha del cuaderno Propiedades de
grupo. Hemos finalizado la creación del grupo INFO. Ahora, podemos trabajar en la página Diseño con los
formatos de registro contenidos en este grupo.
Gerencia de Sistemas (c) 53
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: crear pantallas nuevas.
Para crear una nueva pantalla de registro en la página Diseño, es necesario crear un grupo que creará una
página vacía con la que podrá trabajar.
Para crear un nuevo grupo:
1. Pulse en el último
grupo con el botón
derecho del ratón en
el árbol de DDS.
2. Pulse Insertar grupo
en el menú
emergente. Aparecerá
el cuaderno
Propiedades de grupo
y también la página
Diseño, en blanco,
correspondiente al
grupo SCREEN1.
3. Cambie el nombre del
grupo por NUEVO y
cierre el cuaderno
Propiedades de grupo.
El programa utiliza varios registros para construir una sola pantalla o informe. Las DDS no recuerdan las
asociaciones entre registros; sin embargo, el Diseñador CODE le permite agrupar estos registros como una
sola unidad. Los grupos le permiten mantener agrupados todos los registros asociados a una pantalla mientras
trabaja. Puede agrupar un registro con otros registros, utilizarlo por separado o bien utilizarlo en más de un grupo.
Gerencia de Sistemas (c) 54
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: crear pantallas nuevas.
Página Diseño, en blanco, correspondiente al grupo NUEVO.
Puede crear elementos en la página Diseño seleccionando la herramienta
adecuada de la paleta de la izquierda y, a continuación, pulsando en la ubicación
de la página Diseño donde desea crear el elemento.
En este momento, la mayoría de los elementos están inhabilitados en la paleta,
debido a que no hay ningún registro en el que puedan crearse campos.
Los dos únicos botones disponibles son Crear registro estándar y Crear registro de
subarchivo.
Gerencia de Sistemas (c) 55
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: crear pantallas nuevas.
Pulse el botón Crear registro de subarchivo y pulse sobre el área de color gris
oscuro. Se creará un par formado por un subarchivo y un registro de control de
subarchivo.
Gerencia de Sistemas (c) 56
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: añadir campos al registro de subarchivo.
Pulse el campo superior, mantenga pulsado el
botón del ratón y muévalo a la fila 8, columna
5. Observe que la fila y columna actuales
Pulse el botón Crear campo con nombre y, a Aparecen justo encima del campo a medida que
continuación, pulse en cualquier lugar de la fila lo mueve.
8. Aparecerán seis campos en una columna
vertical. Esto es debido a que el subarchivo que
ha creado especifica actualmente un valor
SFLPAGE (tamaño de lista visible) de seis.
Desplace el ratón sobre el borde derecho del
campo. Se convierte en una flecha de dos
puntas. Mantenga pulsado el botón del ratón y
muévalo a la izquierda. El tamaño del campo se
reducirá. El tamaño actual aparecerá junto
encima del campo. Cuando el valor de tamaño
sea 3, suelte el botón del ratón.
Cambie el nombre del registro RECORD1 por NUEVOSFL y el del campo FIELD1 por
CODIGO escribiendo sobre el texto en cada lista.
Gerencia de Sistemas (c) 57
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: añadir campos al registro de subarchivo.
Pulse el botón para cambiar la
utilización del campo a entrada.
Crear una columna adicional: sitúe el cursor en la fila
8, columna 9. En el extremo inferior derecho de la
Pulse el botón Paleta de color y seleccione el color ventana Diseñador CODE muestra la posición actual del
rosa para cambiar el color del campo. cursor.
Escriba: +O(30) y pulse la flecha atrás para seleccionar
el texto que ha creado.
Observe en la página DDS seleccionado que ha creado
una constante de texto que contiene +O(30).
Pulse el botón Convertir serie a campo de la barra de herramientas
o pulse F11 para convertir la sintaxis SDA en un campo de salida
de tipo carácter de longitud 30.
Cambie el nombre del campo nuevo por NOMBRE mediante
la barra de herramientas.
Gerencia de Sistemas (c) 58
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: añadir campos al registro de subarchivo.
Pulse
A continuación,
botón derecho
añadiremos
sobre el un
campo
campo
añadido.
para elPulse
sueldo.
Escriba 66666666
Propiedades F4 en y
elpulse
menúflecha
emergente.
atrás. Pulse F11 para
convertir este campo en un campo numérico de salida.
Hemos convertido este campo en un campo numérico de salida con delimitadores de
coma, dos posiciones decimales, un símbolo de moneda y sin signo. Revise la página DDS
seleccionado para ver lo que se ha generado.
En la pestaña Edición, marcamos Utilizar código de
edición (EDTCDE). Seleccionamos código de edición
1 y Símbolo de moneda $.
Ponemos el nombre SUELDO al Campo. Indicamos
Longitud, 8.2.
Seleccionamos el color amarillo y presionamos Añadir.
Cerramos el cuadro Propiedades de campo.
El subarchivo aparece compactado a la izquierda. Sería mejor espaciarlo
uniformemente. Basta con que seleccione un campo y pulse el botón de espaciado
horizontal del extremo derecho de la barra de herramientas
Gerencia de Sistemas (c) 59
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: tamaño de subarchivo y página de subarchivo.
Inmediatamente debajo de la paleta de la izquierda hay tres selectores cíclicos. El superior, Tamaño de subarchivo, especifica el número
total de entradas de la lista que la aplicación rellenará. El segundo, Tamaño de página de subarchivo, indica cuántas entradas aparecen
en la pantalla.
En el campo Tamaño de subarchivo, escriba 9999 (el máximo tamaño).
En el campo Tamaño de página de subarchivo, escriba 10.
Pulse la página Diseño. La página Diseño se actualiza en consecuencia.
Gerencia de Sistemas (c) 60
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Conmutar entre varios registros.
A continuación, organizaremos el registro de control de subarchivo. El grupo que ha creado contiene 2 registros.
Cambie el registro actual seleccionando RECORD1CTL en la lista de registros o pulse Registro
siguiente o pulse Alt+Fin. Los campos del subarchivo siguen apareciendo para que la cabecera
de la columna
Cambie el nombre del registro pueda alinearse,
por NUEVOCTL mediante pero aparecen
la barra a media intensidad para distinguirlos de los
de herramientas.
campos del registro actual.
Puede comprobarlo
examinando la lista de
registros de la barra de Ahora necesitamosSitúe
un campo
el cursor
correspondiente
en 4, 9 y escriba:
al nombre
Situar del
en:
herramientas. empleado.
El método más sencillo es ¡la función copiar y pegar!
Gerencia de Sistemas (c) 61
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Conmutar entre varios registros, copiar y pegar campo.
En el árbol de DDS, expanda el registro NUEVOSFL.
Pulse el campo NOMBRE y pulse Control+C.
El menú emergente o el menú Editar también muestra el
elemento de menú Copiar.
Sitúe el cursor en 4, 23 y pulse Control+V.
Pulse el campo y cambie el nombre NOMBRE por POS_EN.
Gerencia de Sistemas (c) 62
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Añadir manejo de errores de campo.
Pulse el botón de cambiar los conjuntos El conjunto de indicadores
de indicadores con nombre en la barra de No existe está ahora en
herramientas de la página Diseño (o pulse vigor.
F7). Aparecerá la ventana Conjuntos de
indicadores con nombre . En el campo
Nombre de valores , escriba: No existe.
Pulse Crear.
Marque el recuadro de selección junto a 60
y pulse Aceptar.
A continuación, seleccione el campo POS_EN.
En la barra de herramientas, seleccione el
color rojo y los atributos de pantalla de
contraste invertido y situar cursor.
Examine el código DDS generado en la página DDS seleccionado.
Gerencia de Sistemas (c) 63
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Acceder a propiedades de campo.
Puede abrir un cuaderno de propiedades desde el menú Seleccionado, pulsando F4 efectuando una doble pulsación en cualquier
elemento del árbol de DDS, de la página Detalles o de la página Diseño.
Propiedades del registro MASDATOS
Propiedades del campo WCTIPVEH, pulsando F4
El cuaderno de propiedades le permite ver y actualizar las
propiedades del objeto DDS que está seleccionado.
Gerencia de Sistemas (c) 64
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Añadir palabras clave.
Pulse el campo
WXDIRECC en el Verá la página Detalles
árbol de DDS. correspondiente al campo
Pulse F5 o WXDIRECC y la pestaña Crear
utilice el menú palabras clave se añadirá al
emergente. cuaderno Programas de utilidad.
Esta página muestra el
subconjunto de palabras clave que
están permitidas para el campo
Seleccionado.
Con el cuaderno de propiedades
de WXDIRECC (pulsando F4),
Cambie de nuevo el campo WXDIRECC al tipo alfanumérico.
pulse el botón de campo numérico
Efectúe una doble pulsación sobre la palabra clave DFTVAL,
para cambiar el campo al tipo
en la pestaña Crear palabra clave. Cambie el valor predeterminado
numérico. Observe que la lista de
Al valor “Calle”. Observe el código en la pestaña DDS seleccionadas
palabras clave de la página Crear
palabras clave ha cambiado.
Gerencia de Sistemas (c) 65
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: verificar el código fuente.
Todo lo que CODE Designer añade al código fuente DDS tiene la sintaxis correcta. De todas formas, es necesario asegurarse de que no
existen errores semánticos. El código fuente DDS se comprueba mediante el mismo verificador utilizado por el editor LPEX.
Pulse Herramientas>Verificar archivo o pulse el botón de verificar en la barra de herramientas principal del menú.
En el árbol de DDS, hay una serie de X rojas Si se producen problemas, se mostrarán en la página Lista de
que indican el problema. errores del cuaderno Programas de utilidad. Pulse la pestaña
Lista de errores.
El icono de archivo
tiene una X roja,
así como el registro
MASDATOS.
Los campos
WJRECARC,
WJRECACA,
WJBOESRC,
WJBOESCA,
WJBONRES y la
tercera palabra Efectúe una doble pulsación sobre el aviso DDS7510 en la
clave RANGE; Lista de errores.
tienen una X roja.
Gerencia de Sistemas (c) 66
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: verificar el código fuente.
Se muestra la página Fuente y el cursor se sitúa exactamente Para corregir el error en el diseñador CODE. En el árbol de
en la ubicación del error en el código fuente. DDS efectúe doble pulsación en la palabra clave RANGE del
campo WJRECARC.
Corregimos el Valor inferior
y superior a 0 y 100
respectivamente.
Volvemos a verificar el código fuente y vemos que se corrigió
el error en el campo WJRECARC (ya no tiene X)
Gerencia de Sistemas (c) 67
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Conmutar entre el diseño y la edición de la pantalla.
Ha verificado el código fuente DDS e identificado un error en el código fuente, empleando Diseñador CODE.
Se muestra la página Fuente y el cursor se sitúa exactamente en la ubicación del error en el código fuente.
Pero la página Fuente es una vista con símbolos, de solo lectura, del estado actual del código fuente DDS.
Sería fantástico poder borrar directamente el error en la vista... Hay algunas acciones que son más rápidas en el
editor, y muchas otras que son más rápidas en el entorno visual.
Vamos a pasar de una modalidad a otra con sólo pulsar un botón.
Pulse Archivo > Editar fuente de DDS en el menú Pulse Control-F para abrir la ventana Buscar/Sustituir.
del editor En el campo Buscar, escriba RANGE y pulse Buscar.
Gerencia de Sistemas (c) 68
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Conmutar entre el diseño y la edición de la pantalla.
En el Editor, corregimos el Valor inferior y superior de RANGE,
a 0 y 100 respectivamente.
Pulse Control-N para buscar la siguiente aparición y
corregirla.
Gerencia de Sistemas (c) 69
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Conmutar entre el diseño y la edición de la pantalla.
Pulse Archivo > Diseñar fuente de DDS en el menú del editor.
Para retornar al Diseñador CODE.
Pulse Herramientas>Verificar archivo, para volver a
verificar el código fuente.
Ahora vemos que se corrigieron los errores (ya no tienen X)
en los campos WJRECARC, WJRECACA, WJBOESRC,
WJBOESCA y WJBONRES.
Gerencia de Sistemas (c) 70
Abrir un miembro DDS en la vista Sistemas remotos
Diseñador CODE: Compilar los cambios del código fuente y cerrar el diseñador.
Pulse Archivo > Guardar en el menú del diseñador para guardar el código fuente en el iSeries.
Pulse Herramientas > Compilar en el menú del diseñador y pulse Sin solicitud (o pulse el botón de compilar en la barra de
herramientas del diseñador CODE).
Un mensaje le avisa cuando la compilación ha finalizado. Pulse Aceptar en el diálogo Mensaje.
Para cerrar el diseñador.
Pulse Archivo > Salir en el menú del
diseñador.
Gerencia de Sistemas (c) 71
Proyecto Iseries
La perspectiva Proyectos i es la herramienta idónea para el desarrollo de aplicaciones iSeries basadas en equipo.
La perspectiva facilita la programación estructurada y permite el desarrollo desconectado.
En la perspectiva, puede supervisar la información de errores e inspeccionar las indicaciones de la hora para resolver conflictos entre
archivos remotos y locales.
También incluye la posibilidad de compilar miembros individuales (además de la función que permite construir proyectos completos).
Puede utilizar los proyectos de iSeries para organizar y estructurar su ciclo de desarrollo y para compartir código entre los miembros
del equipo.
volver
Gerencia de Sistemas (c) 72
Proyecto Iseries
Crear un proyecto iSeries
Se abre la perspectiva
Proyectos i.
Si no tiene abierta abierta la
perspectiva Proyectos i; pulse Ventana,
Pulse botón derecho, Nuevo, Abrir perspectiva, Proyectos i
Proyecto IBM i
Complete Nonbre de proyecto, pulse
Siguiente.
Complete Conexión y biblioteca asociada, pulse Se ha creado el proyecto Nueva
Siguiente. denuncia de siniestro.
Seleccione Programa CL, pulse Finalizar.
Gerencia de Sistemas (c) 73
Proyecto Iseries
Adicionar objetos a un proyecto iSeries
Pulse botón derecho sobre el
proyecto iSeries Nueva denuncia de
siniestro, en el menú emergente
pulse Mostrar objetos remotos
Seleccionamos los objetos que forman parte del proyecto:
QCLSRC/SICDENU05, QCMDSRC/SICDENU05,
QDDSSRC/SIUDENU05, QRPGLESRC/SIUDENU05.
Pulsar Añadir al proyecto.
Desmarcar la opción
Mostrar objetos remotos.
Nos quedan los objetos que
forman parte del proyecto.
Gerencia de Sistemas (c) 74
Proyecto Iseries
Trabajar con miembros fuente en forma local (desconectado)
Pulse botón derecho sobre el miembro fuente, pulse Abrir con,
pulse Editor LPEX de Sistemas Remotos
Para verificar modificaciones locales realizadas al código.
Pulse botón derecho sobre el miembro fuente, pulse
Comparar con, pulse Historia local...
Historia de cambios.
Diferencia entre miembros fuentes.
Gerencia de Sistemas (c) 75
Proyecto Iseries
Trabajar con miembros fuente en forma local (desconectado)
Para retrotraer un cambio realizado al código.
Pulse botón derecho sobre el miembro fuente,
pulse Sustituir por, pulse Anterior del historial
local o seleccione en Historia local...
Gerencia de Sistemas (c) 76
Proyecto Iseries
Transmitir cambios desde la estación local hacia el iSeries
Tomemos por ejemplo el miembro fuente EMUVEHPACL. Modificamos una línea de código en la estación local y vemos
que en el código del iSeries no está este cambio.
Para transmitir este cambio pulse botón derecho sobre el miembro fuente EMUVEHPACL, pulse Acciones remotas, pulse
Transmitir cambios. Si ya existe en el iSeries el miembro fuente, se abre un cuadro de diálogo para confirmar la acción.
Gerencia de Sistemas (c) 77
Proyecto Iseries
Transmitir cambios desde la estación local hacia el iSeries
¡ATENCIÓN !
Debe sincronizar con el servidor iSeries, al final del DIA, de lo contrario puede
perder el trabajo realizado en su estación local.
Gerencia de Sistemas (c) 78
Generar un Compilador de proyecto iSeries
Pulse botón derecho sobre el miembro fuente, pulse Acciones
remotas, pulse Generar COMPILE.CLLE.
Gerencia de Sistemas (c) 79
Compilar proyecto iSeries
Pulse botón derecho sobre el miembro fuente, pulse Acciones remotas, pulse
Someter construcción.
Se actualizan los miembros fuente y se
crean los objetos en el iSeries (todo en
bilbioteca YOSIAM).
Puede visualizar la pestaña Anotaciones de
mandatos de iSeries
Gerencia de Sistemas (c) 80