startServer 命令

语法

startServer server_name [options]

其中 server_name 是要启动的应用程序服务器的名称。

此自变量是必需的。

此自变量是可选的。 如果未指定此参数，那么会根据概要文件名来分配服务器。 If you use the profile named default, the <server> argument is set to server1. If the profile name is not default, the <server> argument is set to the profile name.

startServer <adminagent_name>

其中 adminagent_name 是要启动的管理代理程序的名称。

参数

下列选项可用于 startServer 命令：

-?

显示用法说明。

-curlib <product_library>

指定要用于底层“提交作业”(SBMJOB) CL 命令的当前库。

-cpyenvvar

指示 startServer 命令设置当前为服务器进程定义的环境变量。 缺省情况是不设置当前定义的环境变量。

-help

显示用法说明。

-inllibl <library_list>

指定要用于底层“提交作业”(SBMJOB) CL 命令的初始库列表。

-inlaspgrp <ASP_group>

指定底层“提交作业”(SBMJOB) CL 命令的初始 ASP 组。

-J <java_option>

指定要传递到 Java 解释器的选项。

-jobd <product_library/job_description>

指定底层“提交作业”(SBMJOB) CL 命令的作业描述。

-jobq <product_library/job_queue>

指定底层“提交作业”(SBMJOB) CL 命令的作业队列。

-logfile <fileName>

指定写入跟踪信息的日志文件的位置。 缺省情况下，日志文件名为 startServer.log，并且是在 logs 目录中创建的。

-nowait

指示 startServer 命令不要等待已启动服务器进程的成功初始化。

-outq <product_library/output_queue>

指定底层“提交作业”(SBMJOB) CL 命令的输出队列。

-profileName

在多概要文件安装中定义服务器进程的概要文件。 在单概要文件环境中运行不需要 -profileName 选项。 此选项的缺省值为缺省概要文件。

-quiet

禁止显示 startServer 命令以正常方式显示的进度信息。

-replacelog

替换日志文件，而不是附加到当前日志。

-recovery

指定服务器将以恢复方式启动，执行事务恢复，然后关闭。 当服务器处于恢复方式时将不接受任何新事务。 当您再次启动该服务器时，由于可疑事务而不可用的资源将变为可用。

如果服务器失败，且在恢复过程中您不想接受新事务，那么请使用此选项。

对于转换用户: 如果要从产品的先前版本进行迁移，请确保控制器的 JCL 过程语句中包含的 ENV 参数包含 REC=N 或 REC=Y 元素。 如果 ENV 参数不包括 REC=N 或 REC=Y 元素，那么即使您指定 -recovery 选项，服务器也不会以恢复方式重新启动。

//BBO6ACR  PROC ENV=,PARMS=' ',REC=N,Z=BBO6ACRZ

当您调用带有 -recovery 参数的 startServer 命令并且恢复过程失败时， SystemErr.log 和 SystemOut.log 文件中会出现以下错误消息:

CWNATV03I: Application server xxxxxx in profile xxxxxx has completed recovery. Server stopped.

此消息未指示恢复过程失败。 如果使用 -recovery 参数，请检查要启动的服务器的 SystemErr.log 和 SystemOut.log 文件，以确定恢复过程是否成功。

-sbs <product_library/subsystem_description>

指定要用于底层“提交作业”(SBMJOB) CL 命令的子系统。

-statusport <portNumber>

一个可选参数，允许管理员设置服务器状态回调的端口号。 该工具打开此端口并等待来自服务器的指示该服务器已启动的状态回调。 如果未设置此参数，那么将自动分配一个未使用的端口。

-script [<script fileName>] -background

使用 startServer 命令生成启动脚本，而不是直接启动服务器进程。 启动脚本名称是一个可选参数。 如果未提供启动脚本名称，那么缺省脚本文件名为 start_server (基于作为第一个参数传递给 startServer 命令的服务器名称)。 -background 参数是一个可选参数，用于指定当您运行它时将在后台运行生成的脚本。

-trace

将跟踪信息生成为日志文件以进行调试。

启用对启动服务器的本机进程代码的跟踪。 跟踪输出将写至 profile_root/logs 目录中的 was_jobname-jobuser-jobnum.log 文件。

-timeout <seconds>

指定在服务器初始化超时并返回错误之前的等待时间。

-usejobd

指定切换至 Run-As 用户标识时，将“提交作业”(SBMJOB) 进程中的作业描述用于服务器。

注: 此命令不会影响当前作业描述的 USER 字段。

使用方案

以下示例说明正确的语法。 括号中的信息是在发出前面的命令时会创建的输出描述。

startServer server1

startServer server1 -script (produces the start_server1.sh or .bat files)

startServer server1 -trace (produces the startserver.log file)

startServer adminagent

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)

startServer server1 (starts the server1 server for the default profile)

startServer server1 -trace (starts the server1 server for
the default profile and produces trace files under the
profile_root/logs directory)

startServer -profileName mytest (starts server mytest 
configured under profile mytest)

startServer AdminAgent01

startServer.sh server1 -trace -username MyUserName -password MyUserPassword
 -profileName MyProfileName     (starts the server1 server using the 
         MyProfileName profile. The server runs under the user name MyUserName,
         and produces trace files under the profile_root/logs directory)

退出码

如何捕获 startServer 和 stopServer 的返回码以确定操作是否成功？ 该表显示了对于指定的启动或停止命令，服务器的返回码。

#!/bin/sh
exitCode=`./startServer.sh server1`