Guía de aprendizaje para la gestión de recursos de z/OS con el plugin IBM RSE API for Zowe CLI

Esta guía de aprendizaje no cubre todas las características del plugin RSE CLI, pero realiza una demostración de los métodos que puede aplicar cuando gestiona los recursos de z/OS.

Realizando esta guía de aprendizaje, aprenderá los siguientes métodos de gestión de los recursos de z/OS con el plugin RSE CLI:

• Guía de aprendizaje Gestión de recursos de z/OS con la CLI de IBM RSE API Plug-in for Zowe

  • Objetivos de aprendizaje

  • Escenario de la guía de aprendizaje

  • Tiempo necesario

  • Audiencia

  • Requisitos previos

  • Enfoque 1: Utilización de la extensión Zowe Explorer VS Cose para gestionar recursos de z/OS

  • Enfoque 2: Utilización de un terminal de línea de mandatos para gestionar recursos de z/OS

  • Enfoque 3: Utilización de un script para automatizar operaciones de línea de mandatos en recursos de z/OS

El escenario de la guía de aprendizaje está basado en una empresa ficticia que tiene aplicaciones escritas en COBOL. La empresa no tiene configurado z/OSMF en z/OS. Como alternativa, se ha instalado y configurado IBM Remote System Explorer API (RSE API) en z/OS. La empresa desea utilizar el plugin RSE CLI para interactuar con z/OS utilizando RSE API, en lugar de z/OSMF.

En este escenario, realizará lo siguiente:

• Importar código de aplicación a su máquina local.

• Enviar archivos JCL para ejecutar trabajos en z/OS.

• Listar conjuntos de datos.

• Subir archivos a conjuntos de datos.

• Comprobar el estado del trabajo.

• Descargar archivos de salida de trabajos.

Cada método tarda aproximadamente 10 minutos en completarse. Si explora otras características relacionadas con esta guía de aprendizaje, puede tardar más tiempo en completarse.

Esta guía de aprendizaje es para los desarrolladores del sistema principal que desean utilizar el soporte de RSE API que proporciona el plugin RSE CLI, como alternativa al uso de z/OSMF para gestionar los recursos de z/OS.

Antes de comenzar la guía de aprendizaje, debe completar las tareas siguientes:

1. Cree un perfil RSE. Para obtener instrucciones, consulte Creación de un perfil de RSE con la línea de mandatos o Configuración y utilización de perfiles de RSE para crear el perfil mediante Zowe Explorer.

2. Clone el repositorio de ejemplo y vaya a la rama tutorial-complete Git que tiene el conjunto actualizado final de programas y archivos de soporte para realizar las tareas que se describen en esta guía de aprendizaje siguiendo estos pasos:

   1. Clone el repositorio de ejemplo emitiendo el siguiente mandato en una ventana de línea de mandatos:

      git clone git@github.com:IBM/zopeneditor-sample.git

   2. cd en el directorio zopeneditor-sample que se acaba de clonar.

   3. Vaya a la ramificación tutorial-complete Git con el mandato:

      git checkout tutorial-complete

En esta sección se describe el procedimiento para gestionar los recursos de z/OS con la extensión Zowe Explorer VS Code.

Para comenzar a utilizar VS Code, asegúrese de que se ha instalado la extensión IBM Z® Open Editor VS Code y la extensión Zowe Explorer

VS Code. Para obtener más información, consulte Utilización del soporte de RSE en la extensión Zowe Explorer VS Code.

1. Abra VS Code, seleccione Archivo > Abrir carpeta (Windows) o Archivo > Abrir... (Mac) en la barra de menús superior y seleccione la carpeta zopeneditor-sample que se ha clonado.

   

   En la esquina inferior izquierda, asegúrese de que la rama Git seleccionada es la rama tutorial-complete. Si no está en esa rama, pulse la rama Git que se muestra y seleccione tutorial-complete u origin/tutorial-complete en la lista de ramas disponibles.

2. Abra la carpeta JCL dentro de VS Code y pulse ALLOCATE.jcl para editar el archivo ALLOCATE.jcl en la línea 16 y establezca el HLQ.

   

3. Pulse Terminal en la barra de menús superior de VS Code y luego seleccione Nuevo terminal para abrir el terminal.

4. Envíe el archivo ALLOCATE.jcl local especificando este mandato en el terminal:

   zowe rse submit local-file "./JCL/ALLOCATE.jcl"

