Realización de cambios de código COBOL y PL/I

Cuando visualiza el origen, puede utilizar la vista de esquema para explorar y navegar de forma eficaz por el código del programa. Si examina los elementos de esta vista, puede hacerse una idea de lo que lleva a cabo el programa en un alto nivel.

Cómo utilizarlo

Puede utilizar la vista de esquema sólo después de abrir un archivo o programa. Si la vista de esquema aún no se ha expandido, puede abrirla pulsando Vista > Abrir vista > Esquema.

Puede utilizar esta vista para:

• Expandir y contraer secciones como, por ejemplo, las cabeceras de división, las cabeceras de sección y los nombres de grupos de variables en la vista de esquema.

• Reconocer inclusiones, procedimientos y bucles rápidamente que se localizan mediante los iconos localizados por diferentes elementos.

• Ir a la ubicación del código que desee pulsando esta cabecera de sección en la vista.

• Ordenar por posición, nombre o tipo.

• Buscar identificadores en el esquema pulsando Ctrl+Mayús+O (Windows) o Cmd+Mayús+O (Mac) en la ventana del editor.

Cuando mueve el cursor por el programa, automáticamente se seleccionan los nodos del esquema. Para conmutar entre esta y otras características relacionadas con la vista de esquema, mueva el cursor por la esquina superior derecha de la vista de esquema. Puede ver la opción ..., donde puede pulsar para buscar varias opciones para organizar la vista de esquema como, por ejemplo, Seguir en cursor, Filtrar por tipo y Ordenar por nombre, posición y tipo.

Cuando escribe código, la función de terminación de código le proporciona una lista de coincidencias en la que puede seleccionar mandatos, variable definidas, nombres de párrafos y fragmentos de código.

Cómo utilizarlo

La sugerencia de terminación de código se muestra automáticamente mientras escribe o cuando pulsa Ctrl+Espacio (Windows y Mac) en función de los valores de preferencias.

Puede ver la definición de almacenamiento activa o la definición de DCL y el grupo padre de una variable o nombre de párrafo moviendo el cursor por la variable o el nombre de párrafo.

Cómo utilizarlo

De forma predeterminada, la ayuda contextual de la declaración está habilitada.

Puede previsualizar el contenido de un copybook o archivo de inclusión moviendo el cursor del ratón sobre el nombre del copybook en una sentencia COPY en COBOL y HLASM, o sobre el archivo de inclusión en una sentencia %INCLUDE en PL/I y REXX, sin tener que navegar fuera del archivo en el que está trabajando. Para abrir el archivo en un editor diferente, pulse Ctrl+Clic (Windows) o Cmd+Clic (Mac).

Cómo utilizarlo

Debe especificar la vía de acceso de archivo a los libros de copias o archivos de inclusión en los grupos de propiedades de archivo ZAPP para resolver las referencias. La ubicación puede ser local, como otro directorio en su espacio de trabajo, o puede ser un conjunto de datos MVS en un sistema remoto z/OS utilizando la conectividad Zowe para encontrar y cargar los archivos.

Si no se especifica ninguna vía de acceso o no se encuentran los libros de copias o los archivos de inclusión en la vía de acceso proporcionada, se muestra un error (marca roja). Para resolverlo, siga las instrucciones proporcionadas y nuestras páginas Visión general de ZAPP y Grupos de propiedades .

Puede previsualizar cómo expandirá el compilador los copybooks en su programa COBOL. Los resultados se mostrarán en una nueva pestaña del editor para un archivo temporal que muestra cómo se insertarán los copybooks en el código y se ampliarán las sentencias REPLACING .

Cómo utilizarlo

• Abra un programa COBOL que incluya copybooks.

• Abra el menú contextual haciendo clic con el botón derecho del ratón o pulsando Mayúsculas + F10 (en Windows y Mac) dentro del editor. Una vez abierto el menú contextual, navegue hasta la opción Expandir código fuente y ejecútela.

  Se abre una nueva pestaña del editor, añadiendo "expanded_COBOL" al nombre del archivo para mostrar los resultados. Verá copybooks dentro del texto del programa con comentarios adicionales que enumeran la ubicación de origen del archivo incluido. Dentro del programa, los nombres de las variables se sustituyen por los valores de REPLACING si se especifican en la sentencia original COPY .

Puede previsualizar cómo el compilador expande los includes y las macros en su programa PL/I. Los resultados se muestran en una nueva pestaña del editor para un archivo temporal que muestra cómo se insertan los includes y las macros en el código.

Cómo utilizarlo

• Abra un programa PL/I que contenga includes y/o macros.

