サブシステム記述変更 (CHGSBSD)

実行可能場所: すべての環境 (*ALL)
スレッド・セーフ: いいえ

サブシステム記述変更 (CHGSBSD)コマンドは，指定されたサブシステム記述の操作属性を変更します。サブシステム記述は，サブシステムが活動状態である間に変更することができます。ただし，ジョブが中断される可能性があるので，サブシステムが活動状態である間に記憶域プール (POOLS)パラメーターに*RMV値を指定することはできません。

制約事項:

このコマンドを使用するには，以下が必要です。
- 指定されたサブシステム記述に対するオブジェクト操作(*OBJOPR),オブジェクト管理(*OBJMGT),および読み取り(*READ)権限と，そのサブシステム記述が入っているライブラリーに対する実行(*EXECUTE)権限。
- システム・ライブラリー・リスト項目を指定するには，全オブジェクト(*ALLOBJ)および機密保護管理(*SECADM)特殊権限。
- 補助記憶域プール(ASP)グループ名を指定するには，全オブジェクト(*ALLOBJ)および機密保護管理 (*SECADM)特殊権限。
ジョブが中断される可能性があるので，サブシステムが活動状態である間はPOOLSパラメーターに*RMV値を指定することはできません。
サブシステムが活動状態である間は，ASPGRPパラメーターの値を変更することはできません。

上

パラメーター

キーワード	記述	選択項目	ノーツ
SBSD	サブシステム記述	修飾オブジェクト名	必須, 定位置 1
	修飾子 1: サブシステム記述	名前
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB
POOLS	記憶域プール	単一値: *SAME その他の値 (最大 10 回の繰り返し): 要素リスト	オプショナル, 定位置 2
	要素 1: プールID	1-10
	要素 2: 記憶域サイズ	整数, BASE, NOSTG, RMV, INTERACT, SPOOL, SHRPOOL1, SHRPOOL2, SHRPOOL3, SHRPOOL4, SHRPOOL5, SHRPOOL6, SHRPOOL7, SHRPOOL8, SHRPOOL9, SHRPOOL10, SHRPOOL11, SHRPOOL12, SHRPOOL13, SHRPOOL14, SHRPOOL15, SHRPOOL16, SHRPOOL17, SHRPOOL18, SHRPOOL19, SHRPOOL20, SHRPOOL21, SHRPOOL22, SHRPOOL23, SHRPOOL24, SHRPOOL25, SHRPOOL26, SHRPOOL27, SHRPOOL28, SHRPOOL29, SHRPOOL30, SHRPOOL31, SHRPOOL32, SHRPOOL33, SHRPOOL34, SHRPOOL35, SHRPOOL36, SHRPOOL37, SHRPOOL38, SHRPOOL39, SHRPOOL40, SHRPOOL41, SHRPOOL42, SHRPOOL43, SHRPOOL44, SHRPOOL45, SHRPOOL46, SHRPOOL47, SHRPOOL48, SHRPOOL49, SHRPOOL50, SHRPOOL51, SHRPOOL52, SHRPOOL53, SHRPOOL54, SHRPOOL55, SHRPOOL56, SHRPOOL57, SHRPOOL58, SHRPOOL59, *SHRPOOL60
	要素 3: 活動レベル	整数
	要素 4: サイズ計測単位	KB, MB
MAXJOBS	ジョブの最大数	0-32000, SAME, NOMAX	オプショナル, 定位置 3
TEXT	テキスト'記述'	文字値, SAME, BLANK	オプショナル
SGNDSPF	サインオン表示装置ファイル	単一値: SAME, QDSIGNON その他の値: 修飾オブジェクト名	オプショナル
	修飾子 1: サインオン表示装置ファイル	名前
	修飾子 2: ﾗｲﾌﾞﾗﾘｰ	名前, LIBL, CURLIB
SYSLIBLE	サブシステム・ライブラリー	名前, SAME, NONE	オプショナル
ASPGRP	ASPグループ	名前, SAME, NONE	オプショナル
WLCGRP	作業負荷グループ	名前, SAME, NONE	オプショナル

