WMB for z/OS - Configuracion del nodo CICSRequest en z/OS

1.197 visualizaciones

Publicado el

Este documento explica la configuración del nodo CICSRequest en el lado del z/OS es decir la parte que usara el Broker, para revisar como se configura este nodo en el WMB Toolkit es decir la parte que se usara en el diseño de los flujos revisar la documentación adicional de este nodo.
El presente documento a sido probado en WMB v6.1, para una versión diferente se debe revisar las equivalencias.

0 comentarios
0 recomendaciones
Estadísticas
Notas
  • Sé el primero en comentar

  • Sé el primero en recomendar esto

Sin descargas
Visualizaciones
Visualizaciones totales
1.197
En SlideShare
0
De insertados
0
Número de insertados
33
Acciones
Compartido
0
Descargas
29
Comentarios
0
Recomendaciones
0
Insertados 0
No insertados

No hay notas en la diapositiva.

WMB for z/OS - Configuracion del nodo CICSRequest en z/OS

  1. 1. Configuración del nodo CICSRequest en z/OS Configuración del nodo CICSRequest en z/OSHistoria de las revisionesFecha Revisión Descripción Autor2011-06-18 1.0 Documento final Oscar Vásquez FloresI. ContextoEste documento explica la configuración del nodo CICSRequest en el lado del z/OS esdecir la parte que usara el Broker, para revisar como se configura este nodo en el WMBToolkit es decir la parte que se usara en el diseño de los flujos revisar la documentaciónadicional de este nodo.El presente documento a sido probado en WMB v6.1, para una versión diferente se deberevisar las equivalencias.II. Diagrama de componentes <<node>> MVS1 EXCI <<trn>> TRX <<app>> DFHMIRS <<app>> CICSRequest Node EXEC CICS LINK <<app>> CICS Program <<mflow>> CONNECTION <<broker>> SESSIONS TRANSACTION <<USS>> <<cics>>CICS: Es alguna región donde se ejecutara el programa CICS a invocar.CICS Program: Es el programa CICS a invocar, el único requisito que debe cumplir esde poder invocarse por COMMAREA o DPL.CICS Request Node: Es la librería que implementa las interfaces de WMB y usa el APIde EXCI para invocar a un programa CICS.CONNECTION, SESSIONS: Son recursos del CICS que se deben de crear para hacerque funciona EXCI.DFHMIRS: Es un programa CICS dummy que es usado por EXCI como puente parainvocar al CICS Program.mflow: Es el flujo de WMB que hace uso del nodo CICSRequest.TRX y TRANSACTION: Es la transacción y recurso de CICS que se define para asociarlaa la invocación del CICS Program.USS: Es el Unix System Service o también conocido como OMVS, es un subsistema delz/OS, en la práctica es un tipo de sistema operativo UNIX dentro del sistema operativoz/OS.Oscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)
  2. 2. Configuración del nodo CICSRequest en z/OSIII. Pasos1. El Nodo CICSRequest para WMB for z/OS v6.1 es un Support Pack de código IA12, sepuede bajar de: http://www-01.ibm.com/support/docview.wss?rs=171&uid=swg24006950&loc=en_US&cs=utf-8&lang=en&wv=1Bajar el archivo ia12.tar y el ia12.zip(contiene documentación adicional )2. Subir el ia12.tar dentro de algún directorio HFS del USS, por ejemplo a /u/eoscarvf/,debe subir en modo binario, usar FTP por ejemplo.3. Ingresar a la línea de comandos del USS, por ejemplo desde una sesión de TSO sepuede hacer con “TSO OMVS”, también se puede ingresar por Telnet de forma directa alUSS.Desempaquetar el archivo .tar:tar -xof /u/eoscarvf/ia12.tar quedara así:/u/eoscarvf/ia12/lil/imbcics.lil/u/eoscarvf/ia12/messages/*4. El usuario con el que esta corriendo el Broker debe tener permisos de Lectura yEjecutar sobre los directorios/archivos anteriores, por ejemplo se pueden asignar lossiguientes permisos:$ pwd/u/eoscarvf/$ chmod -R 755 *5. Colocar al directorio /u/eoscarvf/ia12/lil como parte del parámetro LILPATH delBroker. También se puede colocar el archivo imbcics.lil como parte de algún directorioque ya sea parte del LILPATH. Nunca usar los directorios donde esta instalado el WMB,debido a que pueden cambiar por la instalación de algún Fix.LILPATH se configura con el comando mqsichangebroke, se puede usar suequivalente JCL BIPCHBK o desde la consola de comandos (SDSF->) del z/OS con elsinónimo cb.Ejemplo desde la consola de comandos:El comando mqsichangebroker requiere hacer un STOP al Broker:/f Q200BRK, pcCambiamos el LILPATH:/f Q200BRK, cb l=’{Paths ya existentes} : /u/eoscarvf/ia12/lil’Aun no dar START del bróker.6. Actualizar el archivo BIPBPROF para las variables de ambiente que se indican, elarchivo BIPBPROF esta localizado en {COMPONENTDATASET} en el FS del MVS, porejemplo: BIP.BROKER.Q200BRKLuego se debe ejecutar el JOB BIPGEN para que las variables de ambiente seanregistradas en el archivo final ENVFILE, localizado en {HOME} en el HFS por ejemplo/u/home, este es el directorio home de todos los usuarios del USS.BIPGEN esta localizado en el mismo {COMPONENTDATASET}.Variables de ambiente:NLSPATH= {Paths ya existentes} : /u/eoscarvf/ia12/messages/%L/%NMQSI_CONSOLE_NLSPATH= {Paths ya existentes} : /u/eoscarvf/ia12/messages/En_USNODE_CICSREQUEST_IRC_USER_NAME=TESTEX01Oscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)
  3. 3. Configuración del nodo CICSRequest en z/OSNLSPATH y MQSI_CONSOLE_NLSPATH son variables que ya existen y se usan paralos catálogos de mensajes en la consola del z/OS. Este nodo trae mensajes adicionales.NODE_CICSREQUEST_IRC_USER_NAME es una variable nueva, se puede crear acontinuación de las variables anteriores pero es importe poner un comentario del usoque se le dará, su valor es el mismo del atributo NETNAME del recurso CICSCONNECTION, revisar el siguiente paso.En caso no se especifique el valor en NODE_CICSREQUEST_IRC_USER_NAME setomara el nombre del usuario que esta ejecutando al Broker, por lo tanto NETNAMEdebe tener ese valor.7. En cada CICS al que tendrá acceso el nodo CICSRequest se deben crear los recursosCONNECTION y SESSIONS, para esto se puede utilizar la transacción CEDA o elprograma DFHCSDUP para la creación en batch, por ejemplo con CEDA:CONNECTIONCEDA DEFINE CONNECTION(EX01)GROUP(GMBTEST1)DESCRIPTION(CONNECTION EXCI PARA WMB)NETNAME(TESTEX01)ACCESSMETHOD(IRC)PROTOCOL(EXCI)CONNTYPE(SPECIFIC)SESSIONSCEDA DEFINE SESSIONS(EX01)GROUP(GMBTEST1)DESCRIPTION(SESSIONS EXCI PARA WMB)CONNECTION(EX01)PROTOCOL(EXCI)Todos los CICS a los cuales accede un Broker deben tener el recurso CONNECTION conel mismo valor del atributo NETNAME. Esto debido a lo reviso en el paso 6.Como se sabe un imagen de z/OS puede tener varios Broker corriendo.Para más detalles respecto a los recursos CICS creados ver la sección de Anexos.Oscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)
  4. 4. Configuración del nodo CICSRequest en z/OSIV. ConsideracionesUsualmente se nombra al nodo dentro del flujo de WMB con el mismo nombre deprograma que invocara.Se especifica el dato del CICS ApplID, no se puede usar el CICS generic resoursename, debido a que esto es valida en comunicación con VTAM y el protocolo EXCI nosoporta VTAM.Es necesario el CICS Program Name a invocar.En el caso del CICS Userid se puede colocar cualquier dato debido a que este seráreemplazado por el valor de la variable NODE_CICSREQUEST_IRC_USER_NAMEdescrita en pasos anteriores.Si no se coloca nada en el campo CICS Mirror transaction name el programa CICS seejecutara bajo la transacción por defecto CSMI, para temas de monitoreo y calidad deservicio es mejor especificar una transacción por cada programa a invocar desde unflujo de WMB.Oscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)
  5. 5. Configuración del nodo CICSRequest en z/OSPara el ejemplo es necesario definir la transacción MB01, con CEDA:CEDA DEFINE TRANSACTION(MB01)GROUP(GMBTEST1)DESCRIPTION(TRX PARA WMB Y PROGRAMA BXRPTP01)PROGRAM(DFHMIRS)TWASIZE(0)PROFILE(DFHCICSA)Esta transacción debe estar asociada al programa DFHMIRS el cual es usado por EXCIcomo inicio, desde este se hace LINK al programa final.Oscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)
  6. 6. Configuración del nodo CICSRequest en z/OSV. AnexosCreación de un SESSIONSSessions ==> EX01Group ==> GRPMBRK1DEscription ==> Sesion EXCI para WMBSESSION IDENTIFIERS Connection ==> EX01 SESSName ==> NETnameq ==> MOdename ==>SESSION PROPERTIES Protocol ==> Exci Appc | Lu61 | Exci MAximum ==> 000 , 000 0-999 RECEIVEPfx ==> B1 RECEIVECount ==> 004 1-999 SENDPfx ==> SENDCount ==> 1-999 SENDSize ==> 04096 1-30720 RECEIVESize ==> 04096 1-30720 SESSPriority ==> 000 0-255 Transaction :OPERATOR DEFAULTS OPERId ==> OPERPriority ==> 000 0-255 OPERRsl ==> 0 0-24,... OPERSecurity ==> 1 1-64,... PRESET SECURITY USERId ==>OPERATIONAL PROPERTIES Autoconnect ==> No No | Yes | All INservice : Yes No | Yes Buildchain ==> Yes Yes | No USERArealen ==> 000 0-255 IOarealen ==> 04096 , 04096 0-32767 RELreq ==> No No | Yes DIscreq ==> No No | Yes NEPclass ==> 000 0-255RECOVERY RECOVOption ==> Sysdefault Sysdefault|Clearconv|Releasesess|Uncondrel|None RECOVNotify : None None | Message | TransactionLos elementos resaltados son los únicos que se deben ingresar, los demás se debendejar por defecto.Oscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)
  7. 7. Configuración del nodo CICSRequest en z/OSCreación de un CONNECTIONCONnection ==> EX01Group ==> GRPMBRK1DEscription ==> Conexion EXCI para WMBCONNECTION IDENTIFIERS Netname ==> TESTEX01 INDsys ==>REMOTE ATTRIBUTES REMOTESYSTem ==> REMOTEName ==> REMOTESYSNet ==>CONNECTION PROPERTIES ACcessmethod ==> IRc Vtam | IRc | INdirect | Xm PRotocol ==> Exci Appc | Lu61 | Exci Conntype ==> Specific Generic | Specific SInglesess ==> No No | Yes DAtastream ==> User User | 3270 | SCs | STrfield | Lms RECordformat ==> U U | Vb Queuelimit ==> No No | 0-9999 Maxqtime ==> No No | 0-9999OPERATIONAL PROPERTIES AUtoconnect ==> No No | Yes | All INService ==> Yes Yes | NoSECURITY SEcurityname ==> ATtachsec ==> Local Local | Identify | Verify | Persistent| Mixidpe BINDPassword : PASSWORD NOT SPECIFIED BINDSecurity ==> No No | Yes Usedfltuser ==> No No | YesRECOVERY PSrecovery ==> Sysdefault | None Xlnaction ==> Keep Keep | ForceLos elementos resaltados son los únicos que se deben ingresar los demás se deben dejarpor defecto.Descripción de los mas importantes:Netname:ACcessmethod: IRC:Communication between the local CICS region and the region defined by this connectiondefinition is through the interregion communication (IRC) program DFHIRP, using theSVC (as opposed to cross-memory (XM)) mode of DFHIRP.Note: This use of the term IRC is more specific than its general use.You can use IRC for multiregion operation (MRO) for regions that are in the same MVSimage or in different MVS images within a sysplexPRotocol: EXCI: The external CICS interface. Specify this to indicate that this connection is forOscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)
  8. 8. Configuración del nodo CICSRequest en z/OS use by a non-CICS client program using the external CICS interface.Conntype: SPECIFICThe connection is for communication from a non-CICS client program to the CICS region,and is specific. A specific connection is an MRO link with one or more sessions dedicatedto a single user in a client program. For a specific connection, NETNAME is mandatory.Oscar Vásquez Flores(http://eoscarvf.blogspot.com - eoscarvf@gmail.com)

×