MANUAL DE VIA/SMARTTEST

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

NDICE

INTRODUCCIN.......................................................................................................................................3 DEFINICION DEL APPLICATION KNOWLEDGE REPOSITORY.................................................4 CAPTURA DEL CONOCIMIENTO DEL PROGRAMA......................................................................6 SELECCIN DEL ENTORNO DE EJECUCIN..................................................................................8 CONEXIONES ON-LINE.......................................................................................................................11 ENTORNO TSO...................................................................................................................................11 ENTORNO CICS................................................................................................................................14 TEST REMOTOS EN CICS.................................................................................................................17 ENTORNO DB2...................................................................................................................................17 ENTORNO IMS..................................................................................................................................18 CONEXIONES BATCH.........................................................................................................................19 EJECUCIN..............................................................................................................................................19 AVANCE Y PARADA............................................................................................................................21 OPCIONES DE VISUALIZACION........................................................................................................23 PSEUDOCODIFICACIN.....................................................................................................................25 TRACKING / BACKTRACKING..........................................................................................................28 CONTADORES DE EJECUCIN..........................................................................................................29 FILE SERVICES (CICS)..........................................................................................................................30 ACCESO A FICHEROS..........................................................................................................................31 TEMPORARY STORAGE.....................................................................................................................32 TRANSIENT DATA...............................................................................................................................32 BASES DE DATOS DL/I........................................................................................................................33 BASES DE DATOS DB2........................................................................................................................34 TEST COVERAGE ANALYSIS (T.C.A.)..............................................................................................35 DEFINIR EL ENTORNO DE EJECUCIN...........................................................................................36 DEFINIR EL PLAN DE PRUEBA.........................................................................................................36 PREPARAR Y EJECUTAR LA PRUEBA.............................................................................................37 VERIFICAR LOS RESULTADOS DEL TEST .....................................................................................39 OBTENER LOS INFORMES RESULTADO.........................................................................................40

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

INTRODUCCIN
Dentro de EXISTING SYSTEMS WORKBENCH, VIA/SMARTTEST es la herramienta que cumple la doble funcin de prueba y depuracin de programas. Dicha funcin la realiza para un amplio espectro de entornos de ejecucin, lenguajes de programacin y ficheros o bases de datos. Entre otros, permite la prueba de programas Batch u On-line (CICS e IMS/DC) escritos en lenguaje COBOL, PL/I, ASM, APS, bases de datos DB2, DLI e IDMS, ficheros VSAM, QSAM, BDAM, BSAM. Una ventaja fundamental de VIA/SMARTTEST es la uniformidad de la prueba sea cual sea el tipo de programa o entorno; la nica diferencia consistir en la forma de entrada o preparacin de cada una de las pruebas, siendo el resto de componentes y funcionalidad del producto totalmente anloga. Para entrar en el producto, desde el men principal de E.S.W., seleccionar accin de TEST o bien letras T o ST. Si est instalado unitariamente, desde la CLIST apropiada o desde la entrada en el men de TSO. Pantalla principal de VIA/SMARTTEST: File View Test Search Logic List Options Help -----------------------------------------------------------------------------VIA/SmartTest R3.5 Command ===> _______________________________________________________________ __ VIA1676I TO DISPLAY INFORMATION REGARDING CUA FEATURES, PRESS ENTER. ************ *********** ******* ********* ****** ***** *** ***** * **** *** **** *** ******** ****** ****************** *** **** * ***** ************ ***** ***** ****************** *** **** ** *** *** *** **** **** *** *** *** **** *** *** *** ***** *** *** ********* *** *** **** **** *********** ******* *** *** ********* *** 3

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

*** *** **** ************* ***** **** **** *** ***** ******* ************* ***** ***** *** **** ****** ********* ****** ***

*** *** *** (R)

Copyright VIASOFT Inc., an unpublished work. A proprietary product of VIASOFT Inc. Use restricted to authorized licensees.

DEFINICION DEL APPLICATION KNOWLEDGE REPOSITORY

Al igual que toda la plataforma E.S.W., VIA/SMARTTEST se apoya en una Base de Conocimiento especial denominada Application Knowledge Repository (en adelante A.K.R.). Se trata de un fichero BDAM donde se almacenar toda la informacin necesaria para poder efectuar la prueba y depuracin de los programas. Su generacin deber efectuarse desde dentro de la herramienta, ya que presenta un paso muy importante de inicializacin. Para generarlo desde dentro de la herramienta, habr que utilizar la opcin 7 del men de FILE: -- 1. Setup test environment... 2. Select Test Coverage... 3. Open... 4. Close 5. Save 6. Compile/Analyze... 7. AKR utility... 8. Edit pseudo... 9. Execute... 10. Exit Esta opcin nos lleva al men de utilidades de A.K.R., donde podremos consultar el contenido de un A.K.R., alocar, expandir un A.K.R. existente, borrar un miembro o renombrar un miembro del mismo. File - AKR Utility Command ________________________________________________________ Blank - Display member list A - Allocate/expand AKR D - Delete member R - Rename member 4 ===>

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Application Knowledge Repository (AKR): Data set name . . 'USUARIO.VIASOFT.AKR' Member . . . . . ________________________________ (if "R" or "D" selected) New name . . . . ________________________________ (if "R" selected) Volume serial . . ______________________ Password . . . . (if not cataloged) (if password protected)

Si pulsamos INTRO, nos saca directamente la informacin sobre el contenido del A.K.R.: File - AKR Directory ____________________________________________ AKR: Row: 1 Total members: Total entries: 2 D - Delete Free space : 96.6% R Rename Total records : 2 4008 USUARIO.VIASOFT.AKR

Command Scroll ===> CSR

===>

Name New name Alias of Type Date Time Jobname Space ----------------------------------------------------------------------------_ VIAMERG4 __________ IN,STX 26JUN1998 09:47 ZDAJSBA 2.3% _ VIASUB4 __________ IN,STX 26JUN1998 09:46 ZDAJSBA 1.1% ******************************* BOTTOM OF DATA ****************************

En la misma, da informacin sobre los miembros que contiene, para qu producto se captur el conocimiento, la fecha y hora del anlisis, el nombre del Job que lo analiz y el porcentaje de espacio alocado del AKR que ocupa. Tambin informa sobre el espacio libre (en porcentaje) que le queda al A.K.R.; sin embargo, esta estimacin se refiere al espacio que tiene en esos momentos asignado, y no toma en cuenta aquellas extensiones an no utilizadas. Si por el contrario elegimos alocar/expandir un A.K.R. (comando A), saltamos a otra pantalla: 5

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

File - AKR Allocate/Expand Command ___________________________________________________________ S - Submit JCL Catalog Expand existing AKR . . . NO (Yes or No) E - Edit JCL

===>

C - Specify

AKR data set name . . . . 'USUARIO.VIASOFT.AKR' Volume . . . . . . . . ______ Unit . . . . . . . . . SYSDA (Generic unit name) Space units . . . . . . RECORDS (Records, Tracks or Cylinders) Primary space . . . . . 4000 (Primary amount in above units) Secondary space . . . 0 (Secondary amount in above unit) Job statement information: //ZDAJSBB JOB (ACCOUNT),'NAME',CLASS=A,NOTIFY=ZDAJSB, // MSGCLASS=A //* INSERT '/*ROUTE PRINT NODE.USER' HERE IF NEEDED. //* En la misma tendremos que indicar si quiero expandir un A.K.R. existente o alocar uno nuevo, el nombre del mismo, el VOLUME (si se quiere uno especfico), UNIT, SPACE UNITS, PRIMARY y SECONDARY SPACE y una cabecera Job correcta; una vez indicados estos parmetros, se puede submitir el Jcl. En la terminacin del Jcl habr que verificar no solo el resultado del Jcl como tal sino tambin los mensajes propios de Viasoft que indican que el A.K.R. ha sido correctamente inicializado.

