Configuración de la pasarela ISPF para soporte de compilación, despliegue y promoción

Puede configurar la pasarela ISPF para soportar los componente de compilación, despliegue y promoción que están disponibles con una licencia de acceso de cliente Developer for IBM® Enterprise Platforms licencia de acceso de cliente.

ISPF proporciona una interfaz, llamada pasarela ISPF, para aplicaciones de cliente para conectarse al host z/OS y ejecutar los mandatos TSO e ISPF. La pasarela ISPF se instala como parte de ISPF como módulos de carga y archivos en HFS. Estos archivos se instalan normalmente en /usr/lpp/ispf/bin. Los componentes de compilación, despliegue y promoción se crean como parte de la instalación de SMP/E. Dependiendo de su configuración, es posible que necesite realizar modificaciones adicionales en los scripts y componentes proporcionados de pasarela ISPF. El procedimiento y la configuración predeterminados para modificar los valores predeterminados se describen más adelante.

Se incluyen los siguientes componentes:

Archivo de entorno de pasarela ISPF: ISPZXENV
El archivo de entorno de la pasarela ISPF contiene los valores personalizables para la pasarela ISPF.
El archivo ISPZXENV se proporciona como parte de z/OS. De forma predeterminada este archivo se instala en /usr/lpp/ispf/bin. Sin embargo, este directorio se marca de forma general como sólo LECTURA después de instalarse. La pasarela ISPF ejecuta el archivo de entorno para conseguir el valor de determinadas variables de entorno necesarias para que se ejecute la pasarela ISPF. De forma predeterminada estas variables son:
STEPLIB
De forma predeterminada se establece en STEPLIB = 'ISP.SISPLPA:ISP.SISPLOAD'
CGI_ISPCONF
De forma predeterminada se establece en CGI_ISPCONF = '/etc/ispf'
CGI_ISPWORK
De forma predeterminada se establece en CGI_ISPWORK = '/var/ispf'

Para establecer las variables en valores no predeterminados, copie ISPZXENV en un directorio de configuración en el que se pueda escribir como, por ejemplo, /etc/ispf y establezca las variables para sus valores necesarios. Entonces debe modificar la variable de entorno de vía de acceso en startispf.sh, que se describe posteriormente, para leer esa ubicación antes que la vía de acceso Bin ISPF.

Por ejemplo:
export PATH=/etc/ispf:$PATH  

