En aquest tema, aprendrem com afegir comentaris en els nostres scripts JCL i com continuar línies llargues en múltiples línies per mantenir el codi llegible i organitzat.

Comentaris en JCL

Els comentaris són línies de text que no són processades pel sistema, però que ajuden els programadors a entendre el codi. En JCL, els comentaris es poden afegir de dues maneres principals:

  1. Comentaris de Línia Completa: Utilitzant la declaració //*.
  2. Comentaris In-line: Utilitzant el caràcter /* dins d'una línia de codi.

Comentaris de Línia Completa

Els comentaris de línia completa comencen amb //* i poden ocupar tota la línia. Aquests comentaris són útils per proporcionar descripcions generals o notes sobre el codi.

Exemple:

//JOB1    JOB  (ACCT),'Example Job',CLASS=A,MSGCLASS=X
//* Aquest és un comentari de línia completa
//STEP1   EXEC PGM=MYPROG
//* Un altre comentari explicant el pas
//DD1     DD   DSN=MY.DATA.SET,DISP=SHR

Comentaris In-line

Els comentaris in-line es poden utilitzar dins d'una línia de codi, començant amb /* i acabant amb */. Aquests comentaris són útils per explicar parts específiques d'una línia de codi.

Exemple:

//JOB1    JOB  (ACCT),'Example Job',CLASS=A,MSGCLASS=X
//STEP1   EXEC PGM=MYPROG /* Executa el programa MYPROG */
//DD1     DD   DSN=MY.DATA.SET,DISP=SHR /* Conjunt de dades compartit */

Continuació de Línies

En JCL, les línies de codi poden tenir una longitud màxima de 80 caràcters. Si una línia és massa llarga, es pot continuar en la següent línia utilitzant el caràcter de continuació // en la posició 72.

Regles per a la Continuació de Línies

  1. La línia original ha de tenir el caràcter // en la posició 72.
  2. La línia de continuació ha de començar amb // seguit d'un espai en blanc.
  3. La continuació ha de començar en la posició 4 de la nova línia.

Exemple:

//JOB1    JOB  (ACCT),'Example Job',CLASS=A,MSGCLASS=X
//STEP1   EXEC PGM=MYPROG
//DD1     DD   DSN=MY.VERY.LONG.DATA.SET.NAME,DISP=SHR,
//         //   UNIT=SYSDA,SPACE=(CYL,(50,10))

Exemple Pràctic

A continuació, es mostra un exemple pràctic que combina comentaris i continuació de línies:

//JOB1    JOB  (ACCT),'Example Job',CLASS=A,MSGCLASS=X
//* Aquest treball executa un programa exemple
//STEP1   EXEC PGM=MYPROG /* Executa el programa MYPROG */
//DD1     DD   DSN=MY.VERY.LONG.DATA.SET.NAME,DISP=SHR, /* Conjunt de dades compartit */
//         //   UNIT=SYSDA,SPACE=(CYL,(50,10)) /* Espai assignat en cilindres */

Exercicis Pràctics

Exercici 1: Afegir Comentaris

Afegiu comentaris adequats a les següents línies de JCL:

//MYJOB   JOB  (ACCT),'Job with Comments',CLASS=B,MSGCLASS=Y
//STEP1   EXEC PGM=MYPROG
//DD1     DD   DSN=MY.DATA.SET,DISP=OLD

Solució:

//MYJOB   JOB  (ACCT),'Job with Comments',CLASS=B,MSGCLASS=Y
//* Aquest treball executa un programa exemple
//STEP1   EXEC PGM=MYPROG /* Executa el programa MYPROG */
//DD1     DD   DSN=MY.DATA.SET,DISP=OLD /* Conjunt de dades en mode OLD */

Exercici 2: Continuar Línies

Dividiu la següent línia de JCL en múltiples línies utilitzant la continuació de línies:

//DD1     DD   DSN=MY.VERY.LONG.DATA.SET.NAME,DISP=SHR,UNIT=SYSDA,SPACE=(CYL,(50,10))

Solució:

//DD1     DD   DSN=MY.VERY.LONG.DATA.SET.NAME,DISP=SHR,
//         //   UNIT=SYSDA,SPACE=(CYL,(50,10))

Conclusió

En aquesta secció, hem après com afegir comentaris en els nostres scripts JCL per fer-los més llegibles i comprensibles. També hem vist com continuar línies llargues en múltiples línies per mantenir el codi organitzat. Aquests conceptes són fonamentals per escriure JCL clar i mantenible. En el següent mòdul, explorarem les declaracions de definició de dades (DD) en profunditat.

© Copyright 2024. Tots els drets reservats