CAPTURA DEL CONOCIMIENTO DEL PROGRAMA

Un aspecto fundamental del proceso es el anlisis del programa para el almacenamiento de la informacin necesaria en el A.K.R. El proceso de anlisis est incorporado a los procesos habituales de compilacin de la instalacin, y puede estar implementado de tres maneras diferentes: a) Desde dentro de VIA/SMARTTEST, opcin 6 del men de FILE; nos lleva a la pantalla siguiente:

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

File Analyze Submit Command ________________________________________________________ E Edit Jcl S - Submit Jcl ===>

D - SmartDoc Options

Compile and link Jcl (PDS or Sequential): Data set name USER.TEST.CNTL(COMPILA) Analyze features (y/n): Insight: N Smarttest: Y Renaissance: N Extended Analysis: Y SmartDoc: N

A.K.R. data set name USER.TEST.AKR A.K.R. program name ___________ PROGRAM_ID)

(if overriding

Analyze options: ________________________________________________________________ ___________________ ________________________________________________________________ ___________________ ________________________________________________________________ ___________________ Compile? (Y/N).............................................. Link Load module reusable? (Y/N) ............... N (Y if needed by features) ( Smarttest only)

En esta pantalla hay una serie de parmetros a especificar: El Jcl de compilacin con el que queramos compilar el programa. Para qu producto o productos de E.S.W. queremos realizar el anlisis: Insight, SmartTest, SmartDoc o Renaissance. En principio, especificaremos Smarttest = Y, Extended Analysis = Y; de esta forma, podremos utilizar la funcionalidad de Insight dentro de Smarttest. En este caso, si se quiere utilizar directamente VIA/Insight no hace falta especificar la opcin de Insight, ya es suficiente con la opcin de Extended Analysis). Nombre del A.K.R. donde queremos almacenar el resultado del anlisis; tambin se puede especificar si se quiere que dentro del mismo tenga un nombre diferente al Program_Id del programa. Opciones especiales del anlisis. 7

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Si queremos compilar o no el programa; Smarttest precisa siempre de linkedicin, por lo que pongamos Y o N, siempre compilaremos, por lo que se recomienda poner a NO, a no ser que se quiera Compilar/Linkeditar por otras razones ajenas al uso de ESW. Linkedicin de los mdulos como reusables. Se trata de una opcin de Override sobre la que tenga el paso de Linkedicin si esta es NOREUS. La recomendacin es siempre NO. Una vez rellenados dichos parmetros, con S podemos submitir directamente el Jcl, o mediante E, editarlo y submitirlo desde dentro con SUB normal. b) Si existen, desde los paneles de compilacin de la instalacin; en dicho caso, se habrn modificado para incluir si quiero analizar o no para Smarttest, y aparecer una pantalla totalmente anloga a la anterior pero donde ya no se solicita Jcl de compilacin. c) Desde dentro de un Jcl normal de compilacin; en lugar de usar SUB, utilizar VIASUB, que sacar la misma pantalla que en el caso anterior. Esta opcin precisa que la librera de CLIST del producto est alocado en SYSPROC del procedimiento de Logon del usuario. Sea cual sea el mtodo elegido, una vez submitido, habr que verificar el resultado de la compilacin y comprobar que se ha almacenado la informacin en el A.K.R.

SELECCIN DEL ENTORNO DE EJECUCIN

Como se coment anteriormente, una funcionalidad muy importante de VIA/SMARTTEST es la unicidad de la prueba sea cual sea el entorno o programa; sin embargo, esto implica un proceso de decisin para ver COMO se quiere probar cada tipo de programa. Todos los tipos de prueba se dirigen desde la misma pantalla, a la que se puede llegar directamente desde la pantalla principal de VIA/SMARTTEST tecleando ENV, o mediante paneles con la opcin 1 del men de FILE, y opcin 2 del siguiente men. De esta manera, se llega a la pantalla siguiente: Environment Selection Command ________________________________________________________ A Specify additional AKRs P Specify PROCLIBs L - Specify additional LOADLIBS D - Display AKR Directory 8

===>

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Environment selection: Current environment is ISPF Online: 1 - TSO Batch 2 - CICS Batch 3 - ISPF Dialog Batch 4 - IMS/DC Batch 5 - IMS/DB 6 - BTS 7 - DB2 8 - DB2 Procedure Batch Connect: 9 - MVS 10 - IMS 11 - BTS 12 - DB2