上

サブシステム記述 (SBSD)

変更するサブシステム記述の名前およびライブラリーを指定します。

これは必須パラメーターです。

修飾子1: サブシステム記述

名前: 変更するサブシステム記述の名前を指定します。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: 一致が見つかるまで，スレッドのライブラリー・リストの中のすべてのライブラリーが検索されます。
*CURLIB: オブジェクトを見つけるためにスレッドの現行ライブラリーが使用されます。スレッドの現行ライブラリーとして指定されているライブラリーがない場合，QGPLライブラリーが使用されます。

名前: サブシステム記述が入っているライブラリーを指定します。

上

記憶域プール (POOLS)

1つまたは複数の記憶域プール定義のIDおよびこれらに対する変更データを指定します。

既存のプール定義を除去する時には，サブシステムは非活動状態でなければなりません。

指定されない各既存のプール定義のサイズおよび活動レベルは変わりません。

単一値

*SAME: サブシステム記述の中の記憶域プール定義は変更されません。

その他の値（最大10個指定可能）

要素1: プールID

1から10: 変更する記憶域プール定義のプールIDを指定します。

要素2: 記憶域サイズ

*BASE: 指定されたプール定義は，他のサブシステムと共用できる基本システム・プールとして定義されます。基本プールの最小サイズおよび活動レベルは，システム値QBASPOOLおよびQBASACTLVLに指定します。
*NOSTG: 最初は，記憶域も活動レベルもプールに割り当てられません（非活動状態）。
*RMV: 指定されたプール定義がサブシステム記述から除去されます。
*INTERACT: 指定されたプール定義は，対話式作業で使用される共用プールとして定義されます。共用プールのサイズおよび活動レベルは，共用記憶域プールの変更 (CHGSHRPOOL)コマンドを使用して指定されます。
*SPOOL: 指定されたプール定義は，スプール書き出しプログラムで使用される共用プールとして定義されます。共用プールのサイズおよび活動レベルはCHGSHRPOOLコマンドを使用して指定します。
*SHRPOOLNN: 指定されたプール定義は汎用共用プールとして定義されます。60個の汎用共用プールがあり，特殊値*SHRPOOL1から*SHRPOOL60によって識別されます。共用プールのサイズおよび活動レベルは，CHGSHRPOOLコマンドを使用して指定されます。
整数: 指定された記憶域プールの記憶域サイズを指定してください。少なくとも256キロバイトの値を指定しなければなりません。サイズは，要素4: サイズ計測単位を使用してキロバイトまたはメガバイトで指定されます。
注: プールのサイズを変更すると，補助記憶域に書き込むページが必要になることがあります。システムが大規模の変更を完了するために必要な時間は，省略時の待ち時間を上回る可能性があります。これが起こる場合は，変更が完了してもメッセージCPF1001 (システム応答の待機時間が満了した。)が出されます。

要素3: 活動レベル

整数: プール内で同時に実行できるスレッドの最大数を指定します。

要素4: サイズ計測単位

*K: 指定されたプール記憶域サイズはキロバイト単位です。
*M: 指定されたプール記憶域サイズはメガバイト単位です。

上

ジョブの最大数 (MAXJOBS)

このサブシステム記述によって制御されるサブシステムで同時に活動状態にできるジョブの最大数を指定します。この最大数は，開始され，待機または実行中であるすべてのジョブに適用されますが，ジョブ待ち行列にあるジョブまたは実行を終了したジョブには適用されません。

*SAME: サブシステム中で同時に使用できるジョブの最大数は変更されません。
*NOMAX: このサブシステムで同時に活動状態にできるジョブの最大数に制限はありません。
0-32000: このサブシステムで実行可能なジョブの最大数を指定してください。

上

テキスト'記述' (TEXT)

オブジェクトを簡単に記述したテキストを指定します。

*SAME: テキスト（存在している場合）は変更されません。

*BLANK: テキストは指定されません。
文字値: 50文字を超えないテキストを，アポストロフィで囲んで指定してください。

上

