Mandato stopServer
El mandato stopServer lee el archivo de configuración para el proceso del servidor especificado. Este mandato envía un mandato JMX (Java™ Management Extensions) al servidor indicándole que se concluya.
El proceso de servidor puede ser un servidor de aplicaciones, un DMZ Secure Proxy Server for IBM® WebSphere Application Server, un servidor de agente administrativo o un servidor de gestor de trabajos.
De forma predeterminada, el mandato stopServer no devuelve el control a la línea de mandatos hasta que el servidor termina el proceso de conclusión. Hay una opción -nowait para devolver el control inmediatamente y otras opciones para controlar el comportamiento del mandato stopServer. Para obtener más información sobre cómo ejecutar este mandato, consulte el tema Cómo utilizar las herramientas de línea de mandatos.
Si ejecuta el producto en el sistema operativo Microsoft Windows y tiene el servidor ejecutándose como un servicio del sistema operativo Windows, el mandato stopServer detiene el servicio Windows responsable de iniciar el servidor.
Aunque el mandato stopServer devuelve el control cuando finaliza la conclusión del servidor, puede devolverlo antes de que haya terminado el proceso IBM i. En función de la cantidad de memoria que JVM
(Java
Virtual Machine) deba devolver a la agrupación de memoria, el proceso
puede tardar varios segundos o minutos en llevarse a cabo. No debe tratar de iniciar de nuevo el servidor hasta que el proceso haya terminado. Utilice el mandato de CL WRKACTJOB SBS(subsistema) para determinar si el proceso ha terminado completamente.
De forma predeterminada, el subsistema es QWAS85.
Si la seguridad está
habilitada, con el mandato stopServer se debe utilizar un
nombre de usuario y una contraseña porque el mandato invoca un método
MBean en el servidor.
Los parámetros de nombre de usuario y contraseña no son necesarios con el mandato stopServer. Los
parámetros se pasan automáticamente al script que utiliza el servicio
Windows para concluir el sistema.

Sintaxis
La sintaxis del mandato es una de las siguientes:
stopServer <nombre_servidor> [opciones]
donde nombre_servidor es el nombre del directorio de configuración del servidor de aplicaciones o DMZ Secure Proxy Server for IBM WebSphere Application Server que desee detener.
Este argumento es necesario.
Este argumento es opcional. Si se utiliza el perfil predeterminado, el servidor utiliza por omisión
el valor server1. Si el nombre de perfil no es el valor predeterminado,
el servidor toma por omisión el nombre del perfil.
stopServer <nombre_agente_admin>
Donde nombre_agente_admin es el nombre del agente administrativo que se desea detener.
stopServer <gestor_trabajos>
donde gestor_trabajos es el nombre del gestor de trabajos que se quiere detener.
Parámetros
Las siguientes opciones están disponibles para el mandato stopServer:
- -nowait
- Indica al mandato stopServer que no espere a que la conclusión del proceso servidor sea satisfactoria.
- -quiet
- Suprime la información sobre el progreso que el mandato stopServer imprime en modalidad normal.
- -logfile <nombre_archivo>
- Especifica la ubicación del archivo de registro en el que se escribe la información de rastreo. Por omisión, el archivo de anotaciones cronológicas se denomina stopServer.log y se crea en el directorio logs.
- -profileName
- Define el perfil del proceso de servidor en una instalación de varios perfiles. La opción -profileName no es necesaria para la ejecución en un entorno de perfil único. El valor predeterminado de esta opción es el perfil predeterminado.
- -replacelog
- Sustituye el archivo de registro en lugar de anexarlo al archivo de registro actual.
- -trace
- Genera información de rastreo en un archivo para depuración. La salida de rastreo se escribe en el archivo stopServer.log, que se encuentra en el directorio raíz_perfil/logs/servidor.
- -timeout <segundos>
- Especifica el tiempo de espera para que el servidor concluya antes de que se exceda el tiempo de espera y devuelva un error.
- -statusport <númeropuerto>
- Un parámetro opcional que permite a un administrador establecer el número de puerto para una devolución de llamada de estado del servidor. La herramienta abre este puerto y espera la devolución de llamada del estado procedente del servidor, justo antes de que el servidor se haya detenido. Si este parámetro no se establece, se asigna automáticamente un puerto no utilizado.
- -conntype <tipo>
- Especifica el tipo de conector JMX que se utilizará para conectar con el gestor de despliegue. Los tipos válidos son SOAP o RMI (Remote Method Invocation).
- -port <Númeropuerto>
- Especifica el puerto JMX de servidor que debe utilizarse de forma explícita, de modo que no sea necesario leer los archivos de configuración para obtener la información.
- -username <nombre>
- Especifica el nombre de usuario para autenticación si está habilitada la seguridad en el servidor. Funciona igual que la opción -user.
- -user <nombre>
- Especifica el nombre de usuario para autenticación si está habilitada la seguridad en el servidor. Funciona igual que la opción -username.
- -password<contraseña>
- Especifica la contraseña
para autenticación si está habilitada la seguridad en el servidor.
Avoid trouble: Si la ejecución se realiza en un entorno seguro pero no se ha proporcionado un ID de usuario y una contraseña, aparece el siguiente mensaje de error:
Para resolver estos problemas, proporcione la información de ID de usuario y contraseña.gotchaADMN0022E: Se ha denegado el acceso para la operación stop en el MBean Server debido a que las credenciales no son suficientes o están vacías.
- -help
- Imprime una sentencia de uso.
- -?
- Imprime una sentencia de uso.
Ejemplo de uso
Los siguientes ejemplos muestran la sintaxis correcta:
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[z/OS]](../images/ngzos.gif)
stopServer server1
stopServer server1 -nowait
stopServer server1 -trace (produce el archivo stopserver.log)
stopServer adminagent
stopServer jobmgr
stopServer proxy1 (for the secure proxy profile)
![[IBM i]](../images/iseries.gif)
stopServer server1 (stops the server1 server for the default profile)
stopServer server1 -nowait
stopServer server1 -trace (produce el archivo stopserver.log)
stopServer -profileName mytest (detiene el servidor mytest
configurado para el perfil mytest)
stopServer AdminAgent01
stopServer JobMgr01
stopServer proxy1 (default server name for the SecureProxySrv01 profile)