Application Knowledge Repositories (AKR): 1 Specified 'ZDA.ZDAJSB.FTESAKR' ______________________________________________ Application Load Libraries: 1 Specified 'ZDA.ZDAJSB.LOAD' ______________________________________________ ______________________________________________ En la misma, los tipos de prueba estn agrupados en dos grandes grupos, segn se trate de pruebas a realizar en entonos on-line o de pruebas a realizar de forma batch pura: Conexiones On-line: 1 - TSO en una Jcl batch con programa que no accede a Bases de Datos convertido Clist. 2 - CICS Monitor de teleproceso CICS. 3 - ISPF Dialog programas). Programas ejecutados bajo dilogo ISPF (pantallas,clists,

4 - IMS/DC Monitor de teleproceso IMS. 5 - IMS/DB Jcl con programa que accede a Bases de Datos de IMS (DL/I). 6 - BTS Simulador batch de programas on-line IMS. 7 - DB2 Jcl con programa que accede a Bases de Datos DB2 convertido a Clist. 8 - DB2 Procedimientos almacenados de DB2. (DB2 4.1 o superior). Conexiones Batch:

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

9 - MVS BATCH Datos. 10 - IMS BATCH Datos DL/I.

Jcl batch puro con programa que no accede a Bases de Jcl batch puro con programas que acceden a Bases de

11 - BTS BATCH Anlogo para simuladores de IMS/DC. 12 - DB2 BATCH Jcl con programas que acceden a DB2. Adems del entorno, habr otra serie de informacin a suministrar: El o los A.K.R. donde se encuentran los programas a monitorizar; en caso de necesitar introducir ms de tres, con A en la lnea de comandos, obtengo otra pantalla para poder rellenar. La o las libreras Load donde se encuentran los programas a ejecutar; al igual que antes, con L en la lnea de comandos, obtengo otra pantalla de insercin. Dichas libreras Load son las indicadas en el JCL de ejecucin (SYSTSIN, STEPLIB y/o JOBLIB) y en el mismo orden de concatenacin para los entornos 1,5,7. Para los entornos 3 y 4, suele ser suficiente con la librera Load que contiene los cargables a ejecutar. Para los entornos 2,9,10,11 y 12 NO es necesario indicar ninguna Load Library. Con P, puede especificar libreras de procedimientos, y con D mostrar el contenido de los A.K.R. Una vez rellenada esta informacin, ya se puede pasar a especificar el entorno de nuestra prueba; cada uno de ellos a su vez necesitar cierta informacin aadida. Una opcin muy interesante es la posibilidad de salvar los distintos entornos en los que se van efectuando pruebas, con lo que toda esta informacin suministrada, se guarda y no es necesario su reintroduccin. Para ello, LIST PROFILES, u opcin LIST PROFILES del men de LIST, nos lleva a la siguiente pantalla:

Profile Data Set Member List Command _____________________________________________________________ The current environment is: ISPF Profile dataset name : 'SPF.PROF.ZDAJSB' COPY TO dataset name ______________________________________________ S Select member to restore W - Write current environment to member 10

===>

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

C Copy selected member R - Replace member (Pending status) D Delete member * denotes TCA Profile Profile Environ User profile description (optional) - -----------------------------------------------------------------_ VIAPST01 TSO pruebas del curso _ VIAPST02 TSO pruebas _ VIAPST03 ___________________________________________________ _ VIAPST04 ___________________________________________________ _ VIAPST05 ___________________________________________________ _ VIAPST06 ___________________________________________________ _ VIAPST07 ___________________________________________________ _ VIAPST08 ___________________________________________________ _ VIAPST09 ___________________________________________________ _ VIAPST10 ___________________________________________________ _ VIAPST11 ___________________________________________________ _ VIAPST12 ___________________________________________________ _ VIAPST13 ___________________________________________________

AVAILABLE AVAILABLE AVAILABLE AVAILABLE AVAILABLE AVAILABLE AVAILABLE AVAILABLE AVAILABLE AVAILABLE AVAILABLE

Aqu, mediante W a la izquierda del primer profile libre, se salva el mismo; por el contrario, con S se recupera cualquiera de los entornos previamente guardado. CONEXIONES ON-LINE Se trata de aquellas pruebas en monitores de teleproceso propiamente dichos, o aquellas que originariamente eran programas batch, y a los cuales, tras un proceso extremadamente sencillo, se les ha convertido en una CLIST, para ejecutar en regin CICS (on-line por naturaleza). Entre otras cosas, esto permite el ejecutar programas batch de forma completamente on-line, con lo que se evita colapsar los iniciadores del SPOOL y parar al resto de usuarios de la instalacin (por tener ms tiempo ocupados los iniciadores para jobs batch). ENTORNO TSO

11

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Se trata de un Jcl que ejecuta un programa batch el cual no accede a bases de datos, sino nicamente a ficheros. Para la conversin del Jcl a Clist, nicamente habr que suministrar la siguiente informacin:

TSO Session Setup Command ___________________________________________________________ R - Begin TSO test session (RUN) C - Convert batch JCL to TSO CLIST Execution: Load module VIAMERG4 entry (Y/N) YES CSECT/pgm id ________ Execution parameters: (quotes are optional) __________________________________________________ __________________________________________________ File allocation CLIST: Data set name 'USUARIO.LIBRERA.CLIST' Member . . . VIACLIST test NO

===>

Options: Break on Break

Deallocate after

Load Module indicado en el JCL que se quiere ejecutar o que llama al que queremos monitorizar. Break on Entry: programa. Si se quiere que se pare la ejecucin al comienzo del

Break CSECT: Si el programa tiene CSECT linkeditados estticamente y se quiere parar al comienzo de alguna de ellas. Execution Parameters: Parmetros opcionales propios del programa. La propia conversin del JCL en Clist rellena esta informacin. Fichero y miembro donde se va a alocar la Clist en que se va a convertir el Jcl. 12

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Deallocate after test: Al estar ejecutando una Clist, es necesario alocar los ficheros que utiliza el programa; si se pone a YES, cada vez que se ejecute el programa se alocaran y al terminar se desalocaran, por lo que es conveniente dejarlo a NO (y se desalocarn al salir de VIA/SMARTTEST o con la opcin D de DEALLOCATE). A continuacin se debe especificar la opcin C para convertir en Clist, que nos lleva a la siguiente pantalla: Convert Batch JCL Command ___________________________________________________________ C - Convert batch JCL into CLIST allocate E - Edit file allocation CLIST deallocate P - Specify procedure libraries Batch Execution JCL: Data set name 'DE00.ZDAJSB.JCL' Member . . . VIAMEJC4 File allocation CLIST: Data set name 'USUARIO.LIBRERA.CLIST' Member . . . VIACLIST (Blank defaults to JCL member) Options: Delete (Y/N) YES (Delete before create 'DISP=NEW' datasets) Step (Y/N) YES (Only convert step with program to be tested) Subsystem . . ____ (Source Library Manager subsystem name) Step Name . . ________ (Unique step name in JOB to convert)

===>

A - Execute CLIST for D - Execute CLIST for J - Edit batch JCL

Aqu habr que especificar la librera y el miembro que contiene el Jcl a convertir, si se quiere que los ficheros con DISP=NEW se borren al comienzo de la prueba, si se quiere convertir un nico paso o ms, y si el Jcl radica en un Gestor de Fuentes o Jcl, de cual susbsistema de acceso se trata. Una vez especificado, con la opcin C se convierte en Clist, y con PF3 se vuelve a la pantalla anterior, desde la que ya se puede comenzar la prueba.

13

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

ENTORNO CICS Para probar programas bajo entorno CICS, no es necesario salir de TSO y entrar en CICS, ya que la conexin se realiza directamente desde TSO. La conexin se realiza mediante la Opcin 2 de la pantalla de ENVIRONMENT, que nos lleva a la siguiente pantalla: CICS Session Setup Command ===> _________________________________________________________________ Enter PF1 for Setup/Usage instructions C Connect to CICS resources D Disconnect from CICS monitored T Toggle back to CICS regions programs 5 - Set up Remote (RMF) test (LU6, DPL, Asynch) Program (PPT) to test . . PPBE0050 Break at Start (Y/N) . . YES (Break on first monitored program.) CICS Logon Region APPLID CICS7 Toggle PFKEY . . . . . . PF12 1 - Specify limits on CICS 2 - Specify modules/tasks to be 3 - Turn on monitoring in related 4 - Request Break on Entry to

(PF1-PF24,"NONE")

Desde esta pantalla se efectuar la conexin al CICS, pero se necesita cierta informacin: El CICS Logon APPLID (o su alias) es decir, a qu CICS se quiere conectar. Toggle PFKEY Ser una tecla de funcin que servir para cambio de sesin entre TSO y CICS. Con C se efecta la conexin al CICS que queramos; una vez llegado a este, recibiremos la pantalla de Bienvenida y de Logon (si es la operativa habitual de la instalacin), y tras pasarlas, (si hace falta), recibiremos un mensaje de VIA/SMARTTEST CICS IS ACTIVE

14

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

En este momento, ya se puede comenzar a preparar la prueba; mediante la tecla definida como Toggle volveremos a TSO, y desde este al Cics con T. Antes de comenzar a preparar la prueba, es necesario realizar dos advertencias: - Realizar la Newcopy de los productos desde dentro de VIA/SMARTTEST; para ello, men de Test, o comando NEWCOPY NOMBRE-PGM. - Desconectarse ordenadamente. Preparacin del Test Una vez conectado, se puede preparar el test; para ello, habr que volver desde CICS a TSO y rellenar las opciones de la derecha de la pantalla de setup: 1 - SPECIFY LIMITS ON CICS RESOURCES VIA/SMARTTEST tiene una serie de lmites por defecto; si alguno de ellos se queda pequeo, se da un mensaje de advertencia indicando qu lmite hay que ampliar. 2 SPECIFY MODULES/TASKS TO BE MONITORED Dentro de esta opcin, los submens 1 y 2 indican si se quiere interceptar a nivel transaccin (con lo cual se interceptar cualquier programa de la misma) o a nivel programa individual. La opcin 3 indica si se quiere elegir destinos alternativos para ficheros, colas TD o TS, o programas. La opcin 4 es de monitorizacin a nivel global; mediante ella, se interceptar CUALQUIER programa de cualquier usuario conectado a VIA/SMARTTEST, por lo que no es recomendable ni necesaria su utilizacin. 3 - TURN ON MONITORING IN RELATED REGIONS Cada vez es ms comn la existencia de CICS M.R.O.; para poder testear programas en dicho entorno es necesario la utilizacin de esta opcin. Dado que la conexin inicial se hace al TOR, y los programas se ejecutan en los AOR, una vez conectado, habr que entrar en esta opcin, donde aparecen todas las regiones conectadas con la elegida; habr que poner MONITOR=YES en la regin donde se vaya a ejecutar el programa, y actualizar el valor CURRENT SYSID a dicha regin, si se quiere hacer NEWCOPY del programa o uso de las opciones de LIST FILE (FILE SERVICES).

15

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

4 REQUEST BREAK ON ENTRY TO PROGRAMS Existen una serie de opciones que se pueden customizar para cada programa o grupo de programas (admite mscaras); se trata de las opciones siguientes: Test Session Tailoring VIAMERG4.VIAMERG4 Command ===> ________________________________________________ Scroll ===> CSR Monitor Track Count Break Break Break Pseudo Single Module.Program id Act Act Act Act Entry Rtn Act Step --------------------------------- -------- -------- --------- -------- -------------------------************************************* TOP OF DATA ********************************* '''' VIAMERG4.VIAMERG4 YES NO YES NO NO YES YES 5 SET UP REMOTE (RMF) TEST (LU6.1, DPL, ASYNCH) VIA/SMARTTEST presenta la posibilidad de efectuar test remoto, tanto en terminales 3270 normales, como conexiones de cliente/servidor o transacciones asncronas. El proceso a seguir se describe en el apartado siguiente; sin embargo, es necesario describir las diferentes formas de interceptar un programa: CICS USERID: Es la ms indicada, ya que garantiza la unicidad del programa/usuario a interceptar. Dicho parmetro coincide con las 4 ltimas posiciones no blancos del USERID que enva el gateway del cliente. CONNECTION: Se trata del nombre del componente de donde procede la TX a interceptar; Se interceptar cualquier programa procedente de dicha conexin PERO sujeto a las restricciones de parada de las opciones anteriores. OTHER 3270 TERMINAL: Es el test remoto clsico; permite parar cualquier TX arrancada en el mismo CICS pero desde otro terminal diferente al nuestro. LU6.2/IRC: Parar cualquier TX que venga desde esa LU, PERO ATENCION que dicho valor variar entre diferentes ejecuciones. (Facility del CICS: -9XX/Axx). ASYNCH TRANSACTION: Transacciones arrancadas desde la nuestra mediante un EXEC CICS START TRANSID. (sin TERMID asociado). NOTA GENERAL: Cundo se queiran interceptar programas llamados via CALL (en lugar de LINK, XCTL...), hay que especificar tambin el programa que efecta la llamada. Sin embargo, poniendo el parmetro BREAK AT 16

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

START=NO, y en 4 (LI TA) el llamado con CALL, nicamente se parar en el programa deseado. TEST REMOTOS EN CICS Cada da es ms comn la utilizacin de arquitecturas basadas en tecnologas Cliente/Servidor. VIA/SMARTTEST permite el monitorizar ese tipo de programas sin ningn problema. Para ello, el proceso es el siguiente: - Conectarse al CICS. - Volver a TSO. - En la pantalla 2 del Setup, indicar el/los programas a monitorizar. - En opcin 3, verificar que el valor CURRENT SYSID se correponde con el del CICS donde se vaya a ejecutar en realidad la prueba (esto es muy importante en entornos MRO). - En opcin 4, verificar las opciones especficas de parada del programa(s). - En opcin 5 (RMF) indicar por cual de las opciones se va a interceptar al programa; usuario, conexin, LU.. (apartado anterior). - Volver (mediante T, Toggle) a la pantalla de CICS nativo (limpia). - Ejecutar desde el cliente; cuando se llegue a l, el programa se parar. MUY IMPORTANTE: Una vez finalizado un test remoto, LIMPIAR SIEMPRE la pantalla de la opcin 5 (RMF), ya que en sucesivas pruebas en entorno CICS normal podra dar problemas al asignar ese terminal virtual de VIA/SMARTTEST a otro usuario. ENTORNO DB2 Se trata de la prueba de programas batch que acceden a bases de datos DB2. La conversin del Jcl a Clist es muy similar al caso de TSO, con la salvedad de tener que suministrar nuevos parmetros como el plan o el subsistema: DB2 Session Setup Command ===> R - DB2 test session (RUN) to CLIST C - Convert batch JCL

17

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Execution: Load module PPBE0050 YES DB2 Plan name PPBE0050D ________ DB2 Subsystem DB1D

Options: Break on entry (Y/N) Break CSECT/pgm id

Execution parameters: (quotes are optional) __________________________________________________ __________________________________________________ File allocation CLIST: Data set name 'USUARIO.VIASOFT.CLIST' Member . . . . VIACLIST

Deallocate after test NO

ENTORNO IMS Para poder interceptar programas en el monitor de teleproceso IMS, habr que rellenar la pantalla de la pgina siguiente:

IMS/DC Session Setup Command ===> _________________________________________________________________

C Connect to IMS (RUN) D Disconnect from IMS T Select Transactions Options: Break on entry (Y/N) Break CSECT/pgm id YES ________

E 3270 Terminal emulation N Native IMS terminal A - GSAM/User file allocation

Current Test Session Status SESSION IS NOT ACTIVE Current Setup Options: 18

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

TEST SESSION WILL USE PRIVATE DATABASES TEST SESSION WILL USE 3270 EMULATION FOR LTERM ACTIVITY TEST SESSION WILL NOT CONNECT TO AN ONLINE IMS REGION

C Inicia la sesin IMS/DC; es anloga a teclear el comando RUN. D Finaliza la sesin IMS/DC. T Salta a otra pantalla para especificar, revisar y/o modificar la lista de Transacciones. E Muestra la pantalla de emulaciones para elegir el terminal 3270 apropiado. A Para alocar la Clist y el miembro. CONEXIONES BATCH La prueba de los programas batch puede ser realizada tambin de forma totalmente batch pura; sin embargo, presenta el claro inconveniente de coger cada prueba en exclusiva un iniciador de una clase del spool, por lo que se puede llegar a colapsar al resto de usuarios que utilicen dicha clase. La operativa es muy similar a la seguida en el caso de conversin en Clist; la diferencia radica en que en lugar de convertir el Jcl en Clist, (se genera un Jcl paralelo); este debe ser submitido, y cuando coja un iniciador, enviar un mensaje de vuelta al usuario indicando que en cualquier momento puede conectarse al Jcl submitido para comenzar la prueba.

EJECUCIN
Una vez elegido y preparado el entorno, se puede comenzar la prueba; si se eligi parar al comienzo del programa, aparecer la siguiente pantalla; en caso contrario, a menos que haya abend o breakpoint, no se ver el mismo.

File View Test Search Logic List Options Help --------------------------------------------------------------------------------Program View PPBE050.PPBE050 -A Command ===> ________________________________________________ 19

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Scroll ===> CSR 000777 >>>>>> PROCEDURE DIVISION USING LS-PARAM. 000779 **************************************** 000780 000781 INICIO. 000782 *======= 000783 000784 PERFORM PRINCIPIO-PROGRAMA 000785 000786 IF DATOS-CORRECTOS 000787 PERFORM PROCESO 000788 END-IF 000789 000790 PERFORM FIN-PROGRAMA +---------------------------------------------------------------------------------------------------------------------------------+ |STATUS: BREAK AT START OF TEST SESSION PROGRAM: PPBE050 DATE: 01JUL1998 | | STMT: 000778 OFF: 001E34 AMODE: 31 MODULE: PPBE050 TIME: 08:17:55 | |SOURCE: PROCEDURE DIVISION USING LS-PARAM. | +---------------------------------------------------------------------------------------------------------------------------------+

En la misma aparece informacin interesante: Arriba a la derecha aparece un mensaje que nos indica el nombre del load module seguido del nombre del Program_id o CSECT en el AKR, y un mensaje que indica si la sesin est activa o no. El CHEVRON (>>>>>) que indica la siguiente instruccin/sentencia a ejecutar. Abajo, aparece la caja de status que muestra: La sentencia a ejecutar. (STMT) El estado de la sesin del test. (STATUS) El Offset relativo. El Mdulo/Programas activos. La fecha/hora. El ADDRESS MODE (amode).

A partir de ahora, ya se puede comenzar a ejecutar el programa segn cual sea el objetivo de la prueba.

20

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

AVANCE Y PARADA Una de las funciones ms importantes a la hora de ejecutar y controlar una prueba, es como avanzar en la misma, como controlar las posibles paradas y como cancelar la misma. - PA1/ATTENTION: Para suspender la prueba en regin TSO (1,3,4,5,6,7,8), si el programa entra en un bucle o estamos leyendo un fichero o base de datos excesivamente grande, se puede recuperar el control de la ejecucin pulsando dicha PF. - PF3/CAN: Si en cualquier momento se quiere parar el test, con PF3 o CAN, se termina la misma. Para avanzar: - PF4: Tecla programada al comando RUN; se ejecutar hasta fin del programa, o hasta que se produzca un abend o se encuentre un punto de parada. - RUN TO n (donde n es nmero de lnea): Ejecuta hasta el nmero de lnea indicado. (siempre que no se encuentre el fin del programa, abend o punto de parada). Sin especificar n, ejecuta hasta la sentencia donde se encuentra el cursor. Existen tambin una serie de comandos de ejecucin poco a poco: - PF6: Tecla programada al comando STEP: Ejecucin sentencia a sentencia. - STEP n: Ejecucin de n sentencias. - STEP OVER: Posicionado sobre una sentencia (cualquiera que sea), la ejecuta y se posiciona justo en la siguiente a ejecutar; muy interesante ante performs y calls que se quiera ejecutar y no monitorizar. - STEP PARA: Dentro de un prrafo ejecuta hasta el comienzo del siguiente prrafo, y se para en ste. - GO TO nmero de lnea: Salta hasta la lnea indicada pero SIN EJECUTAR las lneas intermedias, por lo que deber utilizarse con extremo cuidado. - LOCATE *: Desde cualquier sitio del fuente, lleva directamente hasta la posicin donde se encuentren los chevrons.

21

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Tan importante como avanzar en la ejecucin como se requiera, es el poder parar la misma segn se desee. Para ello existen diversas opciones: - BREAKPOINTS: Puntos de parada; se pueden colocar manualmente insertando BR en la lnea de nmeros de la izquierda, o bien de forma global mediante el men de Test; este permite introducirlos delante o detrs de alguna variable, slo ante sus modificaciones, sus usos, ante cualquier subsets,... Para eliminarlos, con una D en la lnea de nmeros de la izquierda; si se quieren eliminar todos, RES BREAK los quita. Sin embargo, dado que el colocar estos puntos de parada es un trabajo que puede llegar a ser difcil, existe la posibilidad de inactivar lgicamente a los mismos, sin necesidad de eliminarlos; para ello, existe la opcin LIST BREAKPOINTS del men de LIST: BreakPoints List VIAMERG4.VIAMERG4 -A Command ===> ________________________________________________ Scroll ===> CSR Set pseudo . . ON Set breaks . . ON Set whens . . . ON Pseudo active: 3 Breaks active: 2 Whens active: 0 Inactive: 0 Inactive: 0 Inactive: 0

S Line Pseudo code A Count ------ ----------------------------------------------------------------------------------------_ 000213 3300-READ-INFILE3-X. _ '''''1 BREAK. Y 000000 _ 000214 MOVE SPACES TO OUTFILE-WORK-AREA, ------- ---------------------------------------------------------------------------------------_ 000218 + INFILE3-EOF. _ '''''1 BREAK. Y 000000 _ 000219 IF READ-3-FILES --------------------------------------------------------------------------------------------_ 000432 MOVE ZERO TO READ-INFILE1-SWITCH. _ '''''1 MOVE 04 TO END-FILE-COUNT 22

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Y 000000 +---------------------------------------------------------------------------------------------------------------------------------+ |STATUS: BREAK AT START OF TEST SESSION PROGRAM: VIAMERG4 DATE: 01JUL1998 | | STMT: 000000 OFF: 000000 AMODE: 31 MODULE: VIAMERG4 TIME: 14:35:45 | |SOURCE: *EXTERNAL CODE* | +---------------------------------------------------------------------------------------------------------------------------------+ Adems, es posible el inactivarlos todos a la vez o individualmente uno a uno, y volverlos a activar cundo se desee. - ADDRESS STOP: Sin embargo, en muchas ocasiones, lo que de verdad interesa a la hora de depurar un programa no es una lnea en cuestin, sino una posicin de memoria en particular (sobre todo a la hora de depurar abends). Para ello se pueden introducir puntos de parada ante modificaciones de posiciones fsicas de memoria; dado que la posicin como tal pocas veces ser conocida, es posible el utilizar una variable como forma de referenciar a la posicin fsica. Para ello, STOP NOMBRE-VARIABLE provocar que la ejecucin se pare ante cualquier modificacin que sufra la posicin fsica de memoria que contiene a dicha variable. Al igual que antes, es posible el eliminar dicha forma de parada tanto fsica como lgicamente; en ambos casos, se har a travs de la opcin ADDRESS STOP del men de LIST. Es importante resaltar que dicha opcin solo es utilizable cuando ha comenzado la ejecucin, ya que previamente no se han asignado las posiciones fsicas, y que cuando termina la ejecucin, se pierden, ya que la siguiente vez que se ejecute el programa, las posiciones fsicas asignadas sern otras. OPCIONES DE VISUALIZACION No solo es importante el controlar la ejecucin de la prueba; tambin es fundamental el poder monitorizar y/o modificar en su caso el contenido de las variables. Para ello existen una serie de opciones diferenciadas, segn cual sea el objetivo a conseguir:

23

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

- ZOOM: Mediante esta opcin, se abrir una caja en la pantalla que mostrar el valor de la/las variables existentes en dicha fila de la pantalla, permitiendo su modificacin. Presenta una serie de variaciones: ZD Muestra la variable y su definicin. ZH Variable en hexadecimal. ZG Variable y su grupo. ZGH Grupo en hexadecimal. Para la eliminacin de la ventana, ZO elimina una, RES ZOOM las elimina todas. En el caso de existir muchas variables en una lnea, o si se pide el grupo y tiene muchas variables hijas, pueden llegar a desaparecer de la pantalla las lneas de cdigo; para manipular el nmero mximo de lneas por ventana de ZOOM, se puede utilizar el parmetro DATA de la opcin de MODES en el men de OPTIONS (comando SET) dentro de la ventana de ZOOM se podr avanzar con PF7/PF8. Una particularidad de las ventanas de ZOOM es que permanecen en el lugar del fuente donde se colocaron, con lo que al avanzar en la prueba se dejan de visualizar. Para ello, existe una variacin del mismo: - KEEP: Comando totalmente anlogo al anterior, pero con la diferencia que la caja abierta se mantiene justo debajo de la lnea de comandos. Permite las variaciones K, KH, KG y KGH. Para eliminarlas, D elimina una y RES K las elimina todas. Para controlar el nmero de lneas por caja, existe el parmetro KEEP en MODES del men de OPTIONS. Sin embargo, en muchas ocasiones, no es tan importante el ver y/o modificar el valor de las variables, sino tan solo ver o modificar; para ello existen otra serie de opciones: - DISPLAY nombre variable: Muestra el contenido inmediato de la variable, pero no se permite su modificacin. - SET OPERANDS ON: Muestra en todo momento el valor de las variables implicadas en la siguiente instruccin a ejecutar.

24

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Las dos opciones anteriores muestran el contenido como el verbo DISPLAY de COBOL. Si lo que se desea nicamente es modificar el contenido de ciertas variables, existen una serie de comandos que se pueden introducir directamente en la lnea de comandos para ello: - MOVE valor TO nombre variable: variable indicada. Se mueve el valor especificado a la

- ADD valor TO variable: Aade el valor a la variable. - SUBSTRACT valor FROM variable: Resta un valor a la variable.

PSEUDOCODIFICACIN Una funcionalidad importante de VIA/SMARTTEST es la posibilidad de introducir CDIGO en medio de la realizacin de una prueba. Adems, presenta un autoverificador de la sintaxis del cdigo introducido, y si se introduce justo antes del chevron, la ejecucin se retoma desde el cdigo introducido, no continua con la lnea siguiente. Con esto se gana una gran cantidad de tiempo, ya que se evita el tener que volver al fuente, escribir el cdigo, compilar, preparar datos de entrada... Adems, si se decide que el cdigo introducido es el correcto, existe la posibilidad de trasladarlo de forma automatizada a VIA/SMARTEDIT. Presenta los tres tipos de programacin existentes; Secuencial. Iterativa, Repetitiva y

Para introducir el cdigo, con una I en la lnea de nmeros de la izquierda, se abren lneas en blanco para poder teclear el cdigo deseado. Sentencias iterativas: MOVE, ADD, SUBSTRACT. Sentencias condicionales: IF/ELSE/NEXT SENTENCE. Sentencias repetitivas: GO TO / Etiquetas de prrafos. Variables: Niveles 77. Existen dos sentencias especiales muy interesantes: &COUNT: Introducida en una lnea, cuenta cuantas veces se ha pasado por la misma; es anlogo a definir un contador, incrementarlo...

25

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Permite el interrogar por el contenido de dicho campo, parar cuando tenga un determinado valor... &WHEN: Permite el introducir condiciones para parar la ejecucin en cualquier momento. Al igual que con los BREAKPOINTS, existe la posibilidad de eliminar el cdigo fsicamente (D a la izquierda, o RES PSEUDO para todos) o inactivarlo lgicamente; para ello, opcin LIST PSEUDO del men de LIST. Adems, en la pantalla presenta un contador con el nmero de veces que ha pasado la ejecucin por dicha lnea.

Pseudo Code List VIAMERG4.VIAMERG4 -A Command ===> ________________________________________________ Scroll ===> CSR Set pseudo . . ON Set breaks . . ON Set whens . . . ON Pseudo active: 3 Breaks active: 2 Whens active: 0 Inactive: 0 Inactive: 0 Inactive: 0

S Line Pseudo code A Count ------ ----------------------------------------------------------------------------------------_ 000213 3300-READ-INFILE3-X. _ '''''1 MOVE 0 TO CONTADOR Y 000000 _ 000214 MOVE SPACES TO OUTFILE-WORK-AREA, ------- ---------------------------------------------------------------------------------------_ 000218 + INFILE3-EOF. _ '''''1 BREAK. Y 000000 _ 000219 IF READ-3-FILES --------------------------------------------------------------------------------------------_ 000432 MOVE ZERO TO READ-INFILE1-SWITCH. _ '''''1 MOVE 04 TO END-FILE-COUNT Y 000000 +---------------------------------------------------------------------------------------------------------------------------------+ |STATUS: BREAK AT START OF TEST SESSION PROGRAM: VIAMERG4 26

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

DATE: 01JUL1998 | | STMT: 000000 OFF: 000000 AMODE: 31 MODULE: VIAMERG4 TIME: 14:35:45 | |SOURCE: *EXTERNAL CODE* | +---------------------------------------------------------------------------------------------------------------------------------+ Si se decide trasladar el cdigo al editor, es preciso salvarlo en primer lugar en el AKR; para ello, opcin SAVE del men de FILE, y posteriormente, mediante la opcin EDIT PSEUDO del mismo men de FILE, se salta directamente al editor. Una vez en el fuente, en el mismo aparece un mensaje: File View Test Search List Options Help --------------------------------------------------------------------------------Command ===> ________________________________________________ Scroll ===> CSR USE UPDATE ALL COMMAND TO APPLY CHANGES 000777 000778 PROCEDURE DIVISION USING LS-PARAM. 000779 **************************************** 000780 000781 INICIO. 000782 *======= 000783 000784 PERFORM PRINCIPIO-PROGRAMA 000785 000786 IF DATOS-CORRECTOS 000787 PERFORM PROCESO 000788 END-IF 000789 000790 PERFORM FIN-PROGRAMA. 000791* 000792 PRINCIPIO-PROGRAMA. 000793 000794 OPEN INPUT FENTRADA. +---------------------------------------------------------------------------------------------------------------------------------+ Tecleando UPDATE, pedir el nombre del AKR y del programa desde el cual debe importar el cdigo introducido. Si se borra el mensaje, la opcin UPDATE del men de FILE en VIA/SMARTEDIT produce el mismo efecto. Tambin se traspasan los Breakpoints, pero asteriscados; esto nos permitir, una vez reanalizado y recompilado el programa, volver a testearlo y agregarle

27

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Breakpoints de forma automtica (mediante PATTERN=BREAK) en los mismos sitios.

TRACKING / BACKTRACKING Existen una serie de TRACKS de ejecucin tanto hacia delante como hacia atrs que permiten comprender como se ha ejecutado REALMENTE el programa. - TRACK: Es posible activar un TRACK de ejecucin de manera que en pantalla solo aparezcan aquellas sentencias que realmente se estn ejecutando. Para ello, en la opcin LIST TAILOR del men de LIST, ser preciso activar el switch TRACK=YES para el programa en cuestin. (aunque es el defecto si no hay ninguna entrada en LI TA). Una vez activado, en la opcin EXECUTION TRACKING del men LIST se visualizar la ejecucin lnea a lnea, prrafo a prrafo... Es muy interesante la utilizacin combinada de la utilidad de SET OPERANDS ON para ir viendo el contenido de las variables segn avanza la ejecucin. - BACKTRACK HISTORY: Permite el realizar una traza de ejecucin a la inversa, es decir, ir retrocediendo desde un punto de la ejecucin hacia el comienzo del programa. Tambin es posible el ver todos los valores que ha tenido alguna variable hasta el momento actual. Para llevar a cabo esto, VIA/SMARTTEST debe ir grabando todo lo que est ocurriendo en la ejecucin. El proceso a seguir es el siguiente: - Activacin del SWITCH de BACKTRACK a ON en la opcin MODES del men de OPTIONS. - Ejecucin hasta donde se desee. Ahora, si se desea ir retrocediendo en la ejecucin, STEP BACK va deshaciendo la misma; en cualquier momento se puede ver el contenido que tena alguna variable en ese momento. Si por el contrario se quiere ver la evolucin que ha sufrido el valor de una variable, opcin BACKTRACK HISTORY del men de LIST.

28

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Es importante resaltar que en realidad no se est re-ejecutando el programa; simplemente se fue grabando en cada paso todo lo que se llev a cabo. Por tanto, esto implica un mayor coste en la ejecucin, y cada vez que se termina un test de este tipo, se desactiva automticamente el switch de grabacin.

CONTADORES DE EJECUCIN Otra funcin muy importante de VIA/SMARTTEST es la posibilidad de verificar el alcance de la cobertura de la prueba. Esto permitir el identificar aquellas sentencias que se han ejecutado y cuantas veces, las que no lo han sido... Tambin es muy til a la hora de depurar bucles, ya que en un vistazo se puede comprobar cual es la sentencia o prrafo que lo est provocando. Al igual que la opcin anterior, es preciso activar el switch COUNTS de la opcin de LIST TAILOR en el men de LIST para el programa en cuestin; a continuacin se ejecuta el programa hasta su finalizacin o hasta donde se desee. Para comprobar los contadores, opcin LIST COUNTS del men de LIST

Execution Counts SORTED DESCENDING Command ===> Scroll ===> CSR ________________________________________________ 244 100% Executed STMTS: Highest count: 3 Unexecuted Highest count line: 1150 STMTS SORTED BY ----------------------------------PROCEDURE 29 STMTS: 211 86% 33 VIAPCOB 14%

VIAPCOB Total STMTS: Execution count: 37

S LINE COUNT %--------- 50% --------- 100% DESCENDING COUNT --------------------------------------------------------------------------000777 000778 1 *********

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

DIVISION USING LS-PARAM. 000779 * 000780 1 INICIO. 000781 1 ********** PERFORM PRINCIPIOPROGRAMA 000782 1 ********** IF DATOS-ORRECTOS 000783 1 ********** PERFORM PROCESO 000784 1 ********** ELSE 000785 * PERFORM CANCELAR 000786 1 ********** END-IF. 000787 * 000788 1 ********** PRINCIPIOPROGRAMA. 000789 1 ********** OPEN INPUT FENTRADA 000790 1 ********** OUPUT FSALIDA 000791 1 ********** LISTADO. 000792 1 ********** IF FILE-STATUS NOT EQUAL 0 000793 * PERFORM CANCELAR 000794 1 ********** END-IF . +---------------------------------------------------------------------------------------------------------------------------------+

Proporciona informacin sobre el nmero total de sentencias ejecutadas, el porcentaje del programa testado, el que no lo ha sido, la sentencia que se ha ejecutado ms... y adems dicha informacin puede ser obtenida por lneas, prrafos, en orden ascendente de ejecucin, descendente, de codificacin...

FILE SERVICES (CICS)

VIA/SMARTTEST CICS presenta una funcionalidad muy importante: Los File Services.

30

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Dicho componente permite, una vez conectado a CICS, el acceder para leer, modificar, etc.. directamente a ficheros VSAM, BDAM, colas TS, colas TD, bases de datos DL/I o bases de datos DB2. Permite, de una forma fcil y cmoda, el acceder a dichos tipos de almacenamiento de datos para verificarlos, modificarlos, sin necesidad de usar utilities, cargas, descargas, y mecanismos que ralentizan la obtencin de un juego de datos coherente para la prueba. Para acceder a ellos, en el men de LIST, opcin CICS FEATURES, se selecciona opcin FILES (o directamente LIST FILES) se llega a la siguiente pantalla: CICS FILE SERVICES Comman _______________________________________________________ Enter blanks or a pattern name to obtain a directory list 1 FILE _________ name) 2 TEMP_______________________ Name) 3 DEST ____ Name) 4 DL/I _____ 5 DB2 _________ _________ ID) ( DL/I PSB name) (Table/View) (SYSTABLES Creator (Transient Data (Temporary Storage

(VSAM or BDAM File

En dicha pantalla, eligiendo nmero de opcin a acceder y nombre (admite mscaras) de recurso, se pasa al acceso a dicho tipo de estructura de datos en particular. ACCESO A FICHEROS Con opcin 1, se pasa a otra pantalla donde aparece el nombre (si se eligi uno) la lista que cumple la mscara, de fichero (FCT) en dicho CICS. Tambin se indica el tipo del fichero (VSAM, BDAM o REMOTE) y el status (OPEN,CLOSED...) .

31

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Una vez elegido un fichero en particular, se accede a otra pantalla para la eleccin de la accin a efectuar sobre el fichero, sobre qu registros, etcetera.

Las opciones permitidas son leer un registro, actualizarlo, aadirlo borrarlo. El acceso al fichero puede realizarse por clave (entera o parte), por posicin,... TEMPORARY STORAGE Tambin es posible el acceso directo y modificacin a colas TS. Para ello, en la pantalla inicial de FILE SERVICES, eligiendo la opcin 2, segn se especifique el nombre completo o no, se pasar a una pantalla de seleccin de todas las colas TS disponibles, o directamente a la pantalla de trabajo sobre la misma: TEMPORARY STORAGE REQUEST Command =_________________________________________________________ R Read TS name VIASHARE Item number 00001 (Queue item number) Queued (Y/N) YES (Specify NO for non-queued TS) Location.......... AUXILIARY (Auxiliary/Main storage for ADD requests) Intersystem communication (Optional): System id _________ U Update A Add D Delete

TRANSIENT DATA Mediante la opcin 3 del men de File Services, se llega a la pantalla de modificacin de Transient Data. Segn se ha tecleado el nombre completo mediante mscaras, se pasa directamente a la pantalla de acceso a las colas TD a otra pantalla intermedia con la lista de colas TD que cumplan dicha mscara. 32

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

En la pantalla con la lista de colas TD existe cierta informacin interesante: SYSTEM ID informacin Identificacin de la regin CICS de donde se obtiene la

NAME El DCT nombre o Alias. INDIRECT El DCT para el cual el valor anterior es un Alias (si lo es). TYPE El tipo de Transient Data queue. Puede ser intra-particin (INTRA), extra-particin (EXTRA) o REMOTE (la DCT reside en otra regin CICS). STATUS El status del fichero. Tiene dos partes, donde la primera indica si el fichero est abierto cerrado, y el segundo si est Enable, Disable o Unenabled. Una vez elegida una cola TD, se pasa propiamente a la pantalla de acceso a la cola TD: TRANSIENT DATA REQUEST Command=____________________________________________________ _______ R - Read U - Update A - Add D Delete TD queue LUT1 Item number _____ Add Options: Force trigger (Y/N) ____ Suspend trigger (Y/N) ____ Intersystem Comunication (Optional): System Id _____ Mediante esta pantalla se puede leer, actualizar, aadir o borrar la TD QUEUE especificada. BASES DE DATOS DL/I Mediante la opcin 4 de File Services se pasa a la pantalla de acceso a bases de datos DL/I. Permite leer, reemplazar, insertar y borrar para la PSB especificada previamente. (DCT name) (queue item number) (Force trigger processing on adds) (Bypass trigger increment on adds)

33

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Existen campos para introducir informacin sobre la PSB, PCB (DBDNAME) y la posibilidad de mostrar solo el segmento que coincide la calificacin SSA introducido en el campo de segmento. DL/I DATA REQUEST Command ==_________________________________________________________ G - Get R - Replace I - Insert D - Delete C Clear entries PSB NAME _______ YES PCB number 01 Display requested segments only?

Segment Field Op Value (enclose in single or double quotes) ---------------- ------- -----------------------------------------------------___________ ____ ___ __________________________________ ___________ ____ ___ __________________________________ ___________ ____ ___ __________________________________ BASES DE DATOS DB2 La opcin 5 del men de File Services lleva directamente a la pantalla de trabajo directamente de trabajo sobre las tablas DB2 o a la lista de Tablas/Vistas (o Alias) a las que se puede acceder en dicho CICS. Una vez en dicha pantalla: DB2 Request Command===__________________________________________ Scroll= SCR 1 - Select column data 2 - Build a statement Statement: 1:Select 2:Update Table/View: ZDAJSB.DPTO Creator Id: SYSJSB Columns DEPTNO DEPNAME EMPLEADO APELLIDO NOMBRE 3:Insert 4:Delete

Where Conditions

(AND assumed)

_________________________________ _________________________________ _________________________________ _________________________________ _________________________________

Mediante la opcin 1, se obtiene la informacin que cuadra con la condicin Where (si se introdujo) o directamente todas las filas de la tabla. 34

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Con la opcin 2, se puede construir una sentencia SQL especfica de acceso a DB2.

TEST COVERAGE ANALYSIS (T.C.A.)

VIA/SMARTTEST presenta una funcionalidad muy importante para verificar la cobertura de las pruebas: la TCA. Mediante los counts, se puede verificar si una determinada ejecucin (con unos ciertos datos de entrada) ha pasado (o no) por unos determinados puntos del programa, cuantas veces...; sin embargo, la TCA permitir al usuario el verificar la cobertura de la prueba ante diferentes ejecuciones y datos de entrada. Para acceder a la TCA, opcin 2 del men de FILE, o directamente desde el men principal de VIA/SMARTTEST, el comando LI TCA: File - TCA Test Plan Selection Command ______________________________________________________________

===>

Enter the AKR that contains the COVERAGE PLAN and the PLAN Name. Select the desired TCA option and press enter. TCA AKR Name.. ______________________________________________ TCA PLAN Name. ________ Current environment is TSO

35

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

TCA Options __ 1. Change TCA Execution Environment 2. Define/Display TCA PLAN 3. Setup TCA TEST 4. TCA Test Result Utility 5. Generate TCA Reports

Esta es la pantalla que dirige el proceso a travs de todas las fases precisas de la TCA: 1.- Definir o cambiar el entorno de ejecucin. 2.- Definir el plan de prueba. 3.- Preparar y ejecutar la prueba. 4.- Verificar los resultados del Test. 5.- Generar los informes resultado. Adems, habr que indicar el AKR especfico que contendr el plan de test y el nombre del mismo.

DEFINIR EL ENTORNO DE EJECUCIN Al igual que en VIA/SMARTTEST normal, en TCA es importante definir el entorno en que se va a ejecutar la prueba. Mediante esta opcin, se pasa a la pantalla de ENVIRONMENT normal de VIA/SMARTTEST para definir AKR, libreras LOAD y entorno de la prueba. Es importante destacar que en la versin actual, una vez definido un entorno para una prueba, no se puede modificar dicho entorno durante el mismo. Un aspecto importante a resaltar es la necesidad de analizar para VIA/SMARTTEST los programas de los que se quiera verificar la cobertura. Sin embargo, el AKR que contenga los programas analizados no tiene porqu ser el mismo que contenga al plan de pruebas como tal. DEFINIR EL PLAN DE PRUEBA

36

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Otra opcin muy importante es definir el Plan de Prueba, es decir, indicar cuales son los programas de los que se quiere verificar la cobertura. Los programas que se incluyan en el mismo debern estar analizados para VIA/SMARTTEST en alguno de los AKR definidos previamente en el entorno de la prueba. T.C.A. - COVERAGE PLAN Command ===> ________________________________________________ Scroll ===> CSR VIA2300I ENV SYSTEM VARIABLES AND PARMS RESTORED. Enter Primary Command: G - To GENERATE TCA Reports. S - To SETUP a TCA test Session. L - To List/Maintain TCA Tests Results. TCA AKR Name.. 'ZDA.ZDAJSB.FTESTC' TCA PLAN Name. PRUEBAS Environment. TSO Tests= 0 DESCRIPTION:.. PRUEBAS TCA Enter Line Command: D - To delete entry. I - To Insert new entry. I/D MODULE/PROGRAM COMPILED ANALYZED ---------------------------------------------------------------***************************** TOP OF DATA ***************************** ___ VIAMERG4 VIAMERG4 30JUN1998 12:30:21 26JUN1998 09:47:03 *************************** BOTTOM OF DATA **************************** LANG --------COB II

Unicamente habr que especificar el MODULE/PROGRAM; directamente se obtiene del AKR la fecha y hora de compilacin y la versin de Cobol. PREPARAR Y EJECUTAR LA PRUEBA Desde la pantalla anterior con S, o con la opcin 3 desde la inicial de TCA, se pasa a la pantalla especfica de SETUP de TCA; en la misma habr que preparar y ejecutar la prueba. TSO Session Setup TCA PLAN UPDATED Command ===> _________________________________________________________________ R - Begin TSO test session (RUN) 37

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

C - Convert batch JCL to TSO CLIST Execution: Load module VIAMERG4 NO CSECT/pgm id ________ Execution parameters: (quotes are optional) __________________________________________________ __________________________________________________ File allocation CLIST: Data set name 'ZDA.ZDAJSB.WORK' Member . . . VIACLIST NO *** TCA ACTIVE *** Options: Break on entry (Y/N) Break

Deallocate after test

Es importante resaltar que cuando se intenta verificar la cobertura del Test no es posible coger el control de la prueba como en una prueba normal de VIA/SMARTTEST. Lo que si existen es dos tipos de verificar la cobertura (aunque aparezcan tres tipos): - EXECUTE (o COUNTS) Cuenta cuantas veces se ha pasado por cada lnea, prrafo, cuantas no, del programa. - USER Mediante la introduccin de BREAKPOINTS en el fuente, se controlar cuantas veces se ha pasado por cada uno de ellos (aunque la ejecucin como tal no se para). Los resultados obtenidos estarn referidos a estos puntos de parada, no a todo el fuente como en la opcin anterior. Al submitir la prueba, aparece una pantalla nueva donde se debe indicar cul es el tipo de prueba que se quiere ejecutar; una vez elegido, se ejecutar hasta el fin del programa o se produzca un abend.

File - TCA Test Plan Run Command ______________________________________________________________

===>

38

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

Key in the Description, select TCA test type and press ENTER to begin a TCA test. Press END to return. TCA AKR Name.. 'ZDA.ZDAJSB.FTESTC' TCA PLAN Name. PRUEBAS Test Description=> PRUEBAS TCA TCA Test Options __ 1. EXECUTE Test 2. COUNT Test 3. USER Test

VERIFICAR LOS RESULTADOS DEL TEST Una vez ejecutado la prueba, es posible verificar el resultado de la misma en la opcin 4 de TCA; en caso de haberse producido un abend, solo se habr verificado la cobertura hasta el momento del mismo.

Command ===> Scroll ===> CSR

T.C.A. - TEST UTILITY ________________________________________________

TCA AKR Name.. 'ZDA.ZDAJSB.FTESTC' TCA PLAN Name. PRUEBAS Tests= 2 DESCRIPTION... PRUEBAS TCA Enter Line Commands:

Environment. TSO

D - To Delete Test Result. S - To Select Test Setup for review. E - To Export Test Result.

S RSLT JOBNAME TYP COMPLETED CC DESCRIPTION - -------- --------------- ------------------------- ---------------------***************************** TOP OF DATA ***************************** __ 1 ONLINE EXE 02JUL1998 11:31 0 PRIMERA PRUEBA DE TEST __ 2 ONLINE CNT 02JUL1998 11:35 0 SEGUNDA PRUEBA DE TEST *************************** BOTTOM OF DATA ****************************

39

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

El campo TYP nos indica de que tipo fue la prueba; EXE (execute), CNT(count), USE(user). Permite las opciones D para borrar dicho resultado, S para volver a la pantalla de SETUP y reproducir la misma y E para exportar los resultados a un fichero PUNCH.

OBTENER LOS INFORMES RESULTADO Una vez realizadas las fases anteriores, se puede pasar a obtener los resultados de las distintas pruebas. Para ello, la opcin 5 de la pantalla principal de TCA lleva a otra pantalla donde aparece aquel o aquellos programas de los que se quiera obtener los informes. A partir de esta, una vez seleccionado l o los programas, habr que decidir qu informe o informes se quiere obtener de los mismos: T.C.A. - REPORT SELECTION Command ____________________________________________________________ TCA AKR Name.. 'ZDA.ZDAJSB.FTESTC' TCA PLAN Name. PRUEBAS Select the desired TCA REPORT and press ENTER. Press END to return. TCA Report Options __ 1. Detail Count and Program Summary Report 2. Detail Execution Report 3. Program/Paragraph Label Count Report 4. Program/Paragraph Label Execution Report 5. Execution Summary Report 6. Not Executed Summary Report TCA presenta 6 informes diferentes: 1 Contador de las veces que se ha pasado por cada lnea o Breakpoint. 2 Switch indicando si se ha pasado o no por lnea/Breakpoint. 3 Contador de ejecucin por prrafos. 40

===>

MANUAL DE UTILIZACIN DE VIA/SMARTTEST

4 Anlogo al tipo 2 pero por prrafo. 5 Resumen de todas las ejecuciones realizadas. 6 Informe de aquellas sentecias no ejecutadas.

41