サインオン表示装置ファイル (SGNDSPF)

サブシステムに割り振られたワークステーションでサインオン画面を表示する時に使用するサインオン表示ファイルの名前およびライブラリーを指定します。指定したサインオン表示ファイルが，サブシステム記述の作成または変更時に存在していない場合には，ライブラリー修飾子を指定しなければなりません（修飾されたサインオン表示ファイルの名前がシステムによって保管されるため）。サインオン表示ファイルには，SIGNONというレコード様式が入っていなければなりません。

注: サブシステムが活動状態である時には，サインオン表示ファイルを変更することができます。しかし新しいサインオン表示ファイルは，次回にサブシステムが開始されるまで，使用されません。

注: 表示ファイルの形式検査を完了するには，使用(*USE)が必要です。これは，サブシステムの開始時に表示が正しく機能するであろうことを予測するのに役立ちます。表示ファイルまたはそのライブラリーが許可されていない場合には，それらの形式検査は行われません。

単一値

*SAME: 現行のサインオン表示ファイルの値は変更されません。
*QDSIGNON: サブシステムに割り振られたワークステーションにサインオン画面を表示する際に，QSYSの中のサインオン画面ファイル値QDSIGNONが使用されます。

修飾子1: サインオン表示装置ファイル

名前: 使用されるサインオン画面ファイルの名前を指定します。

修飾子2: ﾗｲﾌﾞﾗﾘｰ

*LIBL: 一致が見つかるまで，スレッドのライブラリー・リストの中のすべてのライブラリーが検索されます。
*CURLIB: オブジェクトを見つけるためにスレッドの現行ライブラリーが使用されます。スレッドの現行ライブラリーとして指定されているライブラリーがない場合，QGPLライブラリーが使用されます。

名前: サインオン表示ファイルが入っているライブラリーを指定してください。

上

サブシステム・ライブラリー (SYSLIBLE)

サブシステムで開始されたジョブのライブラリー・リストのシステム部分の，他のライブラリーの前に追加されるライブラリーを指定します。このパラメーターによって，2次言語ライブラリーを使用することができます。

制約事項:

このパラメーターは，サブシステムが活動状態である間に変更することができます。行う変更はすべて，開始される新しいジョブに対して有効となります。サブシステム内の活動ジョブのライブラリー・リストは変更されません。
QSYSLIBLまたはQUSRLIBLシステム値に2次言語ライブラリーを指定してはなりません。ライブラリー・リストのシステム部分に2次言語ライブラリーを追加できるように，QSYSLIBLに含まれるライブラリーは15個より少なくなければなりません。
システム・ライブラリー・リスト項目に*NONE以外の値を指定するには，*ALLOBJおよび*SECADM特殊権限が必要です。

*SAME: システム・ライブラリー・リストは変更されません。
*NONE: 2次言語ライブラリーがシステム・ライブラリー・リストから除去されます。
名前: システム・ライブラリー・リストに追加するライブラリーの名前を指定してください。

上

ASPグループ (ASPGRP)

サブシステム・モニター・ジョブのライブラリー名スペースに組み込まれる補助記憶域プール(ASP)グループの名前を指定します。このASPグループ名は，そのASPグループ中の1次ASP装置の名前です。

サブシステム・モニター・ジョブがユーザー・ジョブを作成すると，サブシステム・モニター・ジョブのライブラリー名スペースによってジョブ記述が見つかります。ジョブ待ち行列，サインオン表示装置ファイル，およびサブシステム・ライブラリーが，サブシステム・モニター・ジョブのライブラリー名スペースで見つかります。

サブシステム・モニター・ジョブが，ユーザー・ジョブの代行処理をする場合は，サブシステムがユーザー・ジョブのライブラリー名スペースを使用します。プログラムおよびクラスが，ユーザー・ジョブのライブラリー名スペースで見つかります。これらのオブジェクトの場合，サブシステム記述でのASPGRPパラメーターは効果がありません。

