Configuración del script de shell de Rational Build Agent

Jazz Build System contiene un script de muestra llamado startbfa.sh que puede utilizar para iniciar el Rational Build Agent.

Puede encontrar el script en el directorio @pathPrefix@/usr/lpp/jazz/v4.0/buildsystem/buildtoolkit/examples/startbfa, donde @pathPrefix@ es cualquier prefijo que especifique al instalar el SMP/E. Este script es necesario para iniciar Rational Build Agent con el fin de especificar las credenciales para que el agente se pueda conectar con el Jazz Team Server y disponer de acceso a las bibliotecas necesarias para Ant con Enterprise Extensions y la compilación nativa. Este script se copia al directorio de configuración Rational Team Concert, generalmente /etc/jazz40/ccm mediante el trabajo BLZCPBTK.
Importante: El script debe estar configurado para ajustarse a su entorno. Muchas de las variables necesarias habrán sido configuradas por el trabajo de copia y configuración BLZCPBTK. Sin embargo, algunas de las variables, por ejemplo la información de ID de usuario y contraseña no se establecerá automáticamente. Revise y sustituya las series de variables necesarias en el script de ejemplo como se describe en la tabla siguiente:
Tabla 1. Series de variables del script de muestra
Variable Descripción
@pathPrefix@ Prefijo de la vía de acceso del directorio de Jazz
Nota: Es el prefijo del directorio de Jazz, así que su prefijo debería incluir cualquier prefijo especificado como parte de la instalación SMP/E, y después /usr/lpp.
@javaPathPrefix@ Vía de acceso de directorio al SDK de 31 bits de IBM® para z/OS Java 2 Technology.
@yourUserid@ ID de usuario de Jazz.
@yourPasswordFile@ Archivo de contraseñas Jazz como están definidos por el trabajo BLZBPASS. Consulte Ejecución de Jazz Build Engine en z/OS para obtener información sobre cómo ejecutar el trabajo BLZBPASS.
@stepLib@ STEPLIB DD definición de conjunto de datos) para utilizar en la compilación de z/OS. Por ejemplo, SYS1.LINKLIB:CEE.SCEERUN
@bfaBinPath@ Vía de acceso de directorio al directorio de ejecutables de Rational Build Agent.
@bfaConfPath@ Vía de acceso de directorio al directorio de archivos de configuración de Rational Build Agent.
@zLang@ Codificación utilizada en los archivos de host. Por ejemplo IBM-037.
@timeout@ Valor de tiempo de espera en segundos para la ejecución de paso de construcción. Si no se especifica, el valor predeterminado es de 300 segundos.
@workPath@ Vía de acceso de directorio donde se almacenan los metadatos para PDSEs. De forma predeterminada es /u/jazz40/ccm/.
@yourHomeDirectory@ Directorio padre. Utilícelo únicamente cuando no haya definido la variable de entorno HOME en otro lugar.
_CMDSERV_BASE_HOME Indica la ubicación de los archivos suministrados por ISPF de forma que Rational Build Agent puede iniciar la pasarela ISPF. Consulte Configuración de la pasarela ISPF para soporte de compilación, despliegue y promoción para obtener más información acerca de _CMDSERV_BASE_HOME.
Cuando esté preparado para iniciar el Rational Build Agent y aceptar las solicitudes de construcción, podrá ejecutar el script startbfa.sh de una de las maneras siguientes:
  • Inicie el script startbfa.sh manualmente desde OMVS
  • Configure la tarea iniciada BLZBFA de ejemplo proporcionada en la biblioteca BLZ.SBLZSAMP siguiendo las instrucciones del trabajo. A continuación, podrá ejecutar Build Forge Agent como tarea de inicio durante el arranque del sistema. Debe copiar este trabajo en un sistema asignado PROCLIB y configurar los valores de seguridad necesario para que se ejecute como una tarea iniciada.
Nota: A menos que se especifique otro shell en el archivo bfagent.conf , el shell predeterminado (/bin/sh) se utiliza en la sesión iniciada por Rational Build Agent en z/OS.  El shell predeterminado en z/OS siempre ejecuta el script/etc/profile para establecer las configuraciones del sistema después de ejecutar startbfa.sh y es posible que algunas variables de entorno establecidas en el script de shell startbfa.sh se puedan sustituir.

Cuando ejecuta una compilación Ant with Enterprise Extensions o una compilación de dependencia con la opción –verbose o –debug en los argumentos Ant, el mandato de exportación de UNIX se ejecutará antes de que se invoque Ant. Puede mirar las salidas desde el mandato de exportación en el registro de compilación para asegurarse de que las variables están establecidas correctamente.

Si /etc/profile sobrescribe algunas variables de entorno, solicite al programador del sistema que cambie /etc/profile. Si no es posible realizar le cambio de /etc/profile, puede utilizar el shell Bash, que está disponible en z/OS Ported Tools. Especifique la opción –noprofile añadiendo las siguientes dos líneas al archivo bfagent.conf:
shell /bin/bash   
shellflag --noprofile 

Comentarios