5. Una vez enviado el trabajo, pulse el icono Zowe a la izquierda de VS Code. En la vista CONJUNTOS DE DATOS, pulse el símbolo + para añadir el perfil de RSE a la vista. Repita este paso con la vista JOBS.

   Una vez que el perfil de RSE aparezca en la ventana de la vista, pulse la lupa junto al nombre del perfil de RSE y escriba HLQ.SAMPLE* en la barra de búsqueda. Tiene que sustituir HLQ por la modificación que se ha hecho en ALLOCATE.jcl. Los conjuntos de datos creados por ALLOCATE.jcl se deberían mostrar en la vista Conjuntos de datos.

6. Puede comprobar el trabajo desde el JCL que se ha enviado pulsando la lupa que hay junto al perfil de RSE en la vista JOBS y especificando el HLQ que se ha añadido a ALLOCATE.jcl en la barra de búsqueda como filtro. Puede ver los archivos de spool abriendo el nombre de trabajo ZDEALLC y pulsando el archivo de spool para abrirlo en el Editor.

   

7. Cargue los archivos COBOL y el libro de copias en los conjuntos de datos creados, HLQ.SAMPLE.COBOL, HLQ.SAMPLE.COBCOPY y HLQ.SAMPLE.COPYLIB, después de sustituir HLQ por el valor especificado en ALLOCATE.jcl. Pulse con el botón derecho el conjunto de datos y seleccione el miembro que se ha de cargar. En el directorio zopeneditor-sample que se ha clonado, elija los archivos del directorio COBOL para el conjunto de datos HLQ.SAMPLE.COBOL y los archivos del directorio COPYBOOK para el conjunto de datos HLQ.SAMPLE.COBCOPY.

   

8. Copie y pegue los archivos siguientes en el directorio RESOURCES de zopeneditor-sample en el conjunto de datos secuencial adecuado con en la vista Conjuntos de datos de Zowe Explorer, sustituyendo HLQ por el valor especificado en ALLOCATE.jcl. Guarde los archivos en la vista de conjuntos de datos de Zowe Explorer para que se puedan cargar en z/OS.

   • RESOURCES/SAMPLE.CUSTFILE en el conjunto de datos secuencial HLQ.SAMPLE.CUSTFILE

   • RESOURCES/SAMPLE.TRANFILE en el conjunto de datos secuencial HLQ. SAMPLE TRANFILE

   

9. En el directorio JCL de zopeneditor-sample, repita la modificación en RUN.jcl en la línea 30 y establezca el HLQ con el mismo que se ha utilizado en ALLOCATE.jcl. Es posible que sea necesario, o no, modificar los otros símbolos, en función de las bibliotecas de compilación y enlace que utilice el sistema host. Puede o no cambiar los símbolos SPACE1 y SPACE2 y guardar el archivo.

10. Pulse Terminal en la barra de menús superior de VS Code y seleccione Nuevo terminal para abrir el terminal.

11. Envíe el archivo RUN.jcl local especificando este mandato en el terminal:

    zowe rse submit local-file "./JCL/RUN.jcl"

12. Visualice el estado del trabajo para el envío de RUN.jcl renovando la vista Trabajos de Zowe Explorer y seleccionando el nombre de trabajo ZDERUN.

13. Una vez finalizado el trabajo, renueve la vista Conjuntos de datos de Zowe Explorer para ver los nuevos conjuntos de datos que ha creado RUN.jcl. Estos conjuntos de datos incluyen los siguientes archivos, sustituyendo HLQ por el valor especificado en RUN.jcl.

    • HLQ.SAMPLE.CUSTOUT

    • HLQ.SAMPLE.CUSTRPT

    Para ver los archivos, pulse los archivos y ábralos en el editor.

14. Para descargar los archivos resultantes del trabajo, pulse Terminal en la barra de menús superior de VS Code y abra un terminal seleccionando Nuevo terminal y especifique los mandatos siguientes sustituyendo HLQ por el valor especificado en RUN.jcl.

    zowe rse download data-set "HLQ.SAMPLE.CUSTOUT"
    zowe rse download data-set "HLQ.SAMPLE.CUSTRPT"

    Vuelva a la vista Archivos a la carpeta abierta zopeneditor-sample y los archivos descargados estarán en una carpeta llamada como el valor HLQ especificado en los mandatos anteriores.

    

