Manual Básico COBOL.txt CCCCCCCC CCCCCCCC CC CC CCCCCCCC CCCCCCCC OOOOOOO OOOOOOOOO OO OO OO OO OOOOOOOOO OOOOOOO BBBBBBB BBBBBBBB BB BB BBBBBBBB BB BB BBBBBBBB OOOOOOO OOOOOOOOO OO OO OO OO OOOOOOOOO OOOOOOO LL LL LL LL LLLLLLLL LLLLLLLLL I INDICE ANOTACIONES SOBRE ASPECTOS RELEVANTES DEL COBOL II. Cambios en el lenguaje cobol en 1.985 .................... 1 Formatos de programa fuente .............................. 1 PROGRAMA ANIDADO. Programa anidado ......................................... 1 CAMBIOS EN LA IDENTIFICATION DIVISION. Cambios en la Identification Division .................... 1 CAMBIOS EN LA DATA DIVISION. Comparticion de datos .................................... 2 Nuevas clausulas en la definicion de items .......... 2 Niveles de tablas ................................... 3 Página 1
Transcript
Manual Básico COBOL.txt
CCCCCCCC CCCCCCCC CC CC CCCCCCCC CCCCCCCC
OOOOOOO OOOOOOOOO OO OO OO OO OOOOOOOOO OOOOOOO
BBBBBBB BBBBBBBB BB BB BBBBBBBB BB BB BBBBBBBB
OOOOOOO OOOOOOOOO OO OO OO OO OOOOOOOOO OOOOOOO
LL LL LL LL LLLLLLLL LLLLLLLLL
I
INDICE
ANOTACIONES SOBRE ASPECTOS RELEVANTES DEL COBOL II.
Cambios en el lenguaje cobol en 1.985 .................... 1 Formatos de programa fuente .............................. 1
PROGRAMA ANIDADO.
Programa anidado ......................................... 1
CAMBIOS EN LA IDENTIFICATION DIVISION.
Cambios en la Identification Division .................... 1
CAMBIOS EN LA DATA DIVISION.
Comparticion de datos .................................... 2 Nuevas clausulas en la definicion de items .......... 2 Niveles de tablas ................................... 3
Página 1
Manual Básico COBOL.txt
CAMBIOS EN LA PROCEDURE DIVISION.
Operaciones de condicion ................................. 3 Otras condiciones ........................................ 4 Terminadores explicitos de sentencias .................... 4 Llamada a subprogramas ................................... 4 LLamadas estaticas ....................................... 5 LLamadas dinamicas ....................................... 5 Sentencia cancel ......................................... 5 Sentencia evaluate ....................................... 6 Consideraciones sobre la evaluate ........................ 6 Ejemplos de evaluate ................................ 7 Sentencia initialize ..................................... 8 Nueva opciones de la perform ............................. 9 Aspectos adicionales ..................................... 10 Depuracion con cobol II .................................. 11 Interactivamente .................................... 11 Batch ............................................... 11 Compilacion ......................................... 12 Compilaciones con programas secundarios .................. 12 Llamada entre programas cobol II ......................... 12 Transfiriendo control a otros programas .................. 13 Programa principal y subprogramas ........................ 13
II
LLAMANDO PROGRAMAS.
Llamando programas ....................................... 15 Programas anidados ....................................... 16 Estructura de programas anidados ......................... 16 Ejemplo .................................................. 17 Normas para el uso de estructura de programas anidados ... 18 Llamando a programas anidados ............................ 18 Ejemplo .................................................. 19
CALL ESTATICAS Y DINAMICAS.
Call estaticas y dinamicas ............................... 20 Utilizando call estatica ................................. 20 Utilizando call dinamica ................................. 20 Compartiendo datos usando el atributo external ........... 22 Pasando datos mediante by refence or by content .......... 22 Describiendo items comunes en el programa llamante ....... 23 Describiendo datos comunes en el programa llamado ........ 24 Linkage section .......................................... 24
Tablas ................................................... 35 Tablas de longitud variable .............................. 36 Descripcion de una tabla ................................. 36 Tablas de mas de una dimension ........................... 37 Tablas de mas de una dimension ........................... 37 Indexacion ............................................... 38 Declaracion 'SET' ........................................ 38 Declaracion 'SEARCH' ..................................... 39
III
Opcion 'VARYING' ......................................... 41 Tablas definidas con mas de un indice .................... 41 Busqueda binaria ......................................... 42 Declaracion 'SEARCH ALL' ................................. 43 Busqueda dicotomica ...................................... 45 Literales ................................................ 46 Ficheros ESDS ............................................ 46
PASAR DATOS EN CICS A COBOL II.
Pasar datos en cics a cobol II ........................... 47 Instruccion set .......................................... 47 Pointer .................................................. 47 Ejemplos ................................................. 48
EJEMPLOS DE RUTINAS.
Rutina general de conversion de fechas ................... 49 Rutina de conversion de bits a bytes ..................... 51 Rutina general de verificacion de digitos ................ 53 Rutinas de calculos ...................................... 55 Numero de dias entre dos fechas ..................... 55 Numero de meses entre dos fechas .................... 56 Restar un periodo a una fecha ....................... 57
1
ANOTACIONES SOBRE ASPECTOS RELEVANTES DEL COBOL II =======================================================
WLM.-IBM
CAMBIOS EN EL LENGUAJE COBOL EN 1.985 ===========================================
Las tres revisiones mas importantes de lenguaje COBOL, publicadas por el subcomite "COBOL ANS" conocido como X3.23 fueron : en 1.968, en 1.974 y en 1.985.
FORMATO DE PROGRAMA FUENTE =============================
ID DIVISION. ---- ENVIROMMENT DIVISION.
Página 3
Manual Básico COBOL.txt ---- DATA DIVISION. ---- PROCEDURE DIVISION. ---- END PROGRAM Nom-prog. ------> (identico al de PROGRAM-ID.)
--------------------- ¦ PROGRAMA ANIDADO ¦ ---------------------
* Una secuencia de programas COBOL separados (INITIAL) pueden ser tambien entrada del compilador.
CAMBIOS EN LA IDENTIFICATION DIVISION =========================================
¦ ID DIVISION. Nom-Prog is COMMON PROGRAM ¦ ¦ INITIAL PROGRAM ¦ ¦ ¦
* Un programa fuente puede contener a otros y estos referenciar alguno de los recursos de los programas dentro de los cuales estan contenidos.
* Se dice que un programa "B" esta directamente con- tenido en otro "A", sino hay otro programa contenido en el "A" que tambien contenga al "B".
2
* Se dice que un programa "B" esta indirectamente contenido en el "A", si existe un programa contenido en el "A" que a su vez contiene el "B".
--> COMMON B : es un programa contenido en otro y pue- de ser llamado tambien por otros.
--> INITIAL B: cuando este programa es llamado, el y todos los que contiene se ponen en estado inicial.
Estas opciones implican el introducir en los programas COBOL la funcion de recursividad, conjuntamente con la declaracion "CANCEL" que se comentara mas adelante.
CAMBIOS EN LA DATA DIVISION ===============================
COMPARTICION DE DATOS -----------------------
* Los datos contenidos en un "EXTERNAL" pueden ser referenciados por cualquier programa que los tenga descritos.
* Si un programa esta contenido dentro de otro, ambos pueden referenciar los datos que tengan el atributo "GLOBAL".
1) NUEVAS CLAUSULAS EN LA DEFINICION DE ITEMS.
--> GLOBAL B
Página 4
Manual Básico COBOL.txt
El dato esta disponible para todo programa contenido dentro del que lo declara.
atributo de nivel 01.
--> EXTERNAL B
La memoria asociada con el ITEM de datos, esta asocia- da con la unidad de ejecucion mas que con el progra- ma en particular dentro de la unidad de ejecucion.
Este ITEM puede ser referenciado por cualquier programa dentro de la unidad de ejecucion.
No implica que es global y es un atributo de nivel 01.
--> POINTER B
3
esta clausula define un ITEM de datos "PUNTERO" de ni- vel elemental, no numerico y de 4 bytes.
puede usarse en operaciones de comparacion o en "MOVE" a otros ITEMS "PUNTEROS".
Tambien en :
- sentencia SET. - En una condicion de relacion. - En la "USING" de una "CALL", "ENTRY" o cabecera de "PROCEDURE DIVISION".
2) NIVELES DE TABLAS.
* pueden tener hasta siete niveles, dimensiones.
* por tanto podra haber hasta siete anidamientos de clausulas OCCURS.
* Un ITEM podra referenciarse subscrito o indexado por 7.
* en las tablas de longitud variable (DEPENDING ON) el minimo numero de ocurrencias podra ser cero.
CAMBIOS EN LA PROCEDURE DIVISION ====================================
1) OPERACIONES DE CONDICION.
¦IDENTIFICADOR-1 IS [ NOT ] ALPHABETIC-LOWER ¦ ¦ ¦ ¦ ALPHABETIC-UPPER ¦
¦IDENTIF-1 IS [ NOT ] GREATER THAN OR EQUAL TO ( >= ) ¦ ¦ ¦ ¦ LESS THAN OR EQUAL TO ( <= ) ¦
uso de la sentencia SET para cambiar el estado de los nombres de condicion. Ejemplo :
Página 5
Manual Básico COBOL.txt ¦ SET ESTADO TO TRUE [ 88 ESTADO VALUE '2'. ] ¦ ¦ ¦ ¦ EQUIVALE A MOVER 2 AL NIVEL 01 DE ESTADO. ¦
con lo cual tambien se potencia el uso de los nom- bres de condicion.
4
2) OTRAS CONDICIONES.
en operaciones aritmeticas : NOT ON SIZE ERROR en operaciones de mover datos : NOT ON OVERFLOW en operaciones de entrada/salida : NOT INVALID KEY NOT AT END NOT AT END-OF-PAGE
cuando el compilador encuentra un terminador explicito, lo asocia al ultimo verbo no emparejado. solo son validos en las sentencias con forma condicional.
Ejemplo:
¦ ADD 1 TO CONTADOR ¦ ¦ ON SIZE ERROR SET ERROR-OPERACION TO TRUE ¦ ¦ END-ADD ¦
con su uso se puede eliminar practicamente el uso de "."
4) LLAMADA A SUBPROGRAMAS
¦ CALL [ IDENTIFICADOR-1 / LITERAL ] ¦ ¦ ¦ ¦ USING BY REFERENCE IDENTIF-2 ................. ¦ ¦ ¦ ¦ * USING BY REFERENCE ADDRESS OF NOMBRE-REG ..... ¦ ¦ ¦ ¦ USING BY CONTENT IDENTIF-3 ....... / LITERAL / ¦ ¦ ¦ ¦ LENGTH OF IDENTIF-3 ¦
5
Página 6
Manual Básico COBOL.txt BY REFERENCE:
el valor del parametro pasado se evalua en el momen- to de la CALL y es asignado al correspondiente del programa llamado el cual puede procesarlo.
BY CONTENT:
en este caso el programa llamado no puede modificar el valor pasado.
---> en tiempo de compilacion se puede espaci- ficar la opcion DYNAM (llamadas dinamicas) o NODYNAM (llamadas estaticas)
LLAMADAS ESTATICAS -------------------
el programa principal y el subprograma forman parte del mismo modulo, por tanto cuando el control se pasa al programa llamado este ya esta en memoria, por lo que las siguientes llamadas al subprograma lo encontra- ran en el ultimo estado. (excepto cuando el programa llamado tiene el atributo "INITIAL")
LLAMADAS DINAMICAS -------------------
el programa llamado es un modulo independiente y solo se carga en memoria cuando es llamado. Las llamadas sucesivas lo encontraran en el ultimo estado.
SENTENCIA CANCEL =================
¦CANCEL IDENTIFI-1 / LITERAL ¦
se cancela un programa llamado, de tal forma que la proxima llamada lo pondra en su estado inicial.
*** los subprogramas han de terminar con GOBACK o EXIT PROGRAM
*** los efectos siempre son jerarquicos, en caso de pro- gramas anidados
*** todo ello fortalece la recursividad en el COBOL
Manual Básico COBOL.txt ¦WHEN FRASE-1 ¦ ¦ ¦ ¦ ALSO FRASE-2 .....(VARIAS) ¦ ¦ ¦ ¦ SENTENCIA IMPERATIVA ¦ ¦ ¦ ¦ ¦ ¦[ WHEN OTHER SENTENCIA IMPERATIVA ] ¦
--> FRASE-1 puede ser : ANY CONDICION-1 TRUE FALSE NOT IDENTIFI-1 LITERAL EXPR.ARIT. THRU (las mismas )
--> FRASE-2 puede ser : ANY CONDICION-2 TRUE FALSE NOT (igual anterior) THRU (igual)
CONSIDERACIONES SOBRE LA EVALUATE ====================================
* implanta en COBOL una declaracion que facilita la programacion estructurada. ----> equivale a la declara- cion "CASE" de otros lenguajes, cuya carencia en el COBOL se criticaba.
* facilita la construccion de sentencias de logica com- pleja para las cuales antes era necesario recurrir a la "IF" anidadas.
7
* las expresiones a evaluar se lleman sujeto de la se- leccion y el resultado objeto de la seleccion.
* los pares de sujetos y objetos deben ser de la mis- ma clase (numerico, caracter, condicion TRUE o FALSE).
* usar la EVALUATE para seleccionar el proceso de un conjunto de acciones.
* en una EVALUATE pueden especificarse hasta 255 suje- tos y objetos.
* la ejecucion de una EVALUATE finaliza cuando: - la declaracion asociada con una "WHEN" es seleccionada. - la declaracion asociada con una "WHEN OTHER" es SELECC. - ninguna condicion "WHEN" es seleccionada.
* las "WHEN" son comprobadas en el orden de especifi- cacion, por tanto se codificaran en orden de proba- bilidad.
* Dos operandos relacionados con una "THRU" deben ser de la misma clase.
* cualquier sujeto u objeto de seleccion en el cual se ha especificado como "TRUE" o "FALSE" se le asigna ese valor a los ITEMS correspondientes.
Página 8
Manual Básico COBOL.txt
EJEMPLOS DE EVALUATE ----------------------
EVALUATE CAMPO1 WHEN 'D' MOVE 'CONDUCTOR' TO CAMPO1 WHEN 'R' MOVE 'COCHE' TO CAMPO1 WHEN SPACE MOVE SPACES TO CAMPO1 END-EVALUATE
---> USANDO IF IF CAMPO1 = 'D' MOVE 'CONDUCTOR' TO CAMPO1 ELSE IF CAMPO1 = 'R' MOVE 'COCHE' TO CAMPO1 ELSE IF CAMPO1 = SPACE MOVE SPACES TO CAMPO1 END-IF END-IF END-IF
8
EVALUATE TRUE ALSO TRUE WHEN EDAD < 18 ALSO SEXO = 'M' MOVE 'CHICO JOVEN' TO CAMPO1 WHEN EDAD < 18 ALSO SEXO = 'F' MOVE 'CHICA JOVEN' TO CAMPO1 WHEN EDAD > 18 ALSO SEXO = 'M' MOVE 'SEÑOR' TO CAMPO1 WHEN EDAD > 18 ALSO SEXO = 'F' MOVE 'SEÑORITA' TO CAMPO1 WHEN OTHER MOVE 'NO VALIDO' TO CAMPO1 END-EVALUATE
Manual Básico COBOL.txt * IDENTIF-1 puede ser : - Un ITEM subscrito - una tabla completa (no DEPENDING ON) - una estructura
* cuando se usa REPLACING IDENTIF-A/LITERAL deben ser compatibles con IDENTIF-1.
* Si no se usa REPLACING se asume : - Blancos para los ALPHA - Zeros para los NUMERIC
9
NUEVAS OPCIONES DE LA PERFORM =================================
Conjuntamente con la EVALUATE refuerza el lenguaje COBOL como lenguaje adaptado a la programacion estructurada. en principio distinguir entre la PERFORM en linea (la cual se representa con el delimitador END-PERFORM) y la PERFORM fuera de linea, que es la PERFORM tradicional.
¦ PERFORM NOMBRE-PROC1 [ THRU NOMBRE-PROC2 ] ¦ ¦ ¦ ¦ ¦ ¦ [ WITH TEST BEFORE / ¦ ¦ ¦ ¦ AFTER ] ¦ ¦ ¦ ¦ ¦ ¦ UNTIL CONDICION-1 ¦ ¦ ¦ ¦ ¦ ¦ [ DECLARACION-IMPERATIVA ¦ ¦ ¦ ¦ ¦ ¦ END-PERFORM ] ¦
* Si se especifica Nombre-Proc1 no se debe especificar la declaracion imperativa y la END-PERFORM.
* WITH .... para probar la condicion-1 antes o despues de la ejecucion. BEFORE = DO WHILE AFTER = DO UNTIL (Al menos se ejecuta una vez)
10
Página 10
Manual Básico COBOL.txt
¦ ¦ ¦ PERFORM PROC-1 [ THRU PROC-2 ] ¦ ¦ ¦ ¦ [ WITH TEST BEFORE / ¦ ¦ ¦ ¦ AFTER ] ¦ ¦ ¦ ¦ VARYING IDENT-1 FROM IDENT-2 ¦ ¦ ¦ ¦ INDEX-1 INDEX-2 ¦ ¦ ¦ ¦ LITERAL ¦ ¦ ¦ ¦ BY IDENT-3 UNTIL CONDICION-1 ¦ ¦ ¦ ¦ INDEX-3 ¦ ¦ ¦ ¦ ¦ ¦ AFTER ... FROM ..... BY .... UNTIL ... ¦ ¦ ¦ ¦ ¦ ¦ [ DECLARACION IMPERATIVA ¦ ¦ ¦ ¦ END-PERFORM ] ¦
esta modificacion de la "PERFORM" supone implantar en el COBOL el "DO WHILE" y el "DO UNTIL", cuya carencia tambien se le criticaba al COBOL. en resumen el COBOL85 con sus nuevas funciones y am- pliaciones han cubierto los flancos que le hacian vul- nerables ante las criticas respecto al desfase con las funciones que incluian los lenguajes ultimamente desar- rollados ( PASCAL, C).
ASPECTOS ADICIONALES =====================
1.- el DB2 R3 suministra un nuevo parametro en la op- cion HOST del precompilador del DB", "COB2", que sir- ve para indicar si el fuente esta estrito en VS COBOL II.
2.- la opcion de compilacion DYNAM, que permite la car- ga dinamica de programas, al ser llamados por la sentencia CALL no es aplicable a modulos que usen comandos CICS.
3.- para poder llevar a cabo la depuracion se debe com- pilar con la opcion TEST.
11
4.- un programa es reentrante cuando puede ser ejecuta- do por varios usuarios o tareas al mismo tiempo, en COBOL II, la opcion es RENT. Si se especifica esta opcion, tambien es necesario especificar la op- cion RESIDENT.
DEPURACION CON COBOL II ==========================
Página 11
Manual Básico COBOL.txt
ENTORNO ¦COMPILAR¦SOPORTE DE ¦DEPURACION¦DEPURACION ¦ ¦MODULOS OB.¦BATCH ¦INTERACTIVA ------------------------------------------------------------- INTERACTIVO TSO ¦ SI ¦ SI ¦ SI ¦ SI ¦ ¦ ¦ ¦ CICS/OS 1.7 ¦ NO ¦ SI ¦ SI ¦ NO ¦ ¦ ¦ ¦ IMS ¦ NO ¦ SI ¦ NO ¦ SI(BTS) ¦ ¦ ¦ ¦ BATCH MVS ¦ SI ¦ SI ¦ SI ¦ SI ¦ ¦ ¦ ¦
se puede utilizar:
INTERACTIVAMENTE ----------------
* en modo FULL SCREEN.
* en modo de edicion de linea. al utilizarlo de forma interactiva, el programador puede:
* Controlar y visualizar el flujo del programa.
* Alterar temporalmente la logica del programa.
* Ejecutar y re-ejecutar todo o parte de un pro- grama utilizando diferentes valores de datos.
* Inspeccionar y modificar campos de datos en pun- to seleccionados del programa.
------> ES PRERREQUISITO DISPONER DEL ISPF VERSION 2.
BATCH -----
Las peticiones de depuracion se proporcionan en un fi- chero, creado previa la ejecucion del programa. los programas CICS se pueden depuran en modalidad BATCH.
12
COMPILACION -----------
las opciones de compilacion pueden especificarse median- te la ficha CBL o su sinonimia PROCESS, tambien via JCL en la sentencia EXEC que llama al compilador, en la PARM : //COMPILE EXEC PGM=IGYCRCTL,PARM='XREF,SSRANGE,MAP'
para modificar las opciones por defecto se usa la ma- cro IGYCOPT, que se ensamblara y catalogara como modulo IGYCDOPT.
COMPILACIONES CON PROGRAMAS SECUNDARIOS ==========================================
cuando se hacen llamadas a programas secundarios desde programas en COBOL II, tamto si el secundario es COBOL II, como si en COBOL OS/VS, los dos tienen que estar compilados con la misma opcion RES o NORES. Si el programa secundario es COBOL OS/VS, no se permite la compilacion de este con ninguna opcion de DEBUG, pues
Página 12
Manual Básico COBOL.txt en tiempo de ejecucion nos daria un ABEND de usuario 1010. Si el programa secundario esta linkeditado con la op- cion RENT, y no es realmente reentrante, en tiempo de ejecucion nos puede dar un abend de sistema B0A o 30A.
LLAMADAS ENTRE PROGRAMAS COBOL II =====================================
Una RUN UNIT (unidad de ejecucion) incluye uno o mas pro- gramas objeto y puede incluir otros lenguajes diferentes al COBOL.
El primer programa cobol que se ejecuta en la RUN UNIT es usualmente, el MAIN PROGRAM (programa principal).
Cuando una RUN UNIT consiste en varios programas llamados, estos programas deben estar dispuestos para comunicarse con los otros programas. Estos necesitan transferir control y u- sualmente necesitan tener acceso a datos comunes.
Otro metodo que puede ser usado para la comunicacion en- tre programas es el de programas COBOL anidados. Esto permi- te que todos los programas requeridos pro una aplicacion es- ten contenidos dentro del MAIN PROGRAM y de este modo solo es necesario una simple compilacion.
13
TRANSFIRIENDO CONTROL A OTROS PROGRAMAS -------------------------------------------
En la Procedure Division un MAIN PROGRAM puede llamar a un subprograma, y un subprograma puede, asimismo, todavia llamar a otro programa. El programa A llama al B. El A se denomina PROGRAMA LLAMANTE y el B PROGRAMA LLAMADO.
El programa COBOL llamado empieza a ejecutarse al principio de la Procedure Division. Es posible especificar otro punto de entrada (ENTRY POINT) donde empiece la ejecucion utilizando la etiqueta ENTRY el PROGRAMA LLAMADO. Sin embargo, esta no es una practiva recomendada en la programacion estructurada.
Cuando el PROGRAMA LLAMADO se ha procesado completamente puede tambien devolver control al LLAMANTE o finalizar la UNIT RUN.
Un programa llamado no debe, directa o indirectamente, eje- cutar a su llamador. Ejemplo: EL PROGRAMA X LLAMA AL Y EL Y LLAMA AL Z Y EL Z LLAMA AL X
A esto se le denomida una RECURSIVE CALL. Si se intenta eje- cutar una CALL RECURSIVA a un programa COBOL la RUN UNIT termina anormalmente (ABEND).
El PROGRAMA LLAMANTE y todos los LLAMADOS deben estar (to- dos compilados con la opcion del compilador: RESIDENT o NORESIDENT, a menos que haya sido especificada la opcion MIXRES en tiempo de ejecucion.
Página 13
Manual Básico COBOL.txt PROGRAMA PRINCIPAL Y SUBPROGRAMAS. -------------------------------------
No hay sentencias especificas u opciones para identificar si un programa COBOL es principal o es un subprograma. Nor- malmente el primer programa COBOL que empieza la ejecucion de una RUN UNIT es el MAIN PROGRAM (programa principal). Todos los otros programas COBOL en la RUN UNIT (unidad de ejecucion) son Subprogramas.
Hay diferentes maneras de finalizar un programa:
14
+--------------+-------------+-------------------------------------+ ¦Tipo programa ¦Finaliza con:¦ Efectos que causa ¦ +--------------+-------------+-------------------------------------+ ¦ MAIN PROGRAM ¦ STOP RUN ¦ Termina la RUN UNIT y deletea ¦ ¦ (programa ¦ ¦ todos los programas llamados di- ¦ ¦ (programa ¦ ¦ los programas llamados dinamicamen- ¦ ¦ principal) ¦ ¦ namicamente en la RUN UNIT y ¦ ¦ ¦ ¦ todos los programas linkeditados ¦ ¦ ¦ ¦ con aquellos. El control es de- ¦ ¦ ¦ ¦ vuelto al llamador del programa ¦ ¦ ¦ ¦ PRINCIPAL que usualmente suele ¦ ¦ ¦ ¦ ser el sistema operativo ¦ +--------------+-------------+-------------------------------------+ ¦ MAIN PROGRAM ¦ GOBACK ¦ Tiene el mismo efecto que ¦ ¦ (programa ¦ ¦ STOP RUN ¦ ¦ principal) ¦ ¦ ¦ +--------------+-------------+-------------------------------------+ ¦ MAIN PROGRAM ¦EXIT PROGRAM ¦ No tiene ningun efecto ¦ ¦ (programa ¦ ¦ ¦ ¦ principal) ¦ ¦ ¦ +--------------+-------------+-------------------------------------+ ¦ SUBPROGRAMA ¦EXIT PROGRAM ¦ Devuelve control a su inmediato ¦ ¦ ¦ o ¦ llamador sin finalizar la RUN UNIT ¦ ¦ ¦ GOBACK ¦ ¦ +--------------+-------------+-------------------------------------+ ¦ SUBPROGRAMA ¦ STOP RUN ¦ el efecto es el mismo que en ¦ ¦ ¦ ¦ un programa principal: Todos los ¦ ¦ ¦ ¦ programas COBOL en la RUN UNIT ¦ ¦ ¦ ¦ son terminados y se devuelve ¦ ¦ ¦ ¦ control al llamante. ¦ +--------------+-------------+-------------------------------------+ ¦ SUBPROGRAMA: Una sentencia EXIT PROGRAM implicita es gene- ¦ ¦ rada si no hay una instruccion siguiente eje-¦ ¦ cutable ¦ +------------------------------------------------------------------+
Un subprograma es usualmente dejado en su ultimo estado de uso (LAST-USED STATE), cuando termina con EXIT PROGRAM o GOBACK. La siguiente vez que es llamado en la RUN UNIT (u- nidad de ejecucion) sus valores internos estaran como fueron dejados, excepto los valores de retorno para las instrucciones PERFORM que seran restaurados a su valor inicial. Por el con- trario, un programa principal es inicializado cada vez que es llamado. Hay dos excepciones:
1ra.- Un subprograma que es llamado dinamicamente por un programa COBOL OS/VS o COBOL II VS y luego es can- celado, con la opcion RESIDENT estara en el estado inicial la siguiente vez que es llamado.
2da.- Un programa con el atributo INITIAL estara en el estado inicial cada vez que es llamado.
Página 14
Manual Básico COBOL.txt
15
LLAMANDO PROGRAMAS -------------------
Se pueden usar diferentes metodos para transferir control a otro programa. Esto incluye :
1.- CALLs a programas anidados.
2.- CALLS estaticas a otros programas COBOL II VS compilados separadamente.
3.- CALLs dinamicas a otros programas COBOL II VS compilados separadamente.
4.- CALLs a programas en otros lenguajes incluyendo PLI, FORTRAM, y COBOL OS/VS.
Las CALL a programas anidados te permiten crear aplicacio- nes utilizando las tecnicas de programacion estructurada. Pue- den tambien ser utilizadas en lugar de procesos PERFORM pa- ra prevenir modificaciones a items inintencionadamente. Las CALL a programas anidados pueden usar bien la instruccion CALL -literal- o bien CALL -identificador-.
Una CALL estatica es utilizada para llamar a un programa compilado separadamente que es link-editado dentro del mismo modulo de carga que el programa LLAMANTE.
Una CALL dinamica es utilizada para llamar a un programa compilado separadamente que ha sido link-editado en un modulo de carga separado del programa LLAMANTE. En este caso el mo- dulo del subprograma es cargado en memoria la primera vez que es llamado.
Una CALL estatica ocurre cuando se usa la instruccion CALL-literal en un programa que es compilado con la opcion NODYNAM.
Las CALL estaticas son ejecutadas mas rapidamente que las CALL dinamicas y utilizan u ocupan menos memoria.
El uso de la instruccion CALL -identificador- O CALL -literal- compilado con la opcion DYNAM da como resultado una CALL dinamica.
Se deberia considerar la utilizacion de una call dinami- ca cuando: 1.- los subprogramas llamados con una instruccion CALL -literal- son usados infrecuentemente o son muy grandes. 2.- Se quiera llamar a subprogramas en su UNUSED STATE. 3.- Se tiene un programa AMODE(24) en la misma RUN UNIT con programas COBOL II VS que quieren que se ejecu- ten en la modalidad de direccionamiento de 31 BITS. 4.- El nombre del programa que va a ser llamado se co- noce en tiempo de ejecucion.
16
PROGRAMAS ANIDADOS -------------------
Los programas anidados proporcionan un metodo mediante el cual se pueden crear funciones modulares (modular functions)
Página 15
Manual Básico COBOL.txt para la aplicacion mantenimiento de tecnicas de programacion estructurada. Se pueden utilizar como procesos PERFORM con la capacidad adicional de proteger los items locales.
Los programas anidados tambien dan flexibilidad para depu- rar los programas antes de ser incluidos en la aplicacion y dar la capacidad para compilar la aplicacion con una simple invocacion al compilador.
ESTRUCTURA DE PROGRAMAS ANIDADOS -----------------------------------
Un programa COBOL puede contener otros programas COBOL. Los programas contenidos pueden ellos mismos contener otros progra- gramas. Un programa contenido puede ser directamente o indirec- tamente contenido dentro de un programa.
17
EJEMPLO: --------
+-- Programa X ¦ -------- ¦ ....... ¦ Call X1 ¦ Call X2 ¦ ....... ¦ Stop run ¦ ¦ +-- Programa X1 ¦ ¦ -------- ¦ ¦ ¦ ¦ ........ ¦ ¦ Call X11 ¦ ¦ Call X12
Página 16
Manual Básico COBOL.txt ¦ ¦ ........ ¦ ¦ Stop run ¦ ¦ ¦ ¦ +-- Programa X11 ¦ ¦ ¦ -------- ¦ ¦ ¦ ¦ ¦ ¦ ........ ¦ ¦ ¦ ........ ¦ ¦ ¦ Exit Program ¦ ¦ ¦ ¦ ¦ +-- End Program X11 ¦ ¦ ¦ ¦ +-- Programa X12 ¦ ¦ ¦ -------- ¦ ¦ ¦ ¦ ¦ ¦ ........ ¦ ¦ ¦ ........ ¦ ¦ ¦ ¦ ¦ ¦ Exit Program ¦ ¦ ¦ ¦ ¦ +-- End Program X12 ¦ ¦ ¦ +-- ¦ ¦ +-- Programa X2 ¦ ¦ -------- ¦ ¦ ¦ ¦ ......... ¦ ¦ ......... ¦ ¦ Exit Program ¦ ¦ ¦ +-- End Program X2 ¦ +-- End Program X
18
NORMAS PARA EL USO DE ESTRUCTURA DE PROGRAMAS ANIDADOS --------------------------------------------------------------
Hay varias normas que aplicar cuando se utilizan estructuras de programas anidados:
1.- La IDENTIFICATION DIVISION es requerida en cada pro- grama. Todas las otras divisiones son opcionales.
2.- El nombre de programa debe ser unico.
3.- Los programas contenidos no pueden tener la COMFIGU- RATION SECTION. El programa outermost (mas exterior) debe especificar cualquiera de las opciones CONFIGU- RATION SECTION que pueda ser requerida.
4.- Cada programa contenido (llamado) es incluido en el programa continente (llamante) inmediatamente antes de su cabecera END-PROGRAM.
5.- Programas llamados y llamantes deben ser terminados con END-PROGRAM.
LLAMANDO A PROGRAMAS ANIDADOS --------------------------------
Un programa contenido (llamado) solamente puede ser llamado directamente por su programa llamante, a menos que el llamado identificado como COMMON en su clausula PROGRAM-ID. En este ca- so el programa COMMON puede tambien ser llamado por cualquier programa que este contenido directa o indirectamente dentro del
Página 17
Manual Básico COBOL.txt mismo programa que el programa COMMON.
Solamente programas contenidos (llamados) pueden ser COMMON.
Las CALL recursivas no son permitidas.
19
EJEMPLO: --------
+-- Program-id. A ¦ ----------- ¦ ¦ +-- Program-id. A1 ¦ ¦ ----------- ¦ ¦ ¦ ¦ +-- Program-id. A11 ¦ ¦ ¦ ----------- ¦ ¦ ¦ ¦ ¦ ¦ +-- Program-id. A111 ¦ ¦ ¦ ¦ ----------- ¦ ¦ ¦ ¦ ¦ ¦ ¦ +-- End Program A111 ¦ ¦ ¦ ¦ ¦ +-- End Program A11 ¦ ¦ ¦ +-- End Program A1 ¦ ¦ +-- Program-id. A2 is COMMON ¦ ¦ ----------- ¦ ¦ ¦ +-- End Program A2 ¦ ¦ +-- Program-id. A3 is COMMON ¦ ¦ ----------- ¦ ¦ ¦ +-- End Program A3 ¦ +-- End Program A
La siguiente tabla describe la jerarquia de las CALL:
+----------+----------------+-----------------------+ ¦ El ¦ Puede llamar ¦ y Puede ser llamado ¦ ¦ Programa ¦ a los programas¦ por los programas ¦ +----------+----------------+-----------------------+ ¦ A ¦ A1,A2,A3 ¦ Ninguno ¦ +----------+----------------+-----------------------+ ¦ A1 ¦ A11,A12,A2,A3 ¦ A ¦ +----------+----------------+-----------------------+ ¦ A11 ¦ A111,A12,A2,A3 ¦ A1 ¦
.- que A2 no puede llamar a A1 proque no es COMMON y no esta contenido en A2
.- que A111 no puede llamar a A11 porque eso seria una CALL RECURSIVA.
.- que A1 puede llamar a A2 porque A2 es COMMON.
CALL ESTATICAS Y DINAMICAS. ------------------------------
Cuando un subprograma es llamado puede estar ya en memoria y puede ser Linkeditado en el mismo modulo de carga con el programa LLAMANTE (Call estatica) o puede ser cargado solamente al tiempo que es llamado (Call dinamica). Con la carga dinami- ca el programa llamado es cargado solamente cuando se necesita. cargado solamente cuando se necesita.
El proceso de Link-edit difiere dependiendo de si se trata de programas con Call dinamica o estatica.
La instruccion CALL-literal- (donde-literal- = nombre subprogra- ma) es tratada por el compilador como una CALL estatica cuan- do la opcion del compilador NODYNAM esta activa.
Una CALL estatica es ejecutada mas rapidamente que una di- namica y es la preferida si la aplicacion no requiere los servicios de una Call dinamica. Los programas llamados por una Call estatica no pueden ser deleteados (con cancel), por tanto el uso de CALLs estaticas puede ocupar mas memoria principal. Si la memoria IS A CONCERN OF YOURS considerar el uso de CALLs dinamicas.
Si la opcion del compilador NODYNAM esta activa todas las CALLs de el formato CALL -literal- en ese programa seran CALLs estaticas.
Una Call dinamica carga el subprograma en tiempo de ejecucion.
Se debe utilizar una instruccion CALL dinamica cuando:
Página 19
Manual Básico COBOL.txt 21
1.- Los subprogramas llamados con CALL -literal- son usados infrecuentemente o son muy grandes. Si los subprogramas son llamados pocas veces, las CALL dinamicas tienen la ventaja de que trae el subprogra- ma a memoria solamente cuando se necesita.
2.- Se quiera llamar a Subprogramas en su UNUSED STATE. Con el atributo INITIAL el subprograma sera posicio- nado en su INITIAL UNUSED STATE cada vez que es llamado.
Se puede, tambien, selectivamente preparar el ESTADO NO USADO o INICIAL mediante el proceso CALL y CANCEL. Este es un proceso mas engorroso y fastidioso pero da control del estado si eso es lo esencial. Para hacer esto se utiliza una combinacion de CALL dina- mica y la instruccion CANCEL y se compila el progra- ma con la opcion RESIDENT. Cuando se cancela el sub- programa que fue inicialmente llamado por un COBOL OS/VS o COBOL II VS, la siguiente CALL causara que el subprograma sea reinicializado a su UNUSED STATE. El comando cancel no toma accion alguna para borrar de memoria los subprogramas que fueron cargados dina- micamente y bifurcados mediante programas no COBOL.
3.- El nombre del programa a ser llamado solo se conoce en tiempo de ejecucion : - En este caso utiliza el formato CALL -identifi- cador- donde -identificador- es el item que con- tendra el nombre del programa llamado en tiempo de ejecucion. En la proctica se deberia utilizar CALL -identificador- cuando el programa a ser llamado varia dependiendo de las condiciones del programa llamante. - CALL -identificador- es siempre dinamica, incluso si se utiliza la opcion de compilacion NODYNAM. Para que todas las CALL -literal- hechas en un programa sean dinamicas utilizar la opcion de compilacion DYNAM.
Cuando se utilice la opcion de compilacion NODYNAM, no se debe mezclar CALL -identificador- dinamica y una CALL -literal- estatica para el mismo subprograma. Esto desperdicia espacio porque dos copias del subprograma son cargadas en memoria y no se garantiza que el subprograma sea dejado en su LAST- -USED-STATE.
Cuando se tienen CALLs dinamicas en un programa, se debe compilar utilizando la opcion RESIDENT.
Las CALLs dinamicas toman mas procesamiento pero pueden uti- lizar menos memoria principal que las CALLs estaticas.
22
COMPARTIENDO DATOS USANDO EL ATRIBUTO EXTERNAL. ----------------------------------------------------
Los programas compilados separadamente (incluyendo los progra- mas dentro de una secuencia batch) pueden compartir items me- diante el uso del atributo EXTERNAL.
EXTERNAL es especificado en el nivel 01 de la descripcion del dato en la working de un programa y se aplican las si- guientes reglas:
1.- Los items subordinados a un grupo de items EXTERNAL,
Página 20
Manual Básico COBOL.txt son ellos mismos EXTERNAL. 2.- El nombre usado para el item no puede ser usado en otro item EXTERNAL dentro del mismo programa. 3.- La clausula VALUE no puede ser especificada para cual- quier grupo de item o items subordinados EXTERNAL.
Cualquier programa COBOL dentro de la RUN UNIT (Unidad de ejecucion) que tenga la misma descripcion para el item que el programa que contiene el item puede acceder y procesar el item.
Ejemplo: --------
Si el programa A tuviera la siguiente descripcion: 01 EXT-ITEM1 PIC 99 EXTERNAL. El programa B podria acceder a ese item si tuviera la misma descripcion en su working.
Cualquier programa que pueda acceder a un item EXTERNAL puede cambiar su valor. No se debe utilizar este atributo pa- ra items que es nesario proteger.
PASANDO DATOS MEDIANTE BY REFENCE OR BY CONTENT ------------------------------------------------------
BY REFERENCE significa que el subprograma esta refiriendose y procesando el item en la working del programa llamante en vez de trabajar sobre una copia del dato.
BY CONTENT significa que el programa llamante esta pasando solamente el contenido del -literal- o -identificador-.
Con una CALL ... BY CONTENT, el programa llamado no puede cambiar el valor del -literal- o -identificador- en el pro- grama llamante, incluso si se modifica la variable en la cual se recibe el -literal- o el -identificador-.
Si se quiere que el subprograma reciba datos del llamante y compartirlos se debe especificar: CALL ... BY REFERENCE -IDENTIFICADOR-
23
Cualquier cambio que el subprograma haga afecta al dato en el programa llamante.
Un -identificador- en la frase USING de la instruccion CALL ... BY REFERENCE puede ser un nombre de fichero ademas de un nombre de item. Si el -identificador- es un nombre de fichero para un fichero secuencial el compilador COBOL pasa la direc- cion de la DCB (Data Control Block) AS THIS ENTRY OF THE PARAMETER LIST. El -identificador- no puede ser el nombre de un fichero VSAM.
NOTA: Este mecanismo no puede ser usado para ficheros com- partidos entre programas COBOL. Esto es solamente para pasar la DCB a programas assembler.
Si se quiere pasar la direccion del area de registro a un programa llamado se debe especificar : CALL ... BY REFERENCE ADDRESS OF -RECORD NAME-
El subprograma recibe el ADDRESS SPECIAL REGISTER (Registro es- pecial de direccion) para el nombre de registro que se espe- cifico.
Se debe definir el nombre de registro como un nivel 01 o
Página 21
Manual Básico COBOL.txt 77 en la LINKAGE SECTION de los programas llamante y llamado.
Si se quiere pasar la longitud del item se especificara: CALL ... BY CONTENT LENGTH OF -IDENTIFICADOR-
El programa llamante pasa la longitud del -identificador- desde su LENGTH special register (registro especial de longitud).
Cuando los literales son pasados mediante BY CONTENT el pro- grama llamado no puede cambiar el valor.
Si se quiere pasar ambos (el item y su longitud) a un sub- programa se especificara una combinacion de BY REFERENCE y BY CONTENT, por ejemplo : CALL 'ERRPROC' USING BY REFERENCE A BY CONTENT LENGHT OF A.
Los items en un programa llamante pueden estar descritos en la LINKAGE SECTION de todos los programas que llama directa o indirectamente. En este caso, la memoria para estos items es a- locada en el programa llamante de nivel superior. Esto es, el programa A llama al B, el cual llama al C. Los items en el programa A pueden ser descritos en la LINKAGE SECTION de los programas B y C y estar disponibles a los tres programas.
DESCRIBIENDO ITEMS COMUNES EN EL PROGRAMA LLAMANTE --------------------------------------------------------
En el programa llamante, los items comunes son descritos en la DATA DIVISION de la misma manera que otros items. A menos
24
que ellos esten en la LINKAGE SECTION, la memoria es alocada para esos items en el programa llamante. Si se referencian da- tos en un fichero, este debe estar abierto cuando el dato sea referido. Se codificara la clausula USING en las instrucciones
***** CALL *********************
DESCRIBIENDO DATOS COMUNES EN EL PROGRAMA LLAMADO -------------------------------------------------------
En el programa llamado los items comunes son descritos en la LINKAGE SECTION. Codificar la clausula USING despues de la cabecera PROCEDURE DIVISION para recibir los datos.
EJEMPLO: --------
Descripcion del Prog. Descripcion del Prog. LLAMANTE LLAMADO ---------------------- ----------------------
Se debe conocer lo que se va a pasar desde el programa llamante y la estructura de la LINKAGE, para aceptarlo. No importa que clausula de la instruccion CALL se utilice para pasar los datos (BY REFERENCE o BY CONTENT). En cualquier caso el programa llemado debe describir los datos que esta re- cibiendo. Hace esto en la LINKAGE SECTION.
25
************************************************************************ ******** INSTRUCCIONES DE PROGRAMAS COBOL ******* ************************************************************************
INTRUCCION INSPECT ------------------
INSPECT DATA-1 TALLYING CONTADOR FOR CHARACTERS AFTER INITIAL 'S' REPLACING ALL 'A' BY 'O'
INSPECT DATA-1 TALLYING CONTADOR FOR LEADING '0' REPLACING FIRST 'A' BY '2' AFTER INITIAL 'C'
INSPECT DATA-1 REPLACING CHARACTERS BY ZEROS BEFORE INITIAL QUOTE
INSPECT DATA-1 CONVERTING 'abcedfg' TO 'ABCEDFG' AFTER INITIAL '/' BEFORE INITIAL '?'
INSTRUCCION INITIALIZE ----------------------
INITIALIZE ALFANUMERIC-1 REPLACING ALPHANUMERIC DATA BY ALPHANUM-3
INITIALIZE CAMPO-NUMERICO REPLACING NUMERIC DATA BY CAMPO-NUMERICO-2
INITIALIZE CAMPO-EDICION REPLACING ALPHANUMERIC-EDITED DATA BY CAMPO-EDICIION-2
Un item de datos INDEX no se puede inicializar con INITIALIZE. La sentencia INITIALIZE no se puede usar para inicializar tablas de longitud variable (OCCURS...DEPENDING ON...)
INITIALIZE TABLA-ENTRADA REPLACING ALPHANUMERIC DATA BY [ALL] '$'.
--------------------
26
01 TABLA VALUE 'A'. 05 ELEMENTO OCCURS 5 TIMES PIC X.
----------- ¦A¦A¦A¦A¦A¦ ----------- 1 2 3 4 5
INSTRUCCIONES DE TABLAS -----------------------
01 TABLA-1. 05 TABLA-ENTRY OCCURS 10 TIMES INDEXED BY IND-1. 10 TABLA-ENTRY2 OCCURS 5 TIMES ASCENDING KEY IS KEY1 INDEXED BY IND-3. 20 KEY1 PIC X(5). 20 KEY2 PIC X(10).
SET IND-1 TO 2.
SEARCH TABLA-1 AT END .............. WHEN tabla-ENTRY3 (IND-1, IND-2, IND-3) = '.......' WHEN ......... WHEN ......... WHEN ......... END-SEARCH.
INSTRUCCION EVALUATE. ---------------------
EVALUATE TRUE WHEN ESTADO-CASADO ................. WHEN ESTADO-SOLTERO ................. END-EVALUATE.
EVALUATE CODIGO = 'A' VALOR-1 > 100 INDICADOR WHEN TRUE TRUE TRUE .................. .................. WHEN TRUE FALSE ANY .................. .................. END-EVALUATE.
27
Página 24
Manual Básico COBOL.txt
EVALUEATE TRUE TRUE TRUE WHEN DD-31 MM-31 AA-NORMAL WHEN DD-30 MM-30 AA-NORMAL ............. ............. CONTINUE WHEN OTHER ............. ............. ............. END-EVALUATE.
EVALUATE CANTIDAD * 4 WHEN NOT NUMERIC .................. .................. WHEN 1 THRU 10 .................. .................. WHEN NOT 11 THRU 20 .................. .................. END-EVALUATE.
EVALUATE CAMPO-1 CAMPO-2 CAMPO-3 WHEN 1 1 1 MOVE 'A' TO INDICADOR-FINAL WHEN 1 1 0 MOVE 'B' TO INDICADOR-FINAL WHEN OTHER ................. END-EVALUATE.
EVALUATE CAMPO-1 CAMPO-2 CAMPO-3 WHEN 0 1 THRU 3 5 ................ ................ WHEN NUMERIC ANY NOT NUMERIC ................ ................ END-EVALUEATE.
28
INSTRUCCION STRING. -------------------
STRING CAMPO-1 CAMPO-2 DELIMITED BY CAMPO-3 CAMPO-4 DELIMITED BY SIZE <-------- Todo INTO CAMPO-7 WITH POINTER CAMPO-8. <---------- Contiene el numero de caracter a transmitir (no < 1 ni > que la variable receptora).
Manual Básico COBOL.txt ¦11¦ [ON OVERFLOW sentencia-imperativa] -- se ejecutara cuando se excedan inicializar a 1 los limites antes de la ejecucion
INSTRUCCION UNSTRING. ----------------------
UNSTRING CAMPO-ORIGEN DELIMITED BY DELIMITADOR OR ALLL '*' INTO CAMPO-FINAL-1 DELIMITED IN MARCA-1 COUNT IN CUENTA-1 CAMPO-FINAL-2 DELIMITED IN MARCA-2 CAMPO-FINAL-3 DELIMITED IN MARCA-3 COUNT IN CUENTA-3 CAMPO-FINAL-4 COUNT IN CUENTA-3 WITCH POINTER APUNTADOR TALLYING IN CONTADOR-TOTAL ON OVERFLOW GO TO .......
*-->> FILE-NAME1 : Nombre del fichero definido en la SD.
*-->> ASCENDING DESCENDING : Indica la secuencia en la que se va a ordenar el fichero, ascendente ( de menor a moyor) o descendente.
*-->> DATA-NAME1 : Campo en el que tenemos que basar la ordena-
Página 27
Manual Básico COBOL.txt cion, tiene que estar relacionado con el fi- chero, estar situado en la misma posicion y tener la misma longitud que en el fichero de entrada.
31
*-->> COLLATING SEQUENCE : Especifica la secuencia a seguir para usar en las comparaciones no numericas para el campo clave en la opercion de ordenar.
*-->> USING : Cuando se especifica esta opcion todos los regis- tros en file-name2, son transferidos automaticamen- te a file-name1. Los ficheros de entrada tienen que tener organizacion secuencial.
*-->> INPUT PROCEDURE : Especifica el nombre de la seccion que va a seleccionar o modificar registros de entrada antes que la operacion de or- denacion comienze. Puede tener uno o mas parrafos escritos consecutivamente y que no formen parte de la OUTPUT PROCEDURE.
*-->> GIVING : Cuando se especifica esta opcion todos los regis- tros ordenados en file-name1 son transferidos automaticamente al fichero de salida file-name3. El fichero de salida debe tener organizacion secu- encial, y debe estar definido en la FD.
*-->> OUTPUT PROCEDURE : Especifica el nombre de seccion que va a seleccionar o modificar registros de salida. Puede tener uno o mas parrafos escritos consecutivamente y que no for- men parte de la INPUT PROCEDURE.
RELEASE =======
Equivale a un WRITE, para grabar los registros en el fichero del SORT.
Transfiere registros desde un area de entrada/salida a la fase inicial de una operacion de ordenacion. Solo se puede usar en SORT INPUT PROCEDURE.
El record-name tiene que estar asociado al fichero definido en la SD.
RETURN ======
Equivale a una READ, para leer del fichero del SORT.
32
RETURN file-name RECORD ------ [INTO identifier] ----
Página 28
Manual Básico COBOL.txt AT END imperative-statement ------ [END-RETURN] ----------
Transfiere registros desde la fase final del sort o merge a la OTPUT PROCEDURE. Solo se puede usar en la SORT OUTPUT PROCEDURE
El file-name tiene que estar definido en la SD
SORT-RETURN ===========
Equivale al return-code. Sort-return PIC S9(4).
CLAUSULA OCCURS ================
FUNCION: Permitir simplificar las inscripciones de campos de datos que se repiten con la misma descripcion.
FORMATO 1: ---------
OCCURS entero TIMES ------
Entero indica el numero de veces que se repite un campo con la misma descripcion; su valor tiene que ser mayor que cero.
EJEMPLO. Se dispone de una cinta magnetica grabada con un solo registro de 3254 caracteres cuyo contenido es el siguiente:
- Un campo de seis caracteres alfabeticos en los que figura el nombre de la empresa.
- Un campo de ocho caracteres alfanumericos en el que figura el modelo de automovil fabricado.
- 1080 campos de tres caracteres numericos cada uno, cuyo contenido es el numero diario de automoviles fabricados durante los años 1971, 72 y 73 (los meses se consideran de 30 dias).
33
Se quiere, partiendo del formato de dicho registro, que el programador haga la descripcion del mismo:
Como se ve, esta descripcion seria muy laboriosa y necesitaria mucho tiempo el llevarla a cabo, ya que serian necesarias varias hojas de codificacion.
Pero teniendo en cuenta que al ser los 1080 campos de la misma longitud, y del mismo tipo los caracteres a almacenar, se puede simplificar la descripcion empleando la clausula OCCURS, sustituyendo la anterior descripcion por la equivalente:
- A la descripcion del campo en que entra a formar parte la clausula OCCURS se le da el nombre de tabla.
- Al nombre de campo de datos, DIARIA, el cual es comun para los 1080 campos se le denomina: Nombre Generico o Sujeto, y a cada uno de los campos, elementos de la TABLA.
- La clausula OCCURS no puede especificarse en una descripcion que lleve nivel 01 o 77.
FORMATO 2: ---------
OCCURS entero-1 TO entero-2 TIMES DEPENDING ON nombre-de-datos-1 ------ -- ---------
Este formato se emplea cuando el sujeto o nombre generico tiene un numero variable de apariciones.
Si en el ejemplo anterior, en vez de haber grabado la cinta con un unico registro conteniendo la produccion de 36 meses, cada uno de treinta dias' se hubieran grabado 36 registros de longitud variable como consecuencia del numero diferente de dias de cada mes; en este caso la descripcion seria:
34
FD ARCHIVO- AUTOS RECORDING V LABEL RECORD OMITTED.
01 REGISTRO-AUTOS. 02 NOMBRE PIC A(6). 02 MODELO PIC X(8). 02 NUMERO-DIAS PIC 99. 02 DIARIA OCURRS 28 TO 31 TIMES DEPENDING ON NUMERO-DIAS PIC 999.
A la vista de dicha descripcion, entero-1 representa el numero minimo de apariciones y entero-2 el numero maximo. El valor minimo que puede tomar entero-1 es cero y el valor maximo de entero-2 depende del tipo de compilador utilizado, pudiendo llegar a ser superior a 300.000.
Existen compiladores para los que entero-1 es opcional. Siendo correcto describir:
02 MODELO PIC X(8). 02 NUMERO-DIAS PIC 99. 02 DIARIA OCCURS 31 TIMES DEPENDING ON NUMERO-DIAS PIC 999.
DEPENDING debe aparecer en la ultima inscripcion de los campos de datos que constituyen el registro y, como consecuencia, nombre-de-datos-1 debe especificarse antes de la descripcion del nombre generico de la clausula OCCURS, cuando forma parte del registro, como se muestra en el ejemplo precedente, ya que no seria correcto escribir:
Página 30
Manual Básico COBOL.txt FD ARCHIVO- AUTOS RECORDING V LABEL RECORD OMITTED.
01 REGISTRO-AUTOS. 02 NOMBRE PIC A(6). 02 MODELO PIC X(8). 02 DIARIA OCCURS 28 TO 31 TIMES DEPENDING ON NUMERO-DIAS PIC 999. 02 NUMERO-DIAS PIC 99.
por no ser DIARIA el ultimo campo del registro. La serie de caracteres de la clausula PICTURE perteneciente a nombre-de-datos-1 debe ser numerica.
FORMATO 3: ---------
_ _ OCCURS entero-1 TO entero-2 TIMES ¦ DEPENDING ON nombre-de-datos-1 ¦ ------ - -
En este formato incluye a los dos anteriores, añadiendo la clausula ASCENDING o DESCENDING, para indicar si los elementos de la tabla estan ordenados en forma ascendente o descendente por uno o varios campos (nombre-de-datos-2, nombre-de-datos-3 ...), que formen parte de dichos elementos.
La utilizacion de este formato es obligatoria, por ejemplo, cuando para localizar a un determinado elemento de la tabla, se emplee el metodo de busqueda binaria o dicotomica por medio de la declaracion SEARCH ALL, la cual utiliza como indice para realizar dicha busqueda, al nombre-de-indice que se describe a continuacion de INDEXED BY.
Los valores que pueden asignarse a entero-1 y entero-2 son los mismos que los especificados en el Formato-2.
TABLAS ______
Una TABLA es una serie de datos con el mismo formato dispuestos consecutivamente en memoria.
La serie de datos, al tener el mismo formato, se puede describir con un solo nombre.
Las tablas se utilizan con mucha frecuencia en programacion ya que permiten, principalmente:
- Disponer de una informacion rapida (estan en memoria). - Acceder a un elemento por su posicion relativa.
Elemento de tabla es un campo de datos que, en su descripcion, incluye una clausula OCCURS.
La declaracion OCCURS especifica el numero de elementos que
Página 31
Manual Básico COBOL.txt existen en la tabla. (En una tabla, todas las entradas deben de tener el mismo tamaño y formato).
01 TABLADIAS. 03 UNDIA OCCURS 7 TIMES PIC X(9).
Esta partida establece una tabla de siete elementos cada uno de los cuales tiene nueve caracteres de longitud con lo que la tabla tendra una longitud de 63 (9 x 7) caracteres.
Al utilizar la declaracion OCCURS se deben tener en cuenta las siguientes reglas:
36
- OCCURS no aparece en el nivel 01 sino en el nivel mas bajo. - La declaracion PICTURE aparece en el nivel mas bajo.
Como hemos dicho, la reserva de memoria para cada uno de los elementos de la tabla se dispone, fisicamente, en forma lineal, es decir, cada elemento se situa inmediatamente a continuacion del anterior.
01 TABLADIAS. 03 UNDIA OCCURS 7 TIMES PIC X(9).
Se hace referencia a cada partida de una tabla por medio de un numero, llamado SUBINDICE, que identifica su posicion en esa tabla. Por ejemplo, en la tabla anterior tendriamos:
UNDIA(1) = LUNES UNDIA(3) = MIERCOLES
El SUBINDICE se utiliza al nivel de la declaracion OCCURS, es decir, "UNDIA(3)", pero no "TABLADIAS(3)".
TABLAS DE LONGITUD VARIABLE ===========================
La opcion DEPENDING de la clausula OCCURS define una tabla en la que el numero de sus elementos va variando mientras se lleva a cabo la ejecucion del programa. (Seria el caso, por ejemplo, de una tabla en la que se recogiera la fabricacion de coches en un año por meses y por dias laborales; esta claro que en este caso la tabla podria ser de longitud variable en funcion del numero de dias laborables de cada mes).
DESCRIPCION DE UNA TABLA ========================
La descripcion de una tabla puede realizarse en la FILE SECTION o en la WORKING-STORAGE SECTION.
Para llenar con datos una tabla habra que tener en cuenta que:
- Si se describe en la FILE SECTION, el llenado de la misma se hara, normalmente, desde un medio externo: cinta, disco, etc., donde estaran contenidos los datos, por medio de una declaracion READ.
- Si se describe en la WORKING-STORAGE SECTION, se llenara, bien con el contenido existente en otros campos de la memoria y/o los resultados producidos durante el proceso, o bien por una declaracion ACCEPT o READ.
Página 32
Manual Básico COBOL.txt
37
A las tablas que no se espera que cambien (tabla de constantes) se les puede dar valores en la WORKING-STORAGE SECTION de un programa utilizando la declaracion REDEFINES.
01 TABLAMES. 02 FILLER PIC X(30) VALUE 'ENERO FEBRERO MARZO '. 02 FILLER PIC X(30) VALUE 'ABRIL MAYO JUNIO '. 02 FILLER PIC X(30) VALUE 'JULIO AGOSTO SEPTIEMBRE'. 02 FILLER PIC X(30) VALUE 'OCTUBRE NOVIEMBRE DICIEMBRE '.
La clausula REDEFINES debe seguir directamente a la partida que redefine y debe estar en el mismo nivel. Puesto que no se puede incluir una clausula VALUE con una declaracion OCCURS, esta es una tecnica util para codificar una tabla de constantes.
TABLAS DE MAS DE UNA DIMENSION ==============================
El COBOL tambien permite tablas de dos y tres dimensiones. Una tabla unidimensional podia representar ya sea una lista de nombres de estudiantes o un conjunto de calificaciones para cada uno de los estudiantes, y una tabla tridimensional podrian incluir el nombre de cada alumno y la nota media para cada uno de los meses del curso.
Para definir una tabla bidimensional, la clausula OCCURS se utiliza dos veces. La declaracion PICTURE solo se utilizara despues de la ultima OCCURS.
01 TABLA. 02 ALUM OCCURS 50 TIMES. 03 NOTA OCCURS 10 TIMES PIC 99V99.
Con el fin de hacer referencia a una entrada en una tabla bidimensional se necesitan dos subindices ("I" y "J") escritos de la forma (I, J). El primer subindice se refiere a la variable descrita en la primera declaracion OCCURS y debe estar seguido por una coma y un espacio. El segundo subindice se refiere a la variable descrita por la segunda declaracion OCCURS.
Una tabla tridimensional se definiria de la siguiente manera:
Con la declaracion OCCURS se puede definir una variable INDICE (INDEX). A esta variable INDICE se le puede dar un valor en una proposicion SET. El indice es muy semejante, en apariencia, al subindice. Cuando se utiliza un indice se puede utilizar una instruccion especial (SEARCH) con la cual se incrementara la variable indice.
01 TABLA.
Página 33
Manual Básico COBOL.txt 02 ELE PIC 9(3) OCCURS 20 TIMES INDEXED BY K.
Esto define a TABLA con un indice "K". El elemento (ELE) aun puede estar referenciado por medio de subindices.
(No se utiliza la clausula PIC para describir a "K").
DECLARACION "SET" ================
Un indice no puede estar especificado en una instruccion MOVE o en una proposicion aritmetica (ADD, MULTIPLY, etc ...), entonces para asignar un valor a un indice o para igualar el valor de un indice con un nombre de dato se utiliza la declaracion SET.
nombre-indice-1 nombre-indice-2 nombre-indice-3 SET ... TO identificador-3 identificador-1 identificador-2 literal
UP BY identificador SET nombre-indice-1 nombre-indice-2 DOWN BY literal
Los nombres de indice siempre deben tener valores entre "1" y el tamaño de la tabla.
El efecto de la declaracion SET es transferir al operando u operandos que siguen a SET el contenido del operando que sigue a la palabra TO, es decir, es una transferencia realizada en sentido contrario a como la realiza la declaracion MOVE.
Si se utiliza UP BY o DOWN BY, cada vez que se ejecuta la declaracion SET el contenido de los nombres-de-indice que siguen a dicha declaracion se incrementan (UP BY) o decrementan (DOWN BY) en el valor contenido en el identificador o literal que siga a estas dos opciones.
39
SET INDICE BETA TO SUM. (Indice y Beta pasan a valer SUM). SET INDICE TO 46. (Indice pasa a valer 46). SET INDICE UP BY 2. (Indice se incrementa en 2).
01 TABLA. 02 ELE PIC 99 OCCURS 10 TIMES INDEXED BY K. .................. ..................
PROCEDURE DIVISION. SET K TO ZERO.
CALCULO. SET K UP BY 1. IF K NOT > N ADD ELE(K) TO TOTAL GO TO CALCULO. .................. ..................
DECLARACION "SEARCH"
Página 34
Manual Básico COBOL.txt ====================
Lleva a cabo la busqueda en forma secuencial de una tabla hasta que el contenido de un elemento de la misma satisfaga una determinada condicion.
_ _ SEARCH identificador ¦ AT END declaracion-imperativa-1 ¦ - - declaracion-imperativa-2 WHEN condicion-1 NEXT SENTENCE
_ declaracion-imperativa-3 _ ¦ WHEN condicion-2 ¦ - NEXT SENTENCE -
La tabla nombrada (identificador) es buscada desde el valor actual del indice (por tanto, si se quiere que la busqueda empiece por el principio de la tabla, se debe inicializar el valor del indice por medio de la declaracion SET). Cuando termina la daclaracion SEARCH, el indice tiene el valor del elemento de la tabla para el cual la condicion es verdadera. Si se desea continuar una busqueda a partir de donde se interrupio se deja ejecutar de nuevo la declaracion SEARCH sin volver a restablecer el indice.
El efecto de la declaracion SEARCH es el siguiente:
40
Se incicia una busqueda de la tabla indicada y se prueba la condicion que sigue al primer WHEN, caso de que la prueba resulte cierta se ejecuta la declaracion o delaraciones que siguen a dicha condicion y si no resulta cierta se realiza el mismo proceso para los sucesivos WHEN. Si la prueba resulta falsa para todas las condiciones, el indice se incrementa automaticamente en una unidad para repetir el ciclo con el segundo elemento.
Si hecha la prueba de las distintas condiciones con todos los elementos de la tabla no se encuentra alguno que cumpla una de las condiciones, quiere decir que el valor buscado no existe en ningun elemento de la tabla por lo que se da por finalizada la busqueda con lo que pasaria a ejecutar la declaracion que sigue a AT END.
Es decir, de una forma mas esquematica, el proceso seria:
a) Se prueba cada condicion o condiciones de la opcion WHEN en el mismo orden de su escritura.
b) Si no se ha satisfecho ninguna de las condiciones se incrementa el indice de la tabla para poder hacer referencia al siguiente elemento de la misma y se repite el paso a).
c) Si despues de la evaluacion se ha satisfecho una de las condiciones que siguen a WHEN, la busqueda concluye pasando a ejecutarse la declaracion imperativa asociada con tal condicion. El indice, en ese momento, contendra el numero del elemento de la tabla que satisfizo la condicion.
d) Si se alcanza el final de la tabla sin haber satisfecho ninguna condicion de las que siguen a WHEN, la busqueda concluye pasando a ejecutarse la declaracion imperativa asociada con tal condicion. Si se omite AT END, la secuencia de ejecucion del programa pasa a la sentencia siguiente.
e) Puede suceder que, al comienzo de la busqueda, el valor del indice sea superior al numero maximo de elementos de la tabla, en cuyo caso la busqueda concluye inmediatamente, pasando a ejecutar lo especificado en el caso d).
Página 35
Manual Básico COBOL.txt
77 NOM PIC X(10) VALUE 'JUAN GOMEZ'. 01 LINEA1. 02 FILLER PIC X(20) VALUE SPACES. 02 NOMIN PIC X(10) VALUE SPACES. 02 FILLER PIC X(2) VALUE SPACES. 02 VENIM PIC Z.ZZ9 VALUE ZEROS.
41
01 TABLA. 02 ELEM OCCURS 45 TIMES INDEXED BY I. 03 NOMBRE PIC X(10). 03 VENTA PIC 9(4). ........................... ........................... PROCEDURE DIVISION. ........................... ...........................
BUSQUEDA. SET I TO 1. SEARCH ELEMEN AT END GO TO NOEXISTE WHEN NOMBRE(I) = NOM MOVE NOMBRE(I) TO NOMIN MOVE VENTA(I) TO VENIM WRITE ................. GO TO FIN.
Especificando en una declaracion SEARCH la opcion VARYING permite incrementar simultaneamente el indice asociado a la tabla en que se realiza la busqueda y una variable,identificador u otro indice asociado a otra tabla. (Es frecuente el empleo de esta opcion ya que hay trabajos en los que, ademas de buscar en una tabla al elemento que reuna determinadas condiciones, se necesita conocer el numero de orden que ocupa en la misma para, por ejemplo, acceder a otra tabla).
SEARCH ELEMEN VARYING OTRO AT END ... ----
TABLAS DEFINIDAS CON MAS DE UN INDICE =====================================
En la definicion de una tabla puden utilizarse varios indices. En este caso es necesario conocer cual de esos indices es el que va a utilizar el sistema para la busqueda en la tabla.
El empleo de uno u otro indice para realizar la busqueda esta
Página 36
Manual Básico COBOL.txt en funcion de que se especifique o no, en la declaracion SEARCH, la opcion VARYING, es decir:
42
a) Si no se especifica la opcion VARYING, la busqueda en la tabla se realizara utilizando el primer indice de los que figuran en la clausula INDEXED BY.
b) Si se especifica la opcion VARYING junto con el nombre de uno de los indices que figuran en la clausula INDEXED BY, este sera el que se utilice para realizar la busqueda.
c) Puede suceder que en la opcion VARYING se especifique un indice distinto de los que figuran en la definicion de la tabla objeto de la busqueda (por ejemplo, el indice de otra tabla); en este caso la busqueda en dicha tabla se realiza, como en el apartado a), utilizando el primer indice que sigue a INDEXED BY.
SET I3 TO 125. SEARCH FDIARIA VARYING I3 AT END GO TO FIN WHEN ...................... (1) ........................ ........................
SET I1 TO 125. SEARCH FDIARIA AT END GO TO FIN WHEN ...................... (2) ........................ ........................
En (1) se utilizara I3 (de acuerdo con el apartado b)) y en (2) se utilizara I1 (conforme con el apartado a)).
BUSQUEDA BINARIA ================
La instruccion SEARCH ejecuta una busqueda secuencial, es decir, aun si la partida que se esta buscando esta cercana al final de la tabla, se examinan todas las partidas anteriores hasta que se llega a la que se busca. Este proceso se puede utilizar si los valores de los elementos de la tabla estan en secuencia o si no lo estan.
Si las entradas de la tabla estan en secuencia se puede realizar un tipo de busqueda mas eficiente llamada busqueda BINARIA. Una busqueda binaria requiere un campo clave en cada entrada de la tabla. Se busca comprobando primero el valor del campo clave en el punto medio de la tabla. Si el valor que se esta
43
buscando es mayor, entonces se comprueba el valor del campo clave en el punto medio de la parte superior de la tabla. Y continua haciendo bisecciones en las partes restantes de la tabla hasta que se localiza la clave deseada. La busqueda binaria corta
Página 37
Manual Básico COBOL.txt drasticamente el tiempo de acceso para muchas tablas (*).
La descripcion de una tabla que procesara una busqueda binaria requiere de una entrada KEY (clave) ademas del indice.
01 TABLA. 02 ELEMEN PIC 9(4) OCCURS 20 TIMES INDEXED BY I ASCENDING KEY IS CLA.
La KEY (clave) puede ser ASCENDING (ascendente) o DESCENDING (descendente).
(*) : El numero maximo de busquedas necesarias para localizar a un elemento de la tabla que contengan un valor determinado se obtiene por la expresion:
x x-1 2 > numero de elementos de la tabla > 2
en la que "x" indica el numero maximo de busquedas; es decir, si la tabla contiene 235 elementos, el valor de "x" sera igual a "8" ya que:
8 7 2 > 235 > 2
DECLARACION "SEARCH ALL" =======================
Esta declaracion permite la busqueda binaria en una tabla descrita con la opcion INDEXED BY.
El formato de esta declaracion es el siguiente:
SEARCH ALL identificador AT END declaracion-imperativa-1 declaracion-imperativa-2 WHEN condicion NEXT SENTENCE
Las direcciones de los elementos de la tabla, a los que se ha de acceder hasta localizar al que contenga un valor determinado, los calcula el sistema automaticamente. No hay que inicializar con un valor el indice con la declaracion SET.
El proceso que se sigue en la declaracion SEARCH ALL es el mismo que en la SEARCH, es decir:
44
a) Se prueba cada condicion de la opcion WHEN en el mismo orden de su escritura.
b) Si no se ha satisfecho la condicion se incrementa el indice de la tabla para poder hacer referencia al siguiente elemento de la misma y se repite el paso a).
c) Si despues de la evaluacion se ha satisfecho la condicion que sigue a WHEN, la busqueda concluye pasando a ejecutarse la declaracion imperativa asociada con tal condicion. El indice, en ese momento, contendra el numero del elemento de la tabla que satisfizo la condicion.
d) Si se alcanza el final de la tabla sin haber satisfecho la condicion que sigue a WHEN, la busqueda concluye y, por tanto, si se ha especificado la opcion AT END se ejecutara la declaracion imperativa que sigue a dicha opcion. Si se omite AT END, la secuencia de ejecucion del programa pasa a la sentencia siguiente.
Página 38
Manual Básico COBOL.txt Pero, a diferencia de la SEARCH, en la SEARCH ALL se deben de tener en cuenta los siguientes puntos:
1.- Solo puede especificarse una palabra WHEN con una condicion, y esta condicion solo puede ser del tipo de relacion EQUAL TO (=) o compuesta enlazada por el operador logico AND.
2.- Los elementos de la tabla deben estar ordenados en forma ascendente (ASCENDING) o descendente (DESCENDING) por el contenido del campo objeto de la busqueda.
3.- La variable que sea la KEY (clave) se debe incluir en la condicion.
77 NOM PIC X(10) VALUE 'JUAN GOMEZ'.
01 TABLA. 02 ELEM OCCURS 45 TIMES INDEXED BY I ASCENDING KEY NOMBRE. 03 NOMBRE PIC X(10). 03 VENTAS PIC 9(4). ................................... ...................................
BUSQUEDA. SEARCH ALL ELEMEN AT END GO TO NOEXISTE WHEN NOMBRE(I) = NOM MOVE NOMBRE(I) TO ... MOVE VENTAS(I) TO ... GO TO FIN.
45
BUSQUEDA DICOTOMICA ===================
MENOR : PRIMER VALOR -1 MAYOR : ULTIMO VALOR +1
I : INDICE
______________ ¦ ¦ ¦ INICIALIZAR ¦ ¦ MAYOR ¦ ¦ MENOR ¦ -------------- ¦ ¦ ___________________________________ _______ SI ¦ ¦ NO ¦ ------ MAYOR - MENOR = 1 ¦ ¦ ESTA ¦ ¦ ------- ¦ ¦ NO ¦ ¦ ¦ ____________________ ¦ ¦ ¦ ¦ ¦ MAYOR - MENOR ¦ ¦ ¦ I = ------------- ¦ ¦ ¦ 2 ¦ ¦
Página 39
Manual Básico COBOL.txt -------------------- ¦ ¦ ¦ ¦ ¦ ¦ TABLA(I) ¦ ______ = . . > __________ ¦ ¦ ESTA ¦ ----- ------ ----- ¦ MOVE I ¦ ¦ ------ . . ¦ TO MAYOR ¦ ¦ BUSQUEDA ---------- ¦ ¦ ¦ < ¦ ¦ ¦ __________ ¦ ¦ MOVE I ¦ ¦ ¦ TO MENOR ¦ ------------------------------ ----------
46
LITERALES. ____________
Para incluir un apostrofe (') en un literal hay que poner dos.
EJEMPLO: 01 LITERAL PIC x(5) VALUE '''DOS'''.
Si imprimimos, displayamos o preguntamos por este valor obtendre- mos 'DOS'.
01 LITERAL PIC x(5) VALUE '''DOS'.
En este caso el resultado sera 'DOS.
El doble apostrofe ('') solo ocupa una posicion en el campo (').
FICHEROS ESDS. ________________
SELECT ddname ASSIGN TO AS-ddname (1) ORGANIZATION IS SEQUENTIAL ACCESS MODE IS SECUENTIAL FILE STATUS IS status-file.
(1) Si no se especifica AS- la ejecucion cancelara con un FILE STATUS '39'.
FILE STATUS '35'. ___________________
El file status '35' se produce cuando tratamos de leer un fichero VSAM vacio de nueva creacion. Para solucionarlo hay que definirlo como:
SELECT OPTINAL ddname ASSIGN... . . FILE STATUS IS st-xxxxxxx.
Y aceptar el FILE STATUS '05' que nos devuelve cuando lo abrimos como correcto.
Página 40
Manual Básico COBOL.txt IF st-xxxxxx = '00' OR = '05' CORRECTO END-IF.
47
PASAR DATOS EN CICS COBOL II.______________________________
INSTRUCCION SET: FORMATO 5.
_________________________ ¦ ¦ V ¦ >>___SET________identif-4____________TO___identif-6_____________>< ¦_ADDRESS OF identif-5__¦ ¦_ADDRESS OF identif-7_¦ ¦______NULL____________¦
-----Campo receptor----- -----Campo emisor------
La direccion contenida en el emisor reemplaza el contenido actual del receptor.
Identif-4. Debe estar definido como USAGE IS POINTER.
Identif-5. Debe ser un area a nivel 01 o 77 en la LINKAGE.
Identif-6. No puede contener una direccion de la propia WORKING o FILE SECTION. No puede ser un campo de coma flotante.
A_OF identif-7. Pasa la direccion del identif-7, no su contenido.
ADDRESS OF... Registro especial.
Por cada registro a nivel 01 o 77 de la LINKAGE existe un registro especial ADDRESS OFF. Este registro guarda la direccion del area, si este area esta redefinida la direccion ADDRESS OF sera la misma para todas las definiciones de la misma.
POINTER
Un campo pointer es un item elemental no numerico de 4 bytes. Solo puede usarse en:
. La instruccion SET. . En una comparacion. . En la USING de una CALL o en la cabecera de la PROCEDURE.
Si se quiere mover un puntero a un campo numerico el pointer tendra que redefinirse como PIC S9(8) COMP.
SET ADDRESS OF DATOS-RECIBIDOS TO APUN-DIRCOM. EXEC CICS ADDRESS CWA(APUNTADOR-1) END-EXEC. SET ADDRESS OF CWAARE TO APUNTADOR-1.
EXEC CICS ADDRESS CWA(ADDRESS OF CWAARE) Esta instruccion es END-EXEC. equivalente a las dos anteriores.
49
RUTINA GENERAL DE CONVERSION DE FECHAS **************************************
FUNCION: Convierte fechas en funcion de la opcion recibida.
PARAMETROS:
1. Opcion (De 1 a 6) PIC X. Requerido en entrada
2. Fecha en formato juliano PIC S9(7) COMP-3 Campo de entrada/salida segun opcion
3. Fecha en formato DDMMAA o AAMMDD PIC X(6) Campo de entrada/salida segun opcion
OPCIONES : 1. De Juliana a AAMMDD 2. De Juliana a DDMMAA 3. De AAMMDD a Juliana 4. De DDMMAA a Juliana 5. De AAMMDD a Juliana semestral
En todas las opciones enviar el campo deseado recibiendose el convertido en el otro campo. La opcion 5 calcula la fecha juliana referida al comienzo del semestre.
FORMA DE INVOCAR:
CALL 'SUTLD001' USING FECHA-OPCION FECHA-JULIANA FECHA-NORMAL
MOVE EIBDATE TO FECHA-JULIANA. MOVE '2' TO FECHA-OPCION. CALL 'SUTLD001' USING FECHA-OPCION FECHA-JULIANA FECHA-NORMAL.
..........................................
En este ejemplo enviamos la fecha en juliana y nos sera devuelta en formato DDMMAA.
51
RUTINA CONVERSION DE BITS A BYTES *********************************
FUNCION: Convierte los 8 bits de un byte a 8 bytes y viceversa.
LENGUAJE: Assembler
PARAMETROS:
1. Opcion (1 o 2) PIC X. Requerido en entrada
2. Byte que contiene los 8 bits. PIC X. Campo de entrada/salida segun opcion
3. Campo que contiene los 8 bytes. PIC X(8) Campo de entrada/salida segun opcion
OPCIONES :
1. Expande los 8 bits sobre los 8 bytes
2. Comprime los 8 bytes sobre los 8 bits. En las dos opciones enviar el campo deseado recibiendose el convertido en el otro campo. Si la opcion no fuera ni 1 ni 2 se devolveria un 9 en el propio campo de opcion.
PROCEDURE DIVISION. MOVE '1' TO W-OPCION. MOVE BAINDI2I TO W-BITS8. CALL 'SUTLA002' USING W-SUTLA002.
..........................................
En este ejemplo enviamos el BAINDI2I declarado como PIC X a la rutina y nos devolvera su contenido en los 8 bytes de W-BYTES8.
Todos los BAINDI2I que tengan en el BIT7 un 1 se refieren a organismos.
53
RUTINA GENERAL DE VERIFICACION DE DIGITOS *****************************************
FUNCION: Calcula digito en funcion de la opcion recibida
LENGUAJE: Cobol
PARAMETROS:
1. CODIGO DE RETORNO
PIC X Obtenido en salida ' ' : proceso correcto '9' : digito de control enviado no coincide con el calculado (Salvo en opcion 5)
2. DIGITO.
PIC 9 Obtenido en salida (Resultado del calculo)
3. OPCION.
PIC x Requerido en entrada '1' : Digito de tarjetas (enviar 12 dig.) '2' : Digito de cuentas (enviar 12 " ) '3' : Digito clave SICA (enviar 9 " ) '4' : Digito de Codigo Cliente (enviar 12 " )
Página 44
Manual Básico COBOL.txt '5' : Digito DNI Hacienda/Comunitario (enviar 9 " ) En esta opcion se mandan los datos sin digito. El retorno es 9 si lo enviado no es numerico).
4. DATOS (N. tarjeta, N. cuenta etc.)
PIC X(16) Requerido en entrada
FORMA DE INVOCAR:
CALL 'SUTLD005' USING RETORNO DIGITO OPCION DATOS.
MOVE '1' TO OPCION. MOVE '453952000125008' TO DATOS. CALL 'SUTLD005' USING RETORNO DIGITO OPCION DATOS. IF RETORNO NOT = '9' ..........................................
En este ejemplo se envia un numero de tarjeta VISA con el digito incluido, para ser verificado. Si retorno not = 9 el digito es correcto.
Comprobar si la cuenta es correcta devolviendo el codigo de retorno al calcular el digito.
CALCULAR-DIGITO. MOVE CUENTA TO CUENTA-DIGITO MOVE '2' TO OPCION MOVE CORR CUENTA-DIGITO TO CUENTA-DIGITO2 MOVE CUENTA-DIGITO2 TO DATOS CALL 'SUTLA005' USING RETORNO DIGITO OPCION DATOS. IF RETORNO = ' ' DIGITO CORRECTO - CUENTA CORRECTA ELSE DIGITO ERRONEO - CUENTA INCORRECTA.
Página 45
Manual Básico COBOL.txt
55
R U T I N A S D E C A L C U L O ************************************
----- NUMERO DE DIAS ENTRE DOS FECHAS ----- ****************************************************
01 FILLER. 03 T1-DIAS PIC X(48) VALUE '013102280331043005310630073108310930103111301231'. 03 T2-DIAS REDEFINES T1-DIAS OCCURS 12 TIMES. 05 MES PIC 99. 05 DIA PIC 99.
PROCEDURE DIVISION.
XXXX-CALCULO-DIAS. ******************
MOVE ZEROS TO NUMDIAS. MOVE MM-DESDE TO D. MOVE AA-DESDE TO CONTANOS.
56
PERFORM UNTIL CONTANOS = AA-HASTA AND D = MM-HASTA ADD DIA(D) TO NUMDIAS ADD CN-1 TO D IF D > CN-12 MOVE CN-1 TO D MOVE CN-1 TO CONTANOS END-IF IF CONTANOS = CN-100 MOVE ZEROS TO CONTANOS END-IF END-PERFORM.
SUBTRACT DD-DESDE FROM NUMDIAS ADD DD-HASTA TO NUMDIAS.
01 FILLER. 03 T1-DIAS PIC X(48) VALUE '013102280331043005310630073108310930103111301231'. 03 T2-DIAS REDEFINES T1-DIAS OCCURS 12 TIMES. 05 MES PIC 99. 05 DIA PIC 99.
57
PROCEDURE DIVISION.
XXXX-CALCULO-MESES. *******************
MOVE ZEROS TO MESES. MOVE AA-DESDE TO CONTANOS. PERFORM WITH TEST BEFORE UNTIL CONTANOS = AA-HASTA ADD CN-12 TO MESES ADD CN-1 TO CONTANOS IF CONTANOS = CN-100 SUBTRACT CN-100 FROM CONTANOS END-IF END-PERFORM. ADD MM-HASTA TO MESES. SUBTRACT MM-DESDE FROM MESES.