• Abra el menú contextual haciendo clic con el botón derecho del ratón o pulsando Mayúsculas + F10 dentro del editor. Una vez abierto el menú contextual, navegue hasta la opción Expandir código fuente y ejecútela.

  Se abre una nueva pestaña del editor, añadiendo " expanded_pl1 " al nombre del archivo original para mostrar los resultados. La pestaña muestra el contenido de la inclusión y la macro dentro del texto del programa, con comentarios adicionales que enumeran la ubicación de origen de cada archivo incluido.

Cuando pulsa dos veces una variable o nombre de párrafo para resaltar el nombre completo y, a continuación, lo pulsa con el botón derecho, puede ver las operaciones disponibles.

Cómo utilizarlo

• Pulse Cambiar todas las apariciones: Control+F2 (Windows) o Cmd+F2 (Mac)

  Cuando escribe el nuevo nombre, todas las apariciones se cambian de forma simultánea.

  NOTA:: En la barra de desplazamiento del lado derecho del editor, cada aparición se indica con una barra de ubicación.

• Pulse Buscar todas las referencias: Alt+Mayús+F12 (Windows) u Opción+ Mayús+ F12 (Mac)

  Se muestra una vista de referencias de resultados para la variable o párrafo a la izquierda de la pantalla. Pulse cualquier resultado para ir a esta ubicación del archivo.

• Pulse Elegir referencias: Mayús+F12 (Windows y Mac)

  Se abre una vista de referencias de resultados en el recuadro CodeLens bajo la variable o el párrafo. Pulse cualquier resultado para ir a esta ubicación del archivo.

  

• Pulse Ir a la definición: F12 (Windows y Mac)

  Vaya a la ubicación donde está definida la variable o el párrafo. Se abre el libro de copias o el archivo de inclusión, si es aplicable.

• Pulse Ir al símbolo: Control+Mayús+ O (Windows) o Cmd+Mayús+O (Mac)

  Cuando especifica un nombre de objeto en la barra de búsqueda o se desplaza por los elementos para seleccionar el objeto, el cursor se traslada a dicha ubicación.

• Pulse Elegir definición: Alt+F12 (Windows) u Opción+F12 (Mac)

  Se abre un recuadro CodeLens que muestra dónde se ha definido la variable o el párrafo en el código. Si utiliza el acceso directo del teclado Alt+ F12 (Windows) u Opción+F12 (Mac), la variable o el nombre de párrafo sólo se pulsan una vez antes de pulsar los accesos directos del teclado. Pulse dos veces cualquier resultado para ir a esta ubicación del archivo.

  

• Haga clic en Mostrar jerarquía de llamadas : Alt+Mayús+H (Windows) u Opción+Mayús+H (Mac)

  Esta acción muestra la jerarquía de llamadas de un COBOL o PL/I programa en la vista Referencias, comenzando por el párrafo o sección seleccionados ( COBOL ) o el procedimiento o paquete seleccionados ( PL/I ).

• Pulse Cambiar nombre de símbolo: F2 (Windows y Mac)

  Cambie el nombre del símbolo seleccionado y los cambios se realizarán en todo el programa y el libro de copias o archivo de inclusión si está conectado a este símbolo.

La característica de comprobación de sintaxis marca las sentencias y expresiones no reconocidas en rojo, lo que ayuda a realizar correcciones rápidas y a reducir los errores de compilación.

La comprobación de sintaxis también funciona para palabras reservadas de COBOL y nombres de variables desconocidos. Para HLASM, hay errores de sintaxis para espacios incorrectos en una línea de continuación y sentencias de copia no resueltas.

Cómo utilizarlo

Para ver todos los errores de sintaxis en los archivos abiertos, abra la vista Problemas mediante el menú Ver o pulsando el icono de error y aviso en la parte inferior de la barra de estado. Pulse dos veces el elemento de la lista para ir directamente al problema.

Al escribir aplicaciones internacionales con constantes de cadena que contengan caracteres de doble byte shift-in/shift-out, Z Open Editor ayudará a los desarrolladores a garantizar que las líneas del programa COBOL no superen la longitud máxima de línea configurada para el editor.

Lo hará de dos maneras:

1. Los conjuntos de caracteres que ocupan más de un byte se visualizarán automáticamente en el editor con anotaciones guillemets especiales (« »). Estas anotaciones sólo le ayudan a identificar los caracteres. No son caracteres reales del programa y no se almacenarán con él. Además, cuando copie y pegue el texto en otro editor, no se añadirán al portapapeles.

2. Cuando empiece a escribir estos caracteres, la barra de estado empezará a mostrar automáticamente una entrada de recuento de bytes que le muestra cuántos bytes le quedan antes de alcanzar la longitud máxima de línea.

Revise también páginas de códigos EBCDIC y archivos de asignación con ejemplos para convertir caracteres de doble byte de EBCDIC a UTF-8 y viceversa cuando trabaje con archivos de z/OS MVS y UNIX System Services.

Puede deshacer sus cambios pulsando Ctrl+Z (Windows) o Cmd+Z (Mac). Puede rehacer sus cambios pulsando Ctrl+Mayús+Z (Windows) o Cmd+Shift+Z (Mac).