En esta sección se describe el procedimiento para gestionar los recursos de z/OS en un terminal de línea de mandatos.

1. Edite el archivo ALLOCATE.jcl en la línea 16 y establezca HLQ.

2. Envíe el JCL para que se ejecute en z/OS con el siguiente mandato:

   zowe rse submit local-file "./JCL/ALLOCATE.jcl"

   La salida del envío de trabajo se mostrará en el terminal con el ID de trabajo, el código de retorno, el nombre del trabajo y el estado del trabajo.

3. Obtenga una lista de los conjuntos de datos creados por el JCL sustituyendo HLQ por el valor establecido en ALLOCATE.jcl.

   zowe rse list data-set HLQ.SAMPLE*

   La salida debe ser la siguiente:

   HLQ.SAMPLE.COBCOPY
   HLQ.SAMPLE.COBOL
   HLQ.SAMPLE.CUSTFILE
   HLQ.SAMPLE.CUSTOUT
   HLQ.SAMPLE.CUSTRPT
   HLQ.SAMPLE.LOAD
   HLQ.SAMPLE.OBJ
   HLQ.SAMPLE.TRANFILE

4. Cargue los archivos del repositorio clonado en los conjuntos de datos recién creados, sustituyendo HLQ por el valor establecido en ALLOCATE.jcl.

   zowe rse upload dir-to-pds "./COBOL" "HLQ.SAMPLE.COBOL"

   zowe rse upload dir-to-pds "./COPYBOOK" "HLQ.SAMPLE.COBCOPY"

   zowe rse upload file-to-data-set "./RESOURCES/SAMPLE.CUSTFILE" "HLQ.SAMPLE.CUSTFILE"

   zowe rse upload file-to-data-set "./RESOURCES/SAMPLE.TRANFILE" "HLQ.SAMPLE.TRANFILE"

   Asegúrese de que la respuesta del terminal sea success: true para todas las cargas.

5. Realice la misma modificación en RUN.jcl en la línea 30 y establezca el HLQ con el mismo que se ha utilizado en ALLOCATE.jcl.

   Es posible que sea necesario, o no, modificar los otros símbolos, en función de las bibliotecas de compilación y enlace que utilice el sistema host. Puede o no cambiar los símbolos SPACE1 y SPACE2 y guardar el archivo.

6. Envíe el RUN.jcl con el mandato siguiente:

   zowe rse submit local-file "./JCL/RUN.jcl"

   a respuesta incluirá jobid. Para comprobar que el trabajo que ha completado, sustituya jobid en el mandato siguiente por el ID de trabajo devuelto y ejecútelo en la ventana de terminal:

   zowe rse view job-status-by-jobid jobid

7. Cuando estado del trabajo sea finalizado, descargue los archivos generados por el trabajo con los mandatos siguientes:

   zowe rse download data-set "HLQ.SAMPLE.CUSTOUT"
   zowe rse download data-set "HLQ.SAMPLE.CUSTRPT"

   Para ver los archivos descargados, escriba el mandato ls (Mac) o dir (Windows).

Puede realizar las mismas acciones que se describen en el método 1 en un script de shell. En esta sección se describe cómo crear y utilizar el script.

1. Edite el archivo ALLOCATE.jcl en la línea 16 y establezca HLQ.

2. Realice la misma modificación en RUN.jcl en la línea 30 y establezca el HLQ con el mismo que se ha utilizado en ALLOCATE.jcl. Es posible que sea necesario, o no, modificar los otros símbolos, en función de las bibliotecas de compilación y enlace que utilice el sistema host. Puede o no cambiar los símbolos SPACE1 y SPACE2 y guardar el archivo.

3. El script zowecli-cobol-upload-run-tutorial.sh se encuentra en el directorio SCRIPTS del repositorio clonado. Edite la variable HLQ del código en la línea 12 para que la modificación coincida con los archivos JCL.

4. Abra un terminal en VS Code y escriba SCRIPTS/zowecli-cobol-upload-run-tutorial.sh.

   

De forma alternativa, puede ejecutar este script con Zowe CLI, que utiliza z/OSMF en el host en lugar de RSE API. Para adaptar el script para su uso en la CLI de Zowe, cambie los valores de las variables FILES_CMD y JOBS_CMD en el script por lo siguiente:

• FILES_CMD="files"

• JOBS_CMD="jobs"