
Administración de Liberty en z/OS
En la plataforma z/OS, inicie, detenga o modifique Liberty mediante el uso de mandatos de operador de MVS.
Antes de empezar
- Perfiles STARTED para el proceso de servidor y el proceso de ángel
- Perfiles SERVER para permitir el acceso a los servicios autorizados de z/OS
Acerca de esta tarea
En este tema se describe cómo iniciar, modificar, y detener Liberty utilizando la consola de MVS. También puede iniciar y detener el servidor desde un shell o utilizar un shell para iniciar el servidor como una tarea iniciada, consulte Inicio y detención de un servidor desde la línea de mandatos.
- bbgzsrv para Liberty.
- bbgzangl para el proceso de ángel que se necesita para controlar el acceso a servicios autorizados del sistema en la plataforma z/OS.
El destino de un mandato STOP de operador es un trabajo o una tarea iniciada.
Después de personalizar las plantillas de procedimiento JCL, deben colocarse en la concatenación de bibliotecas de procedimientos del sistema. El nombre del miembro de procedimiento se convierte en el argumento para el mandato START.
Procedimiento
Ejemplo
El siguiente ejemplo muestra la plantilla de procedimiento para el proceso de servidor (bbgzsrv). Este PROC se encuentra en un conjunto de datos de la concatenación proclib de z/OS.
//BBGZSRV PROC PARMS='defaultServer'
//*------------------------------------------------------------------
//* INSTDIR - the path to the WebSphere Liberty install.
//* This path is used to find the product code and is
//* equivalent to the WLP_INSTALL_DIR environment variable
//* in the Unix shell.
//* USERDIR - the path to the WebSphere Liberty user area.
//* This path is used to store shared and server specific
//* configuration information and is equivalent to the
//* WLP_USER_DIR environment variable in the Unix shell.
//*------------------------------------------------------------------
// SET INSTDIR='/u/MSTONE1/wlp'
// SET USERDIR='/u/MSTONE1/wlp/usr'
//*------------------------------------------------------------------
//* Start the Liberty server
//*
//* WLPUDIR - PATH DD that points to Liberty's "user"
//* directory. If the DD is not allocated, the user
//* directory location defaults to the wlp/usr directory
//* in the install tree.
//* STDOUT - Destination for stdout (System.out)
//* STDERR - Destination for stderr (System.err)
//* MSGLOG - Destination for messages.log (optional)
//* STDENV - Initial Unix environment - read by the system. El
//* installation default and server specific server
//* environment files will be merged into this environment
//* before the JVM is launched.
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATSL,REGION=0M,
// PARM='PGM &INSTDIR./lib/native/zos/s390x/bbgzsrv &PARMS'
//WLPUDIR DD PATH='&USERDIR.'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*
//*MSGLOG DD SYSOUT=*
//*STDENV DD PATH='/etc/system.env',PATHOPTS=(ORDONLY)
//*STDOUT DD PATH='&ROOT/std.out',
//* PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//* PATHMODE=SIRWXU
//*STDERR DD PATH='&ROOT/std.err',
//* PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//* PATHMODE=SIRWXU
- El lanzador utiliza la DD STDENV como el entorno inicial, pero esta DD es opcional. El entorno inicial para el proceso se define en el PROC. Puede apuntar a cualquier tipo de conjunto de datos que LE soporte, pero el formato debe ser compatible con el esperado. Por ejemplo, EBCDIC, clave=valor simples sin ninguna expansión.
- Se permite una PATH DD que apunte a un directorio existente (que no sea un archivo). Si dicha DD se abre, la corriente FILE devuelta es válida para fldata, de modo que se puede utilizar la vía de acceso HFS asociada a la DD. La plantilla PROC define una WLPUDIR PATH DD que representa el equivalente de WLP_USER_DIR.
- El WLP_USER_DIR se determina mediante la lógica siguiente:
- Si está definido WLPUDIR DD, se asocia la vía de acceso asociada como WLP_USER_DIR
- Si WLPUDIR no está definido, pero WLP_USER_DIR está establecido en el entorno inicial (en STDENV), se utiliza
- Si WLPUDIR no está definido y WLP_USER_DIR no está establecido en el entono inicial, se utiliza el valor predeterminado de $WLP_INSTALL_DIR/usr
- El entorno se determina mediante la siguiente lógica:
- Si se ha definido STDENV DD, LE considera que es el entorno inicial. Si desea establecer la variable de entorno _BPX_BATCH_UMASK, debe establecerse aquí en STDENV DD.
- Si $WLP_INSTALL_DIR/etc/server.env existe y es legible, su contenido clave=valor se lee y se establece en el entorno. El archivo puede estar en ASCII o EBCDIC. Los comentarios empiezan por un '#' y van hasta el final de la línea. Los valores que contienen espacios en blanco puede colocarse entre comillas dobles. Cualquier entrada de entorno especificada en este archivo alterará temporalmente las entradas del entorno inicial
- Si $WLP_USER_DIR/servers/{serverName}/server.env existe y es legible, el contenido de clave=valor se lee y se establece en el entorno. Este archivo también puede estar en ASCII o EBCDIC y da soporte a los comentarios. Las entradas que se especifican aquí alteran temporalmente las entradas del entorno inicial y etc/server.env.
- Independientemente del entorno de usuario especificado, se establecerán explícitamente las entradas siguientes: _BPXK_WLM_PROPAGATE=NO, JAVA_THREAD_MODEL=HEAVY y JAVA_PROPAGATE=NO. Si no está establecido _EDC_PTHREAD_YIELD, se establecerá en -2.
- Una vez establecido el entorno, se determina JAVA_HOME mediante la lógica siguiente:
- Si JAVA_HOME se establece en el entorno, su ubicación se utiliza como JAVA_HOME
- Si JAVA_HOME no está establecido en el entorno, pero existe $WLP_INSTALL_DIR/../java64, se utiliza $WLP_INSTALL_DIR/ ../java64 se utiliza como JAVA_HOME
- Si JAVA_HOME no está establecido en el entorno y $WLP_INSTALL_DIR/../java64 no existe, se utiliza $WLP_INSTALL_DIR/../java como JAVA_HOME
- Tras determinar JAVA_HOME, se determinan las opciones de línea de mandatos de
JVM mediante la lógica siguiente:
- Si $WLP_USER_DIR/servers/{serverName}/jvm.options existe y es legible, se lee su contenido. El archivo puede estar en ASCII o EBCDIC y cada línea del archivo debe ser un solo argumento de línea de mandatos java. Los comentarios empiezan por un '#' y llegan hasta el final de la línea.
- Si $WLP_USER_DIR/servers/{serverName}/jvm.options no existe pero $WLP_INSTALL_DIR/etc/jvm.options existe y es legible, se lee su contenido. El archivo puede estar en ASCII o EBCDIC y debe tener un argumento de línea de mandatos java por línea. Los comentarios están soportados
- Independientemente del contenido de jvm.options, -Dfile.encoding=iso8859-1, -javaagent:$WLP_INSTALL_DIR/lib/bootstrap-agent.jar y -classpath $WLP_INSTALL_DIR/lib/server-launcher.jar están en la línea de mandatos
- Si desea pasar argumentos a JVM, defina la sentencia JAVAOPTS DD, de modo que los
argumentos de línea de mandatos Java™ se lean desde
este DD. El ejemplo siguiente muestra un archivo de entrada de ejemplo:
-Xmx512m -Xms256m -Daaa.bbb.ccc=something.forsomeone - Cuando un servidor de Liberty se ha iniciado desde un procedimiento, el servidor validará que no se está ejecutando con una umask de 000. Si detecta que el valor de umask es 000, lo alterará temporalmente con un valor de 022.
start bbgzsrv,parms='defaultServer'
//BBGZANGL PROC PARMS='',COLD=N
//*------------------------------------------------------------------
// SET ROOT='/u/MSTONE1/wlp'
//*------------------------------------------------------------------
//* Start the Liberty angel process
//*------------------------------------------------------------------
//STEP1 EXEC PGM=BPXBATA2,REGION=0M,
// PARM='PGM &ROOT./lib/native/zos/s390x/bbgzangl COLD=&COLD &PARMS'
//STDOUT DD SYSOUT=*
//STDERR DD SYSOUT=*

Tema de tarea