Jazz™ Gateway を使用すると、Rational Team Concert™ for System z® リポジトリーからワークアイテム番号と状況をプログラムで取り出すことができます。
Jazz Gateway を z/OS®、Windows®、Linux®、およびその他のプラットフォーム上でのサーバー・デーモンとして実行して、Jazz リポジトリーへの SSL 認証を実行します。これで、ワークアイテム XML を取得するため、REST URI にあるワークアイテム番号が Jazz リポジトリーに受け渡され、ワークアイテム状況または 完全なワークアイテム XML がクライアントに返されます。
Jazz Gateway サーバー・デーモンは、特定のポートで通信して、クライアント要求を取得します。z/OS 上で、System z Jazz Gateway のサーバー・ジョブを実行依頼することによって、これらを要求を行います。REXX クライアントを変更して特定のポートを指定することによって、クライアントと System z Jazz Gateway サーバー・デーモンがソケット接続を介して相互に通信できるようになります。
Jazz Gateway は、z/OS 上に、System z 用のビルド・システム・ツールキット・コンポーネントの一部として SMP/E を使用してインストールされます。サポートされている分散プラットフォームにゲートウェイをインストールしたい場合、Jazz Gateway .zip ファイルを、jazz.net にある Rational Team Concert for System z の『All Downloads 』セクションからダウンロードする必要があります。
Java による UNIX での Jazz Gateway の起動
java -cp .¥RTCz-JazzGateway-<buildID>.jar;.¥log4j-1.2.12.jar; .¥com.ibm.team.repository.common_0.6.1.I200810072228.jar;.¥org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.¥commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666
UNIX シェル・スクリプトの例
#! /bin/sh
#
# RTCzGateway-daemon: Starts/stops the Jazz Gateway
#
#
name="IBM Jazz Gateway"
export JAVA_HOME=<Java_sdk_directory>
export GTW_DIR=<Jazz_gateway_directory>
port=${2:-3456}
PID=GtwPid.$port
cmd="$JAVA_HOME/bin/java -classpath $GTW_DIR/RTCz-JazzGateway-I20090929-1150.jar:$GTW_DIR/log4j-1.2.12.jar:$GTW_DIR/com.ibm.team.repository.common_1.0.1.I200909060153.jar:$GTW_DIR/org.eclipse.osgi_3.4.3.R34x_v20081215-1030.jar:$GTW_DIR/commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway $port"
Start() {
if [ -f $PID ]
then
echo "$name $port already started"
else
echo "Starting $name $port daemon... "
$cmd >$PID.log 2>&1&
echo $! >$PID
fi
}
Stop() {
if [ -f $PID ]
then
echo "Shutting down $name $port daemon: "
kill -9 `cat $PID`
rm $PID
else
echo "$name $port daemon not started "
fi
}
Restart() {
Stop
Start
}
# See how we were called.
case "$1" in
start)
Start
;;
stop)
Stop
;;
restart)
Restart
;;
*)
echo $"Usage: $0 {start|stop|restart} <port_number>"
exit 1
esac
exit $?
| システム | 場所 |
|---|---|
| AIX | /etc/rc.d |
| Red Hat | /etc/rc.d/init.d |
| SUSE | /etc/init.d |
| Solaris | /etc/init.d |
Java による Windows での Jazz Gateway の起動
java -cp .¥RTCz-JazzGateway-<buildID>.jar;.¥log4j-1.2.12.jar;.¥com.ibm.team.repository.common_0.6.1.I200810072228.jar;.¥org.eclipse.osgi_3.3.2.R33x_v20080105.jar;.¥commons-httpclient-3.0.jar com.ibm.teamz.jazz.gateway.JazzGateway 6666
Windows サービスのセットアップの例
Jazz Gateway は Java アプリケーションです。そのため、Windows サービスとして実行するための直接的なサポートは組み込まれていません。 ただし、いくつかのサービス・ラッパーが使用可能です。 この例では、Java Service Launcher が使用されています。このユーティリティーは Rational Team Concert for System z の一部ではありませんが、オンラインで使用することができます。 この例を、使用するサービス・ラッパーに合わせて変更してください。
Java Service Launcher の構成
Debugging IBM Jazz Gateway (gateway_port_number) Now starting JVM ControlHandler registered after JVM start
Windows サービスのインストール、および Jazz Gateway の起動
Jazz Gateway サービスの停止
Windows サービスのアンインストール