casstart

エンタープライズ サーバーを起動します。

構文:

casstart [/res-name] [/oconfig-name][/uusername] [/ppassword] [/cgroup] [/z[userid]] [/x[userid]] [/w[seconds]] [/s:start-type] [/mhost:port]

パラメーター:

/res-name 起動するエンタープライズ サーバーの名前。デフォルトでは ESDEMO に設定されます。
/oconfig-name MSS が有効化されたリージョンでこのオプションを使用する場合は、config-name を SIT の名前にする必要があります。リージョンは、Enterprise Server Administration ページで定義された SIT ではなく、指定した SIT を使用して起動します。
/uuserid 許可ユーザー。このユーザーは、エンタープライズ サーバーと Micro Focus Directory Server の両方のセキュリティ ドメイン内に存在する必要があります。つまり、エンタープライズ サーバーと Directory Server の両方のセキュリティ構成が指定されたユーザーの資格情報を検証できる必要があります。エンタープライズ サーバーと Directory Server で異なるセキュリティ マネージャーを使用している可能性があることに注意してください。ユーザーを複数のセキュリティ リポジトリ内で定義することが必要になる場合があります。

Directory Server のステータス情報を更新するには、Directory Server のドメイン内で、ユーザーが [サーバー] リソース クラス内で適切なエンタープライズ サーバー リソースの変更の権限を持っている必要があります。casstart コマンドを正常に実行するには、エンタープライズ サーバーのセキュリティ ドメイン内で、ユーザーが OPERCMDS リソース クラス内の casstart リソースに対して変更の権限を持っている必要があります。

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

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

/z[userid] このパラメーターを使用すると、対話型プロンプトを通じて、またはコンソールからのリダイレクトとしてユーザー資格情報を渡せます。userid はオプションです。これは、Vault 機能に保存されている資格情報を渡すために使用できます。
注: Micro Focus では、/u および /p よりもこのオプションの使用をお勧めします。
/x[userid] ユーザー入力からユーザー資格情報を取得します。
注: userid はオプションです。
/w[seconds]

開始プロセスの終わりまでの遅延 (秒単位) を導入します。値の範囲は 0 から 999 までですが、最小の遅延は 15 秒です。遅延を指定することで、制御がユーザーに渡される前にエンタープライズ サーバー リージョンのプロセスを開始できるようになります。これにより、リージョンが起動するか、遅延が期限切れになるまで、casstart プロセスは終了しません。

注: /w オプションに時間の値を指定しないと、最小遅延に 15 秒が設定されます。

このパラメーターを省略した場合、リージョンで要求を受け入れる準備ができる前に casstart が終了する可能性があります。

/s:start-type このオプションは、PAC に含まれるエンタープライズ サーバー リージョンを起動するために使用します。start-type は次のいずれかになります。
w
ウォーム スタート。
c
コールド スタート。コールド スタートできるのは、PAC で最初に起動するエンタープライズ サーバー リージョンだけです。
注: PAC 内の最初のエンタープライズ サーバー リージョンをコールド スタートすることは必須ではありません。
u
アップグレード スタート。参加するエンタープライズ サーバー リージョンが通常の操作ではバッチ ワークロードを処理できなくなり、EXEC CICS START 要求がすべて拒否されます。
PAC に含まれる残りのエンタープライズ サーバー インスタンスは、ウォーム スタートで実行する必要があります。詳細については、「PAC の起動」を参照してください。
注:
  • PAC で 1 つ以上のエンタープライズ サーバー インスタンスがすでに実行されている場合にエンタープライズ サーバー インスタンスをコールド スタートしようとしても、コールド スタート フラグは無視されます。
  • /s: を指定した場合、このオプションの値は SIT の TS/TD キューのコールド/ウォーム スタート設定をオーバーライドします。/s: を明示的に指定していない場合は、TS/TD キューの SIT 設定が適用されます。
このオプションを使用して PAC に含まれていないエンタープライズ サーバー インスタンスを起動した場合も、TS/TD の SIT オプションはオーバーライドされます。
/mhost:port デフォルトのホストおよびポート (localhost:86 または 127.0.0.1:86) がターゲットの MFDS サービスがバインドされているポートではない場合に、casstart で MFDS サービスを検索するホストおよびポートを指定できます。
注: /m パラメーターが指定されておらず、ES_MFDS_ADDRESS 環境変数が指定されている場合は、この環境変数が代わりに使用されます。詳細については、「Enterprise Server の全般の環境変数」を参照してください。

説明:

UNIX では、スラッシュ (/) の代わりにダッシュ (-) をオプションの前に使用できます。

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

01 ws-cmd-parms.
     05 ws-cmd-len         pic x(02) comp-x.
     05 ws-cmd-value     pic x(1024).
......
......
......
      *> Start up the Server 
      move 1                to ws-cmd-len
      move low-values  to ws-cmd-value
      string "-rMyRegion" delimited by size
               " -uSYSAD -pSYSAD /w" delimited by size
               into ws-cmd-value with pointer ws-cmd-len
      end-string
      subtract 1 from ws-cmd-len
      call 'casstart' using ws-cmd-parms end-call
......
......

32 ビットおよび 64 ビットの両方のアプリケーションの実行をサポートするプラットフォーム上で使用する場合、casstart はその環境をチェックして 32 ビットまたは 64 ビット モードでエンタープライズ サーバーを起動するかどうかを決定します。サーバーの作業モード (生成時に指定) が、環境によって指定されたモードと一致しない場合、casstart は失敗し、適切なメッセージを発行します。UNIX プラットフォームでは、必要に応じて COBMODE 環境変数を 32 ビットまたは 64 ビットに設定しモードを選択します。Windows プラットフォームでは、[スタート] メニューから関連するコマンド プロンプトを選択して環境を選択できます。

casstart コマンドは、コマンド ラインまたは Micro Focus Directory Server (MFDS) からのみ起動できます。たとえば、バッチ ジョブからは起動できません。