Guía de IBM Rational Developer for i
Guía de IBM Rational Developer for i
Versión: 7.5.0
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
volver
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,
[Link] 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.
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.
2. Seleccione
Todos los Programas > IBM Software Delivery Platform > IBM Rational
Developer for i > IBM Rational Developer for i.
volver
volver
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.
volver
Pulse el signo +
situado junto a
Trabajar con
miembros .
volver
Filtros de miembros
fuente.
Si pulsa Editar > Rehacer en el menú del entorno de trabajo. Observará que las
líneas se suprimen de nuevo.
Sitúe el cursor sobre la palabra EVAL del código fuente ILE RPG.
Presione F1.
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.
Complete Factor 1,
presione Enter.
Doble pulsación sobre la
operación seleccionada.
Ahora, solo se visualizan todas las líneas que contienen la serie PcAsegur.
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.
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.
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.
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.
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
Este error se produce por que no están en la lista de bibliotecas; las bibliotecas SRCPSSEG y EMISRC.
volver
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.
Se abrirá la perspectiva Depuración. En caso contrario, puede que vea este mensaje de error.
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).
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.
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.
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?
volver
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.
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.
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.
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.
Cambie el nombre del registro RECORD1 por NUEVOSFL y el del campo FIELD1 por
CODIGO escribiendo sobre el texto en cada lista.
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.
A continuación, organizaremos el registro de control de subarchivo. El grupo que ha creado contiene 2 registros.
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.
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.
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.
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.
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.
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.
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.
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
Se abre la perspectiva
Proyectos i.
Desmarcar la opción
Mostrar objetos remotos.
Nos quedan los objetos que
forman parte del proyecto.
Historia de cambios.
Diferencia entre miembros fuentes.
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.
¡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.
Pulse botón derecho sobre el miembro fuente, pulse Acciones remotas, pulse
Someter construcción.
El verificador de sintaxis comprueba los errores semánticos en la estación de trabajo para garantizar una compilación sin errores en el iSeries, lo cual resulta particularmente útil al escribir código de forma desconectada. Inserta los mensajes de error directamente en el código fuente, facilitando la navegación por ellos y brindando información relevante como la gravedad del error. Esta funcionalidad permite a los desarrolladores corregir errores antes de la compilación en el sistema remota, mejorando así la eficiencia y el flujo de trabajo .
El Diseñador CODE permite a los desarrolladores diseñar gráficamente pantallas e informes y generar el código fuente DDS necesario, agrupando registros relacionados. Esto simplifica el proceso de desarrollo de interfaces complejas y asegura la consistencia visual en los diseños. La posibilidad de crear, modificar y agrupar registros visualmente incrementa la eficiencia del desarrollo y minimiza la probabilidad de errores de diseño, al hacer evidente la estructura de los registros involucrados .
Las herramientas de gestión de errores son esenciales en un entorno de desarrollo de iSeries porque permiten a los desarrolladores identificar, clasificar y corregir errores de manera eficiente antes de la compilación final. Esto incluye verificar errores semánticos, gestionar bibliotecas y analizar mensajes de error con severidades específicas. Mejorar la gestión de errores contribuye significativamente a la calidad del producto final al asegurar que sólo el código correcto llegue al entorno de producción, disminuyendo fallos post-despliegue .
Para añadir bibliotecas en RDi, se debe hacer clic derecho sobre la Lista de Bibliotecas, seleccionar Añadir entrada y luego añadir las bibliotecas necesarias, como YOSIAM, SRCPSSEG y EMISRC. Esto es clave para resolver errores como el RNF0273, que ocurre cuando las bibliotecas no están en la lista, evitando así errores de compilación relacionados con la falta de referencia a bibliotecas necesarias que contienen definiciones específicas .
Ajustar dinámicamente los campos al trabajar con subarchivos en RDi permite a los desarrolladores administrar eficientemente el espacio y alineación de contenido, asegurando que la información se presente de manera clara y accesible. Modificar el tamaño y posición de los campos mejora la representación visual y la interacción con el usuario final, optimizando la experiencia general de uso de la aplicación .
Modificar el tamaño de subarchivos en RDi permite a los desarrolladores especificar cuántas entradas se mostrarán, mejorando así la organización y presentación de datos en la interfaz de usuario. Al ajustar el tamaño del subarchivo y el tamaño de su página, se optimiza el uso del espacio en pantalla, facilitando la navegación y comprensión de grandes conjuntos de datos por parte de los usuarios finales, lo cual es crucial para la usabilidad y la eficiencia de las aplicaciones de usuario .
La capacidad de editar esquemas de miembros fuente remotamente en un entorno iSeries es crucial porque permite a los desarrolladores realizar cambios y actualizaciones en los archivos fuente sin necesidad de acceso físico al sistema. Esto no solo mejora la flexibilidad al trabajar en proyectos distribuidos, sino que también acelera el proceso de desarrollo y mantiene la uniformidad y consistencia en los cambios realizados, asegurando que todos los desarrolladores trabajen en la misma versión del código .
La perspectiva del Explorador de Sistemas Remotos en RDi permite a los desarrolladores visualizar y controlar lo que aparece en los menús y barras de herramientas, accediendo fácilmente a los sistemas remotos IBM i. Esto es esencial para ejecutar mandatos, compilar código, y modificar archivos directamente desde una ubicación centralizada, lo que optimiza la gestión de proyectos e integra diferentes herramientas de desarrollo en un entorno común .
Los filtros de gravedad en las vistas de errores permiten a los desarrolladores priorizar la corrección de errores según su impacto potencial en el funcionamiento del programa. Al clasificar errores por niveles de gravedad, se facilita una atención más enfocada en problemas críticos primero, lo que optimiza el flujo de trabajo y acelera el proceso de depuración, reduciendo el tiempo total de desarrollo y asegurando que los problemas más serios se resuelvan de manera oportuna .
Las herramientas de depuración integradas en RDi permiten a los desarrolladores establecer puntos de interrupción, examinar variables y recorrer instrucciones del programa interactivamente. Esto facilita una identificación precisa y rápida de errores dentro del contexto del programa. Los desarrolladores pueden evaluar el flujo de ejecución del programa en detalle, lo que es esencial para corregir errores de lógica y asegurar que el programa se comporte como se espera en el entorno iSeries .