環境設定と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>

# Openframe Version
openframe.version = <openframe-version>

# OS Property
openframe.os = {mvs|msp|xsp}

# Node Information
openframe.nodelist = <node-list>
openframe.defaultNode = <node-name>

# CPM Name
openframe.cpm.name = <cpm-name>

# Encoding
encoding = <encoding-name>

# Domain Property
domain.name = <domain-name>
domain.type = {Dev|Prod|Test}

# Menus Property
ofmanager.module = [BATCH|TACF|OSC|AIM|NDB|OSI|HIDB]

# 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)

# hibernate property
ofmanager.hibernate.dialect = org.hibernate.dialect.Oracle10gDialect(default)
ofmanager.hibernate.showSql = {true|false}
ofmanager.hibernate.formatSql = {true|false}
項目 説明

ofmanager.datasource

OpenFrame Managerでデータベース表を作成および使用するためのデータソース名を指定します。

この値は、JEUSドメイン設定の<data-source>項目の<data-source-id>値を設定する必要があります。

openframe.webterminal.url

OpenFrame Managerの[OSC]メニューで端末情報を確認するために使用されます。

  • webterminal-ip :OpenFrame GWのWeb端末がインストールされているIPを指定します。

  • ofgw-luport :OpenFrame GWのLU PORTを指定します。OpenFrame GW設定ファイルのofgw.propertiesのlu.port項目から確認できます。

  • webterminal-name :OpenFrame GWのWeb端末アプリケーション名を指定します。OpenFrame GWがインストールされたJEUSのdomain.xmlから確認できます。

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.groupname

WebTを使用してTmaxに接続します。

指定したグループ名でWebtConnectionPoolが作成されます。(デフォルト値:tmax1)

openframe.tmax.connection.init

Tmaxに接続するためのWebtConnectionPoolの初期数を設定します。(デフォルト値:10)

openframe.tmax.connection.max

Tmaxに接続するためのWebtConnectionPoolの最大数を設定します。(デフォルト値:100)

openframe.tmax.connection.inc

使用できる接続が足りない場合、接続数を増やす増分値を設定します。(デフォルト値:10)

openframe.version

Openframeのバージョンを設定します。(デフォルト値:7.3)

openframe.os

インストールされるOpenFrameのOSを入力します。(デフォルト値:mvs)

  • mvs :ManagerをMVS OSのOpenFrameと連携するときに設定します。データセット関連のコマンドを実行する際、BaseのIDCAMSユーティリティを介して実行されます。

  • msp :ManagerをMSP OSのOpenFrameと連携するときに設定します。データセット関連のコマンドを実行する際、BaseのKQCAMSユーティリティを介して実行されます。

  • xsp :ManagerをXSP OSのOpenFrameと連携するときに設定します。データセット関連のコマンドを実行する際、BaseのKQCAMSユーティリティを介して実行されます。

openframe.nodeList

Openframe環境のノード名を指定します。

ノードが複数の場合は、セミコロン(;)で区切ります。(デフォルト値:NODE1;NODE2)

openframe.defaultNode

OFManagerで使用するデフォルト・ノードを指定します。(デフォルト値:NODE1)

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」を参照してください。

domain.name

OpenFrame Managerのドメイン名を指定します。

サイト環境に応じて設定することができ、OpenFrame Managerメイン画面の「情報領域」に表示されます。

domain.type

OpenFrame Managerのドメイン・タイプを指定します。

OpenFrame Managerを使用する目的に応じて次のいずれかに設定することができます。メイン画面の左上にあるタイトル領域に表示されます。ただし、Prodを設定した場合は、タイトル領域にProdは表示されず、OpenFrame Managerのみが表示されます。

  • Dev

  • Prod

  • Test

ofmanager.module

OpenFrame Managerで管理するモジュールを設定します。

各モジュールは略語で設定できます。複数を設定する場合は、セミコロン(;)で区切ります。設定されたモジュールは、OpenFrame Managerに表示され、[Base]メニューは設定と関係なく、常に表示されます。

  • BATCH:[Batch]メニュー

  • TACF:[TACF]メニュー

  • OSC:[OSC]メニュー

  • AIM:[AIM]メニュー

  • NDB:[NDB]メニュー

  • OSI:[OSI]メニュー

  • HIDB:[HIDB]メニュー

ofmanager.language

OpenFrame Managerを表示する言語を設定します。

  • english :英語で表示されます。(デフォルト値)

  • japanese :日本語で表示されます。

ofmanager.consoleReplyRefreshInterval

ユーザー指定の間隔に基づいて、コンソール応答の自動更新されます。

  • 0~4 :自動更新を使用しません。(デフォルト値:0)

  • 5以上 :自動更新の間隔を設定します。(単位 :秒)

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)の削除方法を設定します。

  • yes:約4秒後に自動的に削除されます。

  • no:通知の「×」ボタンをクリックして手動で削除します。

ofmanager.notification.maxCount

OpenFrame Managerの通知の表示件数を指定します。(最大5件まで表示可能)

ofrcmsvr.connection_check_interval

OpenFrameサーバーのうち、ofrcmsvrとの接続を確認する間隔を設定します。(デフォルト値:600秒(10分))

ofrcmsvr.reconnect_interval

OpenFrame サーバーのうち、ofrcmsvrとの接続が切断された際の動作を設定します。(デフォルト値:600秒(10分))

ofmanager.hibernate.dialect

OFManagerで使用するHibernateのDialectを設定します。

ofmanager.hibernate.showSql

OFManager > AIM > AIM Commandメニューでのみ、SQLログを出力するかどうかを設定できます。(MVSには適用されません)

ofmanager.hibernate.formatSql

出力されるSQLを見やすい形式でインデントするかどうかを設定します。ofmanager.hibernate.showSqlがtrueに設定されている場合、SQLはインデントされた形式で出力されます。

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
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

# Openframe Version
openframe.version = 7.3

# OS Property
openframe.os = msp

# Node Information
openframe.nodelist = NODE1;NODE2;
openframe.defaultNode = NODE1

# CPM Name
openframe.cpm.name = EBCASCUS.cpm

# Encoding
encoding=iso-8859-15

# Menus Property
ofmanager.module = BATCH;TACF;AIM;NDB;

# Domain Property
domain.name = OPENFRAME Env.
domain.type = Prod

# OFManager Init Language
ofmanager.language = japanese

# Auto Refresh Interval in CM > Console > Reply
ofmanager.consoleReplyRefreshInterval = 5

# Using UserSpool
ofmanager.menu.batch.userSpool = false

# Using AcpJCL
ofmanager.menu.aim.acpjcl = false

# OFManager font
# Recommended Fonts by Language
# japanese : MS Gothic
# english : HACK, monospace, sans-serif, serif
ofmanager.userFont = MS Gothic

# 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

# OFManager Hibernate
ofmanager.hibernate.dialect = org.hibernate.dialect.Oracle10gDialect
ofmanager.hibernate.showSql = true
ofmanager.hibernate.formatSql = true

1.2. ofmanager.themeColorの例

themColor origin
origin(violet)
themColor blue
blue
themColor green
green
themColor skyblue
skyblue
themColor purple
purple
themColor redorange
redorange

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が提供するロガー形式を追加することができます。(イベントごとにログを記録できます)

  • ConsoleAppender :ロギング・イベントをコンソールに出力します。

  • RollingFileAppender :ファイルの最大サイズを指定してファイルにログを出力します。

<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]メニューが表示されます。

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ガイド』の「マルチノードの設定」を参照してください。