サブシステム・モニター・ジョブがASPグループを使用すると，そのサブシステム内のジョブが同じASPグループを使用します。ASPグループがジョブ作成中に設定され，他のオブジェクトを見つけるために使用できるよう，ジョブ記述に初期ASPグループ(INLASPGRP)パラメーターを使用します。使用するジョブ記述を決めるためにサブシステムがプログラムを見つける必要があるため，サブシステム・モニター・ジョブとユーザー・ジョブ間の整合性は，事前開始ジョブ項目には特に重要です。

制約事項:

制御サブシステムのサブシステム・モニター・ジョブのライブラリー名スペースは，ASPGRPを含むことができません。*NONE以外の値が，制御サブシステムのサブシステム記述で指定される場合，その値は無視されます。
QSYSWRKサブシステムのサブシステム・モニター・ジョブのライブラリー名スペースは，ASPGRPを含むことができません。*NONE以外の値が，QSYSWRKサブシステムのサブシステム記述で指定される場合，その値は無視されます。
サブシステムが始動される前に，ASPグループがオンに変更され，状況は「AVAILABLE」になる必要があります。
ASPグループがオフに変更される前に，サブシステムを終了する必要があります。
このパラメーターは，サブシステムが活動状態である間に変更することはできません。

*SAME: ASPグループ値は変更されません。
*NONE: サブシステム・モニター・ジョブのライブラリー名スペースは，ASPグループを含んでいません。
名前: サブシステム・モニター・ジョブのライブラリー名スペースに組み込まれるASPグループの名前を指定します。

上

作業負荷グループ (WLCGRP)

サブシステム内のジョブに対して使用する作業負荷グループの名前を指定します。

制約事項:

このパラメーターは，サブシステムが活動状態である間に変更することができます。行う変更はすべて，開始される新しいジョブに対して有効となります。サブシステム内の活動ジョブの作業負荷グループは変更されません。
制御サブシステムは，制御サブシステム内のジョブの作業負荷グループを使用しません。*NONE以外の値が，制御サブシステムのサブシステム記述で指定される場合，その値は無視されます。

*SAME: 作業負荷グループ値は変更されません。
*NONE: サブシステム内のジョブには作業負荷グループは使用されません。
名前: サブシステム内のジョブに対して使用する作業負荷グループの名前を指定してください。

上

例

例1:記憶域サイズおよび活動レベルの変更

CHGSBSD   SBSD(QGPL/PAYCTL)  POOLS((2 1500 3))
          SGNDSPF(QGPL/COMPANYA)

このコマンドは，サブシステムPAYCTLによって使用される記憶域プール2の定義を1500Kの記憶域サイズおよび3の活動レベルに変更します。サインオン画面ファイルは，ファイルCOMPANYAを表示するように変更され，QGPL ライブラリーに入れられます。このコマンドが出された時にサブシステムが活動状態であった場合には，次回サブシステムが開始されるまで，COMPANYAは使用されません。

例2:複数の属性の変更

CHGSBSD   SBSD(LIB6/ORDER)
          POOLS((1 *BASE)(2 750 4)(3 *RMV)(4 *NOSTG))
          MAXJOBS(5)

このコマンドは，サブシステムORDERがサポートできるジョブの最大数を5に変更します。（サブシステムの記述はライブラリーLIB6に保管されます。）記憶域プール1の定義は基本共用システム・プールに変更され，プール2の定義は750Kの記憶域サイズと4の活動レベルを持つように変更され，プール3の定義はサブシステムから除去され，また，プール4の定義は記憶域および活動レベルを持たないように変更されます。

例3:言語ライブラリーの変更

CHGSBSD   SBSD(QGPL/SPANISH)  SGNDSPF(QSYS2931/QDSIGNON)
          SYSLIBLE(QSYS2931)

このコマンドは，サブシステム記述SPANISHをスペイン語2次言語に変更します。

上

エラー・メッセージ

*ESCAPE メッセージ

CPF1619: ライブラリー&2のサブシステム記述&1に損傷がある。
CPF1691: 活動サブシステム記述は変更されることも変更されないこともある。
CPF1697: サブシステム記述&1は変更されなかった。

上