casstop

エンタープライズ サーバーを停止します。

構文:

casstop [/res-name] [/sprototype:host:WebServiceport] [/lserver-name] [/i] [/w] [/f] [/uuserid] [/ppassword] [/ggroup] [/tshutdowntransaction

パラメーター:

/res-name 停止するエンタープライズ サーバーの名前。デフォルトでは ESDEMO に設定されます。このオプションを使用する手順は、次のとおりです。
  • /r フラグで指定されたエンタープライズ サーバーを先に起動する必要があります。
  • /r フラグで指定されたエンタープライズ サーバーと同じユーザー ID のもとで実行する必要があります。Directory Server がシステム サービスとして起動され、エンタープライズサーバーが Administration インターフェイスを使用して起動された場合には、恐らくエンタープライズ サーバーを起動するユーザー ID が LOCAL_SYSTEM であるため、このコマンドは機能しません。詳細については、Enterprise Server 『構成と管理』マニュアルの 『Enterprise Server Administration の概要』の章にある 『Directory Server の起動と停止』の項を参照してください。
注: このユーティリティを JCL または WEB サービスから呼び出す場合 (つまり、このユーティリティを SEP 内で実行している場合) は、/r オプションを使用してサーバーに接続することはできません。その場合は、/s または /l オプションを使用してサーバーに接続する必要があります。
または  
/sprototype:host:WebServiceport 停止されるエンタープライズ サーバーの Web サービス リスナーの場所。例えば、/stcp:localhost:9003
または  
/lserver-name エンタープライズ サーバーの名前。ルックアップを実行してエンタープライズ サーバーの Web サービスを特定するという点で、これは /s オプションと異なります。
/i 即時シャットダウン。

このオプションを選択すると、すべての SEP と進行中のトランザクションが直ちに終了されて、PLT シャットダウンは実行されません。リージョンは通常どおり終了します。

/w シャットダウンが完了するのを待機します。
/f 強制シャットダウンを強制します。このオプションは、/s または -/l とともには使用できません。

このオプションを使用すると、すべてのプロセスが強制終了され、リージョンはシャットダウンが処理されることなく停止します。

/uuserid 許可ユーザー。このユーザーは、エンタープライズ サーバーと MF ディレクトリ サーバー両方のセキュリティ ドメイン内に存在する必要があります。つまり、エンタープライズ サーバーとディレクトリ サーバーの両方のセキュリティ設定が指定されたユーザーの資格情報を検証できる必要があります。そのエンタープライズ サーバーとディレクトリ サーバーは異なるセキュリティ マネージャーを使用している可能性があることに注意してください。そのため、ユーザーを複数のセキュリティ リポジトリ内で定義する必要がある場合があります。

ディレクトリ サーバーのステータス情報を更新するには、ディレクトリ サーバーのドメイン内で、ユーザーが [サーバー] リソース クラス内で適切なエンタープライズ サーバー リソースの変更のアクセス許可を持っている必要があります。casstop コマンドを正常に実行するには、エンタープライズ サーバーのセキュリティ ドメイン内で、ユーザーが OPERCMDS リソース クラス内の casstop リソースに対して変更のパーミッションを持っている必要があります。

注: これが要求されるのは、セキュリティを設定している場合のみです。
/ppassword ユーザーのパスワード。
/cgroup ユーザーのサインオン グループ。デフォルトでは、ユーザーがリソースへのアクセスを要求したときには、一部の外部セキュリティ マネージャーによって、そのユーザー、およびユーザーの現在のサインオン グループに関係する規則のみが適用されます。

このオプションを指定しないと、ユーザーはセキュリティ マネージャーによって決定されるデフォルトのグループを使用してサインオンされます。

/ttransaction-id 実行する MSS シャットダウン トランザクション。何も指定しないと、デフォルトで CQIT になります。
注:
  • /r、/s、/l オプションは、停止される相互排他的なエンタープライズ サーバーを識別するための代替方法です。
  • エンタープライズ サーバー用に外部セキュリティ マネージャーが設定されている場合、それを停止するにはユーザー ID とパスワードを指定する必要があります。

コメント:

UNIX では、スラッシュ (/) の代わりにダッシュ (-) をパラメーターの前に使用できます。

コマンド ライン ユーティリティーの多くは (casstart、casstop、casfile、casout、cassub など)、呼び出しインターフェイスを使用してコマンド ライン パラメーターをその呼び出しに渡すプログラムによって起動できます。たとえば、 casstart を参照してください。

戻りコード:

重大なエラーが発生した場合、値 15 が戻りコードに設定ます。その他の場合、それもりも低い値が戻されます。エラーを説明するメッセージが標準出力とコンソール ログに表示されます。独自のアプリケーション プログラム内から casstop を呼び出している場合、メッセージはコンソール ログに表示されます。