En el directorio de trabajo de la pasarela ISPF, de forma predeterminada /var/ispf, debe tener un directorio creado llamado WORKAREA que tiene permisos de lectura y escritura para todos los usuarios. Los directorios temporales del formato /var/ispf/WORKAREA/<userid>/* se crean al utilizar la pasarela ISPF. Si está utilizando la instalación de pasarela ISPF predeterminada que proporciona ISPF, este directorio suele estar en /var/ispf/WORKAREA. Si el directorio no existe, siga las instrucciones del capítulo titulado Instalación y personalización de la pasarela en la publicación ISPF Planning and Customizing (GC34-4814).

Script de inicio de pasarela ISPF: startispf.sh
Script de shell para iniciar la pasarela ISPF para el despliegue y la promoción.
Para iniciar la pasarela ISPF, Rational Team Concert proporciona un script de shell al que se llama desde las tareas Ant de despliegue y promoción. Este script se instala en /usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/ispfgateway. Como parte de la personalización estándar, este script se copia al directorio de configuración de Rational Team Concert , normalmente/etc/jazz40/ccm mediante el trabajo BLZCPBTK . Dependiendo de su configuración, es posible que necesite modificar este script de shell para definir algunas variables de entorno.
PATH
La variable PATH debe apuntar al directorio de inicio de pasarela ISPF:
export PATH=$PATH:/usr/lpp/ispf/bin             
Si modificó ISPZXENV es posible que tenga que definir el PATH como:
export PATH=$PATH:/etc/ispf:/usr/lpp/ispf/bin

Si necesita utilizar diferentes concatenaciones de biblioteca en ISPF.conf, configure la instalación para dar soporte a varios proyectos y corrientes de datos mediante la creación de varias copias del script startispf.sh, el archivo ISPF.conf y el archivo ISPZXENV. En cada copia del archivo ISPZXENV, establezca la variable CGI_ISPFCONF para que apunte a la ubicación del archivo relacionado ISPF.conf. A continuación, en cada copia del script startispf.sh, establezca la variable PATH para que apunte a la correspondiente copia del archivo ISPF.conf. A continuación, utilice el script startispf.sh que corresponda al entorno necesario para un determinado proyecto.

Script de inicio de compilación de ampliaciones empresariales: startbfa.sh
Script de shell para iniciar Rational Build Agent utilizando la compilación Enterprise Extensions.
Las compilaciones de Enterprise Extensions proporcionan un mecanismo para iniciar una compilación que, a su vez, inicia un programa; un archivo ejecutable o mandato ISPF; o un archivo ejecutable o mandato TSO. Si el objeto que inicia la compilación está en una biblioteca asignada ISPF, deberá configurar la compilación para que proporcione acceso al objeto necesario. En startbfa.sh, debe listar la ubicación de los archivos suministrados por ISPF de forma que Rational Build Agent pueda iniciar la pasarela ISPF. De forma predeterminada, estos archivos están en /usr/lpp/ispf y se especifican en startbfa.sh utilizando la variable _CMDSERV_BASE_HOME. Si tiene los archivos binarios de pasarela ISPF instalados en otra ubicación, debe cambiar esta variable. Por ejemplo:
#                                                  
# Specify the home directory for the ISPF programs.
#                                                  
export _CMDSERV_BASE_HOME=/usr/lpp/ispf                   

Los archivos ejecutables y programas ISPF deben asignarse al archivo de configuración de la pasarela ISPF (ISPF.conf) como se describe más adelante. Rational Build Agent también requiere acceso a ISPF.conf. El acceso está establecido en un archivo de entorno de pasarela (ISPZXENV). Si pretende utilizar las prestaciones ISPF en las compilaciones y no utiliza la ubicación predeterminada /usr/lpp/ispf/bin, debe crear una copia de ISPZXENV en un directorio de configuración grabable y apuntar Rational Build Agent a esa ubicación. Establezca la propiedad de compilación teamz.build.ant.myISPFBinPath a la ubicación de directorio que contiene el archivo ISPZXENV . Puede editar el valor o añadir la propiedad utilizando la pestaña Propiedades en la definición de compilación. Para obtener más información, consulte Gestión de compilaciones z/OS

Archivo de configuración de pasarela ISPF: ISPF.conf
El archivo de configuración de la pasarela ISPF contiene los valores personalizables para la pasarela ISPF.
El archivo ISPF.conf se proporciona como parte de z/OS. El archivo de configuración de la pasarela ISPF proporciona las asignaciones necesarias para iniciar una sesión ISPF en una tarea creada. Para que la funcionalidad de compilación, despliegue y promoción inicie módulos para que realicen tareas específicas, estos módulos deben estar disponibles en las concatenaciones ISPF. De forma predeterminada, estas asignaciones se configuran como sigue:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=ISP.SISPLOAD
Para que el despliegue y la promoción funcionen, añada la biblioteca de carga de producto Rational Team Concert (hlq.SBLZLOAD) y la biblioteca de mensajes de producto (hlq.SBLZMENU) a la concatenación de ISPLLIB e ISPMLIB. Las asignaciones modificadas tienen un aspecto similar al de este ejemplo:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Ejecución de módulos de despliegue interpretativos

Si desea añadir sus propios procesos o funciones de despliegue, puede ejecutar versiones interpretativas de los módulos de despliegue. El componente de despliegue se ejecuta en los siguientes programas:
Tabla 1. Ejecución de programas por el componente de despliegue
Programa Función Descripción
BLZPKGZP Empaquetado de despliegue El uso del archivo de manifiesto crea un archivo .zip de los contenidos especificados.
BLZBKPZP Copia de seguridad de despliegue Mediante el archivo de paquetes, realice copias de seguridad de los módulos que sobrescribe el despliegue.
BLZDEPZP Despliegue Mediante el archivo de manifiesto de despliegue, despliegue el contenido del archivo .zip especificado.
Las tareas de despliegue Rational Team Concert llaman a estos programas para realizar la función descrita. Si desea modificar estos programas puede hacerlo modificando las muestras proporcionadas que están en la biblioteca hlq.SBLZSAMP y, a continuación, apuntar a la versión modificada en ISPF.conf. Así, si realiza modificaciones directamente en hlq.SBLZSAMP las asignaciones ISPF.conf son similares a este ejemplo:
sysproc=ISP.SISPCLIB,BLZ.SBLZSAMP 
sysexec=ISP.SISPEXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD
ISPF comprueba primero la concatenación ISPLLIB a menos que el mandato tenga el prefijo del símbolo de porcentaje % ; por lo tanto, debe renombrar o eliminar los módulos que haya cambiado del conjunto de datos hlq.SBLZLOAD.

Adición de las bibliotecas EXEC al archivo de configuración de pasarela ISPF

Para compilaciones de Enterprise Extensions, si utiliza el método de llamada ISPF, también debe añadir su biblioteca EXEC a las concatenaciones SYSEXEC o SYSPROC en ISPF.conf. Si ha especificado un nombre EXEC, o SELECT CMD(exec) , ISPF necesita acceso al EXEC necesario en la concatenación apropiada. Debe modificar ISPF.conf para incluir bibliotecas EXEC necesarias, por ejemplo:
sysproc=ISP.SISPCLIB 
sysexec=ISP.SISPEXEC,MY.PROJECT.EXEC 
ispmlib=BLZ.SBLZMENU,ISP.SISPMENU 
isptlib=ISP.SISPTENU 
ispplib=ISP.SISPPENU
ispslib=ISP.SISPSLIB 
ispllib=BLZ.SBLZLOAD,ISP.SISPLOAD

Para obtener más información sobre la pasarela ISPF, consulte el capítulo titulado TSO/ISPF client gateway in ISPF Planning and Customizing en ISPF Planning and Customizing (GC34-4814).

Resolución de la configuración de pasarela ISPF

Compruebe que la pasarela ISPF se haya configurado correctamente. Cualquier ID de usuario que ejecute funciones de Rational Team Concert que utilicen la pasarela ISPF deben disponer de los permisos necesarios que se describen en la publicación ISPF Planning and Customizing (GC34-4814) en http://publibfp.dhe.ibm.com/epubs/pdf/ispzpc80.pdf.

El script Rational Team Concert startispf.sh utiliza los mandatos de UNIX System Services que deben acceder al directorio /tmp. El Id de usuario de compilación que inicia el script startispf.sh debe disponer de acceso al directorio /tmp. Puede alterar temporalmente la utilización de /tmp como directorio temporal añadiendo la siguiente línea a /etc/jazz40/ccm/startispf.sh:
export TMPDIR=/su_dir_temporal
donde su_dir_temporal es un directorio con acceso de grabación para los usuarios de compilación.

Comentarios