El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia
HOME Mis cursos Finalizados
◄ Anterior
◄

Comentarios y Continuación

Siguiente ►
►

En este tema, aprenderemos cómo agregar comentarios en JCL y cómo manejar la continuación de líneas largas. Estos son aspectos esenciales para mantener la claridad y la legibilidad de tus trabajos JCL, especialmente cuando trabajas con scripts complejos.

Comentarios en JCL

Los comentarios en JCL son útiles para documentar el propósito y la funcionalidad de las declaraciones dentro de un trabajo. Esto es especialmente importante en entornos de trabajo colaborativos o cuando necesitas revisar y mantener trabajos JCL a largo plazo.

Sintaxis de Comentarios

En JCL, los comentarios se indican con dos asteriscos (//*) al inicio de la línea. Todo lo que sigue a estos caracteres en la línea se considera un comentario y no se ejecuta.

Ejemplo de Comentario

//JOB1    JOB  (ACCT),'EXAMPLE JOB',CLASS=A,MSGCLASS=X
//* Este es un comentario que describe el trabajo
//STEP1   EXEC PGM=MYPROGRAM
//* Este comentario describe el paso 1
//DD1     DD   DSN=MY.DATA.SET,DISP=SHR
//* Este comentario describe la declaración DD

En el ejemplo anterior:

  • //* Este es un comentario que describe el trabajo es un comentario que proporciona información sobre el trabajo.
  • //* Este comentario describe el paso 1 es un comentario que describe el paso de ejecución.
  • //* Este comentario describe la declaración DD es un comentario que describe la declaración de definición de datos.

Continuación de Líneas

En JCL, las líneas tienen una longitud máxima de 80 caracteres. Si necesitas escribir una declaración que exceda este límite, puedes continuar la línea en la siguiente utilizando un carácter de continuación.

Sintaxis de Continuación

Para continuar una línea, utiliza un carácter de continuación (//) en la siguiente línea. La continuación debe comenzar en la columna 4 de la nueva línea.

Ejemplo de Continuación de Línea

//STEP1   EXEC PGM=MYPROGRAM,PARM='LONGPARAMETERSTRING,ANOTHERPARAMETER,
/*        YETANOTHERPARAMETER'

En el ejemplo anterior:

  • La declaración EXEC se continúa en la siguiente línea utilizando /* en la columna 4.

Ejemplo Completo

A continuación, se muestra un ejemplo completo que incluye comentarios y continuación de líneas:

//MYJOB   JOB  (ACCT),'EXAMPLE JOB',CLASS=A,MSGCLASS=X
//* Este trabajo ejecuta un programa con parámetros largos
//STEP1   EXEC PGM=MYPROGRAM,PARM='LONGPARAMETERSTRING,ANOTHERPARAM,
/*        YETANOTHERPARAMETER'
//* Definición de un conjunto de datos con un nombre largo
//DD1     DD   DSN=MY.LONG.DATASET.NAME,DISP=(NEW,CATLG,DELETE),
//*        SPACE=(CYL,(50,10)),UNIT=SYSDA

En este ejemplo:

  • Los comentarios proporcionan contexto sobre el trabajo y las declaraciones.
  • La línea EXEC se continúa en la siguiente línea debido a la longitud del parámetro.
  • La declaración DD también se continúa en la siguiente línea para mantener la legibilidad.

Ejercicio Práctico

Ejercicio 1: Agregar Comentarios

Dado el siguiente trabajo JCL, agrega comentarios que describan cada parte del trabajo:

//MYJOB   JOB  (ACCT),'EXAMPLE JOB',CLASS=A,MSGCLASS=X
//STEP1   EXEC PGM=MYPROGRAM
//DD1     DD   DSN=MY.DATA.SET,DISP=SHR

Solución del Ejercicio 1

//MYJOB   JOB  (ACCT),'EXAMPLE JOB',CLASS=A,MSGCLASS=X
//* Este trabajo ejecuta un programa llamado MYPROGRAM
//STEP1   EXEC PGM=MYPROGRAM
//* Definición de un conjunto de datos existente
//DD1     DD   DSN=MY.DATA.SET,DISP=SHR

Ejercicio 2: Continuar una Línea

Dado el siguiente trabajo JCL, continúa la línea EXEC para que sea más legible:

//STEP1   EXEC PGM=MYPROGRAM,PARM='LONGPARAMETERSTRING,ANOTHERPARAMETER,YETANOTHERPARAMETER'

Solución del Ejercicio 2

//STEP1   EXEC PGM=MYPROGRAM,PARM='LONGPARAMETERSTRING,ANOTHERPARAM,
/*        YETANOTHERPARAMETER'

Conclusión

En esta sección, hemos aprendido cómo agregar comentarios en JCL para mejorar la documentación y la legibilidad de los trabajos. También hemos visto cómo manejar la continuación de líneas largas para mantener el código organizado y fácil de leer. Estos conceptos son fundamentales para escribir trabajos JCL claros y mantenibles.

En el próximo módulo, profundizaremos en las declaraciones y la sintaxis de JCL, comenzando con la declaración JOB.

◄ Anterior
◄
Siguiente ►
►
El Proyecto | Sobre nosotros | Contribuir | Donaciones | Licencia
© Copyright 2024. Todos los derechos reservados