環境設定とTACFリソース
OpenFrame Managerを使用するための環境設定とTACFリソースについて説明します。
1. 環境設定
OpenFrame Managerを使用するには、次のファイルを設定する必要があります。
1.1. ofmanager.properties
OpenFrame Managerの環境情報とインストール中に設定した情報が次のファイルに保存されます。
$OFMANAGER_HOME/conf/ofmanager.properties|
設定ファイルを変更した場合は、アプリケーションがデプロイされているJEUS MS(Managed Server)を再起動する必要があります。 |
以下は、ofmanager.propertiesファイルの形式と、各設定項目の説明です。
################################################################################
##### #####
##### OpenFrame Manager CONFIGURATIONS #####
##### #####
################################################################################
# DB Property
ofmanager.datasource=<datasource-name>
# OpenFrame GW Property
openframe.webterminal.url=<webterminal-ip>:<ofgw-luport>/<webterminal-name>
openframe.webterminal.name=<ofgw-name>
# Tmax Property
openframe.tmax.ip=<tmax-ip>
openframe.tmax.port=<tmax-port>
openframe.tmax.connection.groupname=<tmax-connection-groupanme>
openframe.tmax.connection.init=<tmax-connection-init>
openframe.tmax.connection.max=<tmax-connection-max>
openframe.tmax.connection.inc=<tmax-connection-inc>
# OS Property
openframe.os = {mvs|msp|xsp}
# CPM Name
openframe.cpm.name=<cpm-name>
# Encoding
encoding = <encoding-name>
# Menus Property
ofmanager.module = [BATCH|TACF|OSC|AIM|NDB|OSI|HIDB]
# Node Information
openframe.defaultNode=<node-name>
openframe.nodelist=<node-list>
# Domain Property
domain.name = <domain-name>
domain.type = {Dev|Prod|Test}
# textarea font change
ofmanager.language={english|japanese}
# Auto Refresh Interval in CM > Console > Reply
ofmanager.consoleReplyRefreshInterval = ( 0(default) ~ 4 : not using auto-refresh, 5 and over : using auto-refresh)
# Allow Menus
ofmanager.menu.batch.userSpool = {true|false} #Using UserSpool
ofmanager.menu.aim.acpjcl = {true|false} #Using ACPJCL
# OFManager font
# Recommended Fonts by Language
# japanese = MS Gothic
# english = HACK, monospace, sans-serif, serif
ofmanager.userFont = {MS Gothic|HACK|monospace|sans-serif|serif}
# OFManager Theme Color
# #origin(violet), blue, green, skyblue, purple, redorange
ofmanager.themeColor = {origin|violet|blue|green|skyblue|purple|redorange}
# OFManager Notification
ofmanager.notification.autoDelete = {yes|no}
ofmanager.notification.maxCount = (1 ~ 5(default))まで設定
# ofrcmsvr connection property
ofrcmsvr.connection_check_interval=(600(default) ~ 3600)
ofrcmsvr.reconnect_interval=(600(default) ~ 3600)
| 項目 | 説明 |
|---|---|
ofmanager.datasource |
OpenFrame Managerでデータベース表を作成および使用するためのデータソース名を指定します。 この値は、JEUSドメイン設定の<data-source>項目の<data-source-id>値を設定する必要があります。 |
openframe.webterminal.url |
OpenFrame Managerの[OSC]メニューで端末情報を確認するために使用されます。
|
openframe.webterminal.name |
OpenFrame Managerの[OSC]メニューでオンライン・トランザクションの状態を確認するために使用されます。 OpenFrame GWのゲートウェイ名を指定します。OpenFrame GW設定ファイルのofgw.propertiesのgw.name項目から確認できます。 |
openframe.tmax.ip |
OpenFrame Managerが接続するOpenFrame TmaxサーバーのIPを指定します。 |
openframe.tmax.port |
OpenFrame Managerが接続するOpenFrame Tmaxサーバーのポート番号を指定します。 OpenFrameの「$TMAX_HOST_PORT」設定で確認できます。 |
openframe.tmax.connection.group name |
WebTを使用してTmaxに接続します。 指定したグループ名でWebtConnectionPoolが作成されます。(デフォルト値: tmax1) |
openframe.tmax.connection.init |
Tmaxに接続するためのWebtConnectionPoolの初期数を設定します。(デフォルト値: 10) |
openframe.tmax.connection.max |
Tmaxに接続するためのWebtConnectionPoolの最大数を設定します。(デフォルト値: 100) |
openframe.tmax.connection.inc |
使用できる接続が足りない場合、接続数を増やす増分値を設定します。(デフォルト値: 10) |
openframe.os |
インストールされるOpenFrameのOSを入力します。(デフォルト値: mvs)
|
openframe.cpm.name |
OpenFrame Managerの[Base]メニューのデータセット・ビューに表示される文字セットに従ってCPMを指定します。(デフォルト値: EBCASCUS.cpm) 設定可能なCPMテーブルは、$OFMANAGER_HOME/data/cpmディレクトリにあります。 |
encoding |
OpenFrame Managerの[Base]メニューでスプール、JCL、ログなどのファイルを読み込むとき、文字変換に使用される文字セットです。(デフォルト値: iso-8859-15) Oracle JDKでサポートされるエンコーディングの値をサポートします。OpenFrameのインストール環境と同様に設定します。サポートされるエンコーディングについては、「https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html」を参照してください。 |
ofmanager.module |
OpenFrame Managerで管理するモジュールを設定します。 各モジュールは略語で設定できます。複数を設定する場合は、セミコロン(;)で区切ります。設定されたモジュールは、OpenFrame Managerに表示され、[Base]メニューは設定と関係なく、常に表示されます。
|
NodeList |
Openframe環境のノード名を入力します。 ノードが複数の場合は、各ノードをセミコロン(;)で区切ります。(デフォルト値: NODE1;NODE2) |
DefaultNode |
OFManagerでデフォルトとして使用されるノードを指定します。(デフォルト値: NODE1) |
domain.name |
OpenFrame Managerのドメイン名を指定します。 サイト環境に応じて設定することができ、OpenFrame Managerメイン画面の「情報領域」に表示されます。 |
domain.type |
OpenFrame Managerのドメイン・タイプを指定します。 OpenFrame Managerを使用する目的に応じて次のいずれかに設定することができます。メイン画面の左上にあるタイトル領域に表示されます。ただし、Prodを設定した場合は、タイトル領域にProdは表示されず、OpenFrame Managerのみが表示されます。
|
ofmanager.language |
OpenFrame Managerを表示する言語を設定します。
|
ofmanager.consoleReplyRefresh Interval |
ユーザー指定の間隔に基づいて、コンソール応答の自動更新されます。
|
ofmanager.menu.batch.userSpool |
OpenFrame Managerの[Batch] > [User Spool]メニューを使用するかどうかを設定します。 [User Spool]メニューでは、出力クラスがWのスプールを確認できます。この項目を設定しない場合、デフォルトで「false」が設定されます。 |
ofmanager.menu.aim.acpjcl |
OpenFrame Managerの[AIM] > [ACPJCL]メニューを使用するかどうかを設定します。 |
ofmanager.userFont |
OpenFrame ManagerでTmaxから送信されるテキストが、指定したフォントで表示されるように設定します。 |
ofmanager.themeColor |
OpenFrame Managerの基本ボタン、ログインページ、ロゴボタンの背景、選択されたGNBとLNBの色を設定します。 |
ofmanager.notification.autoDelete |
OpenFrame Managerで表示される通知(Notification)の削除方法を設定します。
|
ofmanager.notification.maxCount |
OpenFrame Managerの通知の表示件数を指定します。(最大5件まで表示可能) |
ofrcmsvr.connection_check_interval |
OpenFrameサーバーのうち、ofrcmsvrとの接続を確認する間隔を設定します。(デフォルト値：600秒(10分)) |
ofrcmsvr.reconnect_interval |
OpenFrame サーバーのうち、ofrcmsvrとの接続が切断された際の動作を設定します。(デフォルト値：600秒(10分)) |
|
OpenFrame GWのWeb端末の設定については、OpenFrame GW『管理者ガイド』の「OpenFrame GWの設定ファイル」を参照してください。 |
以下は、設定例です。
################################################################################ ##### ##### ##### OpenFrame Manager CONFIGURATIONS ##### ##### ##### ################################################################################ # DB Property ofmanager.datasource = ds_ofm1 # OpenFrame GW Property openframe.webterminal.url = 192.168.105.191:5699/webterminal7 openframe.webterminal.name= ofgw7 # TMAX WebT Property # Tmax Property openframe.tmax.ip=192.168.105.207 openframe.tmax.port=4394 openframe.tmax.connection.groupname=tmax1 openframe.tmax.connection.init=10 openframe.tmax.connection.max=100 openframe.tmax.connection.inc=10 # OS Property openframe.os = msp # CPM Name openframe.cpm.name=EBCASCUS.cpm # Encoding encoding = iso-8859-15 # Menus Property ofmanager.module = BATCH;TACF;AIM;NDB; # Node Information openframe.defaultNode=NODE1 openframe.nodelist=NODE1;NODE2; # Domain Property domain.name = OPENFRAME Env. domain.type = development # OFManager Init Language ofmanager.language=japanese # Auto Refresh Interval in CM > Console > Reply ofmanager.consoleReplyRefreshInterval = 5 # Using UserSpool ofmanager.userSpool=true # OFManager font # Recommended Fonts by Language # japanese : MS Gothic # english : HACK, monospace, sans-serif, serif ofmanager.userFont = HACK # OFManager Theme Color # origin(violet), blue, green, skyblue, purple, redorange ofmanager.themeColor = origin # OFManager Notification ofmanager.notification.autoDelete = yes ofmanager.notification.maxCount = 5 # ofrcmsvr connection property ofrcmsvr.connection_check_interval=600 ofrcmsvr.reconnect_interval=600
1.3. logback.xml
logback.xmlにログファイルのファイル形式とログレベルを定義します。
以下は、属性ファイルの設定例です。
<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="30 seconds">
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
<encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
<pattern>
[%d{yyyy-MM-dd}T%d{HH:mm:ss.SSS}] [OFMANAGER|%-24logger{0}] [%.-1level] %msg%n
</pattern>
</encoder>
</appender>
<property name="USER_HOME" value="/home/user/logs" />
<appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender">
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<!-- daily rollover -->
<fileNamePattern>${USER_HOME}/ofmanager_%d{MM-dd-yyyy}.%i.log</fileNamePattern>
<timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
<!-- or whenever the file size reaches 50MB -->
<maxFileSize>300MB</maxFileSize>
</timeBasedFileNamingAndTriggeringPolicy>
<!-- keep 30 days' worth of history -->
<maxHistory>30</maxHistory>
</rollingPolicy>
<encoder>
<pattern>
[%d{yyyy-MM-dd}T%d{HH:mm:ss.SSS}] [OFMANAGER|%-24logger{0}] [%.-1level] %msg%n
</pattern>
</encoder>
</appender>
<logger name="org.springframework" level="OFF">
</logger>
<logger name="com.tmax.ofmanager" additivity="false" level="DEBUG">
<appender-ref ref="ROLLING" />
<appender-ref ref="STDOUT" />
</logger>
<logger name="org.springframework.web.servlet.DispatcherServlet" level="DEBUG"/>
<root level="WARN">
<appender-ref ref="ROLLING" />
</root>
</configuration>以下は、各項目の説明です。
| 項目 | 説明 |
|---|---|
<configuration> |
scanとscanperiod項目を設定すると、ログレベルを動的に変更することができます。 |
<appender> |
LogBackが提供するロガー形式を追加することができます。(イベントごとにログを記録できます)
|
<property> |
<property>に設定した値は、変数として使用することができます。USER_HOMEは、ログファイルのパスとして使用されます。 |
<fileNamepatten> |
ログファイル名のパターンを指定します。 デフォルト値は、日付形式と索引("%i")を使用します。 |
<maxFileSize> |
ファイルの最大サイズを設定します。 |
<maxHistory> |
ファイルのログを保持する最大日数を設定します。指定した日数を超えると、最も古いログから自動的に削除されます。 |
<pattern> |
出力されるログの形式を指定します。 |
<root> |
ログレベルを設定し、<appender>を追加して該当のロガー形式でログレベルを出力します。 |
|
これらの項目はデフォルトで提供されるため、管理者は環境に応じてカスタマイズする必要があります。追加項目については、ログバック関連のガイドを参照してください。 |
2. TACFリソース
OpenFrame Managerの一部の機能は、TACF認証を通じてアクセスを制限することができます。各リソースをOFMANAGRクラスに定義する場合、TACF認証を通過したユーザーのみがその機能を使用することができます。 リソースがOFMANAGRクラスで定義されていない場合、すべてのユーザーがアクセスできます。
以下は、OFMANAGRクラスで各リソースを定義するときに設定されるアクセス権限です。
| リソース・プロファイル | 説明 |
|---|---|
LOGIN |
OFMANAGRクラスにLOGINリソースを定義する場合、LOGINリソースの読み取り権限を持つユーザーのみがOpenFrame Managerにログインすることができます。 |
ST.OFCONFIG |
OFMANAGRクラスにST.OFCONFIGリソースを定義する場合、ST.OFCONFIGリソースの読み取り権限を持つユーザーに対してのみ、[Config]ボタンが表示されます。 |
CM.COMMAND |
OFMANAGRクラスにCM.COMMANDリソースを定義する場合、CM.COMMANDリソースの読み取り権限を持つユーザーに対してのみ、[Base] > [Command]メニューが表示されます。 |
OM.PGMADMIN |
OFMANAGRクラスにOM.PGMADMINリソースを定義する場合、OM.PGMADMINリソースの読み取り権限を持つユーザーに対してのみ、[OSC] > [Program Deploy]メニューの[追加]、[インポート]、[編集]、[削除]ボタンが有効になります。 |
TM.USER |
OFMANAGRクラスにTM.USERリソースを定義する場合、TM.USERリソースの読み取り権限を持つユーザーに対してのみ、[TACF] > [Users]メニューが表示されます。 ofmanager.menuAuthChkをfalseに設定した場合は、[Users]メニューに対するTACF権限チェックを行いません。 |
TM.GROUP |
OFMANAGRクラスにTM.GROUPリソースを定義する場合、TM.GROUPリソースの読み取り権限を持つユーザーに対してのみ、[TACF] > [Groups]メニューが表示されます。 ofmanager.menuAuthChkをfalseに設定した場合は、[Groups]メニューに対するTACF権限チェックを行いません。 |
TM.RESOURCE |
OFMANAGRクラスにTM.RESOURCEソースを定義する場合、TM.RESOURCEリソースの読み取り権限を持つユーザーに対してのみ、[TACF] > [General Resources]メニューが表示されます。 ofmanager.menuAuthChkをfalseに設定した場合は、[General Resources]メニューに対するTACF権限チェックを行いません。 |
TM.DATASET |
OFMANAGRクラスにTM.DATASETソースを定義する場合、TM.DATASETリソースの読み取り権限を持つユーザーに対してのみ、[TACF] > [Datasets]メニューが表示されます。 ofmanager.menuAuthChkをfalseに設定した場合は、[Datasets]メニューに対するTACF権限チェックを行いません。 |
BM.USERSPOOL |
OFMANAGRクラスにBM.USERSPOOLソースを定義する場合、BM.USERSPOOLリソースの読み取り権限を持つユーザーに対してのみ、[Batch] > [User Spool]メニューが表示されます。 |
NDB |
OFMANAGRクラスにNDBリソースを定義する場合、NDBリソースの読み取り権限を持つユーザーに対してのみ、[NDB]メニューが表示されます。 |
|
リソース・プロファイルへの権限を持つユーザーが使用できるメニューの詳細については、本ガイドの各機能についての説明を参照してください。 |
3. マルチ・ノードの設定
マルチ・ノード環境でOpenFrame Managerを実行するには、次のような追加設定が必要です。また、同じドメインに属するすべてのノードのTmax設定ファイルは同じである必要があります。
以下は、NODE1とNODE2でマルチ・ノード環境を構成する例です。マルチ・ノード環境でOpenFrame Managerを実行するために、一部のサービスはTmaxのデータ駆動型ルーティング機能を使用します。ルーティングに使用されるデータはノード名です。SERVICEセクションは、サービス全体ではなく、変更が必要なサービスのみ表示されます。OSCOIVP1_OMC1サービスは、OpenFrame OSCがインストールされている環境で必要です。
*ROUTING
rt_nodename FIELD = "FIELD/FB_NODENAME",
RANGES = "'NODE1':svg_node1,'NODE2':svg_node2,*:svg_node1"
*SERVICE
OFRUISVRCONFIG SVRNAME = ofruisvr, ROUTING = rt_nodename
OFRUISVRRDFILE SVRNAME = ofruisvr, ROUTING = rt_nodename
OFRUISVRRDDIR SVRNAME = ofruisvr, ROUTING = rt_nodename
OBMJMSVRJDETAIL SVRNAME = obmjmsvr, ROUTING = rt_nodename
OBMJINITCHECK SVRNAME = obmjinit, ROUTING = rt_nodename
OBMJINITCTLNODE SVRNAME = obmjinit, ROUTING = rt_nodename
OBMJINITCTLJOB SVRNAME = obmjinit, ROUTING = rt_nodename
OBMJINITCTLINIT SVRNAME = obmjinit, ROUTING = rt_nodename
OBMJINITRUN SVRNAME = obmjinit, ROUTING = rt_nodename
OBMJINITSTATUS SVRNAME = obmjinit, ROUTING = rt_nodename
OSCOIVP1_OMC1 SVRNAME = OSCOIVP1OMC, ROUTING = rt_nodename
|
マルチ・ノード環境でTJESを使用するための設定については、OpenFrame Batch『TJESガイド』の「マルチノードの設定」を参照してください。 |