La función Renumerar/Desnumerar solo se aplica a COBOL y renumerará las líneas en el archivo COBOL. Hay una opción en las preferencias para controlar qué columnas tendrán los números de secuencia insertados y eliminados. El usuario selecciona las columnas 1-6, 73-80 o ambas. La numeración se iniciará con 100 y se incrementará cada línea en 100 mientras se conservan los marcadores no numéricos. Esta función equivale a activar la modalidad de número en ISPF.

La función Unnumber de COBOL eliminará la numeración de líneas en las columnas 1-6, 73-80 o ambas mientras se conservan los marcadores no numéricos. Esta función equivale a desactivar la modalidad de número en ISPF.

Cómo utilizarlo

Para configurar las preferencias en los valores de Z Open Editor para qué columnas desea renumerar y desnumerar, modifique los valores de la forma siguiente.

1. Abra los valores:

   • Windows: Archivo > Preferencias > Configuración

   • Mac: Código > Preferencias > Configuración

2. En el lado izquierdo de la interfaz de configuración abierta, expanda Extensiones de la lista de categorías y pulse IBM Z Open Editor. En los valores de IBM Z Open Editor, en COBOL: Números de secuencia, pulse el menú desplegable para seleccionar una preferencia.

3. Pulse la opción adecuada para especificar la ubicación de los números de secuencia que se insertan y se eliminan de un archivo mediante las acciones de volver a numerar y anular numeración del editor. Las opciones son las siguientes:

   • column-1: La numeración de secuencia empieza en la columna 1 y rellenará las columnas 1-6.

   • column-73: la numeración de secuencia empieza en la columna 73 y rellenará las columnas 73-80.

   • column-1-and-73: La numeración de secuencia comienza en la columna 1 y 73, y rellenará las columnas 1-6 y 73-80.

Para numerar o renumerar un archivo COBOL, haga clic con el botón derecho del ratón en el archivo en el editor y seleccione el comando Renumber Sequence Numbers comando. Para anular la numeración del archivo COBOL, haga clic con el botón derecho del ratón en el archivo en el editor y seleccione el comando Unnumber Sequence Numbers comando.

Puede comentar y descomentar el código COBOL utilizando el atajo de teclado. Este método funciona tanto para comentarios de una sola línea como para comentarios de bloque de varias líneas.

Cómo utilizarlo

Para comentar el código COBOL :

1. En un archivo COBOL, coloque el cursor donde desee añadir un comentario de una sola línea, o haga clic y seleccione el código o el texto donde desee comentar un bloque de código.

2. Pulse Ctrl +/(Windows) o Cmd +/(Mac).

Para descomentar el código COBOL :

1. Seleccione el código que está comentado actualmente.

2. Pulse Ctrl +/(Windows) o Cmd +/(Mac).

El plegado de código es una función que permite a los usuarios mostrar u ocultar secciones lógicas del código fuente de COBOL, lo que facilita que los usuarios se centren en el código en el que están trabajando. Las secciones lógicas del código fuente de COBOL incluyen, entre otras, las sentencias DIVISION, SECTION, PARAGRAPH, IF, ELSE, WHEN, DO, DATA-ITEMS y EXEC SQL/ CICS.

Cómo utilizarlo

Puede plegar regiones del código fuente de COBOL utilizando los iconos de plegado situados en el medianil entre los números de línea y el inicio de línea. Mueva el ratón sobre la cuneta y haga clic para plegar y desplegar las regiones. Utilice Shift + Click en el icono de plegado para plegar o desplegar la región y todas las regiones en su interior. Para obtener información más detallada sobre el plegado de código, consulte la documentación sobre plegado de código de VS Code.

COBOL el plegado de código está activado por defecto. Para desactivarlo, utilice el ajuste zopeneditor.cobol.enableCodeFolding.

El plegado de código es una función que permite a los usuarios mostrar u ocultar secciones lógicas del código fuente de PL/I, lo que facilita que los usuarios se centren en el código en el que están trabajando. Las secciones lógicas del código fuente de PL/I incluyen los bloques IF, ELSE, DO, SELECT, WHEN, OTHERWISE, PACKAGE, BEGIN, PROCEDURE y ON.

Para determinadas sentencias COBOL EXEC CICS que hacen referencia a recursos CICS, como programas CICS y archivos CICS, aparece un CodeLens encima de la sentencia. Al hacer clic en CodeLens se abre el Inspector de recursos CICS para el recurso instalado, lo que le permite comprobar que está instalado y ver sus atributos.

NOTA Debe tener la extensión IBM CICS para Zowe Explorer instalada en VS Code.

Puede comentar una o varias líneas de código seleccionadas o una sección de código seleccionada utilizando la función de conmutar comentario.