JP1 Version 12　JP1/IT Desktop Management 2 配布機能 運用ガイド

3021-3-E15-30

前書き

対象製品

適用OSのバージョン、JP1/IT Desktop Management 2が前提とするサービスパックやパッチなどの詳細についてはリリースノートで確認してください。

●JP1/IT Desktop Management 2 - Manager

P-2A42-78CL JP1/IT Desktop Management 2 - Manager 12-50

製品構成一覧および内訳形名

P-CC2A42-7ACL JP1/IT Desktop Management 2 - Manager 12-60（適用OS：Windows Server 2019、Windows Server 2016、Windows Server 2012）

P-CC2A42-7BCL JP1/IT Desktop Management 2 - Agent 12-60（適用OS：Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2）

P-CC2A42-7CCL JP1/IT Desktop Management 2 - Network Monitor 12-00（適用OS：Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1 Enterprise、Windows 8.1 Pro、Windows 8 Enterprise、Windows 8 Pro、Windows Server 2012、Windows 7 Enterprise、Windows 7 Professional、Windows 7 Ultimate）

P-CC2A42-7DCL JP1/IT Desktop Management 2 - Asset Console 12-60（適用OS：Windows Server 2019、Windows Server 2016、Windows Server 2012）

P-CC2A42-7PCL JP1/IT Desktop Management 2 - Internet Gateway 12-00（適用OS：Windows Server 2019、Windows Server 2016、Windows Server 2012）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI、JP1は、株式会社 日立製作所の商標または登録商標です。

Acrobatは、米国およびその他の国におけるAdobe社の登録商標または商標です。

ActiveXは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Adobeは、米国およびその他の国におけるAdobe社の登録商標または商標です。

AIXは、世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

BSAFEは、Dell Inc.の米国およびその他の国における商標または登録商標です。

Hyper-Vは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

IBMは、世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Intelは、Intel Corporation またはその子会社の商標です。

Intel Coreは、Intel Corporation またはその子会社の商標です。

Internet Explorerは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Microsoftは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

OracleおよびJavaは、オラクルおよびその関連会社の登録商標です。

Pentiumは、Intel Corporation またはその子会社の商標です。

Readerは、米国およびその他の国におけるAdobe社の登録商標または商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries. Red Hatは、米国およびその他の国におけるRed Hat, Inc.の登録商標です。

すべてのSPARC商標は、米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は、米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。

UNIXは、The Open Groupの米国ならびに他の国における登録商標です。

Windowsは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Serverは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

Windows Vistaは、米国Microsoft Corporationの米国およびその他の国における登録商標または商標です。

XenAppは、Citrix Systems, Inc.および／またはその一つもしくは複数の子会社の商標であり、米国の特許商標庁および他の国において登録されている場合があります。

その他記載の会社名、製品名などは、それぞれの会社の商標もしくは登録商標です。

This product includes software developed by the Apache Software Foundation (http://www.apache.org/).

This product includes software developed by Ben Laurie for use in the Apache-SSL HTTP server project.

Portions of this software were developed at the National Center for Supercomputing Applications (NCSA) at the University of Illinois at Urbana-Champaign.

This product includes software developed by the University of California, Berkeley and its contributors.

This software contains code derived from the RSA Data Security Inc. MD5 Message-Digest Algorithm, including various modifications by Spyglass Inc., Carnegie Mellon University, and Bell Communications Research, Inc (Bellcore).

Regular expression support is provided by the PCRE library package, which is open source software, written by Philip Hazel, and copyright by the University of Cambridge, England. The original software is available from ftp://ftp.csx.cam.ac.uk/pub/software/programming/pcre/

This product includes software developed by Ralf S. Engelschall <rse@engelschall.com> for use in the mod_ssl project (http://www.modssl.org/).

This product includes software developed by IAIK of Graz University of Technology.

This product includes software developed by Daisuke Okajima and Kohsuke Kawaguchi (http://relaxngcc.sf.net/).

This product includes software developed by the Java Apache Project for use in the Apache JServ servlet engine project (http://java.apache.org/).

This product includes software developed by Andy Clark.

本製品は、米国Dell Inc.のDell BSAFETMソフトウェアを搭載しています。

Java is a registered trademark of Oracle and/or its affiliates.

Java is a registered trademark of Oracle and/or its affiliates.

1. This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)

2. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)

3. This product includes software written by Tim Hudson (tjh@cryptsoft.com)

4. 本製品にはOpenSSL ToolkitソフトウェアをOpenSSL LicenseおよびOriginal SSLeay Licenseに従い使用しています。OpenSSL LicenseおよびOriginal SSLeay Licenseは以下のとおりです。

LICENSE ISSUES

==============

The OpenSSL toolkit stays under a dual license, i.e. both the conditions of

the OpenSSL License and the original SSLeay license apply to the toolkit.

See below for the actual license texts. Actually both licenses are BSD-style

Open Source licenses. In case of any license issues related to OpenSSL

please contact openssl-core@openssl.org.

OpenSSL License

---------------

/* ====================================================================

* Copyright (c) 1998-2016 The OpenSSL Project. All rights reserved.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions

* are met:

*

* 1. Redistributions of source code must retain the above copyright

* notice, this list of conditions and the following disclaimer.

*

* 2. Redistributions in binary form must reproduce the above copyright

* notice, this list of conditions and the following disclaimer in

* the documentation and/or other materials provided with the

* distribution.

*

* 3. All advertising materials mentioning features or use of this

* software must display the following acknowledgment:

* "This product includes software developed by the OpenSSL Project

* for use in the OpenSSL Toolkit. (http://www.openssl.org/)"

*

* 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to

* endorse or promote products derived from this software without

* prior written permission. For written permission, please contact

* openssl-core@openssl.org.

*

* 5. Products derived from this software may not be called "OpenSSL"

* nor may "OpenSSL" appear in their names without prior written

* permission of the OpenSSL Project.

*

* 6. Redistributions of any form whatsoever must retain the following

* acknowledgment:

* "This product includes software developed by the OpenSSL Project

* for use in the OpenSSL Toolkit (http://www.openssl.org/)"

*

* THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY

* EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR

* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR

* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,

* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT

* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;

* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,

* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)

* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED

* OF THE POSSIBILITY OF SUCH DAMAGE.

* ====================================================================

*

* This product includes cryptographic software written by Eric Young

* (eay@cryptsoft.com). This product includes software written by Tim

* Hudson (tjh@cryptsoft.com).

*

*/

Original SSLeay License

-----------------------

/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)

* All rights reserved.

*

* This package is an SSL implementation written

* by Eric Young (eay@cryptsoft.com).

* The implementation was written so as to conform with Netscapes SSL.

*

* This library is free for commercial and non-commercial use as long as

* the following conditions are aheared to. The following conditions

* apply to all code found in this distribution, be it the RC4, RSA,

* lhash, DES, etc., code; not just the SSL code. The SSL documentation

* included with this distribution is covered by the same copyright terms

* except that the holder is Tim Hudson (tjh@cryptsoft.com).

*

* Copyright remains Eric Young's, and as such any Copyright notices in

* the code are not to be removed.

* If this package is used in a product, Eric Young should be given attribution

* as the author of the parts of the library used.

* This can be in the form of a textual message at program startup or

* in documentation (online or textual) provided with the package.

*

* Redistribution and use in source and binary forms, with or without

* modification, are permitted provided that the following conditions

* are met:

* 1. Redistributions of source code must retain the copyright

* notice, this list of conditions and the following disclaimer.

* 2. Redistributions in binary form must reproduce the above copyright

* notice, this list of conditions and the following disclaimer in the

* documentation and/or other materials provided with the distribution.

* 3. All advertising materials mentioning features or use of this software

* must display the following acknowledgement:

* "This product includes cryptographic software written by

* Eric Young (eay@cryptsoft.com)"

* The word 'cryptographic' can be left out if the rouines from the library

* being used are not cryptographic related :-).

* 4. If you include any Windows specific code (or a derivative thereof) from

* the apps directory (application code) you must include an acknowledgement:

* "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"

*

* THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND

* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE

* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE

* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE

* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL

* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS

* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT

* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY

* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF

* SUCH DAMAGE.

*

* The licence and distribution terms for any publically available version or

* derivative of this code cannot be changed. i.e. this code cannot simply be

* copied and put under another distribution licence

* [including the GNU Public Licence.]

*/

マイクロソフト製品のスクリーンショットの使用について

マイクロソフトの許可を得て使用しています。

発行

2022年1月　3021-3-E15-30

著作権

Copyright (C) 2019, 2022, Hitachi, Ltd.

Copyright (C) 2019, 2022, Hitachi Solutions, Ltd.

Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.

奥付

マニュアル発行元

株式会社 日立製作所

〒100‒8280　東京都千代田区丸の内一丁目6番6号

変更内容

変更内容(3021-3-E15-30)　JP1/IT Desktop Management 2　12-60

追加・変更内容

変更個所

インストール定義ファイルの作成を追加した。

7.2.13(2)

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは、JP1/IT Desktop Management 2 - Manager（以降、JP1/IT Desktop Management 2と略す）のリモートインストールマネージャを使用した配布機能の機能詳細、運用方法、および操作方法について説明したものです。

リモートインストールマネージャを使用した配布機能の代表的な使用例や検討しておく必要があることについても紹介しています。

また、JP1/IT Desktop Management 2のコンポーネントであるAutomatic Installation Toolの使用方法の詳細についても説明しています。ソフトウェアの自動インストールに使用するAIT（Automatic Installation Tool）ファイルを作成する際にお読みください。

なお、システムの構築方法については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」を参照してください。

最新の注意事項については、リリースノートを参照してください。

対象読者

このマニュアルは、次の方にお読みいただくことを前提に説明しています。

JP1/IT Desktop Management 2を利用してソフトウェアを配布する管理者の方

JP1/IT Desktop Management 2を構築するシステム管理者の方

マニュアルの構成

このマニュアルは、次に示す章と付録から構成されています。

第1章　リモートインストールマネージャを使用した配布機能の紹介

リモートインストールマネージャを使用した配布機能について説明しています。

第2章　代表的な運用例

リモートインストールマネージャを使用した配布機能の運用例について説明しています。

第3章　システム設計

リモートインストールマネージャを使用した配布機能を利用する場合のシステム設計時に必要な検討事項について説明しています。

第4章　配布管理システムを操作する

配布管理システムの基本的な操作について説明しています。

第5章　システム構成情報とあて先グループを作成する

システム構成情報の作成方法と、ジョブの配布先をグルーピングして管理する方法について説明しています。

第6章　システム構成情報とあて先グループをメンテナンスする

リモートインストールマネージャを使用した配布の運用を開始したあとで、システム構成情報とあて先グループをメンテナンスする方法について説明しています。

第7章　ソフトウェアを配布する

ソフトウェアの配布（リモートインストール）の方法について説明しています。

第8章　更新プログラムを管理する

Windowsの更新プログラムをリモートインストールマネージャでパッケージングして配布する方法について説明しています。

第9章　管理対象のコンピュータのファイルを収集する

管理対象のコンピュータからファイルを収集（リモートコレクト）する方法について説明しています。

第10章　ジョブを管理する

ジョブの作成方法、管理方法について説明しています。

第11章　管理情報を出力する

配布管理システムで管理している情報を、CSV形式ファイルに出力したり、印刷したりする方法について説明しています。

第12章　エージェントを操作する

エージェントの機能を使用する場合の操作について説明しています。

第13章　JP1/IMへJP1イベントを通知する

JP1/IT Desktop Management 2から通知されたJP1イベントをJP1/IMで確認するための情報（JP1イベントの種類およびJP1イベントの属性）について説明しています。

第14章　リモートインストールマネージャを使用した配布機能のコマンド

関連プログラムであるJP1/AJSと連携して、ジョブの実行やパッケージングなどの機能を自動化する方法について説明しています。また、リモートインストールマネージャを使用した配布機能のコマンドについて説明しています。

第15章　トラブルシューティング

JP1/IT Desktop Management 2を使用中にトラブルが発生した場合の、トラブル情報の確認方法やトラブルへの対処方法について説明しています。

第16章　AITファイルを使ったリモートインストール

AITファイルを使ったリモートインストールの方法、AITファイルを作成・使用する場合の注意事項について説明しています。

第17章　AITファイルの作成

Automatic Installation Toolを使って、AITファイルを作成する方法について説明しています。

第18章　AIT言語リファレンス

AITファイルの形式と、AIT言語の構文について説明しています。

第19章　APIリファレンス

AIT言語で使用するAPIについて説明しています。

第20章　AITのトラブルシューティング

Automatic Installation Toolでトラブルが発生した場合の対処方法、およびメッセージについて説明しています。

付録A　JP1/IT Desktop Management 2 - Agentを使用するときの注意事項

JP1/IT Desktop Management 2 - AgentがインストールされているPCのOSがWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2の場合の注意事項について説明します。

付録B　リモートインストールマネージャを使用した配布に関する監査ログの出力

監査ログの出力情報について説明しています。

付録C　メニュー一覧

JP1/IT Desktop Management 2で表示される各ウィンドウおよびアイコンのメニュー一覧について説明しています。

付録D　アイコン一覧

JP1/IT Desktop Management 2で表示される各ウィンドウのアイコン一覧について説明しています。

付録E　リモートインストールマネージャからのツールの起動

リモートインストールマネージャでのツールの登録方法、起動方法、および運用例について説明しています。

付録F　PP識別情報ファイルの編集方法

AITファイル作成時に生成したPP識別情報ファイルの編集方法について説明しています。

付録G　UNIXエージェント、Mac エージェントのシステム情報とソフトウェア情報の取得

UNIXエージェント、Mac エージェントのシステム情報とソフトウェア情報の取得方法について説明しています。

付録H　各バージョンの変更内容

各バージョンの変更内容について説明しています。

付録I　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報について説明しています。

付録J　用語解説

このマニュアルで使用する用語について説明しています。

1　リモートインストールマネージャを使用した配布機能の紹介

リモートインストールマネージャを使用した配布機能で、ソフトウェアやデータなどを管理対象のコンピュータへ配布したり、管理対象のコンピュータのファイルを配布管理システムに収集したりできます。

ここでは、リモートインストールマネージャを使用した配布機能について説明します。

1.1　ソフトウェアの配布（リモートインストール）

JP1/IT Desktop Management 2のリモートインストール機能を使用して、日立プログラムプロダクトや他社ソフトウェアなどを管理対象のコンピュータへ配布できます。

リモートインストール機能では、配布を実行する日時を指定したり、条件と一致したコンピュータだけに配布したりできます。また、配布されるソフトウェアを利用者が指定してインストールしたり、JP1/IT Desktop Management 2がインストールされているスタンドアロンPCにソフトウェアをインストールしたりもできます。

ここでは、リモートインストール機能の概要について説明します。

1.1.1　リモートインストールの作業の流れ

リモートインストールは、インストールするソフトウェアを登録する作業（パッケージング）と、登録されたパッケージを配布してインストールする作業（リモートインストール）との2段階に分けられます。

リモートインストールの作業の流れを次の図に示します。

図1‒1　リモートインストールの作業の流れ

(1)　配布するソフトウェアをパッケージングする

ソフトウェアをリモートインストールするには、まず対象となるソフトウェアを、配布管理システムにパッケージングしておく必要があります。ソフトウェアをパッケージングするには、パッケージャを使用します。

パッケージャは、リモートインストールするソフトウェアを、インストールに必要な情報と一緒に、配布管理システムのキャビネットと呼ばれる場所に保管します。こうして保管されたソフトウェアをパッケージと呼びます。

一度キャビネットに保管されたパッケージは、パッケージャと配布管理システムの両方から、参照したり削除したりできます。ただし、名称を変更したり、ほかのキャビネットに移したりはできないので、パッケージング実行前にキャビネットの構成をよく検討しておいてください。キャビネットは、事前に配布管理システム側で作成しておいてもかまいませんし、パッケージング時にパッケージャが新しく作成してもかまいません。

パッケージャでパッケージングしたソフトウェアは、リモートインストールマネージャまたはコマンドで配布できます。ITDM互換配布の機能では配布できません。パッケージングの操作については、「7.1　パッケージングの方法」を参照してください。

操作画面の配布画面で作成したパッケージは、ITDM互換配布の機能で配布できます。

(2)　リモートインストールのジョブを作成、実行する

ソフトウェアをパッケージングしたら、配布管理システムでリモートインストールを指示するジョブを作成し、実行します。リモートインストールの操作は、リモートインストールマネージャから行います。リモートインストールの操作については、「7.3　リモートインストールの実行」を参照してください。

また、リモートインストールに関する作業には、ジョブの作成・実行以外に、キャビネットとパッケージの管理や中継システム上のパッケージの削除といった作業があります。キャビネットとパッケージの管理については「1.1.7　キャビネットとパッケージの管理」を、中継システム上のパッケージの削除については「1.1.9　中継システムおよび管理用中継サーバ上のパッケージの削除」を参照してください。

1.1.2　配布できるソフトウェアの種類

JP1/IT Desktop Management 2では、リモートインストールの対象となるソフトウェアを、次の3種類に分類して認識しています。この区分をパッケージ種別と呼びます。

日立プログラムプロダクト

他社ソフトウェア

ユーザプログラム、データ

「日立プログラムプロダクト」、または「他社ソフトウェア」であるかどうかは、ソフトウェアのパッケージング時に、パッケージャが自動的に判断します。どちらにも認識されないソフトウェアは、すべて「ユーザプログラム、データ」として扱われます。

なお、パッケージ種別によっては、リモートインストール時にAITファイル（Automatic Installation Toolで作成するファイル）が必要です。AITファイルを使ったリモートインストール方法については、「16.　AITファイルを使ったリモートインストール」を参照してください。

(1)　日立プログラムプロダクト

複数ライセンスパック製品のプログラムプロダクトのリモートインストールができます。また、複数ライセンスパック製品ではないプログラムプロダクトでは、すでに導入しているものをリビジョンアップする場合に限って、リモートインストールできます。ただし、一部のプログラムプロダクト（通信ソフトウェアなど）のリモートインストールはできません。リモートインストールができるプログラムプロダクトは、それぞれのマニュアルまたはリリースノートでご確認ください。

JP1/IT Desktop Management 2のリモートインストール

JP1/IT Desktop Management 2 - Manager

リモートインストールできません。

JP1/IT Desktop Management 2 - Agent（中継システム）

リモートインストールできます。

JP1/IT Desktop Management 2 - Agent（エージェント）

リモートインストールできます。

(2)　他社ソフトウェア

日立以外の流通ソフトウェアを他社ソフトウェアと呼びます。リモートインストールできる他社ソフトウェアは、基本的に複数ライセンスパック製品です。ソフトウェアの種類、購入契約の内容によって、リモートインストールができない場合があります。契約書などで判断できない場合、ソフトウェア会社の了解をユーザの責任で得る必要がありますので注意してください。

なお、他社ソフトウェアの対話形式のインストーラに自動応答してリモートインストールする場合には、AITファイルが必要です。

(3)　ユーザプログラム、データ

単一のファイルまたはディレクトリ下の全ファイルをリモートインストールできます。表計算ソフトウェアなどのアプリケーションプログラムで作成したデータも、ユーザデータとして扱います。

1.1.3　パッケージング時に設定できるインストール条件

ソフトウェアをリモートインストールするには、パッケージング時に、インストールに必要な情報を細かく設定しておく必要があります。例えば、インストールの日時やタイミング、インストールの前提となるプログラムの指定などです。これらをインストール条件と呼びます。

インストール条件は、パッケージング時に［JP1/ITDM2 パッケージング］ダイアログボックスで設定します。また、リモートインストール実行時（ジョブ作成時）に、［インストール条件の変更］ダイアログボックスで変更できます。

ここでは、インストール条件としてどのようなものがあるかを、［JP1/ITDM2 パッケージング］ダイアログボックスのパネル単位に説明します。設定内容の詳細については、「7.2　パッケージの詳細設定」を参照してください。

(1)　システム条件

インストール時に最低限必要なハードディスクの空き容量や、実装メモリなど、ハードウェア上の条件を設定できます。必要に応じて、インストール処理後に10〜20メガバイト以上の空き容量が必要であるなどの条件を設定してください。また、実装メモリの条件を設定すれば、インストールしても動作させられないといった失敗を防ぐことができます。

(2)　ソフトウェア条件

インストールするソフトウェアが、特定のソフトウェアの、特定のバージョンを前提として動作するような場合に、そのソフトウェアがインストールされているかどうかを、バージョンを指定してチェックできます。また、特定のソフトウェアがコンピュータにない場合だけリモートインストールする、といった条件も設定できます。

(3)　パッケージ条件

インストールするパッケージが、特定のパッケージの、特定のバージョンを前提として動作するような場合に、そのパッケージがインストールされているかどうかを、バージョンを指定してチェックできます。また、特定のパッケージがコンピュータにない場合だけリモートインストールする、といった条件も設定できます。

(4)　ファイル属性

リモートインストール後のファイルのアクセス権および所有者を指定できます。

(5)　スケジュール

インストール日時、および実行タイミングを指定できます。実行タイミングには次の3種類があります。

すぐに実行

ジョブ実行時、またはインストール日時として指定された時間にパッケージがインストールされます。

次回起動時に実行

コンピュータの次回起動時にパッケージがインストールされます。

停止時に実行

コンピュータの停止時にパッケージがインストールされます。なお、これは、あて先がUNIXエージェントの場合にだけ有効です。

(6)　インストール方法

インストールモード（ソフトウェアのインストーラの種類に合致したインストール方法）を指定できます。インストールモードには、次の2種類があります。

GUIインストールモード

特別なインストーラ（対話形式のインストーラなど）を使用するインストールモードです。パッケージ種別が「日立プログラムプロダクト」、または「他社ソフトウェア」の場合は、常に「GUIインストールモード」となります。

バックグラウンドインストールモード

特別なインストーラを使用しないインストールモードです。ファイルのコピーだけでインストールが完了する場合に適用します。

(7)　オプション

リモートインストールに対して次のオプションを設定できます。

パッケージデータを圧縮する

ソフトウェアを圧縮してパッケージングできます。パッケージを圧縮するとファイル転送は速くなり、キャビネット上でパッケージを保管するための容量を節約できます。ただし、パッケージング時やリモートインストール時に、圧縮・伸長処理の時間が掛かります。

バージョンアップ時リストア対象とする

リモートインストールの失敗による旧バージョンの破壊を防ぐための、「バックアップ・リストア機能」を使用できます。この機能を使用すると、リモートインストールでプログラムのバージョンアップをする場合に、JP1/IT Desktop Management 2 - Agentが旧バージョンのバックアップを取得します。そして、リモートインストールに失敗した場合に、このバックアップから旧バージョンを回復します。

インストール後コンピュータを再起動する

パッケージのインストール後に、コンピュータが自動的に再起動するように設定できます。

処理中ダイアログの表示

パッケージのインストール時に、コンピュータで処理中ダイアログを表示させるかを指定します。対象となるのは、ダウンロード中ダイアログとインストール中ダイアログです。

(8)　外部プログラム

インストールの直前・直後、およびインストールエラー時に、コンピュータで外部プログラムを起動させることができます。これによって、例えば次のような運用ができるようになります。

インストール前に、コンピュータがユーザ固有の条件に合っているかどうかを調べる外部プログラムを起動させる。

インストールしたプログラムプロダクトを外部プログラムで起動させる。

(9)　AITファイルの設定

リモートインストール時にAITファイルを使用する場合、会社名や所有者名などの情報を設定したり、インストール処理の応答を監視したりできます。

(10)　コンポーネントの選択

JP1/IT Desktop Management 2 - Agentをパッケージングする場合に、エージェントとしてパッケージングするか、中継システムとしてパッケージングするかを選択できます。

1.1.4　リモートインストールを実行するジョブ種別

配布するパッケージを作成したあと、配布管理システムでリモートインストールを指示するジョブを作成・実行します。このようなジョブの種類をジョブ種別と呼びます。

ここでは、リモートインストールを実行するジョブ種別について説明します。

(1)　「パッケージのインストール」ジョブ

配布管理システムから管理対象のコンピュータにパッケージを配布し、インストールする、という最も基本的なジョブです。パッケージの配布とインストールを配布管理システム側の主導で実行します。

(2)　「中継までのパッケージの転送」ジョブ

配布管理システムから中継システムおよび管理用中継サーバまで、パッケージの転送だけを行うジョブです。

「中継までのパッケージの転送」ジョブで転送されたパッケージは、中継システムおよび管理用中継サーバに保管されます。したがって、パッケージの保管期限内は配布管理システムから同一のパッケージが再配布されることはありません。パッケージの保管期限はパッケージング時に指定できます。一度転送したパッケージの保管期限を変更したい場合は、変更後のパッケージを再度中継システムおよび管理用中継サーバまで転送する必要があります。

中継システムおよび管理用中継サーバに転送したパッケージを管理対象のコンピュータまで配布する場合は、「パッケージのインストール」ジョブを実行してください。

配布管理システムから、「中継までのパッケージの転送」ジョブと「パッケージのインストール」ジョブを組み合わせてリモートインストールする場合、それぞれのジョブの実行日時が、配布管理システム−中継システムまたは管理用中継サーバ間、中継システムまたは管理用中継サーバ−管理対象のコンピュータ間の、パッケージの配布日時となります。

(3)　「クライアントユーザによるインストール」ジョブ

管理対象のコンピュータに対してインストールの許可だけを与えておき、実際のインストールは利用者に実行させるジョブです。「いつ」「何を」インストールするかを、ユーザの判断に任せるというものです。

どのコンピュータにも必ずインストールしなければならないソフトウェアであれば、通常のリモートインストールでかまいませんが、そうでない場合、利用者が必要としていないソフトウェアまで勝手にインストールされてしまいます。このような場合に、この「クライアントユーザによるインストール」ジョブが有効です。

このジョブで配布されたソフトウェアを、利用者側で確認し、インストールする運用については、「1.1.5　利用者の都合に合わせたインストール」を参照してください。

1.1.5　利用者の都合に合わせたインストール

配布管理システム主導のリモートインストールは、利用者にとって便利である一方、場合によっては、必要としていないソフトウェアが勝手にインストールされたり、利用者の都合の悪い時間帯にインストールが始まったりするおそれもあります。このようなことを防ぐには、「クライアントユーザによるインストール」ジョブを使用します。

配布管理システムが「クライアントユーザによるインストール」ジョブを実行すると、利用者のコンピュータに対してソフトウェアのインストールの許可だけが与えられます。利用者は、パッケージセットアップマネージャを使用して、ウィンドウ上でインストールが許可されているソフトウェアを確認し、必要なソフトウェアだけをインストールできます。なお、UNIXエージェントの場合は、パッケージセットアップマネージャではなく、rdsinsset -xコマンドを使用してインストール（組み込み）します。

この方法は、インストール時に、利用者がインストーラに手動で答えながらインストールしていきたい場合などにも有効です。

利用者の都合に合わせたリモートインストールの流れを次の図に示します。

図1‒2　利用者の都合に合わせたリモートインストールの流れ

配布管理システムで「クライアントユーザによるインストール」ジョブを実行する。

ジョブのあて先に指定したコンピュータに対して、パッケージのインストール許可が与えられます。

この時点では、パッケージはコンピュータに配布されないで、配布管理システムまたは中継システム上にあります。

利用者のコンピュータのパッケージセットアップマネージャでソフトウェアを選択し、インストールを実行する。

選択したソフトウェアがコンピュータにダウンロードされ、インストールが開始されます。

パッケージセットアップマネージャの操作方法については、「12.4　パッケージセットアップマネージャを操作する」を参照してください。

1.1.6　スタンドアロンPCへのソフトウェアのインストール

USBメモリなどの媒体を使用することで、JP1/IT Desktop Management 2 - Agent（エージェント）がインストールされたスタンドアロンPC（オフラインマシン）に、ネットワークを介さないでソフトウェアをインストール（オフラインインストール）できます。オフラインインストールは、上位システムからの指示でジョブが中断されているコンピュータでも実行できます。

オフラインインストールの方法については、「7.3.4　オフラインインストール」を参照してください。

オフラインインストールの概念を次の図に示します。

図1‒3　オフラインインストールの概念

オフラインインストールは、次の場合に便利です。

ネットワーク外のPCにパッケージをインストールしたい場合

接続しているネットワークの回線速度が遅いときや、パッケージ容量が大きいときなど、パッケージ転送に時間が掛かる場合

配布管理システムおよびオフラインマシンでオフラインインストールを利用するには、次の条件を満たす必要があります。

配布管理システム

JP1/IT Desktop Management 2 - Managerがインストールされている。

JP1/IT Desktop Management 2 - Managerと同じPCでリモートインストールマネージャを使用している。

オフラインマシン

JP1/IT Desktop Management 2 - Agentがインストールされている。

オフラインインストールでインストールしたパッケージは、［システム構成］ウィンドウの［インストールパッケージ］タブやパッケージセットアップマネージャの［インストールパッケージ］ウィンドウに表示されません。このため、インストールできたかどうかを確認したい場合は、インストール結果ファイルをテキストエディタで開いてください。

なお、オフラインインストールでは、次に示す機能を使用できません。

JP1/IT Desktop Management 2 - Agentのインストール

インストールのスケジュール指定

インストール後のコンピュータの再起動

パッケージセットアップマネージャからのインストール

分割配布およびマルチキャスト配布

1.1.7　キャビネットとパッケージの管理

キャビネットおよびパッケージを管理するのは、基本的には、配布管理システムの役割です。リモートインストールマネージャの［パッケージ］ウィンドウから、パッケージを確認し、必要に応じて編集します。このとき、キャビネットを、ソフトウェアの種類や目的別に（流通ソフトウェア用、ユーザデータ用、ウィルス対策製品用など）作成しておくと便利です。

［パッケージ］ウィンドウを次に示します。

図1‒4　［パッケージ］ウィンドウ

［パッケージ］ウィンドウでは、左側の枠に、キャビネットおよびパッケージが次のアイコンで表示されます。

[図データ]：キャビネット（Windows用）

[図データ]：キャビネット（UNIX、Mac OS用）

[図データ]：パッケージ（正常にパッケージングされたもの）

[図データ]：パッケージ（エラーまたはパッケージング中）

［パッケージ］ウィンドウでは、キャビネットとパッケージに対して次に示す操作ができます。

キャビネットおよびパッケージの確認

キャビネットの作成

キャビネットの名称の変更

キャビネットおよびパッケージの削除

キャビネットおよびパッケージを管理する方法については、「7.4　キャビネットとパッケージの管理」を参照してください。

1.1.8　中継システムおよび管理用中継サーバへのパッケージの転送

上位の配布管理システムでは、作成したパッケージを中継システムおよび配下の管理用中継サーバに転送できます。

パッケージを転送することで、ネットワークに掛かる負荷を軽減しつつ、転送先の中継システムおよび管理用中継サーバの管理対象のコンピュータへ効率的にパッケージを配布できます。

1.1.9　中継システムおよび管理用中継サーバ上のパッケージの削除

中継システムおよび管理用中継サーバでは、各コンピュータへ転送するパッケージのファイルをいったん保管します。このパッケージは、パッケージャで指定した「中継でのパッケージ保管期限」が来るまで削除されないため、ハードディスク容量を圧迫するおそれがあります。中継システムおよび管理用中継サーバでハードディスク容量不足が発生すると、ジョブ実行中にジョブの中継がエラーとなってしまいます。このような場合は、次のどちらかの方法で不要なパッケージを削除してください。

配布管理システムから「中継のパッケージの一括削除」ジョブを実行する

「中継のパッケージの一括削除」ジョブを実行すると、ジョブの実行先の中継システムおよび管理用中継サーバに保管されているパッケージがすべて削除されます。

配布管理システムから配下の中継システムおよび管理用中継サーバ上のパッケージを選択して削除する

配布管理システムのリモートインストールマネージャから、配下の中継システムおよび管理用中継サーバに保管されている不要なパッケージを削除できます。この機能の詳細については、「7.4.6　中継システムおよび管理用中継サーバ上のパッケージの削除」を参照してください。

1.2　ファイルの収集（リモートコレクト）

リモートコレクトの機能を使って管理対象のコンピュータのファイルを配布管理システムに収集できます。例えば、表計算ソフトウェアなどのアプリケーションプログラムで作成したユーザデータや、アプリケーションプログラムで発生した障害ログなどを収集できます。

なお、リモートコレクトできるのは、ユーザプログラム、データだけです。日立プログラムプロダクトや他社ソフトウェアはリモートコレクトできません。

ここでは、リモートコレクトの概要について説明します。

1.2.1　リモートコレクトの作業の流れ

管理対象のコンピュータからファイル（ユーザプログラム、データ）を収集するには、配布管理システムで、リモートコレクトを指示するジョブを作成し、実行します。

収集したファイル（収集ファイル）は、アーカイブまたは圧縮された形式で配布管理システムに格納されるため、配布管理システムで扱えるようにするには、収集ファイルを元の形式に復元する必要があります。

リモートコレクトの作業の流れを次の図に示します。

図1‒5　リモートコレクトの作業の流れ

リモートコレクトの操作方法については、「9.1　リモートコレクトの操作」を参照してください。

1.2.2　リモートコレクトを実行するジョブ種別

リモートコレクトを実行するジョブには、次の図に示す種類（ジョブ種別）があります。ネットワークの状態や目的に合わせて、使い分けてください。

図1‒6　リモートコレクトのジョブ種別

なお、「リモートコレクト」ジョブまたは「中継までのリモートコレクト」ジョブを作成するときは、リモートコレクトのオプションとして、管理対象のコンピュータでの収集のタイミング、圧縮の有無、外部プログラムの起動などを設定できます。

これらのオプションの設定方法については、「9.1.1　リモートコレクトの実行」を参照してください。

次に、各ジョブ種別について説明します。

(1)　「リモートコレクト」ジョブ

管理対象のコンピュータから、中継システムおよび管理用中継サーバを経由して配布管理システムまでファイルを収集します。中継システムおよび管理用中継サーバを経由しない場合や、管理対象のコンピュータ−中継システムおよび管理用中継サーバ間、中継システムおよび管理用中継サーバ−配布管理システム間のファイルの収集にもこのジョブを使用します。

(2)　「中継までのリモートコレクト」ジョブ

配布管理システムからの指示でファイルを収集し、ジョブを実行した配布管理システムの中継システムおよび管理用中継サーバに収集ファイルを保管します。中継システムおよび管理用中継サーバが階層化されている場合、ジョブを実行した配布管理システムの直下にある中継システムおよび管理用中継サーバに収集ファイルを保管します。

「中継からのコレクトファイル収集」ジョブと組み合わせて、2段階に分けてファイルを収集できます。

(3)　「中継からのコレクトファイル収集」ジョブ

「中継までのリモートコレクト」ジョブで中継システムおよび管理用中継サーバまで収集したファイルを、配布管理システムに転送します。

リモートコレクトでは、中継システムおよび管理用中継サーバ−配布管理システム間のネットワークの負荷が高くなります。したがって、「中継までのリモートコレクト」ジョブでいったん中継システムおよび管理用中継サーバにファイルを保管し、ネットワークのトラフィックが低くなる夜中などに配布管理システムへこのジョブを実行することで、効率良くファイルを収集できます。ただし、中継システムおよび管理用中継サーバが階層化されている場合、配布管理システムの直下にない中継システムおよび管理用中継サーバをジョブのあて先に指定しても、配布管理システムの直下にある中継システムおよび管理用中継サーバ上のファイルが収集されます。

(4)　「中継のコレクトファイル削除」ジョブ

「中継までのリモートコレクト」ジョブで中継システムおよび管理用中継サーバまで収集したファイルを、削除します。ただし、中継システムおよび管理用中継サーバが階層化されている場合、配布管理システムの直下にない中継システムおよび管理用中継サーバをジョブのあて先に指定しても、配布管理システムの直下にある中継システムおよび管理用中継サーバ上のファイルが削除されます。

1.2.3　収集したファイルの復元

リモートコレクトしたファイルは、アーカイブまたは圧縮された形式で配布管理システムに格納されるため、そのままでは読み書きができません。配布管理システムで扱えるようにするには、ファイルを元の形式に復元する必要があります。

ファイルを復元するには、アンアーカイバと呼ばれるプログラムを使用します。アンアーカイバは、リモートコレクト時にアーカイブや圧縮されたファイル（アーカイブファイル）を元の形式に復元するためのプログラムです。

収集したファイルを復元する方法については、「9.1.2　収集ファイルの復元」を参照してください。

1.3　ジョブの管理

リモートインストールやファイル転送といったJP1/IT Desktop Management 2の機能の多くは、配布管理システムから管理対象のコンピュータへジョブを実行して実現します。

ここでは、ジョブの概念やジョブの種類、ジョブの実行に関する作業など、ジョブの概要について説明します。

1.3.1　ジョブとは

JP1/IT Desktop Management 2では、配布管理システムからジョブと呼ばれる作業の命令を作成、実行することで、ソフトウェアをリモートインストールしたり、ファイルを収集したりして、さまざまな配布管理の業務を実現します。

ジョブは、機器情報の［管理状態］が［管理］になっているコンピュータ（管理対象のコンピュータ）に対して実行できます。［管理状態］が［発見］および［除外対象］のコンピュータにジョブを実行しても、実行待ちになります。機器情報の［管理状態］については、マニュアル「JP1/IT Desktop Management 2 運用ガイド」の、機器の探索の説明を参照してください。

ジョブの作成、実行、保存など、ジョブに関する基本的な作業は、JP1/IT Desktop Management 2の多くの機能で共通しています。配布管理の業務にJP1/IT Desktop Management 2を十分に活用するためには、ジョブについて十分に理解しておいてください。

なお、ジョブを作成、実行する方法については、「10.1　ジョブの作成、実行手順」を参照してください。

注意事項

ジョブとITDM互換配布は、エージェント上で同時に実行できません。そのため、ITDM互換配布がエージェントで実行中のとき、ジョブの状態は実行待ちのままになることがあります。

1.3.2　作成できるジョブの種類

作成できるジョブ種別とジョブの内容を次の表に示します。

表1‒1　配布管理システムで作成できるジョブ種別

項番

ジョブ種別

ジョブの内容

1

パッケージのインストール

パッケージをリモートインストールします。

2

中継までのパッケージの転送

中継システムおよび管理用中継サーバまでパッケージを転送します。

3

中継のパッケージの一括削除

中継システムおよび管理用中継サーバ上のパッケージをすべて削除します。

4

リモートコレクト

管理対象のコンピュータ上のファイルを配布管理システムに収集します。

5

中継までのリモートコレクト

管理対象のコンピュータ上のファイルを配布管理システム直下の中継システムおよび管理用中継サーバに収集します。

6

中継からのコレクトファイル収集

中継システムおよび管理用中継サーバに収集したファイルを、配布管理システムに転送します。

7

中継のコレクトファイル削除

中継システムおよび管理用中継サーバに収集したファイルをすべて削除します。

8

クライアントユーザによるインストール

利用者のコンピュータに、ソフトウェアをインストールする許可を与えます。許可を与えたソフトウェアは、パッケージセットアップマネージャからインストールできます。

9

コンピュータ（UNIX）のシステム情報の取得

OSがUNIXまたはMacのコンピュータのシステム情報を取得します。

10

コンピュータ（UNIX）のソフトウェア情報の取得

OSがUNIXまたはMacのコンピュータにインストールされているソフトウェアの情報を取得します。

11

システム構成情報の取得

中継システムおよび管理用中継サーバ配下のシステム構成情報を取得します。取得できるシステム構成情報を次に示します。

あて先に指定した管理用中継サーバ配下の中継システムとコンピュータ、および直下の管理用中継サーバ

あて先に指定した中継システム配下のコンピュータ

12

中継からの結果通知保留

中継システムおよび管理用中継サーバに対し、ジョブ結果の通知を一時停止するよう指示します。

13

中継の結果通知保留の解除

中継システムおよび管理用中継サーバに停止させていた、ジョブ結果の通知を再開させます。

14

ファイル転送の中断

中継システムおよび管理用中継サーバに対し、その直下のシステムとのファイル転送を中断するよう指示します。

15

ファイル転送の再開

中継システムおよび管理用中継サーバとその直下のシステムで中断させていたファイル転送を再開させます。

Macエージェントに対して適用できるジョブは「パッケージのインストール」、「コンピュータ（UNIX）のシステム情報の取得」、および「コンピュータ（UNIX）のソフトウェア情報の取得」だけです。

Citrix XenApp、Microsoft RDSサーバに対しては、「クライアントユーザによるインストール」は適用できません。

1.3.3　ジョブの詳細設定

ジョブは、リモートインストールマネージャの［ジョブの作成］ダイアログボックスで作成します。

図1‒7　［ジョブの作成］ダイアログボックス

［ジョブの作成］ダイアログボックスには、指定したジョブ種別に応じて、必要なパネルが表示され、ジョブの名称、あて先、実行条件など、ジョブの詳細を設定できます。［ジョブの作成］ダイアログボックスに表示されるパネルの詳細については、「10.2.2　［ジョブの作成］ダイアログボックスに表示されるパネル」を参照してください。

［ジョブの作成］ダイアログボックスに表示されるパネルと、各パネルで設定する内容の概要について次の表に示します。

表1‒2　［ジョブの作成］ダイアログボックスに表示されるパネル

パネル名

設定する内容

［ジョブ］パネル

ジョブ名を設定します。

［あて先］パネル

ジョブの実行対象となるホストを設定します。

［パッケージ］パネル

リモートインストールするパッケージの属性、インストール環境などを設定します。

［ジョブの配布属性］パネル

ジョブをマルチキャスト配布したい場合、またはパッケージを分割して配布したい場合に設定します。大容量のパッケージの場合に便利です。ただし、マルチキャスト配布の設定ができるのは、「パッケージのインストール」ジョブの場合だけです。

［取得項目］パネル

「コンピュータ（UNIX）のシステム情報の取得」ジョブを実行する場合に、取得の対象となる項目を設定します。

［検索対象］パネル

「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブを実行する場合に、取得の対象となるソフトウェアを設定します。検索リストを使用する場合は、使用する検索リストを設定できます。検索対象にネットワークファイルシステムを含めるかどうかも設定できます。

［コレクトファイル］パネル

リモートコレクトの対象となるファイルを設定します。

［スケジュール］パネル

ジョブの登録日時、実行日時および実行期限を設定します。

［クライアント制御］パネル

ジョブのあて先のPCが起動されていない場合、起動してジョブを実行させる設定ができます。また、起動したあとにシャットダウンさせる設定もできます。なお、UNIXエージェント、Macエージェントは、ジョブ実行後にシャットダウンさせることはできません。

1.3.4　ジョブの実行と保存

［ジョブの作成］ダイアログボックスで作成したジョブは、そのまま実行することもできますが、［ジョブ定義］ウィンドウに保存してから実行することもできます。ジョブを保存しておくと、保存したジョブをテンプレートとして使用することで、同じようなジョブを何度でも簡単に実行できます。

なお、ジョブを保存するには、作成したジョブを管理するフォルダをあらかじめ［ジョブ定義］ウィンドウに作成しておく必要があります。

保存したジョブの編集方法やフォルダの作成方法などについては、「10.3.2　保存したジョブおよびフォルダの管理」を参照してください。

1.3.5　グルーピングしたホストへのジョブ実行

規模の大きいシステムでは、ジョブの実行対象として個々のシステムを指定するよりも、何らかのグループを指定する方が便利です。あて先をグループ化したものには、「あて先グループ」と「ID」があります。

あて先グループ

部署や担当業務など任意の条件で、配布先を階層的にグルーピングしたものです。グループの作成だけでなく、各グループにどのコンピュータが所属するかということも、配布管理システムで指定して管理します。ウィンドウ上で、あて先の論理的な階層構造を簡単に把握できるので、あて先を管理しやすくするためにも、何らかのあて先グループを作成しておくことをお勧めします。

ジョブのあて先として、あて先グループを指定すると、そのグループに属するすべてのコンピュータに対してジョブが実行されます。

部署ごとにグルーピングして管理する一方で、各部署のコンピュータをプロジェクト別にグルーピングすることもできます。このため、次の図のように、部署ごとのグルーピングとプロジェクトごとのグルーピングを重複して設定できます。

あて先グループの概念を次の図に示します。

図1‒8　あて先グループの概念

ID

IDでは、所属するコンピュータをシステム管理者側から登録するだけでなく、利用者側からもIDを選択して登録できます。また、IDに対して実行したジョブは、その後、そのIDに新しくコンピュータが登録されるたびに自動的に実行されるため、配布管理システムがソフトウェアを再度配布する必要はありません。OSやマシンの用途など変動しやすい項目で分類しても、利用者側から所属するIDを変更するだけで済むので、システム管理者の負担を軽減できます。

IDの概念を次の図に示します。

図1‒9　IDの概念

1.3.6　実行されたジョブの流れ

ジョブを実行した場合の流れを説明します。

［管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数］および［ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数］は、JP1/IT Desktop Management 2 - Managerのセットアップ、またはエージェント設定で設定する項目です。

リモートインストールマネージャからジョブを実行する。

配布管理システムからジョブ実行時に指定されたあて先に対して、実行要求（下位システムへジョブが実行されたことを知らせるための通知）が送信されます。

実行要求を受信した下位システムは、上位システムにジョブを要求する。

要求のあった下位システムあてにジョブがダウンロードされる。

下位システムから実行結果が配布管理システムへ通知される。

ジョブ実行の流れを次の図に示します。

図1‒10　ジョブ実行の流れ

配布管理システムでは1分間隔でジョブを監視し、接続する必要のある下位システムがある場合、実行要求を送信します。一度に実行要求を送信する下位システムの最大数は［ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数］になります。ただし、現在接続している下位システム数が、「すでに接続している下位システム数 < 管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」の場合、新たに接続できる下位システム数分の実行要求だけを送信します。

なお、ジョブに指定されたあて先に対応する下位システムの数とは、ジョブを実行した配布管理システムに直接接続された下位システムの範囲です。したがって、配布経路に中継システムおよび管理用中継サーバが含まれている場合は、直接接続している中継システムおよび管理用中継サーバだけが数に含まれ、中継システムおよび管理用中継サーバに接続している下位システムについては数に含まれません。

(1)　ジョブの実行例

ジョブの実行例を次に示します。

条件

ジョブに指定されたあて先の数：60台

「ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数」：20

「管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」：50

ジョブのダウンロードに掛かる時間：200秒

この条件でのジョブ実行の流れを次の図に示します。

図1‒11　ジョブ実行の流れの例

「ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数」分のあて先20台に実行要求が送信される。

接続中の下位システム数：20 < 「管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」：50

「ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数」分のあて先20台に実行要求が送信される。

接続中の下位システム数：40 < 「管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」：50

「管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」の残り10台に対して実行要求が送信される。

接続中の下位システム数：50 ＝ 「管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」：50

接続中の下位システムが「管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」と同じ数になっているため、実行要求が送信されない。

操作1.で接続した下位システムから実行結果が通知される。

接続中の下位システム数：30 < 「管理用サーバへの同時接続JP1/IT Desktop Management 2 - Agent数」：50

ジョブに指定されたあて先の数60のうち、残りの10台に対して実行要求が送信される。

1.3.7　ジョブの実行順序

管理対象のコンピュータで同時に複数のジョブが実行される場合、次に示す規則で実行されます。ここでは、実行時間（インストール日時）が指定されているジョブを日時指定のジョブ、実行時間（インストール日時）が指定されていないジョブを即時実行のジョブと表現します。

日時指定のジョブは指定された日時順に実行されます。

即時実行のジョブは、リモートインストールマネージャでジョブが実行された順に実行されます。

日時指定のジョブと即時実行のジョブが混在した場合、リモートインストールマネージャで日時指定のジョブより前に実行された即時実行のジョブは管理対象のコンピュータでも先に実行されます。

(1)　複数パッケージを計画的に実行する方法

複数のパッケージを順番にインストールしたいなど、ジョブに順序性を持たせたい場合は前述の規則を考慮し、さらに次に示す指定方法に従ってジョブを実行してください。

同じ経路（中継システムおよび管理用中継サーバ経由）で実行してください。

パッケージのインストールモード（GUIインストールモードまたはバックグラウンドインストールモード）の指定は同じにしてください。

パッケージの実行タイミングに「次回起動時に実行」を指定した場合、コンピュータが再起動されないとインストールされません。したがって「すぐに実行」を指定したパッケージと順序性を持たせる場合は、コンピュータの再起動のタイミングに注意してください。

1ジョブ内に複数のパッケージが選択されている場合で、パッケージの実行タイミングやインストールモードが同じ指定のときは、コンピュータでは次の順序でインストールされる順番が決まります。

インストール順序の決定方法

インストール順序は、リモートインストールマネージャの［ジョブの作成］ダイアログボックスで指定するパッケージのキャビネット識別ID（2けた）、パッケージ識別ID（44けた）、バージョン（6けた）、世代番号（4けた）を連結した文字列の昇順になります。複数パッケージを一度に配布する場合は、インストール順序に従って、キャビネット識別ID、パッケージ識別IDなどを設定してください。例えば、パッケージA、パッケージBが次の識別子でパッケージ登録されているとします。

識別子

パッケージAの値

パッケージBの値

キャビネット識別ID

'DD'

'AA'

パッケージ識別ID

'AAA'

'CCCCC'

バージョン

'0100 '

'0100/A'

世代番号

'0000'

'0001'

連結した文字列

'DDAAA0100 0000'

'AACCCCC0100/A0001'

インストール順序は連結した文字列の昇順となるため、パッケージBの方がパッケージAより先にインストールされます。

［ジョブの作成］ダイアログボックスの［パッケージ］パネルでは、パッケージ名をパッケージの各識別IDを連結した文字列の昇順に表示しています。したがって、インストール順序を一覧表示で確認できます。

ユーザプログラム、データや他社ソフトウェアの場合

先にインストールするパッケージのパッケージ識別IDにASCIIコードの英数字順で若いIDを指定するようにしてください。

日立プログラムプロダクトの場合

パッケージ識別IDは固定になっていますが、パッケージング時にキャビネット識別IDを変更することで、インストール順序を特定できます。先にインストールしたいソフトウェアのキャビネット識別IDにASCIIコードの英数字順で若いIDを指定するようにしてください。この場合、インストール順序によってキャビネットを分けてパッケージする必要があります。

なお、次の注意事項があります。

パッケージのスケジュール属性にインストール日時を指定した場合、およびジョブ作成時にジョブの実行日時を指定した場合、リモートインストールマネージャで実行したジョブの順番ではインストールされません。このため、インストール日時およびジョブの実行日時は指定しないようにしてください。

バックグラウンドインストールモードのパッケージは、GUIインストールモードのパッケージより優先してインストールされます。したがって、インストールモードの異なるパッケージが混在するときは、別のジョブに分けて実行し、先に実行したパッケージの完了を待って、後続のパッケージを実行してください。

分割配布が指定されたジョブは、リモートインストールマネージャであとから実行されたジョブがコンピュータで先に実行されることがあります。

中断中でも配布する指定のジョブは、中断中のジョブより先に実行されます。

1.3.8　ジョブの実行状況の確認

ジョブの実行状況は、リモートインストールマネージャの［ジョブ実行状況］ウィンドウで確認できます。このウィンドウには、実行したジョブの状況が、フォルダやジョブごとに階層的に表示されます。左枠にはフォルダやジョブなどの階層構造が、右枠には左枠で選択した階層内の情報が表示されます。

図1‒12　［ジョブ実行状況］ウィンドウ

ジョブに表示される色は、ジョブの対象となるホストの状態のうち、最も悪い状態の色が表示されます。例えば、ジョブが赤色（障害の発生していることを示す）になっている場合、ジョブから赤色の階層を1つずつ下ることよって、障害の発生しているホストに到達できます。

ジョブの実行状況を確認する方法については、「10.4　ジョブの実行状況を確認する」を参照してください。

1.3.9　実行結果を確認したあとの対処

実行結果を確認したあと、正常に終了したジョブは［ジョブ実行状況］ウィンドウから削除してください。実行済みのジョブを削除しないで残しておくと、実行中のジョブの処理が遅くなったり、リモートインストールマネージャの動作が遅くなったりすることがあります。実行待ちおよび再実行できるエラーの状態となっているジョブがある場合は、そのジョブを指定して再実行できます。このような、ジョブの実行結果を確認したあとの対処については、「10.5　ジョブの実行結果を確認したあとの対処」を参照してください。

対処が必要なジョブを表示する方法については、「10.4.6　特定の実行状況のジョブの表示方法」を参照してください。

1.4　システム構成情報の管理

JP1/IT Desktop Management 2を使用するには、プログラムをインストールするだけでなく、配布管理システムで、中継システム、管理用中継サーバ、および管理対象のコンピュータの構成とアドレス（ホスト名またはIPアドレス）を管理しておく必要があります。この情報をシステム構成情報と呼びます。システム構成情報に登録されているコンピュータが、ジョブの実行先として認識できるようになります。

ここでは、システム構成情報の管理の概要について説明します。

1.4.1　システム構成情報の確認

システム構成情報は、リモートインストールマネージャの［システム構成］ウィンドウで確認・作成できます。このウィンドウに表示されたネットワークの階層が、ジョブ実行時の実際の経路になります。［システム構成］ウィンドウを次に示します。

図1‒13　［システム構成］ウィンドウ

［システム構成］ウィンドウでは、左枠にシステムの階層構造が表示されます。階層の最上位には、配布管理システムのアイコン（[図データ]）が表示されます。中継システムのアイコン（[図データ]）をダブルクリックすると、選択した中継システムの下位の階層や管理対象のコンピュータのアイコン（[図データ]）が表示されます。配布管理システムを階層化したシステムでは、配布管理システムの配下に管理用中継サーバのアイコン（[図データ]）が表示されます。

管理用中継サーバ、中継システム、および管理対象のコンピュータのアイコンの隣には、それぞれのホスト名またはIPアドレスが表示されます。

左枠で管理対象のコンピュータ以外を選択した場合、右枠には左枠で選択した階層内の構成が表示されます。

システム構成情報の作成方法については、「5.　システム構成情報とあて先グループを作成する」を参照してください。

1.4.2　コンピュータのグルーピング

配布管理システムでリモートインストールなどのジョブを実行するとき、ジョブの実行対象となるホスト（あて先）を指定します。このとき、システム構成情報を利用して、あて先を1台1台指定することもできますが、多数のコンピュータがある場合は効率的ではありません。JP1/IT Desktop Management 2では、物理的なネットワーク構成とは関係なく、目的に応じてコンピュータを幾つかのグループに分類し、グループ単位でジョブを実行できます。

(1)　作成できるグループの種類

作成できるグループには、あて先グループとIDの2種類があります。どちらも、部署や担当業務といった任意の条件でグルーピングできます。さらに、1つのホストを複数のあて先グループまたは複数のIDに登録して、1台のPCを、部署ごと、業務ごとといった複数のグループに所属させる運用もできます。このため、配布先のホストを効率良く管理できます。

(a)　あて先グループ

あて先グループは、配布管理システム側でホストをグルーピングする方法です。システム構成とは関係なくホストをグルーピングできますので、部署やプロジェクトなど、任意の条件で、ホストを階層的なグループに分類して管理できます。あて先グループ名はユーザが任意に設定できます。部署やプロジェクトなどでホストをグルーピングし、管理しやすい名称を付けておくと、ジョブの実行が容易になります。

ジョブのあて先として、あて先グループを指定すると、そのグループに属するすべてのコンピュータに対してジョブが実行されます。

(b)　ID

IDは、配布管理システムで、グループの名称と、そのIDを管理する中継システムおよび管理用中継サーバ（ID管理元中継）だけを決めておく方法です。どのグループに所属するかは、利用者側で決めます。複数のIDに所属することもできます。

また、配布管理システムから、ファイルを使って複数のコンピュータをIDに登録することもできます。ただし、IDは階層的に管理できません。

あて先にIDを指定したジョブ（IDジョブ）がID管理元中継に転送されると、そのIDに属するコンピュータにID管理元中継からジョブが実行されます。

IDでグループを作成すると、利用者側でIDに登録するため、管理者がジョブのあて先のコンピュータを個々にメンテナンスする必要がないため便利です。また、コンピュータが増設されても、利用者側でIDに登録すれば、登録したIDのジョブが自動的に実行されるため、コンピュータの構成変更に動的に対応できます。

利用者側でIDに登録するとき、IDに登録を許可するパスワードを設定できます。パスワードを設定することで、利用者が間違ったIDに登録してしまうことを避けられます。

(2)　あて先のグルーピング方法

あて先グループとIDは、リモートインストールマネージャの［あて先］ウィンドウで設定します。

図1‒14　［あて先］ウィンドウ

あて先グループの作成方法については、「5.2　あて先グループを作成する」を参照してください。

IDの作成方法については、「5.3　IDを作成する」を参照してください。

［あて先］ウィンドウの左枠には、グループの階層構造が表示されます。左枠の階層をダブルクリックすると、ダブルクリックした階層の下位の階層が表示されます。右枠には左枠で選択したグループに属するホストの情報が表示されます。

［あて先］ウィンドウでは、次に示すアイコンでグループが表示されます。

[図データ]：あて先グループ

[図データ]：ID

ジョブを実行する対象のコンピュータは、主に［あて先］ウィンドウで指定します。［システム構成］ウィンドウでも指定できますが、ホストの名称がIPアドレスまたはホスト名で表示されているため、各ホストを認識しにくい場合があります。［あて先］ウィンドウでは、ジョブを実行するホストをグループ単位に指定できます。

システム構成情報が、コンピュータのネットワーク構成を管理するための情報であるのに対して、あて先グループやIDは、コンピュータをグループに分けて管理するための情報と言えます。効率良くジョブを実行できるよう、グルーピングの基準を検討しておいてください。

1.4.3　システム構成情報のメンテナンス

システム構成を運用していく上で、システム構成情報のメンテナンスが必要になります。ここでは、新しく追加されたホストを検索してあて先グループに登録したり、新しく追加されたホストをあらかじめ作成しておいた条件によってあて先グループやIDに自動的に振り分けたりして追加する方法についても説明します。

なお、機器のメンテナンスで削除候補機器として検出された重複機器や不稼働機器を自動または手動で削除した場合、その機器のシステム構成情報も自動的に削除されます。また、所属していたあて先グループやIDからも、その機器が自動的に削除されます。機器のメンテナンスについては、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」の機器の自動メンテナンスの説明を参照してください。

(1)　システム構成情報の検索

［システム構成］または［あて先］ウィンドウから、一定の条件を満たすあて先を検索できます。検索には次の2種類があります。

あて先名、あて先グループ名、ID名などの名称をキーにした検索

ホストの登録日付をキーにした検索

これらの検索機能を利用して、検索結果のホストを［あて先］ウィンドウにコピーしたり、システム構成情報から削除したりして、システム構成情報をメンテナンスできます。

検索機能を利用してシステム構成情報を手動でメンテナンスする方法については、「6.1　システム構成情報のメンテナンス」を参照してください。

(2)　あて先グループの自動メンテナンス

一度作成したあて先グループをメンテナンスする方法としては、［あて先］ウィンドウからの編集や、ファイルからのインポートなどがあります。しかし、数千台規模のホストを管理するシステムの場合などは、システム管理者が定期的にあて先グループを追加・削除するのは負荷が掛かり過ぎます。

JP1/IT Desktop Management 2では、システム構成情報を監視することで新たに追加されたホストや移設されたホストを自動的に検知し、あらかじめ作成しておいたグルーピング条件（ポリシー）に従ったあて先グループに自動的に振り分けることができます。このような運用をあて先グループの自動メンテナンスと呼びます。あて先グループの自動メンテナンスは、管理対象のコンピュータから機器情報が通知されたときに実行されます。

あて先グループの自動メンテナンスの概要を次の図に示します。

図1‒15　あて先グループの自動メンテナンスの概要

また、管理対象のコンピュータから情報が通知されたタイミング以外に、任意のタイミングであて先グループをメンテナンスすることもできます。これによって、作成したポリシーに従って、システム構成情報に登録されているホストを任意の時点で一括してあて先グループに振り分けられます（ポリシーの一括反映）。

あて先グループにポリシーを一括反映する方法については、「6.2.2　あて先グループにポリシーを一括反映する」を参照してください。

なお、ポリシーはファイルから作成できます。また、ファイルを入出力することで、既存のポリシーをバックアップしたり、ポリシーを切り替えたりできます。ポリシーをファイルから作成する場合は、「6.4　ポリシーをファイルから作成する」を参照してください。

(3)　IDの自動メンテナンス

作成したIDに対してどのIDに所属するかは、基本的には利用者が決めます。配布管理システムで所属するコンピュータを決めたい場合、一定の条件に一致したコンピュータを自動的にIDに登録させることができます。［あて先］ウィンドウやファイルのインポートでメンテナンスする方法より効率良く、確実にコンピュータをIDに登録できます。

このように、IDに一定の条件（ポリシー）を設定して、コンピュータを自動的にIDに登録する運用を、IDの自動メンテナンスと呼びます。

IDの自動メンテナンスのポリシーには次の3種類があります。

新規作成ホストによるID登録

JP1/IT Desktop Management 2へ追加されたコンピュータを自動的に検知して、IDに登録させることができます。

資産管理項目によるID登録

資産管理項目（部署、設置場所、またはハードウェア資産情報の追加管理項目）の値を条件として設定し、その条件に従ってコンピュータを自動的にIDに登録させることができます。

機器情報によるID登録

機器のシステム情報の値やソフトウェアのインストール情報、資産管理項目の値を条件として設定し、その条件に従ってコンピュータを自動的にIDに登録させることができます。

IDの自動メンテナンスの概要を次の図に示します。

図1‒16　IDの自動メンテナンスの概要

IDの自動メンテナンスを利用する方法については、「6.3　IDの自動メンテナンス」を参照してください。

なお、あて先グループの自動メンテナンスと同様に、ファイルからポリシーを作成できます。ポリシーをファイルから作成する場合は、「6.4　ポリシーをファイルから作成する」を参照してください。

また、IDの自動メンテナンスを利用してジョブを実行するには、あらかじめIDに対してジョブを実行しておく必要があります。

例えば、PC初期導入時に必ず実行したいジョブがある場合、あらかじめIDに対してジョブを実行しておき、そのIDに新規に追加されたコンピュータをポリシーとして設定することで、新規に追加されたコンピュータへ自動的にジョブを実行できます。

ID自動メンテナンスを利用したジョブの流れを次の図に示します。

図1‒17　ID自動メンテナンスを利用したジョブの流れ

1.4.4　システム構成情報の削除履歴の管理

JP1/IT Desktop Management 2 - Managerでは、管理対象のコンピュータ、中継システム、および管理用中継サーバが、いつ、どのような契機で、システム構成情報から削除されたのかがわかるように、削除履歴を管理できます。削除履歴には、削除されたホストのシステム構成情報が保管されるので、削除履歴を基に、ホストをシステム構成情報に復元することもできます。

システム構成情報の削除履歴を管理するには、JP1/IT Desktop Management 2 - Managerのセットアップで、「削除履歴を保管する」をオンにしておく必要があります。

なお、削除したホストのあて先グループ、ID、および機器情報は、履歴として保管されません。また、システム構成情報をシステム構成情報ファイルから作成したときに一括削除されたホストは、履歴の保管対象にはなりません。

システム構成情報の削除履歴を管理する方法については、「6.5　システム構成情報の削除履歴を管理する」を参照してください。

1.5　UNIXエージェント、Macエージェントのシステム情報とソフトウェア情報の管理

配布管理システムではジョブを実行して、OSがUNIX、Macのコンピュータのシステム情報とソフトウェア情報を取得し、UNIXエージェント、Macエージェントの管理に役立てることができます。

UNIXエージェント、Macエージェントのシステム情報とソフトウェア情報の取得方法については、「付録G　UNIXエージェント、Macエージェントのシステム情報とソフトウェア情報の取得」を参照してください。

1.5.1　UNIXエージェント、Macエージェントのシステム情報の管理

UNIXエージェント、Macエージェントのシステムの使用状況を管理するシステム情報を取得できます。

1.5.2　UNIXエージェント、Macエージェントのソフトウェア情報の管理

UNIXエージェント、Macエージェントにインストールされているソフトウェアの種類やバージョン情報などを把握できます。

JP1/IT Desktop Management 2でリモートインストールしたソフトウェアや、エージェントに存在する検索リストにあるソフトウェアなどの情報を取得できます。また、UNIXエージェント側で情報の通知を抑止していない場合は、コンピュータに適用されているOSパッチを取得して、ソフトウェアの情報と同様に管理することもできます。

なお、UNIXやMacのソフトウェア情報を取得してJP1/IT Desktop Management 2の操作画面で管理するには、コンフィグレーションファイル（jdn_manager_config.conf）を編集する必要があります。コンフィグレーションファイルの編集方法については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」のUNIXエージェント、Macエージェントのソフトウェア情報管理の設定を変更する手順の説明を参照してください。

1.6　管理情報の出力

機器情報、あて先属性、パッケージ属性、ジョブ実行状況など、配布管理システムで管理している情報を、CSV形式ファイルに出力したり、印刷したりできます。

ここでは、配布管理システムで管理している情報を出力する方法の概要について説明します。

1.6.1　CSV形式ファイルへの出力

配布管理システムで管理している情報（管理情報）を、CSV形式のファイルへ出力できます。CSV形式のファイルに出力した管理情報は、表計算ソフトなどに読み込ませて利用できます。

管理情報をCSV形式のファイルへ出力するには、CSVファイル出力を利用します。［CSVファイル出力］ダイアログボックスで、出力項目やファイルの出力先を設定できます。

CSVファイル出力を使って管理情報をCSV形式ファイルへ出力する方法については、「11.1.1　CSV形式ファイルに出力できる項目」を参照してください。

1.6.2　印刷

配布管理システムで管理している情報を印刷できます。［印刷情報の設定］ダイアログボックスで印刷したい項目を選択し、必要な情報を設定して印刷します。

管理情報を印刷する方法については、「11.2　管理情報を印刷する」を参照してください。

1.7　管理対象のコンピュータでの設定

管理対象のコンピュータには、システム構成の最下位にあるコンピュータだけでなく、ジョブを受信して送信する管理用中継サーバや中継システムも含まれます。

管理対象のコンピュータとして使用できるシステムを次の表に示します。

表1‒3　管理対象のコンピュータとして使用できるシステム

システム

プログラム

管理用中継サーバ

JP1/IT Desktop Management 2 - Manager

中継システム

JP1/IT Desktop Management 2 - Agent

エージェント

ここでは、配布されたソフトウェアのインストールについて説明します。

1.7.1　配布されたソフトウェアのインストール

配布管理システムで「パッケージのインストール」ジョブが実行されると、管理対象のコンピュータは、指示されたソフトウェアを自動的にダウンロードし、自システムにインストールします。ソフトウェアのダウンロードとインストールがすべて自動的に実行されるため、利用者側で「いつ」「何を」インストールするかを意識する必要はありません。

なお、すべてを自動的に実行させる運用が、利用者にとって不都合な場合には、(1)に示すような回避策があります。また、利用者が手動でソフトウェアを選択してインストールする(2)のような運用方法もあります。

(1)　ジョブの実行タイミングのコントロール

通常、パッケージのダウンロード、インストールなどのジョブのタイミングは、上位のサーバ（配布管理システム）によって決定されていて、利用者側で意識する必要はありません。利用者は、配布管理システムからパッケージが転送されたり、ソフトウェアが自動的にインストールされたりするのを待つだけです。

しかし、このような運用では、利用者の業務の最中に突然インストールが始まるなどの不都合が起こることも考えられます。利用者は、利用者の都合を無視して一方的にジョブが実行されるのを防いだり、利用者の都合に合わせてジョブの実行を指示したりできます。

利用者側でジョブの実行タイミングをコントロールするには、ジョブの保留機能を使用します。

(a)　ジョブの保留機能を使用する

上位サーバからの一方的なジョブの実行を防ぐ方法として、ジョブの保留機能があります。この機能を使用すると、サーバからジョブが転送されたときに、［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスが表示され、ユーザが、そのジョブを実行するかどうかを選択できます。ジョブを即時に実行したくない場合にジョブの実行を一時的に保留できます。

ジョブの保留機能の使用は、エージェント設定で設定します。［ジョブの設定］−［ジョブの保留許可の設定］で、［利用者による、ジョブの保留を許可する］のチェックボックスをオンにしてください。

なお、保留の対象となるのは、GUIインストールモードの「パッケージのインストール」ジョブだけです。ただし、実行日時（パッケージのインストール日時またはジョブの実行日時）が指定されている場合は保留できません。

ジョブを保留する方法については、「12.3.1　ジョブを保留する方法」を参照してください。

(2)　ソフトウェアを選択してインストールする

配布管理システムから「クライアントユーザによるインストール」ジョブを使用して配布されたソフトウェアは、自動的にはインストールされないで、インストールの許可だけが与えられた状態になっています。このようなソフトウェアについては、利用者が、必要なソフトウェアを選択してインストールします。インストールできるソフトウェアの一覧を表示し、ソフトウェアを選択してインストールするには、パッケージセットアップマネージャを使用します。

複数の一般ユーザがパッケージセットアップマネージャを共用することはできません。

パッケージセットアップマネージャの使用方法については、「12.4　パッケージセットアップマネージャを操作する」を参照してください。

1.7.2　手動でソフトウェアをインストールする場合の注意事項

手動でソフトウェアをインストールする場合の注意事項を示します。

管理対象のコンピュータがWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008、またはWindows Vistaの場合は、「付録A　JP1/IT Desktop Management 2 - Agentを使用するときの注意事項」もあわせて参照してください。

他社ソフトウェアインストール時の注意事項

他社ソフトウェアのリモートインストール中に、動作中のインストーラに対し画面操作をしないでください。インストールがハングアップする場合があります。

パスワードロック時の注意事項

管理対象のコンピュータがパスワードでロックされている（［Ctrl］+［Alt］+［Delete］キーの入力を要求するダイアログボックスが表示されている）と、GUIインストールモードで画面応答が必要なソフトウェアは、画面応答ができないためリモートインストールされません。なお、リモートインストールに対応した日立プログラムプロダクトは、リモートインストール時に画面応答が不要なため、ロックされていてもインストールされます。

管理対象のコンピュータが起動できないまたは起動に時間が掛かる

次に示す場合、管理対象のコンピュータ（または中継システム）が起動できない、または起動に時間が掛かることがあります。

接続先の上位システムが起動していない。

前回の起動中に処理できなかったジョブ結果を送信している。

エージェント設定の［基本設定］−［上位システムとの通信のタイミング］で、［システム起動を基準としたポーリングをする］のチェックボックスをオンにし、［ポーリングのタイミング］を［システム起動前］に設定している。

1.の場合は、接続先の上位システムが起動すれば、管理対象のコンピュータは起動されます。

2.または3.の場合は、ジョブ結果の送信や上位システムのポーリングが終了すれば、管理対象のコンピュータは起動されます。

インストールプロセスがハングアップした場合の対処

リモートインストール時に起動させたユーザプログラムがハングアップしたり、GUIインストールモードでのユーザプログラム終了コード通知インターフェースが不正だったりした場合、リモートインストールのプロセスもハングアップします。プロセスがハングアップしたら、管理対象のコンピュータを再起動してください。

分割配布の場合の注意事項

管理対象のコンピュータがポーリングしない環境での分割配布

管理対象のコンピュータがポーリングしない場合、サーバからの起動だけで分割配布が実行されます。サーバからの起動に失敗することがある環境では、分割配布の運用を避けることをお勧めします。

保留と分割配布

分割配布では分割されたジョブがすべて転送完了したあと、インストールするかしないかを問い合わせる［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスが表示されます。このとき、インストールを選択すると、インストールが開始されます。保留を選択すると、インストールは保留され、ユーザからの指示があるまでインストールされません。

分割配布のインストール日時指定

インストール日時指定の分割配布のとき、分割配布の途中でインストール日時を過ぎた場合でも、分割配布で分割されたジョブがすべて転送完了したあとにインストールが開始されます。

分割配布の起動時組み込み

システム起動時組み込み指定の分割配布の場合、分割されたジョブがすべて転送完了した時点以降の次の起動時にインストールが開始されます。

仮想化環境で使用する場合の制限事項

仮想化環境でJP1/IT Desktop Management 2 - Agent（エージェント）をインストールまたは操作する場合の制限について説明します。なお、OSの種類によっては、JP1/IT Desktop Management 2 - Agent（エージェント）が仮想化環境に対応していない場合があります。

リモートデスクトップに関する制限事項

リモートデスクトップで接続してパッケージをインストールする場合、オフラインインストールはできません。

OSがWindows Server 2003の場合、リモートデスクトップで接続してJP1/IT Desktop Management 2 - Agent（エージェント）をインストールまたは操作するときは、コンソールセッションに接続してください。

OSがWindows Server 2019、Windows Server 2016、Windows Server 2012、またはWindows Server 2008の場合、リモートデスクトップで接続してJP1/IT Desktop Management 2 - Agent（エージェント）を操作するときは、複数のユーザで同時にJP1/IT Desktop Management 2のアプリケーションを実行できません。

ユーザの簡易切り替え機能に関する制限事項

OSがWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008、Windows Vistaの場合、ユーザの簡易切り替え機能を使用してJP1/IT Desktop Management 2 - Agent（エージェント）を操作するときは、複数のユーザで同時にJP1/IT Desktop Management 2のアプリケーションを実行できません。

1.8　JP1/AJSと連携したジョブの自動実行

JP1/AJSは、業務を自動的に運用するためのプログラムです。処理を順序付けて定期的に実行したり、特定の事象が発生したときに処理を開始したりできます。

JP1/IT Desktop Management 2が提供するジョブの作成・実行などの運用操作のコマンドインターフェースを利用することで、コマンドの実行順序をJP1/AJSに登録して自動的に実行させたり、ファイルの更新などの事象をきっかけにJP1/IT Desktop Management 2のコマンドを実行させたりできます。

JP1/AJSと連携した、ジョブの自動実行の概要を次の図に示します。

図1‒18　JP1/AJSと連携したジョブの自動実行の概要

JP1/AJSの機能および操作の詳細については、JP1/AJSのマニュアルを参照してください。JP1/IT Desktop Management 2が提供するコマンドの詳細については、「14.　リモートインストールマネージャを使用した配布機能のコマンド」を参照してください。

2　代表的な運用例

ここでは、リモートインストールマネージャを使用した配布機能の運用例を示して、運用のポイントを紹介します。

2.1　遠隔地にあるJP1/IT Desktop Management 2を操作する

遠隔地にあるJP1/IT Desktop Management 2を操作するシステムを構築できます。

例えば、社内のサーバにJP1/IT Desktop Management 2をインストールして、JP1/IT Desktop Management 2の操作は管理者の手もとのPCから実施するといった運用ができます。

遠隔地にあるJP1/IT Desktop Management 2を操作するには次の2とおりの方法があります。

JP1/IT Desktop Management 2の配布管理システムとは別のコンピュータにリモートインストールマネージャ（Remote Install Manager）だけをインストールする

Remote Install Managerだけをインストールする手順については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」を参照してください。

配布管理システムがインストールされているコンピュータをリモートコントロールする

リモートコントロール機能については、マニュアル「JP1/IT Desktop Management 2 運用ガイド」の遠隔地にあるサーバを運用する流れの説明を参照してください。

2.2　リモートインストール機能を使用してJP1/IT Desktop Management 2 - Agentを配布する

中継システムまたはエージェントをバージョンアップする場合は、JP1/IT Desktop Management 2を利用してリモートインストールできます。リモートインストールの方法は、そのほかの日立プログラムプロダクトと同じです。

なお、リモートインストールしたJP1/IT Desktop Management 2 - Agentの設定は、インストール先のコンピュータでのインストール前の設定が引き継がれます。

リモートインストール機能を使用してJP1/IT Desktop Management 2 - Agentを配布する場合の注意事項を次に示します。

プログラムおよびコンポーネントに関する注意事項

それぞれのプログラムでリモートインストールできるコンポーネントは次のとおりです。JP1/IT Desktop Management 2 - Agentをインストールする場合は、リモートインストールするコンポーネントを選択できます。

JP1/IT Desktop Management 2 - Agent（エージェント）をインストールする場合

エージェント

リモコンエージェント

パッケージャ

Automatic Installation Tool

JP1/IT Desktop Management 2 - Agent（中継システム）をインストールする場合

中継システム

リモコンエージェント

パッケージャ

Automatic Installation Tool

リモートインストールに関する注意事項

JP1/IT Desktop Management 2 - Agentのダイアログボックスを閉じてからインストールしてください。

なお、次のダイアログボックスは自動で起動されることがあるので、特に注意してください。

ジョブエラー時のダイアログボックス

ITDM2_Startupから起動失敗したショートカットの削除確認ダイアログボックス

起動時の利用者情報の入力ダイアログボックス

［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックス

シャットダウンまたは再起動の確認ダイアログボックス

リモートインストール先のディスクには、リモートインストールするJP1/IT Desktop Management 2 - Agentの約3倍の空き容量が必要です。

ほかのパッケージと一緒にリモートインストールしないでください。

リモートインストールを実行してJP1/IT Desktop Management 2 - Agentを配布する場合、JP1/IT Desktop Management 2 - Agentと同じバージョンのパッケージャを使用してください。

パッケージングまたはリモートインストールのジョブ作成時に、［外部プログラム］パネルの「外部プログラム起動」で、インストール直後、およびインストールエラー時に起動する外部プログラムは指定できません。

インストール処理中にコンピュータを再起動するかJP1/IT Desktop Management 2 - Agentのメニューを操作すると、インストールが失敗することがあります。また、インストールの状況を示すダイアログで［キャンセル］ボタンをクリックするとインストールは中断されます。

インストール中のダイアログを表示させない場合、JP1/IT Desktop Management 2 - Agentのインストールが完了したあとに再起動が必要なときでもメッセージは表示されません。

次のようなジョブを実行しないでください。

1つのリモートインストールジョブでJP1/IT Desktop Management 2 - Agentを含む複数のパッケージを配布する。

JP1/IT Desktop Management 2 - Agentのリモートインストールジョブを含む複数のリモートインストールジョブを同時に実行する。

JP1/IT Desktop Management 2 - Agent以外のパッケージを配布する場合は、JP1/IT Desktop Management 2 - Agentの配布が完了したことを確認してから実行してください。

JP1/IT Desktop Management 2 - Agentのリモートインストールを正しく完了させるためには、リモートインストールが完了したあと、他製品をインストールする前に次のどちらかの方法でコンピュータを再起動してください。

手動でコンピュータを再起動する。

ほかのパッケージのリモートインストールジョブに「インストール後コンピュータを再起動する」を設定して実行する。

リモートインストールの実行結果は、配布管理システムの［ジョブ実行状況］ウィンドウで確認できます。

［ジョブ実行状況］ウィンドウから表示される［詳細情報］ダイアログボックスの「保守コード」が実行結果のリターンコードです。

リモートインストールを実行するジョブ種別の「クライアントユーザによるインストール」ジョブを実行し、管理対象のコンピュータのパッケージセットアップマネージャを使用したインストールでは、中継システムおよびエージェントのインストールはできません。

2.3　配布日時およびインストール日時を指定してソフトウェアを配布する

2.3.1　概要

スケジュールを設定してソフトウェアを配布できます。さらに、配布先でソフトウェアをインストールする日時や、システム起動時や終了時にインストールするといった、インストールのタイミングも指定できます。

例えば、同じインストール日時を指定したパッケージをあらかじめ複数のコンピュータに配布しておくことで、複数のコンピュータに同じタイミングでソフトウェアを導入するといった運用ができます。

インストール先のコンピュータでのインストール日時およびインストールのタイミングはソフトウェアのパッケージング時に指定できます。ジョブを実行する日時は、ジョブの作成時に指定できます。

日時を指定してジョブを実行する運用例　→　「7.6.5　決められた時刻にインストールする」

配布日時およびインストール日時を指定してソフトウェアを配布する流れを次の図に示します。

図2‒1　配布日時およびインストール日時を指定してソフトウェアを配布する流れ

2.3.2　操作手順

配布するソフトウェアを、インストール日時やジョブの実行タイミングを指定してパッケージングする。

パッケージングの手順　→　「7.1　パッケージングの方法」

パッケージのインストール日時の指定　→　「7.2.7　［スケジュール］パネル」

実行日時を指定したリモートインストールのジョブを作成する。

ジョブの作成手順　→　「7.3.1　リモートインストールの実行手順」

ジョブの実行日時の指定　→　「10.2.5　［スケジュール］パネルの設定」

ジョブを実行する。

ジョブの実行方法　→　「10.3　ジョブを実行、保存する」

実行されたジョブの実行順序　→　「1.3.7　ジョブの実行順序」

ジョブの作成時に設定したスケジュールに従って、ジョブが実行されます。コンピュータに配布されたパッケージは、パッケージング時に指定したスケジュールに従ってインストールされます。

ジョブの実行状況を確認する

実行状況の確認方法　→　「10.4.3　［ジョブ実行状況］ウィンドウで表示される項目」

失敗したジョブを再実行する

ジョブの再実行方法　→　「10.5.2　エラージョブの再実行」

2.3.3　注意事項

パッケージング時の注意事項　→　「7.1.4　パッケージング時の注意事項」

ジョブの実行状況確認時の注意事項　→　「10.4.2　ジョブの実行状況を確認するときの注意事項」

2.4　新規に追加された管理対象のコンピュータへ自動的にソフトウェアを配布する

2.4.1　概要

IDに条件（ポリシー）を設定すると、JP1/IT Desktop Management 2が管理するシステムに新規に追加されたコンピュータを自動的にIDに登録させることができます。

あらかじめ、IDに対してソフトウェア配布のジョブを実行しておくことで、新規に追加されたコンピュータへ自動的にソフトウェアを配布できます。これによって、ウィルス対策製品などのシステムの初期導入時に必要なソフトウェアを配布することで、セキュリティ対策に役立てることができます。

ID「ID_NEWCLT」を作成して、新規に追加されたコンピュータへ自動的にソフトウェアを配布する流れを次の図に示します。

図2‒2　新規に追加されたコンピュータへ自動的にソフトウェアを配布する流れ

2.4.2　操作手順

IDを作成する。

IDの作成方法　→　「5.3.2　IDの作成」

配布するソフトウェアをパッケージングする。

パッケージングの手順　→　「7.1　パッケージングの方法」

あて先にIDを指定したリモートインストールのジョブ（IDジョブ）を作成する。

ジョブの作成手順　→　「7.3.1　リモートインストールの実行手順」

ジョブ作成時のあて先の指定　→　「10.2.4　［あて先］パネルの設定」

IDジョブを実行する。

IDにポリシーを設定する。

新規に追加されたコンピュータが、自動的にIDに登録されるようになります。IDにコンピュータが新規登録されると、次回、上位システムとの接続が発生したタイミングで、IDジョブとして実行したジョブが自動的にコンピュータに実行されます。

IDへのポリシー設定手順　→　「6.3　IDの自動メンテナンス」

ジョブの実行状況を確認する

実行状況の表示　→　「10.4.3　［ジョブ実行状況］ウィンドウで表示される項目」

実行状況の確認方法　→　「10.4.5　IDジョブの実行状況の表示方法」

失敗したジョブを再実行する

ジョブの再実行方法　→　「10.5.2(2)　エラージョブの再実行方法」

2.4.3　注意事項

パッケージング時の注意事項　→　「7.1.4　パッケージング時の注意事項」

IDを使用する場合の注意事項　→　「5.3.5　IDを使用する場合の注意事項」

システム構成情報とIDを連携させる運用の注意事項　→　「5.4.3　システム構成情報とIDの連携時の注意事項」

IDジョブの実行状況確認時の注意事項　→　「10.4.5(3)　IDジョブの実行状況を確認するときの注意事項」

コンピュータを自動的にIDに追加する運用の注意事項　→　「6.3.2　IDの自動メンテナンス運用時の注意事項」

2.5　性能低下を回避するためにメンテナンスする

長期間にわたり運用を続けると、機器情報が蓄積されて、データベース容量を圧迫するだけではなく、データベースの検索や更新処理にも影響を及ぼし、システムの性能を低下させるおそれがあります。

次に示す項目はこのような性能低下を回避するためにCSVファイル出力などを使用して、情報の登録数を定期的に確認して不要な情報を削除することをお勧めします。

CSVファイル出力については、「11.1.1　CSV形式ファイルに出力できる項目」を参照してください。

なお、削除によるデータベースの断片化を解消するために、削除後にデータベースの再編成を行うこともお勧めします。

システム構成

CSVファイル出力であて先属性を出力して登録数を確認できます。

不要なホストは機器のメンテナンスで削除できます。

機器のメンテナンスについては、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」の機器の自動メンテナンスの説明を参照してください。

また不要な削除履歴の削除の詳細については、「6.5.4　削除履歴の削除」を参照してください。

インストールパッケージ情報

CSVファイル出力でインストール済みパッケージ情報を出力して登録数を確認できます。

インストールパッケージ情報の削除の詳細は「7.5　インストールパッケージ情報の削除」を参照してください。

ジョブ

ジョブ定義

リモートインストールマネージャの［ジョブ定義］ウィンドウで登録数を確認できます。

またフォルダを作成することでジョブを管理しやすくなります。

詳細は、「10.3.2　保存したジョブおよびフォルダの管理」を参照してください。

ジョブの実行結果

CSVファイル出力でジョブ実行状況を出力して登録数を確認できます。

［ジョブ実行状況］ウィンドウからだけでなく、コマンドでもジョブの実行と削除ができます。

ジョブの削除については、「10.5.1　ジョブの削除」を参照してください。

なお、ジョブの実行結果の保存の設定で不要なジョブの実行結果を記録しないようにすることでディスク容量を削減できます。

設定方法については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」の管理用サーバをセットアップする手順の説明を参照してください。

注意事項

ジョブが大量に溜まると、管理用サーバの性能が劣化します。実行完了したジョブなど不要なジョブは［ジョブ実行状況］ウィンドウから定期的に削除してください。

パッケージ

CSVファイル出力でパッケージ属性を出力して登録数を確認できます。

［パッケージ］ウィンドウだけでなく、コマンドでもパッケージ登録と削除ができます。

パッケージの削除については「7.4.5　キャビネットおよびパッケージの削除」を参照してください。

3　システム設計

ここでは、リモートインストールマネージャを使用した配布機能を利用する場合のシステム設計時に必要な検討事項について説明します。JP1/IT Desktop Management 2全体のシステム設計については、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」のシステム設計の説明を参照してください。システム設計後に、JP1/IT Desktop Management 2システムを構築します。構築方法については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」の各システム構成の構築の説明を参照してください。

3.1　ネットワーク環境の検討

JP1/IT Desktop Management 2で使用するネットワーク環境について説明します。また、ファイアウォールを使用したシステムや複数LAN接続環境で、JP1/IT Desktop Management 2を使用する場合に必要な設定について説明します。

3.1.1　配布機能のネットワーク環境

JP1/IT Desktop Management 2では、TCP/IPプロトコルだけを使用しています。そのため、Windows Serverなどの特定のネットワークOSに依存しません。複数のネットワークOSや管理対象のコンピュータ側の通信プログラム（TCP/IPプロトコルスタック）が混在する環境でも利用できます。

ホスト名の管理にはWINSまたはDNSのどちらでも利用できます。ただし、1台のネームサーバですべてのコンピュータが管理されるようなシステムはお勧めできません。このようなシステムは名前解決のための問い合わせが1台のネームサーバに集中し、システムの性能を著しく低下させる場合があるためです。このような場合は、hostsファイルで名前を管理する方が、ネットワークの負荷を軽減できます。

注意事項

リモートインストールマネージャを使用した配布のネットワーク帯域を制御する場合、流量制御の設定が異なる複数のコンピュータを配布先に指定して同時にジョブを実行すると、流量制御の設定に関わらず、ジョブの完了までの時間が遅くなることがあります。流量制御の設定に応じた時間でジョブを完了させたい場合は、同じ流量制御の設定のコンピュータだけを配布先に指定してジョブを実行するようにしてください。

3.1.2　ホストを識別する運用キーの決定

ホストを識別するキーには、ホスト識別子とノード識別キーの2種類があり、どちらもJP1/IT Desktop Management 2のホストを識別する運用キーとして使用できます。

ホスト識別子

ホスト識別子は、JP1/IT Desktop Management 2内で一意な値であり、各コンピュータを識別するキー情報です。そのため、ホスト識別子は、次に説明するノード識別キーに比べて、ネットワーク構成の変化による影響を受けません。ホスト識別子はJP1/IT Desktop Management 2 - Agentのインストール時に生成され、JP1/IT Desktop Management 2 - Agentのホスト識別子管理ファイルに保管されます。

ノード識別キー

ノード識別キーには、ホスト名またはIPアドレスが使用できます。どちらで管理するかはセットアップ時に選択します。両方を混在して使用することはできないので、JP1/IT Desktop Management 2の運用を開始する前に、どちらを使用するか決めておいてください。

使用するノード識別キーを運用の途中で変更することもできますが、次の情報を削除する必要があります。

システム構成情報

あて先

ジョブ定義

ジョブ実行状況

JP1/IT Desktop Management 2のホストを識別する運用キーを決定するため、ノード識別キーとして、ホスト名とIPアドレスのどちらを使用するかを検討してください。

(1)　ノード識別キーの選択

JP1/IT Desktop Management 2を使用するネットワークで、ノード（ホスト）を管理するときに使用する名称をノード識別キーと呼びます。ノード識別キーとして、ホスト名またはIPアドレスが使用できます。

ホスト名とIPアドレスを混在して使用することはできないため、運用を開始する前に、どちらのノード識別キーを使用するかを決めておく必要があります。なお、配布管理システムを階層化したシステムでは、システム全体でノード識別キーを統一する必要はありません。管理用中継サーバが管理するシステム内でノード識別キーを統一してください。

(a)　ホスト名でJP1/IT Desktop Management 2のノードを管理する場合

次に示すシステムでは、ホスト名を使用してノードを管理してください。

ファイアウォールを設置しているシステム

DHCPを使用しているシステム

ホスト名は、「5.1.2　JP1/IT Desktop Management 2でのホスト名の付け方」で示す規則に従って付けてください。

(b)　IPアドレスでJP1/IT Desktop Management 2のノードを管理する場合

ネットワーク内のノードをホスト名で管理しにくいシステムでは、IPアドレスを使用してノードを管理できます。IPアドレスでノードを管理する場合、中継システムと管理対象のコンピュータは、hostsファイルなど名称解決のための定義は不要ですが、管理用中継サーバは定義する必要があります。

3.1.3　TCP/IP環境の設定

JP1/IT Desktop Management 2をインストールする前に、TCP/IPの環境を整えておく必要があります。必要な作業を次に示します。

ホスト名とIPアドレスの定義

ノード識別キーとしてIPアドレスを使用する場合、中継システムと管理対象のコンピュータはホスト名を定義する必要はありませんが、管理用中継サーバはホスト名を定義する必要があります。

(1)　ホスト名とIPアドレスの定義

事前にユーザネットワークでホスト名とIPアドレスを定義しておく必要があります。

ノード識別キーとして、ホスト名を使用する場合、配布管理システムのウィンドウ（［システム構成］や［あて先］ウィンドウ）では、ユーザネットワークで定義したホスト名を使用します。配布管理システムのウィンドウでホスト名を変更したときは、ユーザネットワークのホスト名の定義も変更してください。

JP1/IT Desktop Management 2 - Managerでは、コンピュータを識別するためにTCP/IPのホスト名を使っています。そのため、JP1/IT Desktop Management 2 - Managerを導入するPCで、コンピュータのホスト名からIPアドレスを決定できなければなりません。

ホスト名とIPアドレスを定義したり、配布管理システムでコンピュータのホスト名からIPアドレスを決定したりするには、次の方法があります。

DHCPとWINSを利用する。

DNSを利用する。

hostsファイルを編集する。

次にそれぞれの方法について説明します。

(a)　DHCPとWINSを利用する

DHCPを使うと動的にコンピュータのIPアドレスが決定されるため、IPアドレスの割り当て、保守作業を軽減できます。ただし、JP1/IT Desktop Management 2では、動的に変更されるIPアドレスをノード識別キーとして利用できないため、DHCPを使う場合には、ノード識別キーとしてホスト名を使用してください。

また、WINSを使って各PCのホスト名を管理することで、各PCでホスト名の定義をする必要がなくなります。サブネット間を移動したPCにDHCPによって新しいIPアドレスが動的に割り当てられた場合も、変更に応じてWINSデータベースが自動的に更新されるため、手動で定義を変更する必要はありません。

コンピュータがシャットダウンすると、WINS上の情報が解放されるため、JP1/IT Desktop Management 2ではコンピュータのホスト名からIPアドレスを決定できなくなり、ジョブがエラーとなることがありますので、注意してください。DHCPおよびWINSの設定方法は、Windowsのヘルプを参照してください。

(b)　DNSを利用する

インターネットで接続されているホストを接続先にする場合は、DNSを使用します。DNSで管理されるホスト名は、JP1/IT Desktop Management 2で定義すれば、ドメインを超えてリモートインストールなどのジョブを実行できます。

DNSの設定方法は、Windowsのヘルプを参照してください。

DNSを使用する場合の注意事項を次に示します。

DNSを利用する場合、TCP/IPプロトコルのネットワークソフトウェアを設定する必要があります。コンピュータが属するドメイン名と名前を管理するサーバのIPアドレスを指定してください。

ホスト名からIPアドレスへの変換、およびIPアドレスからホスト名への変換（逆引き）の両方ができるように設定してください。

hostsファイルとDNSを併用する場合、名前の解決にDNSを使用するホストの完全修飾ドメイン名（ホスト名のあとにピリオドとドメイン名を表記した名前）を、別のホスト名としてhostsファイルに記述しないでください。

ネットワークプロバイダに直接接続されたリモートホストなどは、割り当てられているホスト名が一時的な名称となっていることがあります。このようなホストについては、JP1/IT Desktop Management 2では管理できません。

(c)　hostsファイルを編集する

DHCP、WINS、DNSを利用しない場合は、ホストごとに接続先のホスト名を定義します。配布管理システムが動作しているホストでは、接続している中継システム、管理用中継サーバ、および管理対象のコンピュータのホスト名とIPアドレスが定義されている必要があります。また、JP1/IT Desktop Management 2 - Agentの動作しているホストでは、配布管理システムのホスト名とそのIPアドレスが定義されている必要があります。

ホスト名とIPアドレスを定義するには、次のファイルを編集してください。

Windowsディレクトリ¥system32¥drivers¥etc¥hosts

（形式）

IPアドレス ホスト名 別名

（例）

192.0.0.1 hostA NetworkA-hostA

192.0.0.2 hostB NetworkA-hostB

(2)　JP1/IT Desktop Management 2 - Agent（エージェント）を使用する場合

JP1/IT Desktop Management 2 - Agent（エージェント）を使用する場合は、次の項目を確認してください。

TCP/IPの確認

［コントロールパネル］−［ネットワーク］を選択して［ネットワークの設定］パネルで、「現在のネットワーク構成」にTCP/IPがあることを確認してください。TCP/IPがない場合は、［ネットワークの設定］パネルの［追加］ボタンをクリックして、TCP/IPを追加してください。

次に［ネットワークの設定］パネルで「TCP/IP」を選択して、［プロパティ］ボタンをクリックしてください。［TCP/IPのプロパティ］ダイアログボックスが表示されますので、ネットワークに必要な設定がされていることを確認してください。

通信環境ファイルの設定

Windowsディレクトリ（デフォルトでは「windows」）下に、hostsファイルがあります。hostsファイルには、接続先の上位ホスト名とそのIPアドレスを定義してください。

3.1.4　ファイアウォール環境での配布機能の運用

JP1/IT Desktop Management 2は、ファイアウォールを使用しているシステムでも、セキュリティのレベルを下げることなく運用できます。例えば、配布管理システムが設置された配布拠点と中継システムが設置された各部門のネットワークが、それぞれ、ファイアウォールで管理されていても、配布管理システムから中継システムへソフトウェアを配布できます。

ここでは、ファイアウォールを使用した環境で、JP1/IT Desktop Management 2を運用する方法について説明します。

ファイアウォールを使用した環境でJP1/IT Desktop Management 2を運用する場合、ファイアウォールにJP1/IT Desktop Management 2で使用するポート番号を設定する必要があります。ポート番号については、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」のポート番号の説明を参照してください。

(1)　使用できるファイアウォール

JP1/IT Desktop Management 2で使用できるファイアウォールには、次の方式があります。

パケットフィルタリング方式

アプリケーションゲートウェイ方式

(a)　パケットフィルタリング方式ファイアウォール

設定によってファイアウォールを通過するパケットを制限する、ファイアウォール実現方式の一つです。

パケットフィルタリング方式のファイアウォールの場合は、該当するノードのIPアドレスとポート番号を設定することで、JP1/IT Desktop Management 2が使用できるようになります。

(b)　アプリケーションゲートウェイ方式ファイアウォール

パケットの中継を禁止し、アプリケーションゲートウェイでアクセスを制御する、ファイアウォール実現方式の一つです。

アプリケーションゲートウェイ方式のファイアウォールの場合は、ゲートウェイでアプリケーションごとにアクセスを制御するので、JP1/IT Desktop Management 2をアクセス可能なアプリケーションに設定する必要があります。

3.1.5　複数LAN接続環境での配布機能の運用

1台のPCにNICなどの複数のネットワークアダプタが存在する複数LAN接続環境でも、JP1/IT Desktop Management 2を運用できます。

JP1/IT Desktop Management 2では、次の2種類の複数LAN接続環境での運用をサポートしています。

複数ネットワークに分かれている環境

ネットワークが多重化されている環境

次にこれらの環境でのJP1/IT Desktop Management 2の運用を説明します。

(1)　複数のネットワークに分かれている環境

複数のネットワークに分かれている環境の例を次に示します。

図3‒1　複数のネットワークに分かれている環境の例

複数のネットワークに分かれている環境でも、ジョブの実行要求に、要求元の上位システムのIPアドレスが格納されているため、管理対象のコンピュータは正しいあて先にジョブの受信要求を送信できます。

上位システムからのジョブの実行要求時

下位システムとソケットコネクションが確立できた自システムのIPアドレスを取得し、要求元IPアドレスとして下位システムに通知します。

下位システムからのジョブの受信要求時

上位システムからのジョブの実行要求時に通知された要求元IPアドレスに対してソケットコネクションを確立し、ジョブの受信を要求します。

(2)　ネットワークが多重化されている環境

ネットワークが多重化されている環境の例を次に示します。

図3‒2　ネットワークが多重化されている環境の例

ネットワークが多重化されている環境の場合、通常はメインのネットワークを使い、トラブルが発生した場合などには、バックアップのネットワークに切り替えて使うという運用が考えられます。また、JP1/IT Desktop Management 2が使用する通信回線は、メインのネットワークだけに限定して使用するという運用も考えられます。

このような運用に対応するには、各エージェント設定で、ネットワークアダプタの優先順位を設定する必要があります。エージェント設定の［通信設定］−［複数の上位システムへのポーリングの設定］を設定してください。

3.1.6　ネットワークに負荷を掛けない運用方法

JP1/IT Desktop Management 2では、配布するソフトウェアや、さまざまな管理情報を、ネットワークを経由して転送します。このため、より効率的な運用のためには、ネットワークの混み合う時間帯を避けてジョブを実行するなど、ネットワークにできるだけ負荷を掛けない工夫が必要です。JP1/IT Desktop Management 2には、セットアップ時にネットワークのトラフィックを調整したり、インストールするソフトウェアを分割して配布したりするなど、ネットワークの負荷を軽減するための幾つかの機能があります。この節では、ネットワークの負荷を小さくして効率良くソフトウェアを配布する方法を紹介します。なお、JP1/IT Desktop Management 2でのソフトウェアの配布を効果的に行うためには、配布管理システムだけでなく、管理対象のコンピュータ側での設定や操作も必要です。管理対象のコンピュータでのユーザの作業については、「12.　エージェントを操作する」を参照してください。

(1)　中継システムの利用

リモートインストール時に、効率的にパッケージを転送するためには、中継システムの役割を理解しておく必要があります。

中継システムは、配布管理システムに直接接続する管理対象のコンピュータの数を減らして負荷を分散させるだけでなく、パッケージのコピーを作成・保管することで、中継システム下の管理対象のコンピュータへ効率的にパッケージを転送します。また、「中継までのパッケージの転送」ジョブと「パッケージのインストール」ジョブを組み合わせて、2段階に分けてパッケージを転送できます。

リモートインストール時の中継システムの動作を次の図に示します。

図3‒3　リモートインストール時の中継システムの動作

「中継までのパッケージの転送」ジョブは、中継システムに保管されるため、保管されている間は同一のパッケージであれば配布管理システムから再配布されることはありません。パッケージの保管期限はパッケージング時に指定できます。

(2)　同時に接続するホストの台数の調整

契約回線が少ない場合や、ネットワークに対するトラフィックを掛けられない場合などは、同時に接続するホストの台数をチューニングする必要があります。配布管理システムで、同時に接続するホストの台数を調整するには、次の方法があります。

セットアップまたはエージェント設定で調整する。

ジョブ実行時にユーザの運用で調整する。

(a)　セットアップまたはエージェント設定で調整する

配布管理システムでは、セットアップで、ネットワークのトラフィックを制御できます。メニューから［セットアップ］を選択してセットアップ画面を起動し、［リモートインストールマネージャを使用した配布のセットアップ］画面の［サーバカスタマイズオプション］パネルを表示してください。中継システムの場合は、エージェント設定の［中継システムの設定］で設定します。

図3‒4　［サーバカスタマイズオプション］パネル

同時に接続するホストの台数を調整する項目は［ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数］（中継システムの場合はエージェント設定の［中継システムの設定］−［中継システムの処理の設定］の［同時実行する数を指定してジョブを実行する］）です。

配布管理システムが、一度に多数のコンピュータを対象としてジョブを実行すると、ネットワークの負荷が非常に大きくなります。そこで、［ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数］を設定すると、同時に処理する下位ホストの数を制限できます。例えば、［ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数］を20台に設定した場合、300台のコンピュータに対してリモートインストールを実行すると、内部的には、20台ずつ15回に分けてジョブが実行されます。

(b)　ユーザの運用で調整する

セットアップ時に、PCの性能、ネットワーク構成、動作環境などを考慮した値を設定しておくことで、ほとんどの場合十分な信頼性を得ることができます。しかし、配布するデータ量が大きい場合には、配布するデータ量を制御しても、ネットワークの負荷が高くなるおそれがあるので、最終的にはユーザの運用によって調整する必要があります。

ジョブの対象コンピュータ数の調整

例えば、5メガバイトのパッケージを64Kbpsの回線で送信する場合、回線効率を60%とすると、約18分掛かります。これが、配布管理システムと中継システム、および中継システムと管理対象のコンピュータの間の接続回線上を並行して流れることになります。この数値を基に、接続回線の負荷を考慮して、1つのジョブで配布対象とするコンピュータ数を決定してください。

同時に接続する中継システム数の調整

配布管理システムに、同時に多数の中継システムが接続しないようにするためには、ジョブを分割して実行することをお勧めします。ユーザに負担を掛ける運用方法ですが、確実にネットワークの負荷を軽減できます。

まず、ネットワークのトラフィックなどを考慮して、配布管理システムに同時に接続する中継システムを決めます。次に、同時に接続する中継システム下のすべての管理対象のコンピュータを1つのグループとして分類します。ジョブを実行するときは、これらのグループごとに一定の間隔（1つのジョブの処理に掛かる時間）を空けたスケジュールで実行します。これによって、配布管理システムに、同時に多数の中継システムが接続することを防ぐことができます。

(3)　スケジュール配布

リモートインストールのジョブを作成するとき、ジョブの実行日時を指定できます。これがパッケージの転送日時となります。ネットワークが比較的空いている夜間などを指定しておくと、効率良く転送できます。

また、中継システムまでのパッケージの転送と、中継システムから管理対象のコンピュータへの転送を別のジョブで実行すると、配布管理システム−中継システム間、中継システム−管理対象のコンピュータ間のパッケージの転送時刻を、別々に設定できます。

転送するデータ量を減らすのではなく、転送時間を工夫することで、ネットワークに掛かる負荷を軽減できます。

なお、配布先のPCが省電力モードの状態のとき、JP1/IT Desktop Management 2 - Agent（エージェント）は動作しないため、ソフトウェアの配布が実行されません。配布先のPCに省電力モード対応のPCがある場合、ジョブのスケジュールを指定するときは注意が必要です。

(4)　パッケージの分割配布

コンピュータにインストールするソフトウェアを一度に配布するのではなく、分割して配布する方法があります。これを分割配布と呼びます。分割配布を使用すると次のメリットがあります。

大容量のパッケージの配布時に、ネットワークの負荷を軽減して配布できる。

分割したパッケージの間には、インターバル（転送休止時間）を置くことができる。

配布する経路の途中に中継システムや管理用中継サーバがある場合は、パッケージの分割サイズやインターバルの時間を変更できる。

分割配布の途中で配布を完了したい場合は、分割配布の強制完了で未転送のパッケージを一括して転送（通常配布）し、配布を完了できる。

パッケージの分割配布を利用したソフトウェアの配布を次の図に示します。

図3‒5　パッケージの分割配布を利用したソフトウェアの配布

(5)　ジョブのマルチキャスト配布

通常のソフトウェアの配布では、コンピュータ数が増加すると、上位システムから送信するパケット数も増加します。このパケットの送信量を削減するために、上位システムから1ジョブ分のパケットを送信するだけで、指定した多数のコンピュータへソフトウェアを配布できる方法があります。これを、マルチキャスト配布と呼びます。

ソフトウェアの配布時に、マルチキャスト配布を指定すると、パケットの送信量が削減できます。そのため、配布時間を短縮したり、ネットワークの負荷を軽減したりできます。マルチキャスト配布は、次の場合に効果的です。

同時に多数のコンピュータにソフトウェアを配布する場合

大容量のソフトウェアを配布する場合

マルチキャスト配布を利用したソフトウェアの配布を次の図に示します。マルチキャスト配布は、コンピュータと、その接続先の上位システム間だけで有効です。

図3‒6　マルチキャスト配布を利用したソフトウェアの配布

マルチキャスト配布をするためのシステム構成と設定については、「3.2　マルチキャスト配布をするための設定」を参照してください。

(6)　ジョブの中断と再開

リモートインストール、またはパッケージ転送中のホストに対して、一時的にジョブの実行を中断できます。例えば、業務停止中に実行する予定のジョブが業務開始までに完了しなかった場合に、実行中のジョブを中断し、業務終了後に再開できます。

また、ジョブの中断中に、特定のジョブだけを中断させないで配布することもできます。例えば、ウィルス定義ファイルを急いで配布したい場合に、ほかの配布ジョブを中断して、ウィルス定義ファイルを先に配布できます。

(a)　ジョブの中断と再開の仕組み

ジョブを中断または再開するには、次の方法があります。

配布管理システムから中継システムおよび管理用中継サーバに中断または再開を指示する。

配布管理システム自身に対して中断または再開を指示する。

配布管理システムでdcmsuspコマンドを実行する。

dcmsuspコマンドについては、「14.17　dcmsusp.exe（ファイル転送の中断と再開）」を参照してください。

なお、中断できるファイル転送の単位は、4,096バイトです。

配布管理システムから中継システムおよび管理用中継サーバに中断または再開を指示する

配布管理システムから「ファイル転送の中断」ジョブおよび「ファイル転送の再開」ジョブを実行して指示します。これらのジョブのあて先には、ジョブを中断したいホストが直接接続している上位システムを指定します。

「ファイル転送の中断」ジョブ実行時のシステムの動作を次の図に示します。

図3‒7　「ファイル転送の中断」ジョブ実行時のシステムの動作

配布管理システムから中継システムおよび管理用中継サーバに対して「ファイル転送の中断」ジョブを実行する。

「ファイル転送の中断」ジョブのあて先の中継システムおよび管理用中継サーバが「中断状態」になる。

中断状態の中継システムおよび管理用中継サーバと、その直下のシステムとの間のファイル転送が中断され、下位システムあてのジョブの実行状態が「中断中」になる。

「ファイル転送の再開」ジョブ実行時のシステムの動作を次の図に示します。

図3‒8　「ファイル転送の再開」ジョブ実行時のシステムの動作

配布管理システムから中断状態の中継システムおよび管理用中継サーバに対して「ファイル転送の再開」ジョブを実行する。

「ファイル転送の再開」ジョブのあて先の中継システムおよび管理用中継サーバで中断状態が解除され、下位システムあてのジョブの実行状態が「再開中」になる。

中断されていたファイル転送が再開され、ジョブの実行状態が「実行中」に戻る。

配布管理システム自身に対して中断または再開を指示する

リモートインストールマネージャで、自システムに対して中断または再開を指示できます。リモートインストールマネージャから指示する場合は、［実行］メニューの［ファイル転送の中断/再開］から［中断させる］または［再開させる］を選択してください。

自システムに対する中断または再開時のシステムの動作を次の図に示します。

図3‒9　自システムに対する中断または再開時のシステムの動作

リモートインストールマネージャのメニューから［中断させる］を選択する。

自システムが「中断状態」になる。

自システムと直下のシステムとの間のファイル転送が中断され、下位システムあてのジョブの実行状態が「中断中」になる。

リモートインストールマネージャのメニューから［再開させる］を選択する。

自システムの中断状態が解除され、下位システムあてのジョブの実行状態が「再開中」になる。

中断されていたファイル転送が再開され、ジョブの実行状態が「実行中」に戻る。

(b)　中断中にジョブを配布する

あて先の直上のシステムが中断状態になっていても、ファイル転送を中断させないでジョブを配布できます。ジョブの作成時に、［ジョブの作成］ダイアログボックスの［ジョブの配布属性］パネルで、「中断中でも配布する」を選択してください。

中断中のジョブの配布を次の図に示します。

図3‒10　中断中のジョブの配布

ジョブの中断時には、システムが中断状態になった時点でその直下のシステムとのファイル転送が中断されますが、「中断中でも配布する」を選択すると、そのジョブのファイル転送が中断されなくなります。

(c)　ジョブの中断と再開の適用範囲

ジョブの中断と再開の適用範囲を次に示します。

中断できるジョブは次の3種類です。

「パッケージのインストール」ジョブ

「中継までのパッケージの転送」ジョブ

「クライアントユーザによるインストール」ジョブ

「ファイル転送の中断」および「ファイル転送の再開」ジョブは、配布管理システムで作成します。

(7)　クライアント制御の利用

ネットワーク経由で、手元のPCから離れた場所にあるPCを起動したり、シャットダウンしたりする機能があります。この機能をクライアント制御と呼びます。この機能を使って、JP1/IT Desktop Management 2では、深夜や休日などの電源が入っていない状態のPCに対してソフトウェアをリモートインストールできます。

ただし、この機能を利用するには、PCがAMTまたはWake on LANに対応し、さらに自動シャットダウンに対応していることが必要です。また、UNIXエージェントの場合、ジョブ実行後にシャットダウンすることはできません。加えて、UNIXエージェント、Macエージェントに適用する「コンピュータ（UNIX）のシステム情報の取得」ジョブ、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブでは、シャットダウンの指定はできません。

クライアント制御を利用したリモートインストールの概要を次の図に示します。

図3‒11　クライアント制御を利用したリモートインストール

クライアント制御を利用したリモートインストールの注意事項については、「3.3　クライアント制御を利用するための設定」を参照してください。

(8)　オフラインインストールの利用

JP1/IT Desktop Management 2 - AgentがインストールされたスタンドアロンPC（オフラインマシン）に対して、ネットワークを介さないでソフトウェアをインストール（オフラインインストール）できます。

オフラインインストールは、配布管理システムでインストールに必要なファイルを媒体に格納し、その媒体をオフラインマシンに搬送して実行します。

オフラインインストールの実行方法の詳細については、「7.3.4　オフラインインストール」を参照してください。

3.2　マルチキャスト配布をするための設定

ジョブ作成時にマルチキャスト配布を指定すると、通常の配布方式に比べてデータの送信量を削減できます。そのため、ネットワークの負荷を軽減でき、配布時間を短縮できます。

この節では、マルチキャスト配布の概要およびマルチキャスト配布をするためのシステム構成について説明します。また、実際にマルチキャスト配布をする方法や、マルチキャスト配布時の注意事項についても説明します。

3.2.1　ユニキャスト配布とマルチキャスト配布

JP1/IT Desktop Management 2のジョブの配布方式には、ユニキャスト配布とマルチキャスト配布の2種類があります。配布方式はジョブごとに設定できます。

上位システムから管理対象のコンピュータへ1対1でジョブのパケットを送信する通常の方式を、ユニキャスト配布と呼びます。ユニキャスト配布では、上位システムは、送信先のコンピュータごとにパケットを送信する必要があります。そのため、パケットの送信数は、コンピュータ数の増加に対応して増大します。

一方、マルチキャスト配布は、IPマルチキャストプロトコルを利用して、特定の多数のコンピュータへパケットを送信する方式です。マルチキャスト配布では、上位システムはマルチキャストグループと呼ばれる概念上のグループにパケットを送信します。パケットは、そのグループに所属している各コンピュータに配信されます。コンピュータ数に関係なく、上位システムはマルチキャストグループだけにパケットを送信すればよいため、送信量を削減できます。

マルチキャストグループは、マルチキャストアドレスというグループ固有のIPアドレスを持っています。実際には、パケットはこのマルチキャストアドレスに対して送信されます。コンピュータ側では、エージェント設定でマルチキャストアドレスを設定し、マルチキャストグループにそのコンピュータを登録しておきます。マルチキャストアドレスに対して送信されたパケットは、マルチキャストグループに登録されている全コンピュータに配信されます。このとき、重複する経路は1パケットだけが流れるため、回線を圧迫することなく効率良く配布できます。

ユニキャスト配布とマルチキャスト配布の概念を、次の図に示します。

図3‒12　ユニキャスト配布とマルチキャスト配布の概念

(1)　マルチキャスト配布の対象となるジョブ

JP1/IT Desktop Management 2では、「パッケージのインストール」ジョブだけがマルチキャスト配布の対象になります。次のようなジョブにマルチキャスト配布を適用すると、効果的に通信量を削減できます。

あて先の数が多いジョブ

大容量のパッケージを配布するジョブ

ジョブのあて先が少ない場合や、パッケージの容量が小さい場合は、マルチキャスト配布するとかえって効率が悪くなります。その場合は、ジョブ作成時にユニキャスト配布を設定してください。

なお、ジョブ作成時に「マルチキャスト配布」を選択するか「ユニキャスト配布」を選択するかは、ジョブの配布方式の設定であって、ジョブのあて先の設定とは関係ありません。ジョブのあて先が個別のホスト、あて先グループ、IDの場合を問わず、指定したあて先にマルチキャスト方式で配布されます。指定したあて先の中にマルチキャストグループに登録されていないコンピュータがあった場合は、そのコンピュータにだけユニキャスト方式で配布されます。

(2)　マルチキャスト配布が適用される経路

JP1/IT Desktop Management 2では、ジョブにマルチキャスト配布を指定すると、管理対象のコンピュータと直接接続する上位システムの間だけマルチキャスト配布方式でパケットが送信されます。ジョブを実行したシステムから管理対象のコンピュータが直接接続する上位システムまでの経路は、ユニキャスト配布になります。

3.2.2　マルチキャスト配布に必要なネットワーク環境

マルチキャスト配布するには、次のネットワーク環境が前提となります。

管理対象のコンピュータが接続する上位システムから管理対象のコンピュータまでの間にルータを設置する場合は、IPマルチキャスト対応のルータを使用し、IPマルチキャストに関しての設定をする必要があります。経路上にIPマルチキャストに対応していないルータがある場合、その先のセグメントにはジョブはユニキャスト配布されます。

3.2.3　マルチキャスト配布をするためのシステム構成

マルチキャスト配布を実現するために、どのようなシステム構成にしたらよいかを説明します。

(1)　マルチキャスト配布の標準的なシステム構成

マルチキャスト配布を実現するための標準的なシステム構成と、パケットの流れを次の図に示します。

図3‒13　標準的なマルチキャスト配布のシステム構成とパケットの流れ

マルチキャストグループは、管理対象のコンピュータが接続する上位システム単位に作成します。そして、各マルチキャストグループには、それぞれ別のマルチキャストアドレスを割り当てます。説明の番号は、図中の番号と対応しています。1と2はシステム構成の設定、3と4はジョブの実行によるパケットの流れです。

中継システムAに接続するコンピュータ群をマルチキャストグループA、中継システムBに接続するコンピュータ群をマルチキャストグループBとします。マルチキャストグループAのコンピュータ群には239.255.0.1を、マルチキャストグループBのコンピュータ群には239.255.0.2を、マルチキャストアドレスとして設定します。

中継システムAにマルチキャストグループAのマルチキャストアドレス（239.255.0.1）を、中継システムBにマルチキャストグループBのマルチキャストアドレス（239.255.0.2）を設定します。

こうすることで、中継システムAはマルチキャストグループAのコンピュータ群へ、中継システムBはマルチキャストグループBのコンピュータ群へジョブをマルチキャスト配布できます。

配布管理システムで、「マルチキャスト配布」を指定したジョブを作成し、実行します。

配布管理システムは、各中継システムに1ジョブ分ずつパケットを送信します。この例では、中継システムが2つ接続しているので、2ジョブ分のパケットを送信します（ユニキャスト配布）。中継システムAおよび中継システムBまでは、ユニキャスト配布されます。

中継システムAおよび中継システムBは、コンピュータ数に関係なく、1ジョブ分だけパケットを送信します。各コンピュータまでの重複する経路上は、1ジョブ分のパケットが流れます（マルチキャスト配布）。

同じ構成でジョブをユニキャスト配布した場合は、管理対象のコンピュータが接続する上位システムからは、あて先となるコンピュータ数だけジョブのパケットが流れます。そのため、4の経路では、中継システムAおよび中継システムBからそれぞれ3倍のパケットが送信されます。

なお、配布管理システムに直接管理対象のコンピュータを接続している構成でも、ジョブをマルチキャスト配布できます。その場合、配布管理システムに、配布先のマルチキャストグループのマルチキャストアドレスを設定します。

3.2.4　マルチキャスト配布の実行方法

システム構成を決定したあと、次の手順でマルチキャスト配布を実行します。

マルチキャスト配布の送信側と受信側で、マルチキャスト配布の設定をする。

配布管理システムでジョブを作成するとき、配布方式に「マルチキャスト配布」を指定する。

次に各手順を説明します。

(1)　セットアップ

管理対象のコンピュータが接続する上位システムで、マルチキャスト配布の設定をします。次の個所で設定してください。

JP1/IT Desktop Management 2 - Managerでの設定

セットアップの［リモートインストールマネージャを使用した配布のセットアップ］画面の［マルチキャスト配布］パネル、またはエージェント設定の［通信設定］−［マルチキャスト配布の設定］

このセットアップで、ポート番号とマルチキャストアドレスを設定します。パケットサイズも指定します。設定したマルチキャストアドレスに対して、ジョブは配布されます。なお、セットアップでマルチキャスト配布の設定をしても、ユニキャスト配布を指定したジョブはユニキャスト配布されます。

セットアップ時の注意事項

管理対象のコンピュータの接続先の上位システムよりも上位のシステムでは、セットアップにマルチキャスト配布の設定をする必要はありません。例えば、マネージャ、中継システム、管理対象のコンピュータの順に接続している場合、マネージャのセットアップは不要です。

管理対象のコンピュータが接続する上位システムと管理対象のコンピュータの間に、IPマルチキャストに対応していないルータがある場合は、マルチキャスト配布はできなく、ユニキャスト配布になります。この場合、管理対象のコンピュータが接続する上位システムおよび中継システムで、マルチキャスト配布の設定をしないでください。マルチキャスト配布の設定をしていると、ユニキャスト配布に切り替わるまでに時間が掛かります。

(2)　マルチキャスト配布を指定したジョブの作成

マルチキャスト配布は、ジョブ単位で指定できます。ジョブをマルチキャスト配布したい場合、［ジョブの作成］ダイアログボックスの［ジョブの配布属性］パネルで、「配布方式」に「マルチキャスト配布」を指定します。ジョブの作成の詳細については、「7.3　リモートインストールの実行」を参照してください。

3.2.5　マルチキャスト配布をする場合の注意事項

マルチキャスト配布をする場合、次の点に注意してください。

ネットワーク内で、複数の中継システムおよび管理用中継サーバに同一のマルチキャストアドレスを設定すると、それらに接続するコンピュータには、複数の中継システムおよび管理用中継サーバからジョブがマルチキャスト配布されます。ジョブの配布の重複を避けるため、中継システムおよび管理用中継サーバごとに一意のマルチキャストアドレスを使用してください。

管理対象のコンピュータとその上位システムのマルチキャストアドレスが異なる場合、ジョブにマルチキャスト配布を指定してもユニキャスト配布されます。例えば、トラブルによって中継システムがダウンした場合、一時的にマルチキャストアドレスの異なるほかの中継システムを経由してジョブを実行すると、ユニキャスト配布になります。

分割配布を指定したジョブは、マルチキャスト配布できません。

マルチキャスト配布時にエージェントが未起動の場合、または管理対象のコンピュータの電源が入っていない場合、エージェントが起動したあと、または管理対象のコンピュータの電源が入ったあとにマルチキャスト配布されます。

コンピュータがマルチキャスト配布されたジョブを完全に受信できなかった場合、受信できなかった部分以降のデータが自動的にユニキャスト配布されます。

ジョブの作成時、「マルチキャスト配布」とクライアント制御の「対象のコンピュータが稼働していない場合に起動する」は同時に指定しないでください。両方指定してジョブを実行すると、電源がオフのコンピュータに対しては配布時間が長くなります。電源がオフのコンピュータに対してマルチキャスト配布したい場合は、対象のコンピュータを起動してから実行してください。

マルチキャスト配布を指定したジョブを実行して数分後に、パッケージをユニキャストで受信してしまう（ダウンロード中のダイアログが表示される）マシンが存在する場合、エージェント設定の［通信設定］−［マルチキャスト配布の設定］−［ジョブ送信パケットサイズの上限値］の値を小さく（数KB程度）して下さい。

ただし、この値を小さくすると、パッケージのダウンロード時間が反比例で長くなります。例えば、パケットサイズを半分にすると、ダウンロード時間は2倍になります。

3.3　クライアント制御を利用するための設定

クライアント制御を利用するために必要な設定と注意事項について説明します。

クライアント制御で管理対象のコンピュータを起動するには、Wake on LANを利用する方法があります。クライアント制御を実行するときは、管理対象のコンピュータの環境に合わせて自動的に起動方法が選択され、ジョブが実行されます。

なお、UNIXエージェントの場合、ジョブ実行後にシャットダウンすることはできません。また、UNIXエージェント、Macエージェントに適用する「コンピュータ（UNIX）のシステム情報の取得」ジョブ、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブではシャットダウンの指定はできません。

3.3.1　Wake on LANを利用する場合の設定

エージェント設定で必要な設定を次に示します。

(1)　値の設定に注意が必要な項目

下位システムの同時実行要求数

コンピュータを起動する側のマネージャのセットアップまたは中継システムのエージェント設定で、次の値を0にするとあて先の起動ができなくなります。

管理用サーバの場合、［リモートインストールマネージャを使用した配布のセットアップ］画面の［サーバカスタマイズオプション］パネルの［ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数］

中継システムの場合、エージェント設定の［中継システムの設定］−［中継システムの処理の設定］の［ジョブを同時実行するJP1/IT Desktop Management 2 - Agent数］

(2)　推奨の値がある項目

ポーリングの設定

ポーリングの設定は「ポーリングする」を有効にすることをお勧めします。

(3)　注意事項

Wake on LANを利用してクライアント制御を実行する場合の注意事項を次に示します。

(a)　システム構成についての注意事項

ジョブの経路上にルータが設置されたシステム構成でクライアント制御を使うには、次のどちらかのネットワーク環境にしてください。セキュリティ上の安全性から、1の環境での運用をお勧めします。

ルータごとに1つ以上の管理用中継サーバまたは中継システムを配置し、かつ常時起動されている状態にします。（推奨）

ルータに、ブロードキャスト指定のパケットを通過させるように設定します。

この場合、ルータごとに管理用中継サーバまたは中継システムを配置する必要はありません。

なお、ルータにブロードキャスト指定のパケットを通過させるように設定すると、サービス運用妨害（DoS）攻撃を受けるおそれがあります。このような状況を避けるには、1の環境で運用してください。

(b)　ハードウェアについての注意事項

クライアント制御を使用する場合のハードウェアについての注意事項を次に説明します。

BIOSの設定でWake on LANの項目がある場合は、「Enable」に設定してください。

HUBやNICなどがLinkChange機能をサポートしている場合、その機器の電源がオンになるとWake on LANが「Enable」になっているPCが起動されてしまいます。このため、機器の電源は常にオンにしておくか、またはLinkChange機能を無効にしておく必要があります。

LANカードから出力される信号には、「RWU-High」、「RWU-Low」、および「PME」の3種類があります。マザーボードによって使用できる信号の種類が異なるため、その組み合わせによってジャンパーピンの設定を変える必要があります。組み合わせによるジャンパーピンの設定については、LANカードメーカーのドキュメントを参照してください。

(c)　起動時の注意事項

クライアント制御を使用してコンピュータを起動する場合の注意事項を次に示します。

クライアント制御を使って複数のジョブを実行する場合、すべてのジョブにコンピュータを起動させる指定をしても、1つのあて先に対して一度起動した場合は、同じあて先に対する次のジョブの起動要求は無視されます。

1台のPCで複数のネットワークインターフェースカードを使用している環境では、クライアント制御を使って起動できないことがあります。

「対象のコンピュータが稼働していない場合に起動する」を設定してジョブを実行した場合、PCの起動時間に対して、JP1/IT Desktop Management 2 - ManagerまたはJP1/IT Desktop Management 2 - Agent（中継システム）からの起動間隔が短過ぎるため、PCによっては起動時にハングアップしてしまう場合があります。この場合、JP1/IT Desktop Management 2 - ManagerまたはJP1/IT Desktop Management 2 - Agent（中継システム）の、次に示すレジストリ値をPCの起動時間より大きな値に変更することで、回避してください。

レジストリキー

・JP1/IT Desktop Management 2 - Managerの場合

　HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥HITACHI¥JP1/IT Desktop Management - Manager¥DM

・OSが32ビット版のJP1/IT Desktop Management 2 - Agent（中継システム）の場合

　HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/IT Desktop Management - Agent¥DMP

・OSが64ビット版のJP1/IT Desktop Management 2 - Agent（中継システム）の場合

　HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥HITACHI¥JP1/IT Desktop Management - Agent¥DMP

名前

DeliveryExecSelectInterval

データ

最小値（秒）：30

最大値（秒）：9,999

デフォルト値（秒）：60

3.3.2　シャットダウン時の注意事項

クライアント制御を使用してコンピュータをシャットダウンする場合の注意事項を次に示します。

Windowsのコンピュータを自動的にシャットダウンしようとしても、シャットダウンしなかったり再起動したりすることがあります。これはハードウェアまたはWindowsの環境が、自動シャットダウンに対応していないことが原因のおそれがあります。この場合は、ハードウェアが自動シャットダウンに対応しているかを確認してください。また、ハードウェアメーカーが提供している最新のアップデートプログラムを実行し、Windowsとハードウェア仕様の整合性を取るようにしてください。ハードウェアが自動シャットダウンに対応していて、アップデートプログラムを実行しても現象が再現する場合は、ハードウェアメーカーおよびMicrosoft社が提供する情報を参照してください。

中継システムおよび管理用中継サーバに対してシャットダウンする指定をしても無視されます。

UNIXのコンピュータは自動的にシャットダウンできません。

UNIX、Macのコンピュータに適用する「コンピュータ（UNIX）のシステム情報の取得」ジョブ、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブでは、シャットダウンの指定はできません。

Windowsのコンピュータでスクリーンセーバーが起動され、パスワードで保護されている場合、自動的にシャットダウンはできません。

シャットダウンを指定したジョブの受信時に編集中のファイルが存在した場合、自動的にシャットダウンはできません。

シャットダウンを指定したジョブを上位システムから実行しても、対象のコンピュータがログオン前の場合は、エージェント設定の［利用者への通知設定］の［コンピュータの再起動の設定］で指定したとおりの動作をしません。

対象のコンピュータがログオン前の場合で、［指定する時間内に利用者の応答がない場合に、自動的に再起動する］を選択しているときは、確認ダイアログボックスを表示しないでシャットダウンします。

なお、ここでいう「ジョブを上位システムから実行」とは、管理対象のコンピュータ側からパッケージセットアップマネージャを使用してジョブを実行する場合以外を示します。

3.4　エージェントの動作環境について

ネットワーク環境や運用方法に合わせたエージェントの動作環境を設定する方法について説明します。

3.4.1　エージェントのポーリング方法

エージェントは配布管理システムのジョブを受信して実行します。配布管理システムのジョブを受信できるのは、管理対象のコンピュータが起動されているときだけです。通信障害が発生したときや管理対象のコンピュータが起動されていないときは、上位システムからのジョブを受信できません。このような場合、自システムあてのジョブがあるかどうかをエージェントに監視させることができます。上位システムからのジョブを監視することをポーリングといいます。

エージェント設定では、ポーリングのタイミングや実行間隔などを設定できます。ポーリング方法には、次の種類があります。エージェントの運用方法に合わせてポーリングの方法を選択してください。

ポーリングしない。

システム起動時に1回だけポーリングする。

システム起動時から一定間隔でポーリングする。

1日1回、設定した時刻にポーリングする（JP1/IT Desktop Management 2 - Agent（エージェント）だけ）。

1日1回、システム起動時にポーリングする（JP1/IT Desktop Management 2 - Agent（エージェント）だけ）。

3.4.2　エージェントのマルチポーリング環境

配布先の構成は、システム構成情報で定義されているため、エージェントへのジョブは、あらかじめ決められた経路で実行されます。また、エージェントから接続する中継システムも、システム構成情報で定義された1つの中継システムだけです。

配布経路を複数設定したり、エージェントから複数の中継システムへ接続したりする構成にする場合は、マルチポーリングの環境を作成します。エージェントが接続する中継システムは、接続時の優先順位を付けて設定できます。マルチポーリング環境で運用すれば、中継システムでトラブルが発生しても、別の中継システムを経由して目的のエージェントに対しジョブを実行できます。また、エージェントから中継システムに接続する場合、接続時の優先順位に従って、複数の中継システムに接続できます。

メモ

IDを使用して配布する場合、マルチポーリング環境を設定することで、エージェントの接続先の上位システムを自動で切り替えることもできます。

(1)　マルチポーリング環境の設定

エージェント設定の［通信設定］−［複数の上位システムへのポーリングの設定］で、［ポーリング対象とする上位システム］に優先順位を付けて設定します。

図3‒14　［通信設定］−［複数の上位システムへのポーリングの設定］

［追加］ボタン

接続先の上位システムを追加します。上位システムは最大8個まで設定できます。［上位システムの追加］ダイアログボックスで、追加する上位システムの製品種別、ホスト名またはIPアドレスを設定してください。

［削除］ボタン

上位システム一覧の中から選択されている上位システムを削除します。

［▲］ボタン

選択されている上位システムの優先順位を1つ上げます。

［▼］ボタン

選択されている上位システムの優先順位を1つ下げます。

(2)　マルチポーリング環境でのポーリング方法の選択

エージェントは、自システムあてのジョブがあるかどうかを、上位の中継システムにポーリングすることで確認しています。中継システムとのポーリング方法は、エージェント設定の［通信設定］−［複数の上位システムへのポーリングの設定］で設定します。ポーリング方法には次の2つがあります。

ホットスタンバイ

ホットスタンバイでは、ポーリング対象の中継システムは1つです。通常は、［ポーリング対象とする上位システム］で設定した、優先順位が1位の中継システムにポーリングします。この中継システムに接続できない場合は、優先順位が2位の中継システムにポーリングします。優先順位が2位の中継システムに接続できない場合は、接続できるまで優先順位が高い中継システムから順番にポーリングしていき、接続に成功した中継システムにポーリングし続けます。

マルチホスト

マルチホストでは、［ポーリング対象とする上位システム］で設定した複数の中継システムすべてにポーリングします。優先順位が1位の中継システムから順番にポーリングしていきます。

ヒント

配布用の上位システムを自動で切り替えてファイルを配布する運用とする場合は、次の設定をしてください。

［複数の上位システムへのポーリング形態］で［ホットスタンバイ］を選択する

［システム起動時に、[優先順]に従ってポーリングする］を選択する

［一定時間ポーリングに失敗する場合は配布用の上位システムを切り替える］をチェックする

詳細は、「7.6.15　配布用の上位システムを自動で切り替えてファイルを配布する」を参照してください。

(3)　マルチポーリング環境での注意事項

マルチポーリング環境で運用する場合の注意事項を次に示します。

マルチポーリング環境で動作するエージェントの場合、IDは優先順位が1位の上位システムに登録できます。

ホットスタンバイで、優先順位が1位の中継システムのトラブルを回復した場合、エージェントをこの中継システムに再びポーリングさせるには、接続中の中継システムを停止してください。接続中の中継システムを停止した場合は、次回のポーリング時にポーリング対象の中継システムが変更されます。

ホットスタンバイを使用する環境ですべての経路に対してジョブを実行する場合、エージェントが接続した中継システムの経路のジョブは実行されますが、それ以外の経路のジョブは「未実行」のステータスのまま中継システム上に残ります。そのため、中継システム上に残ったジョブと完了したジョブは、配布管理システムから定期的に削除してください。中継システム上にジョブが大量に残ったままになると、中継システムの性能が劣化するおそれがあります。

マルチホストを使用する環境ですべての経路に対してジョブを実行する場合、エージェントがポーリングするたびに同じジョブを受信します。この場合、リモートインストールのジョブを実行するときは、ジョブのインストール条件での「同じパッケージがあったら上書き」チェックボックスをオフの状態にすることをお勧めします。チェックボックスがオンの場合、ジョブ実行時に毎回パッケージが転送されるのでネットワークに負荷が掛かるおそれがあります。チェックボックスがオフの場合、エージェントが一度受信したジョブは、その後はパッケージが転送されることなく正常終了します。なお、このときのジョブの保守コードは「900090009000」となります。

3.4.3　エージェントの接続先の自動変更

接続先を決定するための情報をエージェントに配布しておくと、管理対象のコンピュータのIPアドレスから適切な接続先の上位システムを判断して、自動的に設定できます。コンピュータのIPアドレスが変更されると接続先も自動的に変更されるため、コンピュータが移動した場合に便利です。ここでは、エージェントの接続先の自動変更について説明します。

この機能は、JP1/IT Desktop Management 2 - Agentで使用できます。

ただし、Citrix XenApp、Microsoft RDSサーバではサポートしていません。

(1)　接続する上位システムを自動的に設定・変更する

接続先の上位システムを自動的に設定・変更するには、あらかじめ上位接続先情報ファイル（dmhost.txt）を作成し、管理対象のコンピュータに配布します。配布後の特定のタイミングで、接続先が自動的に再設定されます。

メモ

上位接続先情報ファイル（dmhost.txt）を使用する場合と同様のことが接続先設定ファイル（itdmhost.conf）を使用してもできます。接続先設定ファイル（itdmhost.conf）については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」のエージェントの接続先を自動設定する手順の説明を参照してください。

(a)　上位接続先情報ファイルを作成する

上位接続先情報ファイルは、接続する上位システムを決定するためのファイルです。このファイルは、コンピュータのIPアドレスの範囲と対応する接続先上位システムの組み合わせを定義しています。例えば、IPアドレス「172.16.22.1〜172.16.22.255」のコンピュータの接続先は東京支部のPC、IPアドレス「172.17.22.1〜172.17.22.255」のコンピュータの接続先は名古屋支部のPC、というように定義します。作成方法の詳細については、「3.4.3(2)　上位接続先情報ファイル（dmhost.txt）の作成」を参照してください。

作成した上位接続先情報ファイルをJP1/IT Desktop Management 2 - Managerのデータフォルダに格納しておくと、インストールセットの作成時にインストールセットに取り込まれます。

(b)　上位接続先情報ファイルを管理対象のコンピュータに配布する

上位接続先情報ファイルが取り込まれたインストールセットを使用してJP1/IT Desktop Management 2 - Agentをインストールすると、管理対象のコンピュータの次のディレクトリに上位接続先情報ファイルが格納されます。

JP1/IT Desktop Management 2 - Agentのインストール先ディレクトリ¥MASTER¥DB

パッケージとして上位接続先情報ファイルを登録し、そのパッケージを配布するジョブを作成すれば、対象のコンピュータに配布することもできます。次の設定でパッケージしてください。

［システム条件］パネルの「インストール先ディレクトリ」の設定

ドライブ：「なし（空白）」

ディレクトリ：「%ITDM2AGT%¥MASTER¥DB」

管理対象になる前のコンピュータの場合は、手動で格納してもかまいません。

メモ

上位接続先情報ファイル（dmhost.txt）と接続先設定ファイル（itdmhost.conf）の両方が存在する場合は、上位接続先情報ファイル（dmhost.txt）は無視されます。

(c)　接続先が変更されるタイミング

上位接続先情報ファイルを管理対象のコンピュータに格納したあと、ポーリングが実行されるのを待つか、または管理対象のコンピュータのOSを再起動してください。上位接続先情報ファイルの内容に従って、エージェントが接続する上位システムが設定されます。

エージェントの接続先を自動変更するポーリングは次の2種類です。

システム起動を基準としたポーリング

エージェント設定の［基本設定］で、［システム起動を基準としたポーリングをする］のチェックボックスをオンにしている場合

時刻を指定してポーリング

エージェント設定の［基本設定］で、［時刻を指定してポーリングする］のチェックボックスをオンにしている場合

一度設定したあとでも、次の操作をしたあとにポーリングが実行されるのを待つかまたはOSを再起動すると接続先が再設定されます。

管理対象のコンピュータのIPアドレス変更

上位接続先情報ファイルの編集または上書き

接続先情報を変更した上位接続先情報ファイルをエージェントに再配布するか、各エージェントのインストール先ディレクトリ¥MASTER¥DBに格納されている上位接続先情報ファイルを直接編集して上書きし、コンピュータを再起動すると接続先が変更されます。

管理対象のコンピュータを移動してIPアドレスを変更した場合、ポーリングが実行されるのを待つかまたはOSを再起動するだけで適切な上位システムに接続先が変更されます。エンドユーザは接続先の変更を意識する必要はありません。

上位接続先情報ファイルによってエージェントの接続先の自動設定・変更が起きると、ログがPCごとにインストール先フォルダ¥LOG¥USER.LOGファイルに取得されます。

(d)　接続先の自動変更と他機能との関係

上位接続先情報ファイルを使用した接続先の自動変更は、JP1/IT Desktop Management 2の他機能と併用できない場合があります。次の点に注意してください。

管理対象のコンピュータの起動時にエージェントのインストール先フォルダ¥MASTER¥DB¥下に上位接続先情報ファイルが存在する場合は、エージェント設定で設定した配布用の上位システムではなく、上位接続先情報ファイルに指定された接続先情報に基づいて上位システム（管理用サーバまたは中継システム）に接続されます。

上位接続先情報ファイルによる接続先の設定を無効にするには、次のどれかの対処をしてください。どの場合でも、結果として、dmhostで指定した接続先に接続されるようになります。

中身が空の上位接続先情報ファイルをエージェントに配布する

各エージェントのインストール先ディレクトリ¥MASTER¥DB¥下に格納されている上位接続先情報ファイルを削除する

各エージェントのインストール先ディレクトリ¥MASTER¥DB¥下に格納されている上位接続先情報ファイルの名前をdmhost.txt以外に変更する

(2)　上位接続先情報ファイル（dmhost.txt）の作成

上位接続先情報ファイルは、dmhost.txtという名称のテキストファイルです。作成方法を次に説明します。

(a)　上位接続先情報ファイルの形式

上位接続先情報ファイルには、管理対象のコンピュータのIPアドレスの範囲と対応する接続先の組み合わせを、1行につき1件定義します。1行のバイト数は、1,023バイト以内です（バイト数は、半角文字：1バイト、全角文字：2バイトで換算）。各項目間は「,」（コンマ）で区切ってください。行の先頭に「;」（セミコロン）を付けると、その行はコメントと見なされます。なお、最終行の改行はしないでください。

ファイルの形式を次に示します。

形式

最小のIPアドレス,最大のIPアドレス,接続先,接続種別［,接続先,接続種別］…［,マルチキャスト配布用アドレス］

説明

最小のIPアドレス（必ず指定）

管理対象のコンピュータのIPアドレスの範囲で最小のIPアドレスを指定します。半角数字を使用して「xxx.xxx.xxx.xxx」の形式で指定してください。

最大のIPアドレス（必ず指定）

管理対象のコンピュータのIPアドレスの範囲で最大のIPアドレスを指定します。半角数字を使用して「xxx.xxx.xxx.xxx」の形式で指定してください。

接続先※（必ず指定）

接続先のホスト名またはIPアドレスを指定します。接続先の運用キーの設定がホスト名であればホスト名を、IPアドレスであればIPアドレスを指定してください。ホスト名の場合、半角英数字64文字までを使用して指定してください。IPアドレスの場合、半角数字を使用して「xxx.xxx.xxx.xxx」の形式で指定してください。

接続種別※（必ず指定）

接続先が管理用サーバであれば「netmdm」を、中継システムであれば「netmdmw」を指定してください。

マルチキャスト配布用アドレス（省略可能）

管理対象のコンピュータにジョブをマルチキャスト配布したい場合、接続先に設定しているマルチキャストアドレスを指定します。半角数字を使用して「xxx.xxx.xxx.xxx」の形式で指定してください。マルチキャストアドレスとして使用できるアドレスの範囲は、「224.0.1.0〜239.255.255.255」です。

注※

1行に接続先と接続種別のセットを最大8個まで指定できます。複数の接続先と接続種別を指定した場合、先に指定した接続先の方が優先順位が上位となります。

注意事項

管理対象のコンピュータのIPアドレスが定義した範囲に含まれない場合、接続先の設定は変更されません。

管理対象のコンピュータのIPアドレスがループバックアドレス（127.0.0.1）の場合、接続先の設定は変更されません。

管理対象のコンピュータのIPアドレスの範囲が重複する複数の定義をした場合は、先に定義した行が有効となります。

次の場合は、指定行の定義が無効になります。

・1〜4番目の項目に省略があった場合

・IPアドレスに無効な値を指定した場合

・「接続先」に半角65文字以上の値を指定した場合

・接続種別に「netmdm」および「netmdmw」以外を指定した場合

「マルチキャスト配布用アドレス」の指定を省略した場合、または無効な値を指定した場合、マルチキャストアドレスの設定はできません。ただし、1〜4番目の項目で定義した、IPアドレスの範囲と対応する接続先の組み合わせは有効になります。

1行に1〜5番目以外の項目を指定した場合、その項目は無視されます。

1行の文字数が1,023文字を超えた場合、1,024文字目以降は無視されます。

(b)　上位接続先情報ファイルの作成例

上位接続先情報ファイルの作成例を次に示します。

;上位接続先情報
172.17.12.1,172.17.12.250,dmsub01,netmdmw,dmsub02,netmdmw,dmman01,netmdm
172.17.13.1,172.17.13.250,dmman01,netmdm,dmman02,netmdm
172.17.11.1,172.17.11.60,dmsub02,netmdmw
0.0.0.0,255.255.255.254,dmman02,netmdm

この例では、管理対象のコンピュータのIPアドレスが「172.17.11.6」の場合、4行目の「172.17.11.1〜172.17.11.60」の範囲に該当するため、接続先の上位システムは「dmsub02」というホスト名の中継システムになります。

なお、上位接続先情報ファイルの最終行に、すべてのIPアドレスを範囲とする「0.0.0.0〜255.255.255.254」を定義しておくと、該当するIPアドレスがなかった（IPアドレスが172.17.12.1〜172.17.12.250、172.17.13.1〜172.17.13.250および172.17.11.1〜172.17.11.60以外の）管理対象のコンピュータの接続先の上位システムは、「dmman02」になります。また、2行目や3行目のように複数の接続先を指定した場合、先に指定した接続先の優先順位が上位（2行目ではdmsub01、3行目ではdmman01が1位）となります。

(c)　上位接続先情報ファイルを配布したあとの注意事項

上位接続先情報ファイルを管理対象のコンピュータに配布して接続先が設定されたあと、接続先ホストのIPアドレスを変更するときは、それまで適用していた上位接続先情報ファイルを該当する管理対象のコンピュータから削除しておいてください。削除しないと、接続先ホストのIPアドレス変更を契機に接続先の自動変更が動作し、想定した上位システムとは別の接続先が設定されることがあります。

3.4.4　上位システムを名前解決できない場合の接続設定

運用キーにホスト名を使用している環境では、検疫システムなどによってDNSサーバへの接続が遮断されると、エージェントが接続先の上位システムを名前解決できなくなる場合があります。このような場合に、上位システムからの実行要求情報を受信したタイミングで、通信プロトコル中のIPアドレスから接続先の上位システムを名前解決させることができます。これによって、エージェントが接続先の上位システムを名前解決できない環境でも、ジョブをポーリングしたり上位システムへ機器情報を通知したりできます。このときエージェントは、実行要求を発信した上位システムを接続先として認識します。

この機能を使用するには、［エージェントの設定項目］−［通信設定］の実行要求を受信するための通信プロトコルで、「上位システムへの接続に、受信したIPアドレスを使用する」チェックボックスをオンに設定してください。

この機能を使用すると、上位システムからの実行要求を受信したタイミングで、自動的に管理対象のコンピュータに上位システムアドレス格納ファイルが作成されます。上位システムアドレス格納ファイルには、上位システムのIPアドレスとホスト名の対応が記述されます。以降、エージェントはこのファイルに記述された内容を基に上位システムを名前解決して接続します。

なお、通常、上位システムアドレス格納ファイルの編集は不要です。ただし、上位システムを名前解決できない環境にホスト名運用のコンピュータを新規に導入する場合は、あらかじめ上位システムアドレス格納ファイルを作成する必要があります。

上位システムを名前解決できない環境にホスト名運用のコンピュータを新規に導入する場合の設定については、「3.4.4(1)　上位システムを名前解決できない環境に新規にコンピュータを導入する場合の設定」を参照してください。上位システムアドレス格納ファイルの形式については、「3.4.4(2)　上位システムアドレス格納ファイルの形式」を参照してください。

注意事項

運用キーがIPアドレスの場合は設定不要です。

上位システムがクラスタシステムの場合、正しく接続できないことがあります。

(1)　上位システムを名前解決できない環境に新規にコンピュータを導入する場合の設定

上位システムを名前解決できない環境にホスト名運用のコンピュータを新規に導入する場合、上位システムと接続できないためコンピュータがあて先として認識されません。そこで、あらかじめ上位システムアドレス格納ファイルを作成し、次の方法で管理対象のコンピュータに格納しておきます。

エージェントのインストール後に上位システムアドレス格納ファイルを格納する

エージェントのインストール後に、次のフォルダへ上位システムアドレス格納ファイルを格納します。

JP1/IT Desktop Management 2 - Agentのインストール先ディレクトリ¥MASTER¥DB

セットアップが完了したあと、コンピュータを再起動すると、上位システムアドレス格納ファイルを基に上位システムと接続します。

(2)　上位システムアドレス格納ファイルの形式

上位システムアドレス格納ファイルには複数の接続先を記述できます。管理対象のコンピュータは、記述されているホスト名に対応したIPアドレスで、上位システムと接続します。

上位システムアドレス格納ファイルの形式を次に示します。

ファイル名

SERVERIP.ini

形式

[ホスト名]
IPaddress=IPアドレス
[#-filecheck]
key=Programcheck

説明

ホスト名

管理対象のコンピュータの接続先のホスト名を指定します。大文字、小文字は区別されません。同じホスト名が複数指定されている場合は、最初のホスト名が使用されます。

IPアドレス

ホスト名に対応するIPアドレスを指定します。

なお、ホスト名とIPアドレスの組み合わせは、一度に複数記述できます。

作成例

上位システムアドレス格納ファイルの作成例を次に示します。

[host001]
IPaddress=10.100.100.20
[host005]
IPaddress=10.100.100.15
[host007]
IPaddress=10.100.100.57
[#-filecheck]
key=Programcheck

上位システムアドレス格納ファイル作成時の注意事項を次に示します。

IPアドレスによる接続がエラーとなった場合、エラーとなった部分のホスト名およびIPアドレスの組み合わせは削除されます。

「[#-filecheck]」の部分を削除すると、上位システムアドレス格納ファイルが削除されます。

上位システムアドレス格納ファイルは半角英数字で記述してください。

4　配布管理システムを操作する

ここでは、配布管理システムの基本的な操作について説明します。配布管理システムを操作するには、JP1/IT Desktop Management 2システム全体の構築が必要です。構築方法については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」の各システム構成の構築の説明を参照してください。

4.1　配布管理システムの開始と停止

配布管理システムのサーバの機能は、OSの起動時に自動的に開始され、OSの終了時に自動的に停止されます。

任意のタイミングで配布管理システムを開始したい場合はstartserviceコマンドを、停止したい場合はstopserviceコマンドを実行してください。コマンドの詳細については、マニュアル「JP1/IT Desktop Management 2 運用ガイド」を参照してください。

4.2　配布管理システムのメニュー

配布管理システムの機能を使用するには、［スタート］メニューからJP1/IT Desktop Management 2のプログラムフォルダを選択し、各機能のメニューを選択します。これらのメニューは、JP1/IT Desktop Management 2 - Managerのインストール時に、コンポーネントの［Remote Install Manager］を選択した状態でインストールすると作成されます。

配布管理システムのメニューのうち、リモートインストールマネージャを使用した配布だけで利用するメニューについて次に説明します。

リモートインストールマネージャ

ソフトウェアの配布、ファイルの収集など、配布管理システムの主な機能を実行するリモートインストールマネージャを起動するメニューです。

リモートインストールマネージャの操作方法については、「4.3　リモートインストールマネージャの起動と終了」および「4.4　ウィンドウの構成と基本操作」を参照してください。

アンアーカイバ

圧縮またはアーカイブされたファイルを元の形式に復元するためのアンアーカイバを起動するメニューです。管理対象のコンピュータからリモートコレクトしたファイルは、アーカイブまたは圧縮された形式で配布管理システムに格納されるため、配布管理システムで扱えるようにするには、アンアーカイバを使用して復元する必要があります。

アンアーカイバの操作方法については、「9.1.2　収集ファイルの復元」を参照してください。

4.3　リモートインストールマネージャの起動と終了

配布管理システムの主な機能は、リモートインストールマネージャから操作します。

ここでは、リモートインストールマネージャを起動および終了する方法について説明します。

4.3.1　リモートインストールマネージャを起動する

リモートインストールマネージャを起動する手順を次に示します。

Windowsの［スタート］メニューから［JP1_IT Desktop Management 2 - Manager］−［リモートインストール マネージャ］を選択する。

［ログイン（リモートインストールマネージャ）］ダイアログボックスが表示されます。

図4‒1　［ログイン（リモートインストールマネージャ）］ダイアログボックス

配布管理システムにログインするための情報を入力する。

「管理用サーバ」には、管理用サーバのホスト名またはIPアドレスを入力します。

「接続受付ポート番号」には、管理者のコンピュータからの接続受付ポート番号を入力します。

「ユーザーID」および「パスワード」には、JP1/IT Desktop Management 2のシステム管理権限と配布管理権限の両方の権限があるユーザーIDおよびパスワードを入力します。

リモートインストールマネージャを起動すると、次に示すウィンドウが表示されます。メニューの意味については、「付録C　メニュー一覧」を参照してください。

図4‒2　リモートインストールマネージャ

ツールバー

ツールバー上のボタン（ツールボタン）をクリックすると、ボタンに応じた機能を実行します。ボタンにマウスカーソルを合わせると、ボタンの機能が表示されます。ツールバーは、［表示］メニューの［ツールバー］を選択することで、表示の有無を選択できます。また、ツールバーは、最初の起動時にはウィンドウの上側に付いていますが、ドラッグして移動することもできます。

ラベル

個々のウィンドウのラベル（ウィンドウの上部に表示される項目）をクリックすると、クリックしたラベルを基準にして、ウィンドウに表示される情報を並べ替えることができます。

ステータスバー

JP1/IT Desktop Management 2のメッセージが表示されます。ステータスバーは、［表示］メニューの［ステータスバー］を選択することで、表示させるかどうかを選択できます。

なお、リモートインストールマネージャは、管理者権限を持ったユーザー（WindowsのAdministratorsグループに属するアカウントのユーザー）が操作してください。

4.3.2　リモートインストールマネージャを終了する

リモートインストールマネージャを終了するには、［ファイル］メニューの［終了］を選択します。次回の起動時からは、前回の終了時のウィンドウの配置がそのまま引き継がれます。

4.4　ウィンドウの構成と基本操作

ここでは、リモートインストールマネージャのウィンドウの役割と基本操作について説明します。

リモートインストールマネージャ上に表示できるウィンドウを次の表に示します。

表4‒1　リモートインストールマネージャ上に表示できるウィンドウ

項番

ウィンドウの種類

1

［システム構成］ウィンドウ

2

［あて先］ウィンドウ

3

［パッケージ］ウィンドウ

4

［ジョブ定義］ウィンドウ

5

［ジョブ実行状況］ウィンドウ

6

［管理情報リスト］ウィンドウ

4.4.1　［システム構成］ウィンドウ

JP1/IT Desktop Management 2で管理するシステムを構成するシステムの物理的な構成情報を表示するウィンドウです。JP1/IT Desktop Management 2のジョブを実行するには、まずこのウィンドウで、ジョブの対象となるすべてのシステムを定義する必要があります。

図4‒3　［システム構成］ウィンドウ

ウィンドウの左枠には、システム構成が階層的に表示されます。右枠には次のタブがあり、表示させる情報を選択できます。

なお、これらのタブは［あて先］ウィンドウでも表示されます。

［一覧］タブ

左枠で選択したシステムの下位のシステムが一覧表示されます。

［属性］タブ

左枠で選択したシステムの属性情報（ホスト識別子、ホスト名など）が表示されます。「更新日時」に、システム構成情報を更新した日時が表示されます。「キー」欄に表示されるアイコンは、その項目がノード識別キーであることを示しています。

［インストールパッケージ］タブ

左枠で選択したシステムにリモートインストールマネージャでインストールしたパッケージが、一覧表示されます。

重要

［システム構成］ウィンドウの左枠でホストを選択して次に示す操作をすると、意図した結果にならない場合があります。これらの操作をする場合は、［システム構成］ウィンドウの右枠でホストを選択して操作してください。

ホスト名を変更するために［F2］キーを押しても、名前を入力できる状態にならない。

［名前の変更］メニューまたは［F2］キーを押してホスト名を変更すると、別のホスト名が変更される。

ホスト名を変更した後、変更したホストの選択状態が解除される。

［削除］メニューまたは［Delete］キーを押してホストを削除した後に別のホストのホスト名を削除したホストと同名に変更して［属性］タブまたはプロパティを表示すると、削除したホストの情報が表示される。

管理用中継サーバを削除すると、「システムエラーが発生しました」というメッセージが表示される。

［切り取り］メニューまたは［Ctrl］＋［X］キーを押してホストを切り取り、貼り付けたホストの［属性］タブまたはプロパティを表示すると、同名のホストと同じ情報が表示される。その後の操作で、「すでに同じ名前の項目が存在します」または「あて先経路に画面のあて先名とアルファベットの大文字と小文字が異なるものがあります」というメッセージが表示される。

4.4.2　［あて先］ウィンドウ

［システム構成］ウィンドウに定義されたホストを、ジョブのあて先として管理しやすいようにグループ化して表示するウィンドウです。あて先グループおよびIDの、作成、編集などができます。

図4‒4　［あて先］ウィンドウ

ウィンドウの左枠には、グループ化されたあて先が階層的に表示されます。右枠には［システム構成］ウィンドウと同じ種類のタブに加えて、次のタブが表示されます。

［ID管理元中継］タブ

左枠でIDを選択した場合に、そのIDを管理する中継システムおよび管理用中継サーバが一覧表示されます。

左枠でIDを選択した場合、［一覧］タブにはそのIDに所属するあて先が一覧表示されます。ただし、メニューで［表示］−［IDをダブルクリックした時だけID下のあて先を表示する］を選択すると、シングルクリックではあて先が表示されません。ID下のあて先が多数（10,000台以上）あって、あて先を参照する必要がない場合は、ダブルクリックした時だけあて先を表示する設定にすることをお勧めします。

4.4.3　［パッケージ］ウィンドウ

キャビネット内の、パッケージの情報を表示するウィンドウです。パッケージの確認や編集ができます。

図4‒5　［パッケージ］ウィンドウ

ウィンドウの左枠には、キャビネットとパッケージの階層構造が表示されます。右枠には次の3種類のタブがあり、表示させる情報を選択できます。

［一覧］タブ

左枠で選択した項目の1つ下位の情報（キャビネットまたはパッケージ）が一覧表示されます。

［属性情報］タブ

左枠で選択したキャビネットまたはパッケージの属性情報（キャビネット名、パッケージ名、パッケージの容量や圧縮の有無など）が表示されます。

［パッケージ内容］タブ

パッケージ種別が「ユーザプログラム、データ」の場合に、パッケージに含まれているファイルの名称、サイズ、および最終更新日時が表示されます。

4.4.4　［ジョブ定義］ウィンドウ

作成（保存）されたジョブを表示するウィンドウです。ジョブを作成して保存すると、［ジョブ定義］ウィンドウにフォルダごとに表示されます。実行日時を設定したジョブを実行したときも、実行したジョブが［ジョブ定義］ウィンドウに保存されます。

図4‒6　［ジョブ定義］ウィンドウ

このウィンドウでは、ジョブを保存するためのフォルダを作成したり、保存されているジョブを編集して再実行したりできます。

4.4.5　［ジョブ実行状況］ウィンドウ

ジョブの実行状況を表示するウィンドウです。実行したジョブの状況が、フォルダ、ジョブ、あて先、パッケージの順で、階層的に表示されます。ジョブの実行結果を確認したり、エラーとなったジョブを再実行したりできます。

図4‒7　［ジョブ実行状況］ウィンドウ

4.4.6　［管理情報リスト］ウィンドウ

ソフトウェア検索リストの一覧を表示するウィンドウです。

ソフトウェア検索リストとは、UNIXエージェントまたはMacエージェントにインストールされているソフトウェアを検索するためのリストです。リストの登録内容とUNIXエージェントまたはMacエージェントのフォルダ内容を突き合わせて検索し、同じものがあればインストールパッケージとして通知されます。ソフトウェア検索リストは、ユーザーが任意で作成します。このウィンドウから作成・編集ができます。なお、ユーザーが任意で作成したソフトウェア検索リストを、ユーザ指定検索リストと呼びます。

図4‒8　［管理情報リスト］ウィンドウ

4.4.7　ウィンドウの操作方法

リモートインストールマネージャのウィンドウに対する操作方法を次に示します。

(1)　新しいウィンドウを開く

リモートインストールマネージャのウィンドウ上で新しいウィンドウを開くには、［ファイル］メニューから［新規作成］を選択し、下位に表示されるメニューから目的のウィンドウを選択します。表示できるウィンドウ数に制限はありません。同じ種類のウィンドウを複数開くこともできます。

(2)　ウィンドウを整列させる

リモートインストールマネージャのウィンドウ中に複数のウィンドウを表示する場合、ウィンドウを整列させると、リモートインストールマネージャを操作しやすくなります。ただし、同時に配置できるウィンドウは3または4種類です。

ウィンドウの整列方法を次に示します。

［オプション］メニューから［整列パターン］を選択する。

［整列パターン］ダイアログボックスが表示されます。

図4‒9　［整列パターン］ダイアログボックス

パターン

表示するウィンドウの数およびレイアウトのパターンを選択します。同じ種類のウィンドウは、同じ位置に整列されます。したがって、同じ種類のウィンドウを複数表示しているときにウィンドウを整列すると、重ねて表示されます。

ウィンドウ

整列させるウィンドウの種類を選択します。「選択元」でウィンドウ名を選択し、［>］ボタンをクリックすると、ウィンドウ名が「選択したウィンドウ」に移動し、表示対象となります。選択を取り消すときは、「選択したウィンドウ」でウィンドウ名を選択後、［<］ボタンをクリックします。すべての選択を取り消すときは［<<］ボタンをクリックします。

「選択したウィンドウ」内での順序は、パターン図中の数字（1〜4）に対応しています。この図の例では、パターン1の「1」の位置に［システム構成］ウィンドウ、「2」の位置に［パッケージ］ウィンドウ、「3」の位置に［ジョブ実行状況］ウィンドウが配置されます。選択したウィンドウが整列実行時に表示されていないときは、リモートインストールマネージャのウィンドウ中の対応個所が空欄になります。

［OK］ボタンをクリックする。

設定を反映して、［整列パターン］ダイアログボックスが閉じます。

［ウィンドウ］メニューから［ウィンドウの整列］を選択する。

設定したレイアウトでウィンドウが整列します。

5　システム構成情報とあて先グループを作成する

ここでは、システム構成情報の作成方法と、ジョブの配布先をグルーピングして管理する方法について説明します。

5.1　システム構成情報を作成する

JP1/IT Desktop Management 2の運用を開始する前に、中継システムおよび管理用中継サーバと管理対象のコンピュータの構成を管理するための情報、システム構成情報を作成しておく必要があります。システム構成情報には、システム構成と各ホストのアドレスを定義します。各ホストのアドレスには、ノード識別キーで選択したアドレス（ホスト名またはIPアドレス）を設定します。

ここでは、システム構成情報の作成方法の種類やホスト名の付け方、システム構成情報を作成および変更する方法について説明します。

5.1.1　システム構成情報の作成方法の種類

ここでは、システム構成情報の作成方法の種類と、作成方法を選択するときの基準について説明します。

(1)　作成方法の種類

システム構成情報の作成方法には、次の3種類があります。

システム構成情報を自動的に作成する

物理的なネットワーク構成を基にシステム構成情報が自動的に作成され、［システム構成］ウィンドウに反映されます。

管理対象のコンピュータまたは中継システムが増設、削除されたり、ホスト名またはIPアドレスが変更されたりしたとき、その情報が配布管理システムに自動的に通知されるため、配布管理システムではシステム構成情報をメンテナンスする必要がありません。

また、システム構成の自動登録機能によって、システム構成の変更に合わせてIDも自動的に変更されます。システム構成情報とIDの連携については、「5.4　システム構成情報とIDを連携させる運用」を参照してください。

システム構成情報をファイルに出力して更新する

システム構成情報をファイルに保存しておくと、システムにトラブルが発生したときなど、システム構成情報を復旧するのに役立ちます。

システム構成情報を［システム構成］ウィンドウで作成する

リモートインストールマネージャのGUI上で、管理対象のコンピュータや中継システムのホスト名またはIPアドレスを1つずつ定義します。

管理用中継サーバ配下のシステム構成情報を取得する

配布管理システムを階層化したシステムで、マネージャからシステム全体のシステム構成情報を管理するには、次の手順で管理用中継サーバ配下のシステム構成情報を取得する必要があります。

管理用中継サーバごとにシステム構成情報を作成する。

マネージャから各管理用中継サーバをあて先にして、「システム構成情報の取得」ジョブを実行する。

システム全体のシステム構成情報をマネージャで取得できます。

システム全体のシステム構成情報を取得したあとのシステム構成情報のメンテナンスには、システム構成の自動登録機能を使用できます。管理用中継サーバ配下でシステム構成が変更されると、変更内容が管理用中継サーバからマネージャへ自動的に通知されます。

管理用中継サーバで、次の方法でシステム構成を変更した場合、変更内容が管理用中継サーバからマネージャへ自動的に通知されません。この場合、管理用中継サーバに対して、「システム構成情報の取得」ジョブを実行してください。

システム構成情報をファイルから作成

システム構成情報を［システム構成］ウィンドウで作成

システム構成情報を［システム構成］ウィンドウで削除

システム構成情報を［検索］ダイアログボックスで削除

なお、3階層以上の大規模システムで、中継システムおよび管理用中継サーバの接続先を変更した場合、変更先の配布管理システムに、移動したシステム配下の情報が反映されないことがあります。反映されていない場合には、変更先の配布管理システムで、移動した中継システムおよび管理用中継サーバに対して、「システム構成情報の取得」ジョブを実行してください。

5.1.2　JP1/IT Desktop Management 2でのホスト名の付け方

ホスト名の付け方について説明します。

(1)　ホスト名の付け方

ホスト名は64バイトまで設定できます。

ホスト名を設定するときは、次の条件に従ってください。

半角英字（A〜Z、a〜z）、数字（0〜9）、「-」（マイナス）、および「.」（ピリオド）を使用する。

「.」（ピリオド）はドメイン名の区切り文字としてだけ使用する。

DNSを利用している場合、ホスト名は「ホスト名.ドメイン名」とし、ドメイン名を含めた長さを64バイト以内にする。

ホスト名の最初の文字には英字を使用する。

スペースは使用できない。

大文字と小文字は区別されないため、大文字を小文字に（または小文字を大文字に）変換すると同一名称となるような名称は使用できない。

全角文字は使用できない。

最後の文字に「-」（マイナス）および「.」（ピリオド）は使用できない。

ホスト名として、hostsファイルに定義されている別名は使用できない。

ホスト名をノード識別キーとしているシステムでは、JP1/IT Desktop Management 2を使用するすべてのホストにユニークなホスト名を設定する。

ホスト名として「localhost」は使用できない。

なお、配布管理システム（システム最上位のホスト）の直下のホストから最下位のホストまでのホスト名を合計した長さ（ホスト名とホスト名の間の区切り文字を含む）が255バイトを超える名称は設定できません。また、UNIXシステムなど、大文字と小文字を区別するシステムがあるため、JP1/IT Desktop Management 2を使用するネットワークでは、ホスト名を大文字または小文字のどちらかに統一することをお勧めします。

5.1.3　システム構成情報を自動的に作成する

上位システムへ自動的にシステム構成情報を通知して登録させるシステム構成の自動登録機能によって、システム構成情報が自動的に作成されます。

システム構成情報を自動的に作成するために必要な設定と注意事項について次に示します。

(1)　システム構成情報を自動的に作成するために必要なTCP/IP環境の設定

配布管理システムをホスト名で設定する場合、TCP/IPの定義データベースに配布管理システムの定義が必要です。また、中継システムでは、TCP/IPの定義データベースに下位ホストの定義が必要です。

(2)　システム構成情報を自動的に作成するときの注意事項

上位システムのシステム構成情報を誤って削除してしまった場合やデータベースが壊れてしまった場合は、バックアップから回復、または下位システムから再度システム構成情報ファイルを通知させてください。

システム構築時やシステム構成情報編集時の注意事項を次に示します。

(a)　システム構築時の注意事項

中継システムのシステム構成情報が登録されていないときに、下位システムからのシステム構成情報が通知されると、下位システムの構成情報が消失してしまう場合があります。そのため、JP1/IT Desktop Management 2でシステムを構築する場合、配布管理システム、中継システム、エージェントの順に、構築してください。万一、正しくシステム構成情報が構築されていない場合は、JP1/IT Desktop Management 2 - Manager（マネージャ）から「システム構成情報の取得」ジョブを実行してください。

(b)　システム構成情報編集時の注意事項

配布管理システムでシステム構成情報を編集しないでください。編集する必要がある場合はリモートインストールマネージャで、システム構成情報をファイルへ出力し、バックアップを取得してから編集してください。

特に、システム構成情報中の中継システムを削除してしまうと、この中継システムに接続しているコンピュータのシステム構成情報も削除されます。システム構成情報が削除されたコンピュータからシステム構成情報が通知されても配布管理システムには記録されなくなります。

システム構成情報をファイルへ出力する方法およびファイルの内容をシステム構成情報に反映する方法については、「5.1.4　システム構成情報をファイルに出力して更新する」を参照してください。

5.1.4　システム構成情報をファイルに出力して更新する

作成済みのシステム構成情報はファイルに出力できます。このファイルを、システム構成情報ファイルといいます。システム構成情報ファイルは、バックアップとして保存したり、テキスト形式で編集したりできます。

保存したり編集したりしたシステム構成情報ファイルをシステム構成情報に反映するには、リモートインストールマネージャでシステム構成情報ファイルを読み込みます。

ここでは、システム構成情報をファイルに出力する方法、システム構成情報ファイルを編集する方法、およびシステム構成情報ファイルをシステム構成情報に反映する方法について説明します。

(1)　システム構成情報をファイルに出力する

［システム構成］ウィンドウに表示したシステム構成情報をファイルに出力できます。システム構成情報を変更する場合は、変更前のシステム構成情報をファイルに出力し、このファイルを編集すると便利です。

なお、配布管理システムを階層化している場合、マネージャで出力したファイルには、管理用中継サーバ配下のシステム構成情報は含まれません。管理用中継サーバ配下のシステム構成情報を出力する場合は、管理用中継サーバでシステム構成情報をファイルに出力してください。

システム構成情報をファイルに出力する方法を次に示します。

［システム構成］ウィンドウで、［ファイル］−［ファイルへ保存］を選択する。

［システム構成の保存］ダイアログボックスが表示されます。なお、この操作は、［最新の情報に更新］を実行したあと、行ってください。自動反映によって画面の状態と内部データの不一致が発生した場合、正しい情報が出力されないことがあります。

ファイル名を設定し、［OK］ボタンをクリックする。

システム構成情報がファイルに出力されます。

システム構成情報のファイル出力例を次に示します。

図5‒1　システム構成情報のファイル出力例

なお、システム構成からファイルを作成した場合、IPアドレスの位置に「xxx.xxx.xxx.xxx」が設定されます。出力したファイルを利用して、ホストをIPアドレスで管理する場合、テキストエディタなどでIPアドレスを記述する必要があります。

(2)　システム構成情報ファイルを編集する

システム構成情報ファイルでは1つのホストごとに、IPアドレス、ホスト名、ホストのタイプ、作成日時、コメント、経路などを設定します。ただし、作成日時を設定できるのは、JP1/IT Desktop Management 2 - Managerだけです。

表示言語が日本語の場合、Shift_JISエンコーディング形式のテキストファイルを使用します。表示言語が中国語（簡体字）の場合、GBKエンコーディング形式のテキストファイルを使用します。表示言語が英語の場合、ASCIIコード形式のテキストファイルを使用します。1カラム目に「'」（シングルクォーテーション）または「#」（シャープ）を付けると、その行はコメントと見なされます。

形式

IPアドレス ホスト名 HID=ホスト識別子,TYPE=ホストのタイプ,MAC=MACアドレス,COMMENT=コメント,ROOT=経路,DATE=作成日時

説明

ホスト識別子以降の順序は任意です。

IPアドレス（必ず設定）

ホストのIPアドレスを設定します。

設定したIPアドレスは、JP1/IT Desktop Management 2 - Manager上では管理されませんが、TCP/IPのhostsファイルと形式を一致させるために設定します。

TCP/IPのhostsファイルを、システム構成情報ファイルとして直接入力することもできます。この場合は、すべてのホストが管理対象のコンピュータとして設定されます。

TCP/IPのhostsファイルを基に、ホストのタイプ（TYPE）、コメント（COMMENT）、経路（ROOT）を追加すると、より簡単にシステム構成情報ファイルを作成できます。

ホスト名（必ず設定）

ホスト名の指定方法については、「5.1.2　JP1/IT Desktop Management 2でのホスト名の付け方」を参照してください。

HID=ホスト識別子

ホストを一意に認識するホスト識別子を設定します。［システム構成］ウィンドウで［ファイル］−［ファイルへ保存］を選択してシステム構成情報をファイルに出力し、必ずこのホスト識別子をそのまま設定してください。なお、［ファイルへの保存］で出力したシステム構成情報ファイルに、ホスト識別子が設定されていないホスト、または新規に追加するホストについては、このオペランドを指定しないでください。

TYPE=ホストのタイプ

ホストのタイプとして、「MANAGER」（管理用中継サーバ）、「MASTER」（中継システム）または「CLIENT」（エージェント）を設定します。省略したときは、デフォルトで「CLIENT」が設定されます。

TCP/IPのhostsファイルとシステム構成情報ファイルを共用する場合は、「TYPE」の前に「#」を指定します。「#」と「TYPE」の間には半角スペースを指定してください。TCP/IPのhostsファイルでは、「#」以降の記述はコメントと見なされます。

MAC=MACアドレス

ホストのMACアドレスを設定します。MACアドレスの情報は、Wake on LAN機能などに関連する情報のため、基本的にこのオペランドは変更しないでください。変更すると機能が動作しないおそれがあります。

COMMENT=コメント

コメントを設定します。コメントに「,」は使用できません。半角で64文字までの文字列が設定できます。

ROOT=経路

複数の中継システムを経由する場合に、上位の中継システムから下位の中継システムまでのフルパスを、ホスト名、IPアドレス、またはホスト識別子のどれかで設定します。2つ以上の中継システムおよび管理用中継サーバを経由する場合は、「¥」または「!」で区切って設定します。JP1/IT Desktop Management 2 - Managerと接続するホストの場合は、設定する必要はありません。

DATE=作成日時

ホストを管理用サーバに初めて登録する（した）日時です。年月日時分秒をYYYY/MM/DD/hh/mm/ssの形式で入力します。YYYYに指定できる値は1971〜2037で、hhに指定できる値は0〜23です。

省略した場合は、［ファイルから作成］を実行したときの日時が設定されます。

(3)　システム構成情報ファイルの内容をシステム構成情報に反映する

システム構成情報ファイルの内容をシステム構成情報に反映する方法を次に示します。

［システム構成］ウィンドウで、［ファイル］−［ファイルから作成］を選択する。

ファイルを選択するためのダイアログボックスが表示されます。

作成したシステム構成情報ファイルを選択し、［OK］ボタンをクリックする。

システム構成情報ファイルの内容がシステム構成情報に反映されます。

システム構成情報ファイルの内容をシステム構成情報に反映する場合、次の点に注意してください。

すでにシステム構成情報を作成していた場合、［システム構成］ウィンドウの内容はファイルに設定された内容に置き換えられます。既存のシステム構成情報にあって、ファイルに記述されていないホストは、システム構成情報から削除されます。

既存の［あて先］ウィンドウの内容は、IDの情報以外はすべて削除されます。

既存の［システム構成］ウィンドウの内容にホスト識別子が設定されている場合、必ずホスト識別子をそのまま設定してください。

システム構成情報を更新している間に、システム構成の自動登録機能の処理が発生すると、「root不正」のエラーになることがあります。この場合、しばらく待ってから実行し直してください。

5.1.5　システム構成情報を［システム構成］ウィンドウで作成する

［システム構成］ウィンドウで、ホストを定義する方法を次に示します。

［システム構成］ウィンドウをアクティブにし、ホストを設定する位置を選択する。

選択した位置の下位にホストを設定します。

［ファイル］−［ホストの新規作成］を選択する。

［ホストの作成］ダイアログボックスが表示されます。

図5‒2　［ホストの作成］ダイアログボックス

名前の指定

ホスト名、またはIPアドレスを指定します。

ホスト名の指定方法は「5.1.2　JP1/IT Desktop Management 2でのホスト名の付け方」を参照してください。

タイプ

ホストのタイプとして、管理用中継サーバ、中継システム、またはエージェントを選択します。選択しなかったときは、エージェントがデフォルトで選択されます。

コメント

任意のコメントを、半角で64文字まで入力できます。

項目を設定後、［終了］ボタンをクリックする。

ホストが定義されます。［追加］ボタンをクリックすると、続けてホストを追加できます。

5.1.6　管理用中継サーバ配下のシステム構成情報を取得する

配布管理システムを階層化したシステムでは、マネージャで管理用中継サーバ配下のシステム構成情報を作成、変更することはできません。管理用中継サーバが管理するシステム構成情報を「システム構成情報の取得」ジョブを実行して取得し、マネージャのシステム構成情報に追加します。システム構成の自動登録機能を使用して取得することもできますが、下位システムより先に上位システムの設定を完了させておく必要があります。そのため、導入時やシステム構成情報を大きく変更するときなど、設定の順番を考慮できない場合は、「システム構成情報の取得」ジョブを実行して取得してください。

マネージャ配下のシステム構成情報を取得したあとのシステム構成情報のメンテナンスには、システム構成の自動登録機能を使用します。管理用中継サーバ配下のシステム構成情報に変更が発生した時点で、管理用中継サーバから自動的に変更内容が通知され、マネージャのシステム構成情報に反映されます。

なお、3階層以上の大規模システムで、中継システムおよび管理用中継サーバの接続先を変更した場合、変更先の配布管理システムに、移動したシステム配下の情報が反映されないことがあります。反映されていない場合には、変更先の配布管理システムで、移動した中継システムおよび管理用中継サーバに対して、「システム構成情報の取得」ジョブを実行してください。

(1)　「システム構成情報の取得」ジョブの実行方法

(a)　ジョブの作成と実行

システム構成情報を取得するための、ジョブの作成手順を次に示します。操作および設定内容の詳細については、「10.2　ジョブを作成する」を参照してください。

［あて先］または［システム構成］ウィンドウで［実行］−［ジョブの実行］を選択する、または［ジョブ定義］ウィンドウで［ファイル］−［ジョブ定義の新規作成］を選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されます。

［ジョブ定義の新規作成］ダイアログボックスでジョブ種別（システム構成情報の取得）を指定し、［OK］ボタンをクリックする。

［ジョブの作成］ダイアログボックスが表示されます。

各パネルの項目を設定する。

［ジョブの作成］ダイアログボックス上に表示されるパネルの種類および設定内容は次のとおりです。

［ジョブ］パネル

ジョブ名を設定します。

［あて先］パネル

システム構成情報を取得する管理用中継サーバを指定します。管理用中継サーバ、または管理用中継サーバのあて先グループを指定してください。

［スケジュール］パネル

ジョブの登録日時、実行日時、および実行期限を設定します。

［実行］、［保存］、または［保存&実行］ボタンをクリックする。

ジョブが保存または実行されます。

(b)　実行結果の確認

ジョブを実行するとマネージャの［システム構成］ウィンドウに、管理用中継サーバ配下のシステム構成情報が反映されます。

図5‒3　［システム構成］ウィンドウ

(c)　ジョブ実行時の注意事項

「システム構成情報の取得」ジョブを実行すると、システム構成情報だけでなく、管理用中継サーバ配下のあて先グループの情報もマネージャの［あて先］ウィンドウに反映されます。しかし、管理用中継サーバ配下のIDの情報は、システム構成情報とIDを連携させる運用をしていたとしても、マネージャの［あて先］ウィンドウには反映されません。

「システム構成情報の取得」ジョブで取得したシステム構成情報は、ジョブを実行したシステムにしか反映されません。例えば、統括管理用サーバ、管理用中継サーバ、および中継システムの3階層の構成にしている場合に、統括管理用サーバから中継システムに対して「システム構成情報の取得」ジョブを実行すると、統括管理用サーバのシステム構成情報は更新されますが、管理用中継サーバのシステム構成情報は更新されません。管理用中継サーバのシステム構成情報も更新したいときは、管理用中継サーバで「システム構成情報の取得」ジョブを実行してください。

システム構成情報が登録されていない中継システムおよび管理用中継サーバに対して「システム構成情報の取得」ジョブを実行した場合、ジョブを実行したシステムがそれまでに取得していたシステム構成情報は、新しく取得されたシステム構成情報に合わせて削除されます。

(2)　システム構成の自動登録機能の設定

マネージャで次の設定をすると、管理用中継サーバが管理するシステム構成情報が自動的にマネージャに通知され、マネージャのシステム構成情報に反映されます。

設定内容

［リモートインストールマネージャを使用した配布のセットアップ］画面の［システム構成関連］パネルの「システム構成情報を自動反映する」のチェックボックスをオンにします。デフォルトはオンとなっているため、最初はオフに設定しておき、管理用中継サーバ配下のシステム構成情報をマネージャで取得したあと、オンに変更してください。

重要

システム構成の自動登録機能を設定しておくと、システム構成情報だけでなく、管理用中継サーバ配下のあて先グループの情報もマネージャの［あて先］ウィンドウに反映されます。しかし、管理用中継サーバ配下のIDの情報は、マネージャの［あて先］ウィンドウには反映されません。IDの情報も反映するには、システム構成情報とIDを連携させる設定にする必要があります。システム構成情報とIDの連携については、「5.4　システム構成情報とIDを連携させる運用」を参照してください。

5.1.7　システム構成情報を変更する

中継システム、または管理対象のコンピュータを追加または削除すると、システム構成の自動登録機能によって、変更した内容が自動的に配布管理システムに通知されます。通知された内容は、［システム構成］ウィンドウに自動的に反映されます。ここでは、配布管理システムからの操作でシステム構成情報を変更する方法について説明します。

なお、配布管理システム、中継システム、および管理用中継サーバのホスト名（IPアドレス運用の場合はIPアドレス）を変更する場合は、事前にすべてのジョブを完了させるか、または削除する必要があります。

(1)　ファイルから変更する

変更前のシステム構成情報をファイルに出力します。出力したファイルを更新したあと、このファイルからシステム構成情報を作成します。

システム構成の一部だけを変更する場合も、システム構成に残すすべてのホストをファイルに記述してください。ファイルに記述されていないホストは、システム構成から削除されます。

ホストを削除する場合は、そのホストの情報をファイルから削除してください。

システム構成情報をファイルに出力する方法、およびファイルからシステム構成情報を作成する方法については、「5.1.4　システム構成情報をファイルに出力して更新する」を参照してください。

(2)　システム構成ウィンドウで変更する

ここでは、［システム構成］ウィンドウからシステム構成情報を変更する方法を説明します。変更、削除するホストを検索する方法については、「6.1.1　名称によるホストの検索方法」を参照してください。

(a)　ホストを移動する

管理用中継サーバ、または中継システムを移動すると、下位のホストもすべて移動します。複数のホストを同時に移動するときは、［システム構成］ウィンドウの右枠で移動するホストを選択します。

ホストの移動は管理元の管理用中継サーバで実行できます。

ホストの移動方法は、次のとおりです。

［システム構成］ウィンドウをアクティブにし、移動するホストを選択する。

選択したホストが反転表示されます。

［編集］−［切り取り］を選択する。

選択したホストが切り取られます。なお、［切り取り］選択後は、左枠の「ネットワーク」をダブルクリックしないでください。ダブルクリックすると［編集］メニューの［貼り付け］が非活性になり、ホストを貼り付けられなくなります。この場合は、再度［切り取り］を選択し直してください。

移動先の位置を選択する。

選択した位置が反転表示されます。

［編集］−［貼り付け］を選択する。

切り取ったホストが、移動先に貼り付けられます。

なお、ホストの移動は、ドラッグ&ドロップの操作でも実行できます。

(b)　ホストを削除する

一度削除したホストを、元に戻すことはできません。管理用中継サーバ、または中継システムを削除すると、下位の管理対象のコンピュータもすべて削除されます。複数のホストを同時に削除するときは、［システム構成］ウィンドウの右枠で削除するホストを選択します。

［システム構成］ウィンドウでホストを削除する際には、［ホストの削除］ダイアログボックスが表示されます。［ホストの削除］ダイアログボックスの「登録しているIDからも削除する」チェックボックスをオンにすると、対象のホストが登録されているIDからも削除されます。このチェックボックスは、選択したホストがエージェントの場合だけオンにできます。選択したホストが管理用中継サーバ、または中継システムの場合は削除できません。あらかじめ［システム構成］ウィンドウで対象の管理用中継サーバ、または中継システムと同じコンピュータ上のエージェントおよび配下のエージェントを削除してから管理用中継サーバ、または中継システムを削除してください。

ホストの削除方法は、次のとおりです。

［システム構成］ウィンドウをアクティブにし、削除するホストを選択する。

選択したホストが反転表示されます。

［編集］−［削除］を選択する。

確認ダイアログボックスが表示されます。

［OK］ボタンをクリックする。

選択したホストが削除されます。

ホストを検索したあと、［検索］ダイアログボックスでホストを削除することもできます。詳細は、「6.1.4　検索したホストをシステム構成情報から削除する」を参照してください。

(c)　ホスト名を変更する

ホスト名を変更すると、変更した内容が自動的に配布管理システムに通知されます。通知された内容は、［システム構成］ウィンドウに自動的に反映されます。一度設定したホスト名は、［システム構成］ウィンドウで変更できます。ホスト名の変更は、管理元の管理用中継サーバで実行してください。

［システム構成］ウィンドウでホスト名を変更する手順を次に示します。

［システム構成］ウィンドウで名称を変更するホストを選択する。

選択したホストが反転表示されます。

［ファイル］−［名前の変更］を選択する。

名称を設定後、［Enter］キーを押す。

設定した名前に変更されます。

［システム構成］ウィンドウでホスト名を変更すると、［あて先］ウィンドウにある同じホスト名も変更されます。

(d)　ホストの属性を変更する

ホストの属性を中継システムからエージェントへ（またはエージェントから中継システムへ）変更したり、経路やコメントを変更したりする場合は、［ファイル］−［属性の変更］を選択すると表示される［属性の変更］ダイアログボックスを使用します。

なお、ホスト種別を変更する場合は、次の点にご注意ください。

［システム構成］ウィンドウでホストの属性を変更すると、［あて先］ウィンドウにある同じホストの属性も変更されます。

管理用中継サーバのホスト種別は変更できません。管理用中継サーバの場合、「IPアドレス」、「コメント」だけが変更できます。

図5‒4　［属性の変更］ダイアログボックス

ホスト名

ホスト名が表示されます。ホスト名は、運用キーがIPアドレスの場合に変更できます。

IPアドレス

IPアドレスが表示されます。IPアドレスは、運用キーがホスト名の場合に変更できます。

タイプ

ホストのタイプとして、中継システムまたはエージェントを選択します。ホストのタイプを中継システムからエージェントに変更すると、変更前に設定されていた中継システム下のホストは、すべて削除されます。

経路

ホスト名を「!」で区切って、経路を設定します。存在しない経路を設定したときは、経路は変更されないで、エラーとなります。

［参照］ボタン

システム構成から経路を選択できる［パスの設定］ダイアログボックスが表示されます。

コメント

任意のコメントを半角で64文字まで入力できます。

(3)　管理用中継サーバ配下のシステム構成情報を変更する

自サーバから、管理用中継サーバ配下のシステム構成情報を変更することはできません。管理用中継サーバ配下のシステム構成情報が変更された場合は、システム構成の自動登録機能を使用する、または自サーバから「システム構成情報の取得」ジョブを実行して、変更された情報を自サーバのシステム構成情報に反映してください。

ただし、自サーバの［システム構成］ウィンドウで、管理用中継サーバ配下のホストのコメントを変更することはできます。

なお、3階層以上の大規模システムで、管理用中継サーバまたは中継システムの接続先を変更した場合、変更先の配布管理システムに、移動したシステム配下の情報が反映されないことがあります。反映されていない場合には、変更先の配布管理システムで、移動した管理用中継サーバまたは中継システムに対して、「システム構成情報の取得」ジョブを実行してください。

(4)　システム構成情報を変更するときの注意事項

システム構成情報を変更するときの注意事項を次に示します。

ノード識別キーを変更する場合

ノード識別キーを変更する場合、システム構成情報をリモートインストールマネージャから削除しておいてください。システム構成情報は、ファイルに出力しておくと便利です。ノード識別キーを変更したあと、出力したファイルを使用してシステム構成情報を設定できます。

システム構成情報を手動で作成した場合、出力したシステム構成情報ファイルには、使用中のノード識別キーで各ホストのアドレスが記述されています。そのため、出力したファイルに各ホストのホスト名またはIPアドレスを記述する必要があります。例えば、ノード識別キーをホスト名からIPアドレスに変更する場合、ノード識別キーを変更する前に出力したファイルにはIPアドレスが記述されていません。メモ帳などでIPアドレスを記述するか、hostsファイルを読み込んで、システム構成情報を作成してください。

ホスト名を変更する場合

管理用サーバのホスト名を変更した場合は、そのホストに接続する下位システムで、接続先のホスト名を変更してください。下位システムが管理用中継サーバの場合はセットアップで、下位システムが中継システムまたはエージェントの場合はエージェント設定で変更できます。

なお、中継システムのホスト名を変更した場合は、その中継システムを管理する上位の管理用サーバのエージェント設定で、中継システムのホスト名を変更してください。

ノード識別キーのキー項目がホスト名のときは、ホスト名を変更したあと、コンピュータを再起動してください。

5.1.8　システム構成情報を作成するときの注意事項

システム構成情報を作成するときの注意事項を次に示します。

システム構成の階層は7階層までをサポートしています。

システム構成に中継システムを作成する場合は、ノード識別キーで選択したアドレス（ホスト名またはIPアドレス）で中継システムと同一名称のエージェントを、中継システム下に作成する必要があります。中継システム下に作成した、中継システムと同一名称のエージェントは、ほかの経路に移動しないでください。

5.2　あて先グループを作成する

［あて先］ウィンドウでは［システム構成］ウィンドウで設定したホストを、あて先グループに分けて管理できます。

ここでは、あて先グループの作成方法について説明します。

5.2.1　あて先グループの作成方法の種類

あて先グループを作成するには、次の方法があります。どの方法で作成するかは、あて先グループの特性によって判断してください。

システム構成情報を利用して作成する

システム構成情報をテキストファイルに出力して、これを編集してあて先グループを作成し、［あて先］ウィンドウに取り込む方法です。物理的なネットワーク構成に沿ったグループを作成する場合は、この方法が便利です。

詳細については、「5.2.3　あて先グループをファイルから作成する」を参照してください。

［あて先］ウィンドウ上の操作で作成する

GUI操作で、直接［あて先］ウィンドウ上にあて先グループを作成する方法です。ネットワーク構成と関係のないあて先グループを作成する場合や、すでに作成しているあて先グループの情報を変更する場合は、この方法が便利です。

詳細については、「5.2.4　あて先グループを［あて先］ウィンドウで作成する」を参照してください。

条件（ポリシー）に従って自動作成する

あらかじめ設定しておいたグルーピング条件（ポリシー）に従って、新たに追加されたホストや移設されたホストを、あて先グループに自動的に振り分ける方法です。詳細については、「6.2　あて先グループの自動メンテナンス」を参照してください。

5.2.2　グループ名の付け方

あて先グループ名およびID名は、32バイトまで設定できます。ただし、次に示す制限があります。

次に示す半角文字は使用できません。

「!」「"」「%」「'」「*」「.」「/」「:」「<」「>」「?」「@」「¥」「|」

スペースは使用できません。

大文字と小文字は区別されないため、大文字を小文字に（または小文字を大文字に）変換すると同一名称となるような名称は使用できません。

また、作成できるあて先グループの階層は7階層までです。最上層からあて先グループ名を連結した文字数（各あて先グループ名の先頭の区切り文字を含む）と、末端のホスト名の文字数（ホスト名の先頭の区切り文字を含む）を合計した文字数が255バイトを超える名称は設定できません。

5.2.3　あて先グループをファイルから作成する

あて先グループの情報を設定したファイル（あて先グループファイル）を作成して、あて先グループを作成します。

(1)　あて先グループファイルを作成する

あて先グループファイルには、1つのあて先につき、あて先名、あて先のタイプ、所属あて先グループのパスなどを設定します。表示言語が日本語の場合、Shift_JISエンコーディング形式のテキストファイルを使用して入出力します。表示言語が中国語（簡体字）の場合、GBKエンコーディング形式のテキストファイルを使用して入出力します。表示言語が英語の場合、ASCIIコード形式のテキストファイルを使用して入出力します。1カラム目に「'」（シングルクォーテーション）または「#」を付けると、その行はコメントと見なされます。

なお、システム構成情報をテキストファイルに出力し、これを加工すると簡単にあて先グループファイルを作成できます。作成例については、「5.2.6　あて先グループの作成例」を参照してください。

形式

あて先名 HID=ホスト識別子,TYPE=あて先のタイプ,MAC=MACアドレス,ROOT=所属あて先グループのパス,DATE=作成日時

説明

TYPE＝あて先のタイプ以降の順序は任意です。

●あて先名（必ず設定）

あて先グループまたはホストの名称を設定します。

あて先名があて先グループの場合は、「* あて先グループ名」という形式で指定します。先頭の「*」は半角です。「*」とあて先グループ名の間を半角スペースで区切ります。あて先グループ名はユニークに設定します。あて先グループ名の付け方については、「5.2.2　グループ名の付け方」を参照してください。

あて先名がホストの場合、あて先名の指定方法はノード識別キーによって異なります。

ノード識別キーにホスト名を使用している場合、あて先名は「* ホスト名」という形式で指定します。先頭の「*」は半角です。「*」とホスト名の間を半角スペースで区切ります。「*」の代わりに、別の文字または文字列（スペース以外）を設定してもかまいません。例えば、「*」の部分に、IPアドレスを設定することもできます。

ノード識別キーにIPアドレスを使用している場合、あて先名は「IPアドレス *」という形式で指定します。先頭のIPアドレスと半角の「*」の間は半角スペースで区切ります。「*」の代わりに、別の文字または文字列を設定してもかまいません。例えば、「*」の部分に、ホスト名を設定することもできます。また、「*」を省略してもかまいません。

なお、マネージャであて先グループファイルを作成する場合、あて先名に指定できるホストは、システム構成情報に登録しているホストです。

●HID=ホスト識別子

ホストを一意に認識するホスト識別子を設定します。［あて先］ウィンドウで［ファイル］−［ファイルへ保存］を選択してあて先グループの情報をファイルに出力し、ホスト識別子が設定されていた場合、必ずこのホスト識別子をそのまま設定してください。なお、［ファイルへ保存］で出力したあて先グループファイルにホスト識別子が設定されていないホスト、または新規に追加するホストについては、このオペランドを指定しないでください。

●TYPE=あて先のタイプ

あて先のタイプとして次のホスト種別を設定できます。省略したときは、デフォルトで「CLIENT」が設定されます。

GROUP（あて先グループ）

MANAGER（管理用中継サーバ）

MASTER（中継システム）

CLIENT（エージェント）

●MAC=MACアドレス

ホストのMACアドレスを設定します。MACアドレスの情報は、Wake on LAN機能などに関連する情報のため、基本的にこのオペランドは変更しないでください。変更すると機能が動作しないおそれがあります。

●ROOT=所属あて先グループのパス

所属あて先グループをフルパスで設定します。ROOTを設定しない場合は、直前のあて先グループを所属あて先グループとして、TYPEオペランドで設定されたタイプであて先を作成します。

●DATE=作成日時

ホストを管理用サーバに初めて登録する（した）日時です。年月日時分秒をYYYY/MM/DD/hh/mm/ssの形式で入力します。YYYYに指定できる値は1971〜2037で、hhに指定できる値は0〜23です。

省略した場合は、［ファイルから作成］を実行したときの日時が設定されます。

(2)　ファイルからあて先グループを作成する

あて先グループファイルからあて先グループを作成すると、［あて先］ウィンドウの内容は、あて先グループファイルに設定された内容に置き換えられます。既存の［あて先］ウィンドウのあて先グループを保存するときは、ファイル名を付けて保存してください。

既存の［あて先］ウィンドウの内容にホスト識別子が設定されている場合、必ずホスト識別子をそのまま設定してください。

ファイルからのあて先グループの作成方法を次に示します。

［あて先］ウィンドウで、［ファイル］−［ファイルから作成］を選択する。

作成したあて先グループファイルを選択し、［OK］ボタンをクリックする。

(3)　あて先グループをファイルに出力する

［あて先］ウィンドウのあて先グループの構成をファイルに出力できます。あて先グループを変更する場合は、変更前のあて先グループをファイルに出力し、このファイルを編集すると便利です。

あて先グループの構成をファイルに出力する方法を次に示します。

［あて先］ウィンドウで、［ファイル］−［ファイルへ保存］を選択する。

［あて先の保存］ダイアログボックスが表示されます。なお、この操作は、［最新の情報に更新］を実行したあと、行ってください。自動反映によって画面の状態と内部データの不一致が発生した場合、正しい情報が出力されないことがあります。

ファイル名を設定し、［OK］ボタンをクリックする。

あて先グループの構成がファイルに出力されます。

あて先グループの構成のファイル出力例を次に示します。

図5‒5　あて先グループの構成のファイル出力例

5.2.4　あて先グループを［あて先］ウィンドウで作成する

あて先グループを作成したあと、あて先グループに属するホスト（中継システムまたはエージェント）を登録します。

(1)　あて先グループの作成手順

あて先グループの作成方法を次に示します。あて先グループ下にあて先グループを作成することはできますが、上位のあて先グループと同じ名称を下位のあて先グループに付けることはできません。作成できるあて先グループの階層は7階層までです。

［あて先］ウィンドウをアクティブにし、あて先グループを作成する位置を選択する。

選択した位置の下位にあて先グループを作成します。

［ファイル］−［グループの新規作成］を選択する。

［あて先グループの作成］ダイアログボックスが表示されます。

図5‒6　［あて先グループの作成］ダイアログボックス

「あて先グループの作成」を選択し、作成するあて先グループの名称をユニークに設定します。あて先グループ名の付け方については、「5.2.2　グループ名の付け方」を参照してください。

項目を設定後、［実行］ボタンをクリックする。

あて先グループが作成されます。作成をやめるときは［終了］ボタンをクリックしてください。

(2)　ホストの登録

作成したあて先グループに、ホストを登録する方法を次に示します。［システム構成］ウィンドウにないホストは、［あて先］ウィンドウでは設定できません。

［あて先］ウィンドウをアクティブにし、ホストを設定する位置を選択する。

選択した位置の下位にホストを設定します。

［ファイル］−［あて先の新規作成］を選択する（または、ホストの作成ボタンをクリックする）。

［あて先の作成］ダイアログボックスが表示されます。

図5‒7　［あて先の作成］ダイアログボックス

所属あて先グループ名

ホストを登録するあて先グループの名称が表示されます。

あて先名

登録するホストのホスト名またはIPアドレスを指定します。

［追加］ボタンをクリックしたあと、システム構成内に同じホスト名のホストが複数存在する場合、［あて先の選択］ダイアログボックスが表示されます。どのタイプのホストを選択するか指定します。

図5‒8　［あて先の選択］ダイアログボックス

項目を設定後、［終了］ボタンをクリックする。

設定を保存して［あて先の作成］ダイアログボックスが閉じます。

このとき［追加］ボタンをクリックすると、続けてホストを追加できます。

また、［システム構成］ウィンドウに表示されているホストをあて先グループのアイコンにドラッグ&ドロップして、ホストを登録することもできます。

5.2.5　あて先グループを変更する

ここでは、あて先グループを変更する方法を説明します。

登録済みの情報に、あて先グループまたはホストを追加登録する場合は「5.2.5(1)　ファイルから追加する」を参照してください。登録済みの情報をいったん初期化して登録し直す場合は「5.2.5(2)　ファイルから変更する」を参照してください。

(1)　ファイルから追加する

JP1/IT Desktop Management 2 - Managerのリモートインストールマネージャを使用する場合は、あて先グループまたはホストをファイルから追加できます。

あて先グループまたはホストをファイルから追加する方法を次に示します。

追加したいあて先グループまたはホストだけを設定した、あて先グループファイルを作成する。

あて先グループファイルを作成する方法は、「5.2.3(1)　あて先グループファイルを作成する」を参照してください。

［あて先］ウィンドウで、［ファイル］−［ファイルから追加］を選択する。

［あて先の追加］ダイアログボックスが表示されます。

手順1.で作成したあて先グループファイルを選択し、［開く］ボタンをクリックする。

あて先グループまたはホストの登録が開始されます。

(2)　ファイルから変更する

変更前のあて先グループの構成をファイルに出力します。出力したファイルを更新したあと、このファイルからあて先グループを作成します。

あて先グループの構成をファイルに保存する方法、および保存したファイルからあて先グループを作成する方法については、「5.2.3　あて先グループをファイルから作成する」を参照してください。

(3)　［あて先］ウィンドウで変更する

［あて先］ウィンドウから、あて先グループを変更する方法を説明します。変更するあて先グループまたはホストを検索する方法については、「6.1.1　名称によるホストの検索方法」を参照してください。

(a)　あて先グループ名の変更

あて先グループ名を変更する方法を次に示します。［あて先］ウィンドウでは、ホストのあて先名は変更できません。

［あて先］ウィンドウで名称を変更するあて先グループを選択する。

選択したあて先グループが反転表示されます。

［ファイル］−［名前の変更］を選択する。

名称を設定後、［Enter］キーを押す。

設定した名称に変更されます。

(b)　あて先グループまたはホストの編集（削除、コピー、移動）

あて先グループまたはホストを編集（削除、コピー、移動）する場合、［あて先］ウィンドウをアクティブにし、編集するあて先グループまたはホストを選択して［編集］メニューから［削除］、［コピー］、［切り取り］、および［貼り付け］を選択します。

また、あて先グループまたはホストは、ドラッグ&ドロップの操作でも編集できます。

注意事項

［コピー］または［切り取り］選択後は、左枠の「ネットワーク」をダブルクリックしないでください。

ダブルクリックすると［貼り付け］が非活性になり、ホストを貼り付けられなくなります。この場合は、再度［コピー］または［切り取り］を選択してください。

［あて先］ウィンドウを複数表示している場合、あるウィンドウでコピーしたあて先グループまたはホストを、別のウィンドウに貼り付けることはできません。

(c)　あて先を編集するときの注意事項

［あて先］ウィンドウで、あて先グループまたはホストを編集（削除、コピーまたは移動）しているときに通信障害などが発生すると、障害前の状態に戻すことができない場合があります。このため、多数のあて先グループまたはホストを編集する場合、編集する前にあて先グループの構成をファイルに保存しておくことをお勧めします。

あて先グループの構成をファイルに保存する方法、および保存したファイルからあて先グループを作成する方法については、「5.2.3　あて先グループをファイルから作成する」を参照してください。

5.2.6　あて先グループの作成例

システム構成情報およびあて先グループの作成例を次に示します。

システム構成情報およびあて先グループの構成

次の図に示す構成で、システム構成情報は自動的に作成し、あて先グループはシステム構成情報ファイルを編集して作成します。

図5‒9　システム構成およびあて先グループの構成

システム構成情報ファイル

自動的に作成されたシステム構成情報をファイルに出力した結果を、次に示します。

図5‒10　システム構成情報ファイル

あて先グループファイル

システム構成情報ファイルを編集して作成したあて先グループファイルを、次に示します。システム構成情報を出力するには、［システム構成］ウィンドウで［ファイル］−［ファイルの保存］を選択します。

図5‒11　あて先グループファイル

5.3　IDを作成する

IDも、あて先グループと同様、リモートインストールマネージャの［あて先］ウィンドウで作成します。IDを作成するのは配布管理システムですが、作成したIDは、IDを管理する中継システムおよび管理用中継サーバ（ID管理元中継）に通知され、管理されます。利用者側からのIDへの登録状況も、ID管理元中継で管理されます。

ここでは、IDの運用の概要を説明したあと、IDの作成や管理対象のコンピュータの登録の詳細を説明します。

5.3.1　IDの運用方法

IDの運用例を次の図に示します。

図5‒12　IDの運用例

次に、IDの運用手順、階層化したシステムでの運用方法、および、中継システムおよび管理用中継サーバでIDを使用する場合の運用方法について説明します。

(1)　IDの運用手順

(a)　IDを作成する

IDは、配布管理システムで次に示す情報を設定して作成します。

IDの名称

ここで設定したID名称が、ジョブの配布時に配布先として選択できます。

パスワード（オプション）

利用者がIDに登録するときに登録を許可するパスワードを設定できます。パスワードを設定するとIDに利用者が登録するときは、ここで指定したパスワードを入力する必要があります。

ID管理元中継

ID管理元中継として使用するホスト（中継システムおよび管理用中継サーバ）を指定します。ID管理元中継は、1つのIDに対して複数指定できます。

(b)　管理対象のコンピュータをIDへ登録する

IDへの登録は、［IDへの登録］ダイアログボックスを使用して、管理対象のコンピュータで実行します。管理対象のコンピュータからID管理元中継に接続して、そのID管理元中継が管理しているIDに登録します。また、配布管理システム側でコンピュータをIDに登録することもできます。JP1/IT Desktop Management 2に新規に追加されたコンピュータを自動的にIDに登録することもできます。

管理対象のコンピュータに対応するID管理元中継は、エージェントのセットアップ時に［接続先設定］パネルに表示される上位システムです。JP1/IT Desktop Management 2 - Managerの場合は、管理用中継サーバのセットアップで設定した上位システムとなります。

(c)　配布管理システムからあて先にIDを指定したジョブを実行する

あて先にIDを指定できるジョブは次のとおりです。

パッケージのインストール※

クライアントユーザによるインストール

コンピュータ（UNIX）のシステム情報の取得※

コンピュータ（UNIX）のソフトウェア情報の取得※

注※

このジョブはMacエージェントにも適用できます。

あて先にIDを指定したジョブ（IDジョブ）は、指定したIDを管理するID管理元中継に転送されます。ID管理元中継では転送されたジョブを保管し、このIDに登録されているコンピュータに対してジョブを実行します。IDジョブが実行されたあと、このIDにコンピュータが登録されると、登録した時点で保存されているIDジョブが実行されます。そのため、IDを指定してジョブを実行する場合は、配布するパッケージの中継システムでの保管期限を考慮してください。中継システムでの保管期限を過ぎるとパッケージが中継システムから削除されるため、IDに登録したコンピュータへパッケージが配布されません。

(d)　IDジョブの実行結果

次に示すジョブでIDを指定した場合、管理対象のコンピュータでの実行結果を配布管理システムで確認できます。IDジョブの実行結果の確認方法については、「10.4.4　ジョブの実行状況の表示方法」を参照してください。

パッケージのインストール

クライアントユーザによるインストール

(e)　IDの編集

作成したIDは、IDを作成した配布管理システムで次に示す編集ができます。

ID管理元中継の追加・削除

パスワードの変更

IDの削除

管理対象のコンピュータのIDへの登録（ファイルから）

ID管理元中継へのIDの登録

注意事項

同時に同じIDの編集操作を行なわないでください。

(2)　配布管理システムを階層化したシステムでのIDの運用方法

配布管理システムを階層化したシステムで、IDを使用する場合の運用方法を次に示します。

(a)　管理用サーバでのIDの作成

管理用サーバでIDを作成する場合、ID管理元中継として配下の中継システムおよび管理用中継サーバを設定できます。

ID管理元中継として中継システムおよび管理用中継サーバを設定する方法については、「5.3.2　IDの作成」を参照してください。

(b)　管理用中継サーバでのIDの管理

管理用中継サーバでは、管理用中継サーバで作成したIDのほか、上位の管理用サーバからID管理元中継として指定されたIDが［あて先］ウィンドウに表示されます。

管理用中継サーバでは、上位の管理用サーバが作成したIDに対して次の操作ができます。

IDの削除

IDに登録しているコンピュータを削除

(c)　複数の配布管理システムで同じIDを管理する場合

次の図に示すように、複数の管理用サーバで、同一のIDを作成できます。

図5‒13　複数の配布管理システムで同じIDを管理する

統括管理用サーバ（Man00）および管理用中継サーバ（Man01）の両方で、中継システム（Sub00）をID管理元中継として、「Windows7」のIDを作成できます。

ただし、Man00がMan01をID管理元中継として、「Windows7」のIDを作成することはできません。Man01では同一名称のIDが作成済みのため、自システムで作成したIDと同じIDに対して、Man00のID管理元中継となることはできません。

IDを削除、またはID管理元中継を変更した場合は、変更したシステムから上位のシステムへ変更内容が通知され、上位のシステムに自動的に反映されます。

複数の配布管理システムで管理されているIDを削除する例を、次の図に示します。

図5‒14　複数の配布管理システムで管理されているIDを削除する

5.3.2　IDの作成

IDを作成する方法を次に示します。

［あて先］ウィンドウで、［ファイル］−［IDの作成］を選択する。

［IDの作成］ダイアログボックスが表示されます。

図5‒15　［IDの作成］ダイアログボックス

ID名称

IDの名称を設定します。ID名の付け方については、「5.2.2　グループ名の付け方」を参照してください。

パスワード

利用者がIDに登録するときに入力するパスワードを設定します。半角英数字で14文字までのパスワードが設定できます。パスワードの指定は省略できます。なお、入力した文字は「*」に変換して表示されます。

ID管理元中継の設定

ID管理元中継を設定します。複数のホストをID管理元中継として設定できます。

「システム構成」には、［システム構成］ウィンドウに表示されるホストのうち、中継システムと管理用中継サーバが表示されます。「システム構成」でID管理元中継にするホストを選択し、［>］ボタンをクリックすると、ID管理元中継に設定されます。「システム構成」では、同時に複数のホストを選択できます。

また、［ALL>］ボタンをクリックすると、すべての中継システムおよび管理用中継サーバを、一括してID管理元中継に設定できます。

IDを設定後、［追加］ボタンをクリックする。

IDが作成されます。

ID管理元中継を追加するときに、追加処理に失敗して「登録中」のままとなることがあります。このような場合は、失敗要因を取り除いてから再実行してください。

「登録中」状態のID管理元中継は「IDの削除」で強制的に削除できます。

［終了］ボタンをクリックする。

［IDの作成］ダイアログボックスが閉じます。

定義したIDは、［あて先］ウィンドウで確認できます。IDを管理する中継システムおよび管理用中継サーバは、［あて先］ウィンドウの右枠の［ID管理元中継］タブを選択すると表示されます。

図5‒16　［あて先］ウィンドウの［ID管理元中継］パネル

5.3.3　管理対象のコンピュータの登録方法

IDへ管理対象のコンピュータを登録させる方法には次の3種類があります。

管理対象のコンピュータからIDへ登録する。

配布管理システムからファイルを使って管理対象のコンピュータをIDに登録する。

IDの自動メンテナンスを使用して管理対象のコンピュータをIDに登録する。

(1)　管理対象のコンピュータからIDに登録する

管理対象のコンピュータは、Windowsの［スタート］メニューの［IDへの登録］を選択して表示される［IDへの登録］ダイアログボックスを使用して、IDへ登録します。

IDへの登録は、ID管理元中継と接続されている状態で処理します。しかし、ID管理元中継と接続されていない状態でも、IDへの登録やIDからの登録解除を待ち状態にできます。ID管理元中継と接続できる状態になってからあとにログオンした時、または［IDへの登録］を選択した時に、実際の登録や登録解除をID管理元中継に通知します。そのため、プレインストールやシステム構築の準備段階でもIDへの登録ができます。また、管理対象のコンピュータがリモートインストールなどを実行している最中は、ID管理元中継とは別機能で接続している状態です。この場合も、ID管理元中継と接続されていないときと同じように扱われます。

管理対象のコンピュータでのIDへの登録方法については、「12.2.1　IDへの登録」を参照してください。

(2)　配布管理システムからファイルを使って管理対象のコンピュータをIDに登録する

配布管理システム上で、ファイルを使って管理対象のコンピュータをIDに登録できます。新規導入時などに、大量のコンピュータをIDに登録する必要がある場合などに便利です。ファイルには、複数のコンピュータのID登録情報を設定しておきます。このようなファイルをIDファイルと呼びます。ファイルを使って管理対象のコンピュータをIDに登録する方法を次に示します。

(a)　IDファイルを作成する

IDファイルでは、1つのホストごとに、ホスト名、ホスト識別子、ID名称、ID管理元中継名称などを設定します。

なお、表示言語が日本語の場合、Shift_JISエンコーディング形式のテキストファイルを使用して入出力します。表示言語が中国語（簡体字）の場合、GBKエンコーディング形式のテキストファイルを使用して入出力します。表示言語が英語の場合、ASCIIコード形式のテキストファイルを使用して入出力します。

ファイルはテキスト形式で、1カラム目に「'」（シングルクォーテーション）または「#」を付けると、その行はコメントと見なされます。

形式

ホスト名 HID=ホスト識別子,MAC=MACアドレス,ID=ID名称,MASTER=ID管理元中継名称

説明

●ホスト名（必ず設定）

IDに追加するホスト名またはIPアドレスを指定します。64バイトまで指定できます。

●HID=ホスト識別子

ホストを一意に認識する識別子を設定します。［ファイル］−［IDホストをファイルへ保存］でファイルに出力したIDにホスト識別子が設定されていた場合は、［ファイルからID登録］で管理対象のコンピュータをIDへ登録する場合にも、このホスト識別子を必ずそのまま設定してください。なお、［IDホストをファイルへ保存］で出力したファイルのIDにホスト識別子が設定されていないホスト、または新規に追加するホストについては、このオペランドを指定しないでください。

●MAC=MACアドレス

ホストのMACアドレスを設定します。MACアドレスの情報は、Wake on LAN機能などに関連する情報のため、基本的にこのオペランドは変更しないでください。変更すると機能が動作しないおそれがあります。

●ID=ID名称（必ず設定）

追加するID名称を指定します。32バイトまで指定できます。

●MASTER=ID管理元中継名称

追加するIDが存在する中継システムまたは管理用中継サーバのホスト識別子を指定します。管理用中継サーバの場合は、ホスト名またはホスト識別子を指定します。［IDホストをファイルへ保存］でIDをファイルに出力し、ホスト識別子が設定されていた場合は、必ずこのホスト識別子をそのまま設定してください。

64バイトまで指定できます。配布管理システムでこのパラメタを省略した場合、配布管理システム上のIDに管理対象のコンピュータを登録します。

(b)　ファイルを使って管理対象のコンピュータをIDに登録する

作成したIDファイルを使って管理対象のコンピュータをIDに登録するには、配布管理システムの［あて先］ウィンドウで、メニューの［ファイル］−［ファイルからID登録］を選択し、作成したIDファイルを選択します。

(c)　IDをファイルに出力する

配布管理システムに設定したIDと、IDに登録されているホストの情報をファイルに出力するには、［あて先］ウィンドウで、［ファイル］−［IDホストをファイルへ保存］を選択します。なお、この操作は、［最新の情報に更新］を実行したあと、行ってください。自動反映によって画面の状態と内部データの不一致が発生した場合、正しい情報が出力されないことがあります。

IDの情報のファイルへの出力例を次に示します。

図5‒17　IDの情報のファイルへの出力例

(3)　IDの自動メンテナンスを使用して管理対象のコンピュータをIDに登録する

IDの自動メンテナンスを使用して、一定の条件に一致した管理対象のコンピュータを自動的にIDに登録できます。

IDの自動メンテナンスを使用して管理対象のコンピュータをIDに登録する方法については、「6.3　IDの自動メンテナンス」を参照してください。

5.3.4　IDの編集

IDを作成した配布管理システムでは次に示すIDの編集ができます。

ID管理元中継を変更する。

パスワードを変更する。

IDを削除する。

管理対象のコンピュータをIDへ登録する。

IDに登録しているコンピュータを削除する。

ID管理元中継へIDを登録する。

注意事項

同時に同じIDの編集操作を行なわないでください。

(1)　ID管理元中継およびパスワードの変更

自サーバで作成したID管理元中継、およびIDへの登録時に必要なパスワードを変更できます。IDの属性を変更する方法を次に示します。

［あて先］ウィンドウで、［ファイル］−［IDの属性変更］を選択する。

［IDの属性変更］ダイアログボックスが表示されます。

変更後のID管理元中継を設定する。

変更後のID管理元中継、またはパスワードを設定します。

ID管理元中継を変更後、［OK］ボタンをクリックする。

ID管理元中継が変更されます。

ID管理元中継を変更する場合、処理に時間が掛かることがあります。［あて先］ウィンドウに変更した結果が表示されない場合は、しばらく時間をおいたあと、メニューの［ウィンドウ］−［最新の情報に更新］を選択して、再度表示させてください。

(2)　IDの削除

IDを削除する方法を次に示します。

［あて先］ウィンドウで削除するIDを選択し、［ファイル］−［IDの削除］を選択する。

削除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

選択したIDが削除されます。削除したIDは、［あて先］ウィンドウでは「削除中」の状態で表示され、削除されません。IDの削除が完了したあと、メニューの［ウィンドウ］−［最新の情報に更新］を選択すると、削除されます。

(3)　IDに登録したコンピュータの削除

IDに登録したコンピュータの削除方法を次に示します。

［あて先］ウィンドウで、削除するコンピュータを選択し、［編集］−［削除］を選択する。

削除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

選択したコンピュータが削除されます。多階層の構成では、削除に時間が掛かる場合があります。

削除したコンピュータは、削除した時点では「削除中」の状態で［あて先］ウィンドウに表示されています。登録していたIDから削除が完了したあと、メニューの［ウィンドウ］−［最新の情報に更新］を選択すると、表示されなくなります。

(4)　ID管理元中継へのIDの登録

IDを作成した配布管理システムで、ID管理元中継へIDを登録できます。複数のIDを一括してID管理元中継へ登録できるので、ID管理元中継を増設した場合に便利です。

ID管理元中継をIDへ登録する場合は、「5.3.4(1)　ID管理元中継およびパスワードの変更」を参照してください。

(a)　ID管理元中継へIDを登録する

ID管理元中継へIDを登録する方法を次に示します。

［システム構成］ウィンドウで、［ファイル］−［ID管理元中継へのIDの登録・削除］を選択する。

［ID管理元中継へのIDの登録・削除］ダイアログボックスが表示されます。

図5‒18　［ID管理元中継へのIDの登録・削除］ダイアログボックス

「ID一覧」から登録するIDを選択し、［＞］ボタンをクリックする。

「管理するID一覧」へIDが追加されます。

［OK］ボタンをクリックする。

ID管理元中継へIDが登録されます。

(b)　ID管理元中継からIDを削除する

ID管理元中継に登録されているIDを削除する方法を次に示します。

［システム構成］ウィンドウで、［ファイル］−［ID管理元中継へのIDの登録・削除］を選択する。

［ID管理元中継へのIDの登録・削除］ダイアログボックスが表示されます。

「管理するID一覧」から削除するIDを選択し、［＜］ボタンをクリックする。

「管理するID一覧」からIDが削除されます。

［OK］ボタンをクリックする。

ID管理元中継からIDが削除されます。

5.3.5　IDを使用する場合の注意事項

IDを使用する場合の注意事項を次に示します。

(1)　IDに登録しているコンピュータでシステム構成情報を削除した場合

IDに登録しているコンピュータがセットアップの設定でシステム構成情報を削除しても、登録しているIDの情報は連動して削除されません。そのため、管理対象のコンピュータのシステム構成情報を削除する前に、登録しているIDを解除してください。

IDを解除しないで、システム構成情報を削除した場合、リモートインストールマネージャから削除してください。削除方法については、「5.3.4　IDの編集」を参照してください。

なお、自動的にシステム構成情報とIDの情報を連携させる運用もできます。詳細については、「5.4　システム構成情報とIDを連携させる運用」を参照してください。

(2)　［IDグループの編集］フォルダが作成された場合

［ジョブ実況状況］ウィンドウに［IDグループの編集］フォルダが作成された場合は、［IDグループの編集］フォルダ、およびフォルダ内のジョブを削除しないでください。

［IDグループの編集］フォルダには、管理対象のコンピュータをIDに登録したり、ID管理元中継を追加したりするためのジョブが格納されます。これらのIDを編集するジョブは、自動的に作成され、正常終了すると自動的に削除されます。

IDを編集するジョブを手動で削除してしまった場合は、IDの編集が実施されなくなるため、IDを編集する操作（管理対象のコンピュータのIDへの登録やID管理元中継の追加など）をし直してください。

5.4　システム構成情報とIDを連携させる運用

システム構成情報が変更された場合、システム内の関連するIDの情報を連携して変更させることができます。この機能を利用するとシステム管理者がIDを管理する負担を軽減できます。

5.4.1　システム構成情報とIDを連携させるには

システム構成情報とIDの情報を連携させたい場合は、JP1/IT Desktop Management 2 - Managerのセットアップの［リモートインストールマネージャを使用した配布のセットアップ］画面の［システム構成関連］パネルで、［システム構成の変更を同期させる］のチェックボックスをオンにしてください。

5.4.2　システム構成情報とIDの連携例

システム構成情報とIDの連携の例を次に示します。

(1)　システム構成情報からの削除

システム構成情報からID管理元中継またはIDに登録されたコンピュータを削除した場合の、システム構成情報とIDの情報の連携について説明します。

(a)　ID管理元中継を削除した場合

ID管理元中継として定義されている中継システムが削除された場合の例を次の図に示します。

図5‒19　ID管理元中継として定義されている中継システムが削除された場合の例

(b)　IDに登録されたコンピュータを削除した場合

IDに登録されたコンピュータを削除した場合の例を次の図に示します。

図5‒20　IDに登録されたコンピュータを削除した場合の例

(2)　システム構成情報での経路変更

システム構成情報からID管理元中継またはIDに登録されたコンピュータの経路を変更した場合の、システム構成情報とIDの情報の連携について説明します。

(a)　ID管理元中継の経路変更の場合

ID管理元中継として定義されている中継システムの接続先を変更した場合の例を次の図に示します。

図5‒21　ID管理元中継として定義されている中継システムの接続先を変更した場合の例

(b)　IDに登録されたコンピュータの経路変更の場合

IDに登録されたコンピュータの接続先を変更した場合の例を次の図に示します。

図5‒22　IDに登録されたコンピュータの接続先を変更した場合の例

5.4.3　システム構成情報とIDの連携時の注意事項

システム構成情報とIDを連携させる場合の注意事項を次に示します。

(1)　パスワードのあるIDの扱い

パスワードのあるIDに登録されたコンピュータのシステム構成情報が変わった場合、IDの情報は変更されません。

(2)　ジョブとの連携

システム構成情報からID管理元中継またはIDに登録されたコンピュータが削除された場合、そのID管理元中継あてまたは経由のジョブ、および管理対象のコンピュータあてのジョブは削除されます。

IDに登録されたコンピュータの接続先を変更して経路が変更になった場合、旧経路に存在しているコンピュータあてのIDジョブは削除され、新経路で再度、コンピュータあてのIDジョブが登録、実行されます。なお、ID管理元中継の接続先を変更して経路が変更になった場合には、ジョブは連携されないため、旧経路で実行されます。

ID管理元中継またはIDに登録されたコンピュータのノード識別キーの名称変更時にはジョブは連携されません。したがって、名称が変更された時点でそのID管理元中継あてまたは経由するジョブは使用できなくなるため、ジョブを登録し直してください。

(3)　セットアップの設定について

システム構成情報とIDを連携するためには、JP1/IT Desktop Management 2 - Managerのセットアップの［リモートインストールマネージャを使用した配布のセットアップ］画面の［システム構成関連］パネルで、［システム構成の変更を同期させる］のチェックボックスをオンにしておく必要があります。設定が一致していないと、上位システムと下位システムとで管理情報が不一致になることがあります。

(4)　中継システムおよび管理用中継サーバの場合

中継システムおよび管理用中継サーバのIDへの登録先は自システムとする必要があります。上位システムをIDへの登録先とする場合はそのシステムについてはシステム構成情報とIDが正しく連携しない場合があります。

(5)　IDに登録されているコンピュータの接続先を変更した場合

IDに登録されているコンピュータの接続先を変更した場合、そのコンピュータが新しい接続先のIDに自動的に登録されますが、時間が掛かる場合があります。IDを指定したジョブの実行前にまずIDの登録状況を確認してください。システム構成情報とのIDの連携が実行されると構成変更対象となるコンピュータのIDへの追加ジョブが自動的に生成されリモートインストールマネージャのジョブ実行状況画面で参照できます。

5.4.4　ID管理元中継からの自動通知が遅延した場合の対処

ID管理元中継からの自動通知が遅延している間に、コンピュータが経路を変更すると、IDへの登録解除が適用されないことがあります。この問題への対処方法について説明します。なお、ここではIDを作成し、ID管理元中継を管理する配布管理システムまたは管理用中継サーバを「ID管理マネージャ」と表記します。

IDの登録解除が適用されないときの対処

ID管理元中継からのIDの登録解除通知が遅延している間に、コンピュータがID管理マネージャに経路を変更した場合、IDの登録解除が適用されません。このような場合の対処として、次のどちらかの方法を実施してください。

IDの登録解除が適用されていないコンピュータから、再度IDの登録解除を実施する

IDからの登録解除方法については、「12.2.1　IDへの登録」を参照してください。

ID管理マネージャのリモートインストールマネージャで、対象コンピュータのIDの登録情報を削除する

IDに登録したコンピュータの削除方法については、「5.3.4(3)　IDに登録したコンピュータの削除」を参照してください。

注意事項

この問題の防止方法として、経路を変更する直前に、IDの登録解除をしないでください。また、経路を変更したあとは、コンピュータでIDの登録解除が適用されているかどうか確認してください。

6　システム構成情報とあて先グループをメンテナンスする

ここでは、リモートインストールマネージャを使用した配布の運用を開始したあとで、システム構成情報とあて先グループをメンテナンスする方法について説明します。

6.1　システム構成情報のメンテナンス

［システム構成］または［あて先］ウィンドウで、新しく追加されたホストを検索してあて先グループに登録したり、検索したホストに対してジョブを実行したり、検索したホストをシステム構成情報から削除したりできます。

検索方法を次に示します。

あて先名、あて先グループ名、ID名などの名称をキーにした検索

ホストを登録した日付をキーにした検索

ここでは、各検索方法について説明します。また、検索結果のホストを［あて先］ウィンドウにコピーする方法や、システム構成情報から削除する方法についても説明します。

6.1.1　名称によるホストの検索方法

IPアドレス、あて先名、あて先グループ名、ID名などの名称をキーにしたホストの検索方法を次に示します。

［システム構成］または［あて先］ウィンドウの［オプション］−［検索］を選択する。

［検索］ダイアログボックスが表示されます。［システム構成］ウィンドウから表示した場合と［あて先］ウィンドウから表示した場合とで、ダイアログボックスの表示項目は異なります。

それぞれのウィンドウから表示した［検索］ダイアログボックスを次に示します。

図6‒1　［システム構成］ウィンドウから表示した［検索］ダイアログボックス

図6‒2　［あて先］ウィンドウから表示した［検索］ダイアログボックス

あて先（［あて先］ウィンドウから表示した場合だけ）

あて先名を検索対象とする場合に指定します。

あて先グループとID（［あて先］ウィンドウから表示した場合だけ）

あて先グループ名とID名を検索対象とする場合に指定します。

検索文字列

検索文字列を最大64バイトで指定します。ただし、次に示す記号および半角スペースは指定できません。

「¥」「/」「*」「"」「:」「!」「|」「<」「>」「?」「%」「@」「'」

指定した文字列を含むあて先が検索されます。

ホスト名を検索

ホスト名をキーにして検索する場合に選択します。

［検索］ダイアログボックスを［あて先］ウィンドウから表示した場合、検索対象に「あて先グループとID」を選択しているときは、非活性になります。

IPアドレスを検索

IPアドレスをキーにして検索する場合に選択します。

［検索］ダイアログボックスを［あて先］ウィンドウから表示した場合、検索対象に「あて先グループとID」を選択しているときは、非活性になります。

完全に一致するものだけを検索

指定した検索文字列と完全に一致するものだけを検索したい場合に、チェックボックスをオンにします。

大文字と小文字を区別する

大文字と小文字を区別して検索したい場合に、チェックボックスをオンにします。

検索条件を設定し、［検索］ボタンをクリックする。

検索が開始され、下部の「検索結果」リストに検索結果が表示されます。

［検索］ダイアログボックスは、見やすいサイズに変更できます。

「検索結果」リストから任意のあて先を選択して［ジャンプ］ボタンをクリック、またはダブルクリックする。

［システム構成］または［あて先］ウィンドウがアクティブになり、選択したあて先の情報が表示されます。

6.1.2　日付によるホストの検索方法

ホストを管理用サーバに登録した日付をキーにした検索ができます。

日付をキーにしたホストの検索方法を次に示します。

［システム構成］ウィンドウの［オプション］−［検索］を選択する。

［検索］ダイアログボックスが表示されます。

［日付による検索］タブを選択する。

図6‒3　［日付による検索］パネル

検索する日付の範囲を指定する。

範囲指定

検索する日付範囲の開始日と終了日の両方、またはどちらか一方を指定します。入力形式はYY/MM/DDで、YYは西暦下2けたを、MMは月を、DDは日を表します。検索できる日付の範囲は1971年1月1日〜2037年12月31日です。

なお、開始日または終了日のどちらか一方だけを指定する場合は、指定しない方のチェックボックスをオフにしておきます。

過去nか月間

現在の日付から何か月前までを検索範囲にするのかを指定します。指定できる月数は1〜999です。デフォルトは、1です。一度検索すると、前回検索時に指定した値が入力されます。ただし、指定した月数が、検索可能範囲である1971年1月1日以前になる場合は、1971年1月1日から現在の日付までが、検索範囲になります。

過去n日間

現在の日付から何日前までを検索範囲にするのかを指定します。指定できる日数は1〜999です。デフォルトは、1です。一度検索すると、前回検索時に指定した値が入力されます。ただし、指定した日数が、検索可能範囲である1971年1月1日以前になる場合は、1971年1月1日から現在の日付までが、検索範囲になります。

検索条件を設定し終わったら、［検索］ボタンをクリックする。

検索が開始され、下部の「日付による検索結果」リストに検索結果が表示されます。

［検索］ダイアログボックスは、ダイアログボックス枠をドラッグして、見やすいサイズに変更できます。

「日付による検索結果」リストから任意のホストを選択して［ジャンプ］ボタンをクリック、またはダブルクリックする。

［システム構成］ウィンドウがアクティブになり、選択したホストの情報が表示されます。

6.1.3　検索したホストを［あて先］ウィンドウにコピーする

［システム構成］ウィンドウで検索したホストを、［あて先］ウィンドウにコピーできます。新規に追加されたホストを検索したあと、あて先グループへ登録するのに便利です。検索したホストを［あて先］ウィンドウにコピーする方法を次に示します。

［あて先］ウィンドウを表示する。

［システム構成］ウィンドウをアクティブにし、［オプション］−［検索］を選択する。

［検索］ダイアログボックスが表示されます。

［検索］ダイアログボックスでホストを検索する。

検索結果のリストで任意のホストを右クリックし、［コピー］メニューを選択する。

［あて先］ウィンドウのあて先グループを右クリックし、［貼り付け］メニューを選択する。

指定したあて先グループにコピーされます。

上記操作の代わりに、ドラッグ&ドロップでも、［あて先］ウィンドウにコピーできます。

6.1.4　検索したホストをシステム構成情報から削除する

［システム構成］ウィンドウで検索したホストをシステム構成情報から削除できます。中継システムおよび管理用中継サーバと同一PC上に存在するエージェントは削除できません。

エージェントのコンピュータをシステム構成情報から削除すると、所属するあて先グループおよびIDからも同時に削除されます。ただし、削除したコンピュータの機器情報は削除されません。

中継システムおよび管理用中継サーバでIDを連携させる運用をしている場合、マネージャから中継システムおよび管理用中継サーバ配下のコンピュータを削除できます。その際、削除したコンピュータは、中継システムおよび管理用中継サーバで管理しているシステム構成情報、あて先グループ、およびIDからも削除されます。IDを連携させる運用については、「5.4　システム構成情報とIDを連携させる運用」を参照してください。

なお、管理用中継サーバでコンピュータを削除した場合は、削除した管理用中継サーバの上位システムから「システム構成情報の取得」ジョブを実行して、システム全体のシステム構成情報を一致させてください。

多数のコンピュータを削除する場合の注意事項

誤って削除してしまったときの回復手段として、多数のコンピュータを削除する場合は、あらかじめ、システム構成情報、あて先グループ、およびIDのバックアップをとっておいてください。これらの情報をファイルに出力する方法については、「5.1.4　システム構成情報をファイルに出力して更新する」、「5.2.3　あて先グループをファイルから作成する」、および「5.3.3(2)(c)　IDをファイルに出力する」を参照してください。

メモ

機器のメンテナンスで削除候補機器として検出された重複機器や不稼働機器を自動または手動で削除した場合、その機器のシステム構成情報も自動的に削除されます。また、所属していたあて先グループやIDからも、その機器が自動的に削除されます。機器のメンテナンスについては、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」の機器の自動メンテナンスの説明を参照してください。

(1)　コンピュータを削除する方法

検索したコンピュータをシステム構成情報から削除する方法を、次に示します。

［検索］ダイアログボックスで条件を指定し、ホストを検索する。

検索結果のリストで削除するコンピュータを右クリックし、［システム構成から削除］メニューを選択する。

確認のメッセージに対して［OK］ボタンをクリックする。

指定したコンピュータが、システム構成情報、あて先グループ、IDから削除されます。

(2)　削除したコンピュータの情報を参照する

削除したコンピュータの情報はログファイルに出力され、JP1/IT Desktop Management 2 - Managerのインストール先ディレクトリ¥mgr¥rmtins¥guiに9ファイルまで保存されます。

ログファイル名はrimfindn.logで、nは1〜9の番号です。削除を実行するたびに番号が1つずつ増えて、rimfind1、rimfind2、rimfind3、（中略）、rimfind9というファイル名が順次付けられます。ファイルがrimfind9まで作成されると、古いファイルが順次上書きされます。

ログファイルの先頭には検索条件が出力され、それに続いて、削除したコンピュータの情報が、システム構成情報ファイルと同じ形式で出力されます。必要に応じて参照してください。

ログファイルの出力例を次に示します。

図6‒4　ログファイルの出力例

メモ

機器のメンテナンスで削除候補機器として検出された重複機器や不稼働機器を自動または手動で削除した場合、削除した機器の情報は、ログファイルJDNSTRCn.log（nは1〜9の番号）に出力されます。

6.1.5　システム構成情報のメンテナンスの例

ここでは、システム構成情報のメンテナンスの例として、新規に追加されたコンピュータを管理する例について説明します。

(1)　新規に追加されたコンピュータを管理する例

ホストが管理用サーバに登録された日付をキーにして、一定期間に新規に追加されたコンピュータを検索できます。新規に追加されたコンピュータを定期的に検索することで、管理漏れのないように、ジョブの実行やあて先グループへの登録などを実施できます。

任意の期間に新規に追加されたコンピュータを管理する例を、次の図に示します。

図6‒5　任意の期間に新規に追加されたコンピュータを管理する例（1/2）

図6‒6　任意の期間に新規に追加されたコンピュータを管理する例（2/2）

また、新規に追加されたコンピュータを14日間ごと（隔週の特定曜日）に定型的に管理する例を、次の図に示します。新規に追加されたコンピュータを一定の間隔で管理する場合は、この例のように指定します。

図6‒7　14日間ごと（隔週の特定曜日）に新規追加コンピュータを管理する例（1/2）

図6‒8　14日間ごと（隔週の特定曜日）に新規追加コンピュータを管理する例（2/2）

6.2　あて先グループの自動メンテナンス

新たに追加されたホストや移設されたホストを自動的に検知し、あらかじめ作成しておいたグルーピング条件（ポリシー）に従ったあて先グループに自動的に振り分けることができます。これをあて先グループの自動メンテナンスと呼びます。自動メンテナンスの対象は、システム構成情報に含まれるコンピュータです。コンピュータの機器情報の［管理状態］に関係なく、自動メンテナンスの対象となります。

ここでは、あて先グループのポリシーを設定する方法やあて先グループにポリシーを一括して反映する方法について説明します。また、あて先グループにポリシーを設定する運用例についても説明します。

6.2.1　あて先グループのポリシーを設定する

あて先グループのポリシーを設定する方法を次に示します。

なお、ポリシー設定時にあて先グループ名を指定する際には、「5.2.2　グループ名の付け方」を参照してください。

［あて先］ウィンドウで、［オプション］−［あて先グループ/IDの自動メンテナンス］を選択する。

［ポリシーの設定］ダイアログボックスが表示されます。

［ファイル］−［グループの新規作成］を選択し、［あて先グループの作成］ダイアログボックスを表示させ、「あて先グループのポリシーの作成」を実行してもこのダイアログボックスを表示できます。

図6‒9　［ポリシーの設定］ダイアログボックス

［ポリシーの設定］ダイアログボックスには、条件が半角で260文字（全角で130文字）まで表示されます。260文字を超えた部分は表示されませんが、条件として正しく設定されています。

新規にポリシーを設定したい場合は、［追加］ボタンをクリックしてください。

既存のポリシーを変更したい場合は、変更したいポリシーを選択して［変更］ボタンをクリック（またはポリシー種別をダブルクリック）してください。

既存のポリシーを削除したい場合は、削除したいポリシーを選択して［削除］ボタンをクリックしてください。なお、ポリシーを削除しても、そのポリシーによって作成されたあて先グループは削除されません。また、ポリシーによって登録されたホストも、あて先グループからは削除されません。

［追加］ボタンをクリックする。

［メンテナンス対象の選択］ダイアログボックスが表示されます。

図6‒10　［メンテナンス対象の選択］ダイアログボックス

「あて先グループの自動メンテナンス」を選択し、［次へ］ボタンをクリックする。

［ポリシー種別の選択］ダイアログボックスが表示されます。

図6‒11　［ポリシー種別の選択］ダイアログボックス

設定したいポリシー種別を選択し、［次へ］ボタンをクリックする。

表示されたダイアログボックスでポリシーを設定する。

選択した項目ごとに、表示されるダイアログボックスが異なります。各ダイアログボックスでの設定については、次の表に示す(1)〜(6)を参照してください。

選択項目

参照先

IPアドレスによるグルーピング

6.2.1(1)　［IPアドレスによるグルーピング］ダイアログボックスでの設定

新規作成ホストによるグルーピング

6.2.1(2)　［新規作成ホストによるグルーピング］ダイアログボックスでの設定

OS種別によるグルーピング

6.2.1(3)　［OS種別によるグルーピング］ダイアログボックスでの設定

ハードウェア資産情報の追加管理項目によるグルーピング

6.2.1(4)　［ハードウェア資産情報の追加管理項目によるグルーピング］ダイアログボックスでの設定

部署の情報によるグルーピング

6.2.1(5)　［部署の情報によるグルーピング］ダイアログボックスでの設定

設置場所の情報によるグルーピング

6.2.1(6)　［設置場所の情報によるグルーピング］ダイアログボックスでの設定

ポリシーの設定が完了したら、［次へ］ボタンをクリックする。

［ポリシーの確認］ダイアログボックスが表示されます。

図6‒12　［ポリシーの確認］ダイアログボックス

［ポリシーの確認］ダイアログボックスには、条件が半角で260文字（全角で130文字）まで表示されます。260文字を超えた部分は表示されませんが、条件として正しく設定されています。

あて先グループに追加されるホストの種別

ポリシーによって追加されるホストの種別を選択します。「エージェントだけ」を指定した場合、中継システムおよび管理用中継サーバと同じPC上のエージェントは対象外になります。中継システムおよび管理用中継サーバへの配布が不要な場合に選択してください。

［完了］ボタンをクリックする。

ポリシーが作成され、［ポリシーの一括反映］ダイアログボックスが表示されます。ただし、作成したポリシーの種別が新規作成ホストの場合は、このダイアログボックスは表示されないで、［ポリシーの設定］ダイアログボックスに戻ります。

図6‒13　［ポリシーの一括反映］ダイアログボックス

［ポリシーの一括反映］ダイアログボックスでは、追加、変更したポリシーを即時に一括反映するかどうか選択します。

［今すぐ実行する］ボタンをクリックすると、追加、変更したポリシーを即時にあて先グループに一括反映します。［あとで実行する］ボタンをクリックすると、［ポリシーの設定］ダイアログボックスに戻ります。

なお、複数のポリシーが同じあて先グループに登録する設定になっていても、エラーにはなりません。

(1)　［IPアドレスによるグルーピング］ダイアログボックスでの設定

指定したIPアドレスの範囲でコンピュータをグルーピングします。一括指定と範囲指定が選択できます。

［一括指定］パネル

図6‒14　［一括指定］パネル

あて先グループ名称とIPアドレスを指定します。IPアドレスの指定に「*」をワイルドカードとして使用してください。

例えば、「172.20.20.*」と指定した場合、「172.20.20.0〜172.20.20.255」のIPアドレスがグルーピングされます。

［追加］ボタンをクリックすると、一覧表示に条件が追加されます。IPアドレスによるグルーピングでは、複数の異なる条件を設定できます。既存の条件を削除するには［削除］ボタンをクリックしてください。

［範囲指定］パネル

図6‒15　［範囲指定］パネル

IPアドレスを範囲指定できます。ポリシーの追加時、「あて先グループ名称」には、デフォルトの上位の経路として「IPアドレス¥IPアドレスグループ」が表示されます。あて先グループ名称は手入力したり［参照］ボタンから既存のあて先グループを選択したりできますが、変更していない時には「IPアドレスグループ」があて先グループ名になります。

［参照］ボタンと［経路参照］ボタン

各タブで［参照］ボタンまたは［経路参照］ボタンをクリックすると、［グループ一覧］ダイアログボックスが表示されます。

図6‒16　［グループ一覧］ダイアログボックス

現在のあて先グループの一覧がツリー表示され、あて先グループやあて先グループの経路を指定できます。

［参照］ボタンをクリックした場合は、ポリシーの対象とするあて先グループを指定します。

［経路参照］ボタンをクリックした場合は、登録したポリシーの経路を指定します。

なお、あて先グループや経路の指定で入力可能な文字数はポリシーによって異なります。ポリシーごとの入力可能な文字数は各ダイアログボックスでの説明を参照してください。

IPアドレスによってグルーピングする場合、あて先グループ名および経路の入力可能な文字数は1階層当たり32バイトまでで、最上層からあて先グループ名を連結した文字数（パス区切り文字（「¥」または半角のバックスラッシュ）を含める）が164バイトまでとなります。

(2)　［新規作成ホストによるグルーピング］ダイアログボックスでの設定

システム構成情報に新規に登録されたホストをグルーピングします。このポリシーを使ったあて先グループは1つしか設定できません。

図6‒17　［新規作成ホストによるグルーピング］ダイアログボックス

ポリシーの追加時、「あて先グループ名称」には、デフォルトとして「新規作成ホスト」が表示されます。あて先グループ名称は手入力したり［参照］ボタンから既存のあて先グループを選択したりできます。

なお、あて先グループ名称の入力可能な文字数は1階層当たり32バイトまでで、最上層からあて先グループ名を連結した文字数（パス区切り文字（「¥」または半角のバックスラッシュ）を含める）が189バイトまでとなります。

［参照］ボタンをクリックすると、(1)で説明した［グループ一覧］ダイアログボックスが表示され、あて先グループを指定できます。

(3)　［OS種別によるグルーピング］ダイアログボックスでの設定

システム情報の「OS種別」単位でコンピュータをグルーピングします。

図6‒18　［OS種別によるグルーピング］ダイアログボックス

チェックボックスがオンのOS種別が、グルーピングの対象となります。OS種別ごとのあて先グループ名は任意に設定できます。異なるOS種別に対して同じあて先グループ名を設定すれば、異なるOS種別のコンピュータを1つのあて先グループで管理することもできます。

なお、あて先グループ名の入力可能な文字数は1階層当たり32バイトまでで、最上層からあて先グループ名を連結した文字数（パス区切り文字（「¥」または半角のバックスラッシュ）を含める）が164バイトまでとなります。

ポリシーの追加時、デフォルトの上位の経路として「OS種別¥」が表示されます。

［経路参照］ボタンをクリックすると、(1)で説明した［グループ一覧］ダイアログボックスが表示され、経路を指定できます。

経路の入力可能な文字数は、1階層当たり32バイトまでで、最上層からあて先グループ名を連結した文字数（パス区切り文字（「¥」または半角のバックスラッシュ）を含める）が164バイトまでとなります。

［全選択］ボタンをクリックすると、すべてのOS種別のチェックがオンになります。［全選択解除］ボタンをクリックすると、すべてのOS種別のチェックがオフになります。

「32ビット版と64ビット版を分けてグルーピングする」チェックボックスをオンにすると、OS種別のあて先グループの配下に、「x84」（32ビット版）と「x64」（64ビット版）に分けてコンピュータが登録されるようになります。

「OSサブバージョンレベルまでグルーピングする」チェックボックスをオンにすると、OS種別のあて先グループの配下に、Service PackなどのOSサブバージョン単位でコンピュータが登録されるようになります。「OSサブバージョン」の値が半角で32文字（全角で16文字）を超える場合は、あて先グループは作成されません。

自動メンテナンスの対象のコンピュータから取得できないシステム情報がある場合の、コンピュータの登録先を次の表に示します。

設定

CPUの情報を取得できないとき

OSサブバージョンの情報を取得できないとき

「32ビット版と64ビット版を分けてグルーピングする」チェックボックスおよび「OSサブバージョンレベルまでグルーピングする」チェックボックスの両方がオンの場合

OS種別のあて先グループの配下に作成された、OSサブバージョンのグループの配下

CPU種別のあて先グループの配下

「32ビット版と64ビット版を分けてグルーピングする」チェックボックスだけオンの場合

OS種別のあて先グループの配下

−

「OSサブバージョンレベルまでグルーピングする」チェックボックスだけオンの場合

−

OS種別のあて先グループの配下

（凡例）−：設定どおりのグループの配下

(4)　［ハードウェア資産情報の追加管理項目によるグルーピング］ダイアログボックスでの設定

データ型が選択型またはテキスト型のハードウェア資産情報の追加管理項目を基に、コンピュータをグルーピングします。このポリシーは16個まで作成できます。

図6‒19　［ハードウェア資産情報の追加管理項目によるグルーピング］ダイアログボックス

ハードウェア資産情報の追加管理項目のポリシーは、ハードウェア資産情報の追加管理項目を6階層まで指定できます。

［n階層目に設定］ボタンをクリックすると、選択したハードウェア資産情報の追加管理項目をn階層目のあて先グループとして設定します。設定後、ボタン名が［n階層目を解除］に変わります。［n階層目を解除］ボタンをクリックすると、設定した階層が解除されます。下位項目がある場合は、下位項目すべてが解除されます。

ポリシーでの階層が異なるハードウェア資産情報の追加管理項目には、同じハードウェア資産情報の追加管理項目を指定できません。また、複数のポリシーに、同じハードウェア資産情報の追加管理項目を指定できません。

また、ポリシーに設定した追加管理項目に1つも値が設定されていない場合も、あて先グループは作成されません。

［経路参照］ボタンをクリックすると、(1)で説明した［グループ一覧］ダイアログボックスが表示され、経路を指定できます。経路の入力可能な文字数は、1階層当たり32バイトまでで、最上層からあて先グループ名を連結した文字数（パス区切り文字（「¥」または半角のバックスラッシュ）を含める）が189バイトまでとなります。

(5)　［部署の情報によるグルーピング］ダイアログボックスでの設定

部署の範囲を設定して、設定した部署の範囲に含まれるコンピュータをグルーピングします。部署のポリシーは、1つだけ作成できます。

図6‒20　［部署の情報によるグルーピング］ダイアログボックス

部署のポリシーは、最上位の階層から6階層まで指定できます。ポリシーの対象にする階層は、［メンテナンスの対象範囲］で指定します。部署が未登録の階層も指定できるため、あとから部署を追加した場合でもポリシーの対象にできます。

［経路参照］ボタンをクリックすると、(1)で説明した［グループ一覧］ダイアログボックスが表示され、経路を指定できます。経路の入力可能な文字数は、1階層当たり32バイトまでで、最上層からあて先グループ名を連結した文字数（パス区切り文字（「¥」または半角のバックスラッシュ）を含める）が189バイトまでとなります。

JP1/IT Desktop Management 2の機器画面の［機器一覧（部署）］で［不明］に属するコンピュータは、あて先グループに追加されません。［不明］に属するコンピュータもあて先グループに追加したい場合は、次のどちらかの方法で対応してください。

システム管理者が［機器情報の編集］ダイアログで、該当のコンピュータの適切な部署を選択する

機器画面のメニューエリアの［機器情報］−［機器一覧（部署）］の［不明］で、該当のコンピュータを選択してください。次に［操作メニュー］の［機器情報を編集する］を選択すると表示される［機器情報の編集］ダイアログの［部署］で、適切な部署を選択してください。あらかじめ［機器一覧（部署）］で、複数のコンピュータを選択しておくと、まとめて同じ部署に移動できます。

［利用者情報の入力］画面で所属部署の情報を入力することを、利用者に指示する

利用者への指示は、メッセージ通知でできます。詳細については、マニュアル「JP1/IT Desktop Management 2 運用ガイド」の利用者にメッセージを通知する手順の説明を参照してください。

(6)　［設置場所の情報によるグルーピング］ダイアログボックスでの設定

設置場所の範囲を設定して、設定した設置場所の範囲に含まれるコンピュータをグルーピングします。設置場所のポリシーは、1つだけ作成できます。

図6‒21　［設置場所の情報によるグルーピング］ダイアログボックスでの設定

設置場所のポリシーは、最上位の階層から6階層まで指定できます。ポリシーの対象にする階層は、［メンテナンスの対象範囲］で指定します。設置場所が未登録の階層も指定できるため、あとから設置場所を追加した場合でもポリシーの対象にできます。

［経路参照］ボタンをクリックすると、(1)で説明した［グループ一覧］ダイアログボックスが表示され、経路を指定できます。経路の入力可能な文字数は、1階層当たり32バイトまでで、最上層からあて先グループ名を連結した文字数（パス区切り文字（「¥」または半角のバックスラッシュ）を含める）が189バイトまでとなります。

JP1/IT Desktop Management 2の機器画面の［機器一覧（設置場所）］で［不明］に属するコンピュータは、あて先グループに追加されません。［不明］に属するコンピュータもあて先グループに追加したい場合は、次のどちらかの方法で対応してください。

システム管理者が［機器情報の編集］ダイアログで、該当のコンピュータの適切な設置場所を選択する

機器画面のメニューエリアの［機器情報］−［機器一覧（設置場所）］の［不明］で、該当のコンピュータを選択してください。次に［操作メニュー］の［機器情報を編集する］を選択すると表示される［機器情報の編集］ダイアログの［設置場所］で適切な設置場所を選択してください。あらかじめ［機器一覧（設置場所）］で、複数のコンピュータを選択しておくと、まとめて同じ設置場所に移動できます。

［利用者情報の入力］画面で設置場所の情報を入力することを、利用者に指示する

利用者への指示は、メッセージ通知でできます。詳細については、マニュアル「JP1/IT Desktop Management 2 運用ガイド」の利用者にメッセージを通知する手順の説明を参照してください。

6.2.2　あて先グループにポリシーを一括反映する

あて先グループに既存のポリシーを一括反映する方法を次に示します。なお、あて先グループに一括反映できるのはシステム構成情報に登録済みのホストです。新規作成ホストは一括反映できません。

あて先グループの一括メンテナンス機能は台数とポリシー数に比例して時間が掛かります。

また、一括メンテナンス実行中は、機器情報の更新時に行われるあて先グループの自動メンテナンス機能が動作しないため、あて先グループの一括メンテナンスは機器情報の更新が少ない時間帯に実施することをお勧めします。

［あて先］ウィンドウで、［オプション］−［あて先グループ/IDの自動メンテナンス］を選択する。

［ポリシーの設定］ダイアログボックスが表示されます。

［ファイル］−［グループの新規作成］を選択し、［あて先グループの作成］ダイアログボックスを表示させ、「あて先グループのポリシーの作成」を実行してもこのダイアログボックスを表示できます。

図6‒22　［ポリシーの設定］ダイアログボックス

［ポリシーの一括反映］ボタンをクリックする。

［ポリシーの一括反映］ダイアログボックスが表示されます。

図6‒23　［ポリシーの一括反映］ダイアログボックス

一括反映したいポリシー種別を次の種類から選択し、［実行］ボタンをクリックする。

すべてのポリシー

［ポリシーの設定］ダイアログボックスのポリシー一覧に表示されているすべてのポリシーを、あて先グループに一括反映します。ただし、新規作成ホストを条件とするポリシーは反映しません。

なお、IDのポリシーは種別に関係なく、一括反映しません。

ポリシー種別ごとに一括反映をする

一括反映するポリシー種別を次の中から選択します。複数のポリシー種別を選択できます。

・IPアドレス

・OS種別

・ハードウェア資産情報の追加管理項目

・部署

・設置場所

ポリシー種別を選択後、［実行］ボタンをクリックしてください。選択したポリシーに従って、システム構成情報に登録されているホストがあて先グループに振り分けられます。

(1)　新規作成ホストを即時にグルーピングする方法

設定したポリシーに従って、新規作成ホストを即時にあて先グループへ反映したい場合は、次の方法で更新してください。

IPアドレスによるグルーピング

中継システムおよび管理用中継サーバに対して、「システム構成の取得」ジョブを実行してください。管理用中継サーバと同じPC上のエージェントの場合、［あて先］ウィンドウの［ファイル］−［あて先の新規作成］から追加してください。

新規作成ホストによるグルーピング

［システム構成］ウィンドウの［オプション］−［検索］で日付による検索を実行後、検索したホストをあて先グループへ登録してください。

OS種別によるグルーピング

JP1/IT Desktop Management 2の操作画面で機器情報を再度取得してください。

ハードウェア資産情報の追加管理項目によるグルーピング

JP1/IT Desktop Management 2の操作画面で機器情報を再度取得してください。

部署の情報によるグルーピング

JP1/IT Desktop Management 2の操作画面で機器情報を再度取得してください。

設置場所の情報によるグルーピング

JP1/IT Desktop Management 2の操作画面で機器情報を再度取得してください。

機器情報を再度取得する方法については、マニュアル「JP1/IT Desktop Management 2 運用ガイド」の最新の機器情報を取得する手順の説明を参照してください。

(2)　あて先グループのバックアップを保存する方法

あて先グループのバックアップを保存したい場合は、［あて先］ウィンドウで、バックアップとして保存したいあて先グループの名称を変更してください。名称を変更すると、変更後の名称のあて先グループは自動メンテナンスされなくなるので、バックアップとして保存できます。名称を変更してからホストの追加や変更があった場合には、ポリシーの設定に従い、変更前の名称のあて先グループが再度作成され、以降、更新されます。

6.2.3　あて先グループの階層化の仕組み

あて先グループのポリシー設定で複数階層を設定した場合、あて先グループが複数階層で構成されます。ここでは、部署の情報によるグルーピングを例にして、階層化の仕組みを説明します。

図6‒24　部署の情報によるグルーピング例

この図のグルーピング結果について、次に説明します。

Agt01は、ポリシーの設定に従って、「ユニット1」の直下に追加されます。

Agt02は、「課名」および「ユニット名」の情報がありません。この場合は、階層が繰り上げられ「開発部」の直下にAgt02が追加されます。

Agt03は、所属する「営業部」が「ソフトウェア事業部」の直属であるため、「本部名」の情報がありません。この場合もAgt02と同様に階層が繰り上げられ、最上位に「営業部」が追加されます。この「営業部」の配下に階層化された「営業A課」および「ユニット1」が構成されて、「ユニット1」の直下にAgt03が追加されます。

このように、部署の情報が取得されていない場合でも、階層が繰り上げられてあて先グループが構成されます。

なお、機器画面の［機器一覧（部署）］または［機器一覧（設置場所）］でどの階層にも属さないエージェントは、あて先グループに追加されません。あらかじめ機器画面の［機器一覧（部署）］または［機器一覧（設置場所）］で該当するエージェントを適切な部署または設置場所に追加してください。

6.3　IDの自動メンテナンス

IDにポリシーを設定して、自動的にコンピュータをIDに登録する運用を、IDの自動メンテナンスと呼びます。自動メンテナンスの対象は、システム構成情報に含まれるコンピュータです。コンピュータの機器情報の［管理状態］に関係なく、自動メンテナンスの対象となります。

ここでは、IDにポリシーを設定する方法と、IDの自動メンテナンス運用時の注意事項について説明します。

6.3.1　IDのポリシーを設定する

IDのポリシーは、IDを管理するマネージャまたはID管理元中継に指定された管理用中継サーバから設定できます。IDのポリシーを設定する方法を次に示します。

［あて先］ウィンドウで、［オプション］−［あて先グループ/IDの自動メンテナンス］を選択する。

［ポリシーの設定］ダイアログボックスが表示されます。

図6‒25　［ポリシーの設定］ダイアログボックス

［追加］ボタンをクリックする。

既存のポリシーを変更したい場合は、変更したいポリシーを選択して［変更］ボタンをクリックしてください。ポリシーを削除したい場合は、削除したいポリシーを選択して［削除］ボタンをクリックしてください。

［追加］ボタンをクリックすると、［メンテナンス対象の選択］ダイアログボックスが表示されます。

図6‒26　［メンテナンス対象の選択］ダイアログボックス

「IDの自動メンテナンス」を選択してください。

［次へ］ボタンをクリックする。

［ポリシー種別の選択］ダイアログボックスが表示されます。

図6‒27　［ポリシー種別の選択］ダイアログボックス

設定したいポリシー種別を選択し、［次へ］ボタンをクリックする。

表示されたダイアログボックスでポリシーを設定する。

選択した項目ごとに、表示されるダイアログボックスが異なります。各ダイアログボックスでの設定については、次の表に示す参照先を参照してください。

選択項目

参照先

新規作成ホストによるIDへの登録

6.3.1(1)　［新規作成ホストによるIDへの登録］ダイアログボックスでの設定

資産管理項目によるIDへの登録

6.3.1(2)　［資産管理項目によるIDへの登録］ダイアログボックスでの設定

機器情報によるIDへの登録

6.3.1(3)　［機器情報によるIDへの登録］ダイアログボックスでの設定

［次へ］ボタンをクリックする。

［ポリシーの確認］ダイアログボックスが表示されます。

図6‒28　［ポリシーの確認］ダイアログボックス

ポリシーを設定するIDを確認してください。変更する場合は、［戻る］ボタンをクリックしてIDを選択し直してください。

［完了］ボタンをクリックする。

設定されたポリシーが、［ポリシーの設定］ダイアログボックスに表示されます。

(1)　［新規作成ホストによるIDへの登録］ダイアログボックスでの設定

システム構成情報に新規に登録されたホストを自動的にIDに登録します。このポリシーは1つだけ設定できます。

図6‒29　［新規作成ホストによるIDへの登録］ダイアログボックス

［参照］ボタンをクリックすると、［ID一覧］ダイアログボックスが表示されます。ポリシーを設定するIDを選択します。

また、IDを新規作成する場合は、［ID一覧］ダイアログボックスの［IDの作成］ボタンをクリックしてください。

(2)　［資産管理項目によるIDへの登録］ダイアログボックスでの設定

資産管理項目を基に、コンピュータをIDに登録します。指定できる資産管理項目は次のとおりです。

データ型が選択型のハードウェア資産情報の追加管理項目

データ型が選択型または階層型の部署

データ型が選択型または階層型の設置場所

設定できるポリシー数に上限はありません。

なお、ID自動メンテナンスの実行に掛かる時間は、設定したポリシー数によって異なります。

図6‒30　［資産管理項目によるIDへの登録］ダイアログボックス

［資産管理項目によるIDへの登録］ダイアログボックスでの設定方法を次に示します。

設定したい［資産管理項目］欄の選択項目を選択して［>］ボタンをクリックする。

選択した選択項目を［条件］欄に追加します。［項目の値］には、選択した選択項目名が259文字まで表示されます。なお、［条件］は10個まで設定できますが、1つのポリシー内で、同じ資産管理項目は複数指定できません。

［条件］欄から選択項目を削除したい場合は、削除したい選択項目を選択して［<］ボタンをクリックしてください。

［参照］ボタンをクリックする。

［ID一覧］ダイアログボックスが表示されます。ポリシーを設定するIDを選択してください。

また、IDを新規作成する場合は、［ID一覧］ダイアログボックスの［IDの作成］ボタンをクリックしてください。

［追加］ボタンをクリックする。

「条件」欄で指定したポリシーを「ポリシー一覧」に追加します。

ポリシーを削除したい場合は、削除したいポリシーを選択して［削除］ボタンをクリックしてください。

(3)　［機器情報によるIDへの登録］ダイアログボックスでの設定

機器情報を基に、コンピュータをIDに登録します。指定できる機器情報は次のとおりです。

コンピュータ情報（モデル、メーカー）

ネットワーク情報（IPアドレス）

ソフトウェア情報（ソフトウェア名、インストール状態、バージョン）

資産管理項目（ハードウェア資産情報の追加管理項目に登録されているテキスト型のユーザー定義項目）

設定できるポリシー数に上限はありません。

なお、ID自動メンテナンスの実行に掛かる時間は、設定したポリシー数によって異なります。

図6‒31　［機器情報によるIDへの登録］ダイアログボックス

［機器情報によるIDへの登録］ダイアログボックスでの設定方法を次に示します。

任意のIDポリシー名を設定する。

IDポリシー名は省略できません。設定できるIDポリシー名は64バイトまでです。また、重複したIDポリシー名は設定できません。

［条件の設定］欄で条件を指定する情報の種類を選択して［条件の追加］ボタンをクリックする。

選択した情報の種類の［条件の追加］ダイアログボックスが表示されます。

条件を設定する。

［条件の追加］ダイアログボックスで設定できる条件を次の表に示します。

情報の種類

条件項目

設定値

比較条件

コンピュータ情報

モデル

モデルと比較条件を指定します。

等しい

始まる

含む

メーカー

メーカーと比較条件を指定します。

等しい

始まる

含む

ネットワーク情報

IPアドレス

一括指定

範囲指定

一括指定の場合

IPアドレスを指定します。「*」ワイルドカード指定ができます。

範囲指定の場合

IPアドレスの範囲を指定します。

−

ソフトウェア情報

ソフトウェア名

ソフトウェア名と比較条件を指定します。

等しい

始まる

含む

インストール状態

インストール状態を指定します。

未インストール

インストール済

−

バージョン

直接指定

範囲指定

直接指定の場合

バージョンと比較条件を指定します。

範囲指定の場合

バージョンの範囲を指定します。

等しい

等しくない

より大きい

以上

より小さい

以下

資産管理項目

ユーザー定義項目

直接指定

範囲指定

直接指定の場合

ユーザー定義項目の値と比較条件を指定します。

範囲指定の場合

ユーザー定義項目の値の範囲を指定します。

等しい

等しくない

始まる

含む

含まない

（凡例）−：該当なし

［OK］ボタンをクリックする。

設定した条件が、［機器情報によるIDへの登録］ダイアログボックスの［条件一覧］に追加されます。1つのポリシーに対して設定できる条件は、10個までです。なお、1つの機器情報IDポリシー内で、同じ情報の種類の条件（資産管理項目の場合は同じユーザー定義項目の条件）を複数指定できません。

条件を変更する場合は、条件を選択して［変更］ボタンをクリックして、［条件の変更］ダイアログボックスで条件を変更してください。

条件を削除する場合は、条件を選択して［削除］ボタンをクリックしてください。

［参照］ボタンをクリックする。

［ID一覧］ダイアログボックスが表示されます。ポリシーを設定するIDを選択してください。

また、IDを新規作成する場合は、［ID一覧］ダイアログボックスの［IDの作成］ボタンをクリックしてください。

6.3.2　IDの自動メンテナンス運用時の注意事項

IDの自動メンテナンス運用時の注意事項を次に示します。

同じポリシーは複数設定できません。

IDの自動メンテナンスでは、IDのパスワードの有無に関係なく自動的にコンピュータが登録されます。

中継システムおよび管理用中継サーバは、IDの自動メンテナンスの対象外となります。これらをIDに登録するには、手動でIDに登録する必要があります。

IDジョブは、コンピュータがIDに登録されたあとで再度上位システムと通信が発生したタイミングで実行されます。そのため、IDジョブを実行してからIDの自動メンテナンスを使用する場合、コンピュータが自動的にIDに登録されますが、IDジョブが実行されるタイミングはコンピュータによって異なります。

IDが削除された場合、そのIDを指定したポリシーも自動的に削除されます。ただし、ポリシーを設定中にほかのリモートインストールマネージャからIDが削除されたときは、そのIDを指定したポリシーは自動的には削除されません。このような場合、そのポリシーを削除するかIDの指定を変更してください。指定したIDが存在しないため、自動メンテナンスの対象外となります。

ポリシーを削除しても、IDに登録済みのコンピュータはIDから解除されません。

管理用中継サーバで、上位システムで作成された資産管理項目とIDをポリシーに設定する場合、上位システムと同じ条件で、登録先のIDが異なる設定はしないでください。

ポリシーを設定中にIDを新規に作成し、さらにそのIDをID管理元中継で管理する場合、ポリシーの設定が完了する前に中継システムおよび管理用中継サーバがID管理元中継に設定される必要があります。中継システムおよび管理用中継サーバがID管理元中継に設定されたことを確認してからポリシーの設定を完了してください。

運用上、システム管理者は、リモートインストールマネージャの［ジョブ実行状況］ウィンドウから不要となったIDジョブを適宜削除してください。ID自動メンテナンスと連動して不要なIDジョブが自動実行されないようにするとともに、システムの負荷を上げないように運用してください。

6.4　ポリシーをファイルから作成する

あて先グループおよびIDの自動メンテナンスのポリシーを、XML形式ファイルに出力できます。複数のポリシーを作成し、目的に合わせてファイルを入力することで、ポリシーを一括して設定できます。また、ポリシーを出力したXML形式ファイルを編集することで、既存のポリシーの設定を流用してポリシーを新規に作成できます。

ポリシーの設定を記載したファイルを自動メンテナンスポリシーファイルと呼びます。

ここでは自動メンテナンスポリシーファイルの入出力方法と、編集方法について説明します。

6.4.1　自動メンテナンスポリシーファイルの入出力方法

自動メンテナンスポリシーファイルは、［ポリシーの設定］ダイアログボックスの［ファイルから追加］ボタンおよび［ファイル出力］ボタンから入出力できます。

図6‒32　［ポリシーの設定］ダイアログボックス

［ファイルから追加］ボタン

［ファイルから追加］ボタンをクリックすると、［自動メンテナンスポリシーの追加］ダイアログボックスが表示されます。入力対象の自動メンテナンスポリシーファイルを指定して［開く］ボタンをクリックすると、ファイルに記述された内容でポリシーが追加されます。

自動メンテナンスポリシーファイルの内容が次のような場合、ポリシーは1つも追加されません。

形式がXMLとして不正である

定義されているポリシーの条件が不正である

既存のポリシーとすべて同じ設定のポリシーが含まれている

追加できなかった要因がメッセージダイアログボックスに表示されるので、メッセージの内容に従って対応してください。

なお、自動メンテナンスポリシーファイルの入力には、次の注意事項があります。

自動メンテナンスポリシーファイルでユーザが入力したコメントは、ファイル入力時に消去されます。そのため、ファイル出力時には出力されません。

ポリシー種別によって設定できる数に制限があります。［ポリシーの設定］ダイアログボックスの［追加］ボタンからポリシーを作成した場合、ポリシー種別の制限数に達すると、ポリシーの作成は自動的に制限されます。自動メンテナンスポリシーファイル上で制限数より多いポリシー種別を作成した場合、ファイル入力時にエラーメッセージが表示され、自動メンテナンスポリシーファイルのポリシーは反映されません。ポリシー種別の制限数を次の表に示します。

表6‒1　ポリシー種別の制限数

自動メンテナンス種別

ポリシー種別

制限数

あて先グループ

IPアドレス

−

新規作成ホスト

1

OS種別

−

ハードウェア資産情報の追加管理項目

16

部署

1

設置場所

1

ID

新規作成ホスト

1

資産管理項目

−

機器情報

−

（凡例）−：制限なし

［ファイル出力］ボタン

［ファイル出力］ボタンをクリックすると、［自動メンテナンスポリシーの出力］ダイアログボックスが表示されます。格納先ディレクトリを指定して、［保存］ボタンをクリックするとファイルが出力されます。

ポリシーの条件に他言語の設定がある資産管理項目を指定している場合は、デフォルトの言語の項目名および値で条件の定義が出力されます。

6.4.2　自動メンテナンスポリシーファイルの編集方法

自動メンテナンスポリシーファイルは、複数のIDの自動メンテナンスポリシーと、複数のあて先グループの自動メンテナンスポリシーをまとめて定義できます。

自動メンテナンスポリシーファイルに次の半角記号を入力する場合は、別の文字列に置き換える必要があります。

表6‒2　置き換えが必要な半角記号

置き換えが必要な半角記号

置き換えたあとの文字列

<

&lt;

>

&gt;

&

&amp;

"

&quot;

'

&apos;

自動メンテナンスポリシーファイルの構造を次の図に示します。

図6‒33　自動メンテナンスポリシーファイルの構造

1行目のタグは、XML形式ファイルであることを示すタグです。このタグのencodingに指定した文字コードに従って、ファイルが読み込まれます。このタグを省略した場合は、文字コードがUTF-8のファイルとして読み込まれます。

自動メンテナンスポリシーファイルであることを示すタグは、必ず記述してください。

図6-33の自動メンテナンスポリシーファイルの構造では、「自動メンテナンスポリシーの定義の一覧（ID）」、「自動メンテナンスポリシーの定義の一覧（あて先グループ）」の順となっていますが、どちらが先の構造でも正しくインポートできます。また、自動メンテナンスポリシーファイルの出力時には、先にあて先グループポリシーが出力されます。

自動メンテナンスポリシーの定義の一覧（ID）および自動メンテナンスポリシーの定義の一覧（あて先グループ）について、それぞれ次に説明します。

(1)　自動メンテナンスポリシーの定義の一覧（ID）

形式

定義の形式を次に示します。形式中のインデントは、タグの親子関係を示しています。子タグを記述する場合は、必ず親タグの記述が必要です。

タグの並び順は、次に示した順序に従ってください。

<IDPolicyList>
  <IDPolicy>
    <IDName>ID名</IDName>
    <IDPolicyKind>ポリシー種別</IDPolicyKind>
    [<CondAssetFieldDefinitionValue>
      <AssetFieldDefinitionValue assetItem="資産管理項目">
        <AssetFieldDefinitionName>資産管理項目名</AssetFieldDefinitionName>
        <AssetFieldDefinitionValue>資産管理項目の値</AssetFieldDefinitionValue>
      </AssetFieldDefinitionValue>
    </CondAssetFieldDefinitionValue>]
    [<CondInventoryInfoValue>
      <CondInventoryInfoName>機器情報のポリシー名</CondInventoryInfoName>
      <CondInventoryInfoList>
        [<ComputerInfo>
          [<Model filterType="比較条件">モデル</Model>]
          [<Manufacturer filterType="比較条件">メーカー</Manufacturer>]
        </ComputerInfo>]
        [<NetworkInfo>
          <FromIpAddress>開始IPアドレス</FromIpAddress>
          <ToIpAddress>終了IPアドレス</ToIpAddress>
        </NetworkInfo>]
        [<SoftwareInfo installStatus="インストール状態">
          <SoftwareName filterType="比較条件">ソフトウェア名</SoftwareName>
          [<Version filterType="比較条件">
            <VersionValue1>バージョン</VersionValue1>
            [<VersionValue2>バージョン</VersionValue2>]
          </Version>]
        </SoftwareInfo>]
        [<AssetFieldDefinitionInfo>
          <AssetFieldDefinitionName>資産管理項目の項目名</AssetFieldDefinitionName>
          <FieldValue filterType="比較条件">
            <FieldValue1>資産管理項目の値</FieldValue1>
            [<FieldValue2>資産管理項目の値</FieldValue2>]
          </FieldValue>
        </AssetFieldDefinitionInfo>]
      </CondInventoryInfoList>
    </CondInventoryInfoValue>]
  </IDPolicy>
</IDPolicyList>

説明

各タグの説明、指定する値、およびタグの記述回数を次の表に示します。タグの記述回数に0回があるタグは、配下に要素がない場合に省略できます。

タグ

説明

指定する値

タグの記述回数

<IDPolicyList>

IDの自動メンテナンスポリシーの、定義の一覧であることを示します。

−

0回または1回

<IDPolicy>

IDの自動メンテナンスポリシーの定義であることを示します。

−

1回以上

<IDName>

任意のID名を指定します。

次の文字を除く、32バイト以内の任意の文字列（バイト数は、半角文字：1バイト、全角文字：2バイトで換算）

「!」、「"」、「%」、「'」、「*」、「.」、「/」、「:」、「<」、「>」、「?」、「@」、「¥」、「|」、半角スペース、制御文字

1回

<IDPolicyKind>

ポリシー種別を指定します。

新規作成ホストによるID登録の場合

newHost

資産管理項目によるID登録の場合

assetFieldDefinition

機器情報によるID登録の場合

inventoryInfo

1回

<CondAssetFieldDefinitionValue>

資産管理項目によるID登録の条件の定義であることを示します。<IDPolicyKind>でassetFieldDefinitionを指定した場合に記述します。

−

0回または1回

<AssetFieldDefinitionValue assetItem="資産管理項目">

資産管理項目の条件の定義であることを示します。assetItemには、指定する資産管理項目に応じて次の値を指定します。

選択型のハードウェア資産情報の追加管理項目の場合

true

部署または設置場所の場合

false

<AssetFieldDefinitionValue>は、１つのポリシーに対して10個まで定義できます。

−

1回以上

<AssetFieldDefinitionName>

資産管理項目を指定します。※

部署

設置場所

選択型のハードウェア資産情報の追加管理項目

1回

<AssetFieldDefinitionValue>

資産管理項目の値を指定します。※

<AssetFieldDefinitionName>で指定した資産管理項目の選択項目

1回

<CondInventoryInfoValue>

機器情報によるID登録の条件の定義であることを示します。<IDPolicyKind>でinventoryInfoを指定した場合に記述します。

−

0回または1回

<CondInventoryInfoName>

機器情報のポリシー名を指定します。

1文字以上64バイト以下の文字列

1回

<CondInventoryInfoList>

機器情報の条件の、定義の一覧であることを示します。

機器情報の条件の定義（<CondInventoryInfoList>の子ノード）は、1つのポリシーに対して10個まで定義できます。

−

1回

<ComputerInfo>

コンピュータ情報の条件を指定する定義であることを示します。

−

0回または1回

<Model filterType="比較条件">

モデルを指定します。

filterTypeには指定したモデルの比較条件を指定します。

このタグを省略した場合、モデルの条件を「指定なし」として登録します。

モデルに指定する値

1文字以上512バイト以下の文字列

filterTypeに指定する値

exactMatch：と等しい

startWith：で始まる

include：を含む

0回または1回

<Manufacturer filterType="比較条件">

メーカーを指定します。

filterTypeには指定したメーカーの比較条件を指定します。

このタグを省略した場合、メーカーの条件を「指定なし」として登録します。

メーカーに指定する値

1文字以上512バイト以下の文字列

filterTypeに指定する値

exactMatch：と等しい

startWith：で始まる

include：を含む

0回または1回

<NetworkInfo>

ネットワーク情報の条件を指定する定義であることを示します。

−

0回または1回

<FromIpAddress>

開始IPアドレスを指定します。

IPv4形式（xxx.xxx.xxx.xxx）の値

1回

<ToIpAddress>

終了IPアドレスを指定します。

IPv4形式（xxx.xxx.xxx.xxx）の値

1回

<SoftwareInfo installStatus="インストール状態">

ソフトウェア情報の条件を指定する定義であることを示します。

installStatusにはソフトウェアのインストール状態を指定します。

installStatusに指定する値

true：インストール済

false：未インストール

installStatusを省略した場合、「false」を仮定

0回または1回

<SoftwareName filterType="比較条件">

ソフトウェア名を指定します。

filterTypeには指定したソフトウェア名の比較条件を指定します。

ソフトウェア名に指定する値

1文字以上1,024バイト以下の文字列

filterTypeに指定する値

exactMatch：と等しい

startWith：で始まる

include：を含む

1回

<Version filterType="比較条件">

バージョンの条件を指定する定義であることを示します。

filterTypeには指定したバージョンの比較条件を指定します。

このタグを省略した場合、バージョンの条件を「指定なし」として登録します。

filterTypeに指定する値

equal：と等しい

notEqual：と等しくない

greater：より大きい

greaterEqual：以上

less：より小さい

lessEqual：以下

between：の間（VersionValue1とVersionValue2の間）

0回または1回

<VersionValue1>

直接指定、または範囲指定の開始値となるバージョンを指定します。

1文字以上256バイト以下の文字列

1回

<VersionValue2>

範囲指定の終了値となるバージョンを指定します。

範囲指定条件（VersionタグのfilterType属性がbetween）の場合に指定します。

1文字以上256バイト以下の文字列

0回または1回

<AssetFieldDefinitionInfo>

資産管理項目情報の条件を指定する定義であることを示します。

資産管理項目情報の条件は、資産管理項目情報の項目名が重複しない限り複数指定できます。

−

0回または1回以上

<AssetFieldDefinitionName>

資産管理項目情報の項目名を指定します。※

対象となる資産管理項目は、ハードウェア資産情報の追加管理項目に登録されているユーザー定義項目（テキスト型）です。

−

1回

<FieldValue filterType="比較条件">

資産管理項目情報の項目値の条件を指定する定義であることを示します。

filterTypeには資産管理項目情報の項目値の比較条件を指定します。

filterTypeに指定する値

exactMatch：と等しい

notMatch：と等しくない

startWith：で始まる

include：を含む

notInclude：を含まない

between：の間（FieldValue1とFieldValue2の間）

1回

<FieldValue1>

直接指定、または範囲指定の開始値となる資産管理項目の値を指定する。

1文字以上512バイト以下の文字列

1回

<FieldValue2>

範囲指定の終了値となる資産管理項目の値を指定します。

範囲指定条件（FieldValueタグのfilterType属性がbetween）の場合に指定します。

1文字以上512バイト以下の文字列

0回または1回

注※

他言語の設定がある資産管理項目を指定する場合は、デフォルトの言語の項目名および値で指定してください。

(2)　自動メンテナンスポリシーの定義の一覧（あて先グループ）

形式

定義の形式を次に示します。形式中のインデントは、タグの親子関係を示しています。子タグを記述する場合は、必ず親タグの記述が必要です。

タグの並び順は、次に示した順序に従ってください。

<DestGroupPolicyList>
  <DestGroupPolicy>
    <DestGroupPolicyKind>ポリシー種別</DestGroupPolicyKind>
    [<CondIpAddress>
      <FromIpAddress>IPアドレス下限</FromIpAddress>
      <ToIpAddress>IPアドレス上限</ToIpAddress>
    </CondIpAddress>]
    [<CondOSKind>
      <OsKind>OS</OsKind>
    </CondOSKind>]
    [<CondOSKindOption>
      <CpuKind>CPUの種別</CpuKind>
      <OsSubversion>OSサブバージョン</OsSubversion>
    </CondOSKindOption>]
    [<CondAssetCostumField>
      <AssetCostumFieldName>ハードウェア資産情報の追加管理項目</AssetCostumFieldName>
    </CondAssetCostumField>]
    [<CondDepartmentGroup>
      <TargetGroupRange>部署の階層数</TargetGroupRange>
    </CondDepartmentGroup>]
    [<CondLocationGroup>
      <TargetGroupRange>設置場所の階層数</TargetGroupRange>
    </CondLocationGroup>]
    [<DestGroupPath>自動メンテナンスポリシーを適用するあて先グループの経路</DestGroupPath>]
    [<DestGroupName>自動メンテナンスポリシーを適用するあて先グループ</DestGroupName>]
    [<DestGroupTargetHostKind>自動メンテナンスの対象とするコンピュータの管理種別</DestGroupTargetHostKind>]
  </DestGroupPolicy>
</DestGroupPolicyList>

説明

各タグの説明、指定する値、およびタグの記述回数を次の表に示します。タグの記述回数に0回があるタグは、配下に要素がない場合に省略できます。

タグ

説明

指定する値

タグの記述回数

<DestGroupPolicyList>

あて先の自動メンテナンスポリシーの、定義の一覧であることを示します。

−

0回または1回

<DestGroupPolicy>

あて先の自動メンテナンスポリシーの定義であることを示します。

−

1回以上

<DestGroupPolicyKind>

ポリシー種別を指定します。

IPアドレスよるグルーピングの場合

ipAddress

OS種別よるグルーピングの場合

osType

新規作成ホストよるグルーピングの場合

newHost

ハードウェア資産情報の追加管理項目よるグルーピングの場合

assetCostumField

部署の情報よるグルーピングの場合

departmentGroup

設置場所の情報よるグルーピングの場合

locationGroup

1回

<CondIpAddress>

IPアドレスによるグルーピングの条件の定義であることを示します。<DestGroupPolicyKind>でipAddressを指定した場合に記述します。

−

0回または1回

<FromIpAddress>

IPアドレスの下限を設定します。

IPv4形式のIPアドレス

1回

<ToIpAddress>

IPアドレスの上限を設定します。

IPv4形式のIPアドレス

1回

<CondOSKind>

OS種別よるグルーピングの条件の定義であることを示します。<DestGroupPolicyKind>でosTypeを指定した場合に記述します。

−

0回または1回

<OsKind>

OS種別を指定します。

WindowsXP

WindowsServer2003

HP_UX

Solaris

AIX

WindowsVista

WindowsServer2008

Windows7

WindowsServer2008R2

Windows8

WindowsServer2012

Windows8_1

WindowsServer2012R2

Windows10

WindowsServer2016

WindowsServer2019

RedHatEnterpriseLinux

CentOS

1回

<CondAssetCostumField>

ハードウェア資産情報の追加管理項目よるグルーピングの条件の定義であることを示します。<DestGroupPolicyKind>でassetCostumFieldを指定した場合に記述します。

−

0回または1回

<AssetCostumFieldName>

ハードウェア資産情報の追加管理項目を指定します。<AssetCostumFieldName>は、1個のポリシーに対して6個まで指定できます。※

選択型およびテキスト型の、ハードウェア資産情報の追加管理項目

1回以上

<CondDepartmentGroup>

部署の情報によるグルーピングの条件の定義であることを示します。<DestGroupPolicyKind>でdepartmentGroupを指定した場合に記述します。※

−

0回または1回

<CondLocationGroup>

設置場所の情報によるグルーピングの条件の定義であることを示します。<DestGroupPolicyKind>でlocationGroupを指定した場合に記述します。

−

0回または1回

<TargetGroupRange>

部署または設置場所の情報によるグルーピングの対象とする階層を指定します。

1〜6

1回

<DestGroupPath>

自動メンテナンスの対象とするあて先グループが所属する経路を指定します。省略した場合は、すべてのあて先にポリシーが適用されます。このタグは、<DestGroupPolicyKind>で次の値を指定した場合だけ指定できます。

ipAddress

osType

assetCostumField

departmentGroup

locationGroup

newHost

次の文字を除く、32バイト以内の任意の文字列（バイト数は、半角文字：1バイト、全角文字：2バイトで換算）

「!」、「"」、「%」、「'」、「*」、「.」、「/」、「:」、「<」、「>」、「?」、「@」、「¥」、「|」、半角スペース、制御文字

0回または1回

<DestGroupName>

自動メンテナンスの対象とするあて先グループを指定します。このタグは、<DestGroupPolicyKind>で次の値を指定した場合だけ指定できます。

ipAddress

osType

newHost

次の文字を除く、32バイト以内の任意の文字列（バイト数は、半角文字：1バイト、全角文字：2バイトで換算）

「!」、「"」、「%」、「'」、「*」、「.」、「/」、「:」、「<」、「>」、「?」、「@」、「¥」、「|」、半角スペース、制御文字

0回または1回

<DestGroupTargetHostKind>

自動メンテナンスの対象とするホストの種別を指定します。省略した場合は、すべてのホストが対象となります。

すべてのホスト（中継システムおよびエージェント）の場合

all

エージェントだけの場合

agentOnly

0回または1回

<CondOSKindOption>

OS種別よるグルーピングの条件の、詳細の定義であることを示します。<DestGroupPolicyKind>でosTypeを指定した場合に、任意で記述します。

−

0回または1回

<CpuKind>

32ビット版と64ビット版を分けてグルーピングするかどうかを指定します。省略した場合は、32ビット版と64ビット版を分けないでグルーピングします。

分ける場合

true

分けない場合

false

0回または1回

<OsSubversion>

OS サブバージョンレベルまでグルーピングの対象とするかどうかを指定します。省略した場合は、分OS サブバージョンレベルを対象にしないでグルーピングします。

対象にする場合

true

対象にしない場合

false

0回または1回

注※

他言語の設定がある資産管理項目を指定する場合は、デフォルトの言語の項目名および値で指定してください。

6.4.3　ポリシーの作成例

自動メンテナンスポリシーファイルの作成例を示します。

<?xml version="1.0" encoding="utf-8" ?>
<AutoMaintenancePolicy>
  <MaintenancePolicyList>
    <DestGroupPolicyList>
      <DestGroupPolicy>
        <DestGroupPolicyKind>ipAddress</DestGroupPolicyKind>
        <CondIpAddress>
          <FromIpAddress>10.210.177.150</FromIpAddress>
          <ToIpAddress>10.210.177.160</ToIpAddress>
        </CondIpAddress>
        <DestGroupPath>IPアドレス</DestGroupPath>
        <DestGroupName>IPアドレスグループ</DestGroupName>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>ipAddress</DestGroupPolicyKind>
        <CondIpAddress>
          <FromIpAddress>192.168.111.0</FromIpAddress>
          <ToIpAddress>192.168.111.255</ToIpAddress>
        </CondIpAddress>
        <DestGroupPath>IPアドレス</DestGroupPath>
        <DestGroupName>IPアドレスグループ</DestGroupName>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>newHost</DestGroupPolicyKind>
        <DestGroupName>新規作成PC</DestGroupName>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>osType</DestGroupPolicyKind>
        <CondOSKind>
          <OsKind>Windows7</OsKind>
        </CondOSKind>
        <CondOSKindOption>
          <OsSubversion>true</OsSubversion>
          <CpuKind>true</CpuKind>
        </CondOSKindOption>
        <DestGroupPath>OS種別</DestGroupPath>
        <DestGroupName>Windows7</DestGroupName>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>osType</DestGroupPolicyKind>
        <CondOSKind>
          <OsKind>Windows8_1</OsKind>
        </CondOSKind>
        <CondOSKindOption>
          <OsSubversion>true</OsSubversion>
          <CpuKind>true</CpuKind>
        </CondOSKindOption>
        <DestGroupPath>OS種別</DestGroupPath>
        <DestGroupName>Windows8_1</DestGroupName>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>osType</DestGroupPolicyKind>
        <CondOSKind>
          <OsKind>WindowsServer2012R2</OsKind>
        </CondOSKind>
        <CondOSKindOption>
          <OsSubversion>true</OsSubversion>
          <CpuKind>true</CpuKind>
        </CondOSKindOption>
        <DestGroupPath>OS種別¥Server</DestGroupPath>
        <DestGroupName>WindowsServer2012R2</DestGroupName>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>departmentGroup</DestGroupPolicyKind>
        <CondDepartmentGroup>
          <TargetGroupRange>4</TargetGroupRange>
        </CondDepartmentGroup>
        <DestGroupPath>部署</DestGroupPath>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>locationGroup</DestGroupPolicyKind>
        <CondLocationGroup>
          <TargetGroupRange>5</TargetGroupRange>
        </CondLocationGroup>
        <DestGroupPath>設置</DestGroupPath>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
      <DestGroupPolicy>
        <DestGroupPolicyKind>assetCostumField</DestGroupPolicyKind>
        <CondAssetCostumField>
          <AssetCostumFieldName>サーバ／クライアント</AssetCostumFieldName>
          <AssetCostumFieldName>PC種別</AssetCostumFieldName>
        </CondAssetCostumField>
        <DestGroupPath>資産管理項目別</DestGroupPath>
        <DestGroupTargetHostKind>all</DestGroupTargetHostKind>
      </DestGroupPolicy>
    </DestGroupPolicyList>
    <IDPolicyList>
      <IDPolicy>
        <IDName>ID_新規ホスト用</IDName>
        <IDPolicyKind>newHost</IDPolicyKind>
      </IDPolicy>
      <IDPolicy>
        <IDName>ID_ノートPC</IDName>
        <IDPolicyKind>assetFieldDefinition</IDPolicyKind>
        <CondAssetFieldDefinitionValue>
          <AssetFieldDefinitionValue assetItem="true">
            <AssetFieldDefinitionName>PC種別</AssetFieldDefinitionName>
            <AssetFieldDefinitionValue>ノート</AssetFieldDefinitionValue>
          </AssetFieldDefinitionValue>
          <AssetFieldDefinitionValue assetItem="true">
            <AssetFieldDefinitionName>サーバ／クライアント</AssetFieldDefinitionName>
            <AssetFieldDefinitionValue>クライアントPC</AssetFieldDefinitionValue>
          </AssetFieldDefinitionValue>
        </CondAssetFieldDefinitionValue>
      </IDPolicy>
      <IDPolicy>
        <IDName>ID_ノートPC</IDName>
        <IDPolicyKind>assetFieldDefinition</IDPolicyKind>
        <CondAssetFieldDefinitionValue>
          <AssetFieldDefinitionValue assetItem="true">
            <AssetFieldDefinitionName>PC種別</AssetFieldDefinitionName>
            <AssetFieldDefinitionValue>ノート</AssetFieldDefinitionValue>
          </AssetFieldDefinitionValue>
          <AssetFieldDefinitionValue assetItem="true">
            <AssetFieldDefinitionName>サーバ／クライアント</AssetFieldDefinitionName>
            <AssetFieldDefinitionValue>その他</AssetFieldDefinitionValue>
          </AssetFieldDefinitionValue>
        </CondAssetFieldDefinitionValue>
      </IDPolicy>
      <IDPolicy>
        <IDName>ID_東京管理</IDName>
        <IDPolicyKind>assetFieldDefinition</IDPolicyKind>
        <CondAssetFieldDefinitionValue>
          <AssetFieldDefinitionValue assetItem="false">
            <AssetFieldDefinitionName>設置場所</AssetFieldDefinitionName>
            <AssetFieldDefinitionValue>/国内/関東/東京/</AssetFieldDefinitionValue>
          </AssetFieldDefinitionValue>
        </CondAssetFieldDefinitionValue>
      </IDPolicy>
      <IDPolicy>
        <IDName>ID1150A</IDName>
        <IDPolicyKind>inventoryInfo</IDPolicyKind>
        <CondInventoryInfoValue>
          <CondInventoryInfoName>ポリシー名001</CondInventoryInfoName>
          <CondInventoryInfoList>
            <ComputerInfo>
              <Model filterType="exactMatch">Modelname123</Model>
              <Manufacturer filterType="include">makername123</Manufacturer>
            </ComputerInfo>
            <SoftwareInfo installStatus="true">
              <SoftwareName filterType="startWith">Adobe Flash Player</SoftwareName>
              <Version filterType="less">
                <VersionValue1>26.0.0.137</VersionValue1>
              </Version>
            </SoftwareInfo>
            <AssetFieldDefinitionInfo>
              <AssetFieldDefinitionName>個人番号</AssetFieldDefinitionName>
              <FieldValue filterType="startWith">
                <FieldValue1>USR2010</FieldValue1>
              </FieldValue>
            </AssetFieldDefinitionInfo>
            <AssetFieldDefinitionInfo>
              <AssetFieldDefinitionName>○○申請日付</AssetFieldDefinitionName>
              <FieldValue filterType="between">
                <FieldValue1>20171001</FieldValue1>
                <FieldValue2>20171130</FieldValue2>
              </FieldValue>
            </AssetFieldDefinitionInfo>
          </CondInventoryInfoList>
        </CondInventoryInfoValue>
      </IDPolicy>
      <IDPolicy>
        <IDName>ID1150B</IDName>
        <IDPolicyKind>inventoryInfo</IDPolicyKind>
        <CondInventoryInfoValue>
          <CondInventoryInfoName>ポリシー名002</CondInventoryInfoName>
          <CondInventoryInfoList>
            <NetworkInfo>
              <FromIpAddress>192.168.10.20</FromIpAddress>
              <ToIpAddress>192.168.10.255</ToIpAddress>
            </NetworkInfo>
            <SoftwareInfo installStatus="false">
              <SoftwareName filterType="startWith">ABC Software</SoftwareName>
            </SoftwareInfo>
            <AssetFieldDefinitionInfo>
              <AssetFieldDefinitionName>AAACurrentVersion</AssetFieldDefinitionName>
              <FieldValue filterType="exactMatch">
                <FieldValue1>1.8</FieldValue1>
              </FieldValue>
            </AssetFieldDefinitionInfo>
            <AssetFieldDefinitionInfo>
              <AssetFieldDefinitionName>座席コード</AssetFieldDefinitionName>
              <FieldValue filterType="between">
                <FieldValue1>DP-A-501</FieldValue1>
                <FieldValue2>DP-B-299</FieldValue2>
              </FieldValue>
            </AssetFieldDefinitionInfo>
          </CondInventoryInfoList>
        </CondInventoryInfoValue>
      </IDPolicy>
    </IDPolicyList>
  </MaintenancePolicyList>
</AutoMaintenancePolicy>

この作成例では、自動メンテナンスポリシーを次のとおり定義しています。

あて先グループ

IPアドレスが10.210.177.150〜10.210.177.160および192.168.111.0〜192.168.111.255の範囲にあるコンピュータを、経路が「IPアドレス」のあて先グループ「IPアドレスグループ」に登録する

新規作成ホストをあて先グループ「新規作成PC」に登録する

OS種別がWindows 7のコンピュータを、経路が「OS種別」のあて先グループ「Windows7」に、32ビット版と64ビット版を分けて、かつOSサブバージョンレベルまでグルーピングして登録する

OS種別がWindows 8.1のコンピュータを、経路が「OS種別」のあて先グループ「Windows 8.1」に、32ビット版と64ビット版を分けて、かつOSサブバージョンレベルまでグルーピングして登録する

OS種別がWindows Server 2012 R2のコンピュータを、経路が「OS種別¥Server」のあて先グループ「WindowsServer2012R2」に、32ビット版と64ビット版を分けて、かつOSサブバージョンレベルまでグルーピングして登録する

部署の情報によって階層化したコンピュータを、経路「部署」に4階層目まで登録する

設置場所の情報によって階層化したコンピュータを、経路「設置」に5階層目まで登録する

ハードウェア資産情報の追加管理項目の「サーバ／クライアント」および「PC種別」によって階層化したコンピュータを、経路「資産管理項目別」に登録する

ID

新規作成ホストをID「ID_新規ホスト用」に登録する

ハードウェア資産情報の追加管理項目の「PC種別」の値が「ノート」で、「サーバ／クライアント」の値が「クライアントPC」または「その他」のコンピュータを、ID「ID_ノートPC」に登録する

設置場所が「国内/関東/東京」のコンピュータを、ID「ID_東京管理」に登録する

次に示すすべての条件を満たすコンピュータを、ID「ID1150A」に登録する（大文字と小文字は区別されない）

・モデル名「Modelname123」に完全一致

・メーカー名に「makername123」を含む

・「Adobe Flash Player」で始まるソフトウェア名でバージョンが26.0.0.137未満のソフトウェアがインストール済み

・追加管理項目「個人番号」が「USR2010」で始まる

・追加管理項目「○○申請日付」が「20171001〜21071130」の範囲内

次に示すすべての条件を満たすコンピュータを、ID「ID1150B」に登録する（大文字と小文字は区別されない）

・IPアドレスが「192.168.10.20〜192.168.10.255」の範囲内

・「ABC Software」で始まるソフトウェアが未インストール

・追加管理項目「AAACurrentVersion」の値が「1.8」

・追加管理項目「座席コード」の値が「DP-A-501〜DP-B-299」の範囲内

このポリシーをコピーして、IPアドレスの範囲、あて先グループ名などを変更することで、自動メンテナンスポリシーを新たに作成できます。このように、既存のポリシーをコピーして編集することで、効率良く複数の自動メンテナンスポリシーを作成できます。

6.5　システム構成情報の削除履歴を管理する

JP1/IT Desktop Management 2 - Managerでは、いつ、どのような契機で、各システムがシステム構成情報から削除されたか、その削除履歴を管理できます。

システム構成情報の削除履歴を管理するには、JP1/IT Desktop Management 2 - Managerのセットアップで、［リモートインストールマネージャを使用した配布のセットアップ］画面の［システム構成関連］パネルの「削除履歴を保管する」チェックボックスをオンにしてください。

6.5.1　削除履歴の表示

システム構成情報の削除履歴は、［システム構成情報の削除履歴］ダイアログボックスに表示されます。［システム構成情報の削除履歴］ダイアログボックスは、［ファイル］−［システム構成情報の削除履歴］を選択して、表示します。リモートインストールマネージャのどのウィンドウからでも表示できます。

図6‒34　［システム構成情報の削除履歴］ダイアログボックス

［システム構成情報の削除履歴］ダイアログボックスには、システム構成情報である「あて先」、「サブキー」、「経路」に加えて、次の項目が、削除されたホストごとに表示されます。

削除要因

システム構成情報からホストが削除された要因が表示されます。

削除要因

意味

アンインストール結果受信による削除

管理対象のコンピュータ、中継システム、または管理用中継サーバからアンインストールが通知された。

「システム構成情報の取得」ジョブによって、ホストが削除された。

管理者による削除

［システム構成］ウィンドウから、管理対象のコンピュータ、中継システム、および管理用中継サーバを手動で削除した。

［検索］ダイアログボックスから、管理対象のコンピュータを手動で削除した。

機器のメンテナンスで削除候補機器として検出されたホストが削除された。

上位マネージャの指示による削除

下位システムが接続先を変更したとき、管理用中継サーバが上位マネージャから、旧経路に残っている下位システムのシステム構成情報の削除通知を受信した。

管理用中継サーバが上位マネージャから、［検索］ダイアログボックスでの［システム構成から削除］メニューの操作による削除通知を受信した。

削除日時

システム構成情報からホストが削除された日時です。

［システム構成情報の削除履歴］ダイアログボックスには、次の項目を追加表示することもできます。

ホスト識別子、MACアドレス、コメント、作成日時、更新日時

追加表示するには、右クリックして表示されるメニューから［表示する情報］を選択したあと、表示項目を選択します。

［システム構成情報の削除履歴］ダイアログボックスは、ダイアログボックス枠をドラッグして、見やすいサイズに変更できます。また、各列名をクリックするたびに、昇順、降順のソートが繰り返されます。

6.5.2　削除履歴のCSV形式ファイルへの出力

システム構成情報の削除履歴をCSV形式ファイルへ出力できます。ホストごとに次の情報が出力されます。

ホスト名称、IPアドレス、ホスト識別子、MACアドレス、タイプ、経路、コメント、削除要因、削除日時、作成日時、更新日時

削除履歴をCSV形式ファイルへ出力する方法は、次のとおりです。

［ファイル］−［システム構成情報の削除履歴］を選択する。

［システム構成情報の削除履歴］ダイアログボックスが表示されます。

［CSV出力］ボタンをクリックする。

［削除履歴のCSV出力］ダイアログボックスが表示されます。

ファイルを保存する場所とファイル名を指定し、［保存］ボタンをクリックする。

指定したファイルに、削除履歴がCSV形式で保存されます。

CSV形式ファイルの出力を途中で中止する場合は、［中止］ボタンをクリックしてください。

6.5.3　削除したホストのシステム構成情報への復元

システム構成情報の削除履歴を基に、削除したホストをシステム構成情報に復元できます。ただし、削除したホストのあて先グループ、ID、および機器情報は復元されません。

ホスト削除時の経路が存在しない場合、同じホストがシステム構成情報に登録されている場合は、復元できません。また、配布管理システムを階層化したシステムの場合、上位マネージャから、管理用中継サーバ配下の中継システムおよび管理対象のコンピュータは復元できません。

なお、削除したホストをシステム構成情報に復元しても、［システム構成情報の削除履歴］ダイアログボックスの削除履歴からは削除されません。削除履歴は、必要に応じて、削除してください。

削除したホストをシステム構成情報に復元する方法は、次のとおりです。

［ファイル］−［システム構成情報の削除履歴］を選択する。

［システム構成情報の削除履歴］ダイアログボックスが表示されます。

復元したいホストを選択し、［復元］ボタンをクリックする。

システム構成情報に復元されます。

複数のホストを選択して、一括して復元することもできます。

6.5.4　削除履歴の削除

削除履歴を基に、ホストをシステム構成情報に復元しても、［システム構成情報の削除履歴］ダイアログボックスの削除履歴からは削除されません。削除履歴が大量に残っていると、データベース容量を圧迫しますので、不要な履歴は定期的に削除することをお勧めします。

削除履歴を削除するには、［システム構成情報の削除履歴］ダイアログボックスで、履歴の不要なホストを選択し、［削除］ボタンをクリックします。［すべて削除］ボタンをクリックすると、すべての削除履歴が削除されます。

7　ソフトウェアを配布する

ここでは、ソフトウェアの配布（リモートインストール）の方法について説明します。

7.1　パッケージングの方法

ここでは、ソフトウェアをパッケージングする方法について説明します。

7.1.1　パッケージャの起動

ソフトウェアのパッケージングは、パッケージャの［JP1/ITDM2 パッケージャ］ウィンドウから実行します。なお、監査ログを出力する場合は、レジストリのHKEY_LOCAL_MACHINEの更新権限を持つユーザーでパッケージャを起動してください。

［JP1/ITDM2 パッケージャ］ウィンドウの起動方法を次に示します。

Windowsの［スタート］メニューから［JP1_IT Desktop Management 2 - Agent］−［パッケージャ］を選択する。

［ログイン（パッケージャ）］ダイアログボックスが表示されます。

図7‒1　［ログイン（パッケージャ）］ダイアログボックス

管理用サーバ：

管理用サーバのホスト名またはIPアドレスを指定してください。なお、前回パッケージャをレジストリのHKEY_LOCAL_MACHINEの更新権限を持つユーザーで起動した場合、前回接続したサーバ名がデフォルトで表示されます。

接続受付ポート番号：

管理用サーバのポート番号を指定してください。

ユーザーID

JP1/IT Desktop Management 2のユーザーアカウントのうち、システム管理権限と配布管理権限の両方の権限があるユーザーIDを指定してください。

パスワード

［ユーザーID］に指定したユーザーIDに対応するパスワードを指定してください。

必要な情報を設定し、［OK］ボタンをクリックする。

配布管理システムに接続して、［JP1/ITDM2 パッケージャ］ウィンドウが表示されます。

図7‒2　［JP1/ITDM2 パッケージャ］ウィンドウ

［JP1/ITDM2 パッケージャ］ウィンドウには、次のウィンドウが表示されます。

［ファイル］ウィンドウ

パッケージングするファイルを選択するウィンドウです。

［パッケージ］ウィンドウ

キャビネットに格納されたパッケージが表示されるウィンドウです。パッケージを削除したり、キャビネットを編集したりできます。

7.1.2　パッケージングの手順

ここでは、パッケージングの手順について説明します。

パッケージングの手順は、日立総合インストーラから日立プログラムプロダクトをパッケージングする場合と、他社のソフトウェアやユーザプログラムなどの任意のソフトウェアをパッケージングする場合で異なります。

それぞれの場合の手順について説明します。

(1)　日立総合インストーラからパッケージングする場合の手順

日立総合インストーラから日立プログラムプロダクトをパッケージングする手順を次に示します。

［ファイル］ウィンドウで日立総合インストーラのマウントされているドライブのルートディレクトリを選択する。

必ず［ファイル］ウィンドウの左画面でルートディレクトリを選択してください。ルートディレクトリ以外を選択するとパッケージングできません。

［実行］−［パッケージング］を選択する。

［プログラムプロダクトの一覧］ダイアログボックスが表示されます。

図7‒3　［プログラムプロダクトの一覧］ダイアログボックス

パッケージングする日立プログラムプロダクトを選択し、［パッケージング］ボタンをクリックする。

［JP1/ITDM2 パッケージング］ダイアログボックスが表示されます。

図7‒4　［JP1/ITDM2 パッケージング］ダイアログボックス

パッケージの詳細を設定します。［JP1/ITDM2 パッケージング］ダイアログボックスでの設定方法については、「7.2　パッケージの詳細設定」を参照してください。

［プログラムプロダクトの一覧］ダイアログボックスで、複数のプログラムプロダクトを選択した場合、［パッケージング情報］パネルのパッケージ名に表示するプログラムプロダクトを、プルダウン形式の一覧から選択して、すべてのパッケージの詳細を設定します。

設定が完了したら、［パッケージング実行］ボタンをクリックする。

パッケージングが開始されます。

パッケージングが完了すると、完了を知らせるダイアログボックスが表示されます。

［パッケージ］ウィンドウでパッケージが作成されていることを確認する。

図7‒5　［パッケージ］ウィンドウ

パッケージは次のアイコンで表示されます。

[図データ]：パッケージ

パッケージの確認方法については、「7.1.3　保管したパッケージの確認」を参照してください。

(2)　任意のソフトウェアをパッケージングする場合の手順

任意のソフトウェアをパッケージングする手順を次に示します。

［ファイル］ウィンドウで、パッケージングするファイルまたはディレクトリを選択する。

ファイルは複数選択できます。

［実行］−［パッケージング］を選択する。

［JP1/ITDM2 パッケージング］ダイアログボックスが表示されます。

以降の手順については、(1)の手順4.以降と同様です。

間違ってパッケージングしたパッケージは削除できます。パッケージャからパッケージを削除するには、［パッケージ］ウィンドウで、削除したいパッケージを選択し、［編集］−［削除］を選択します。

ワークディレクトリなどのパッケージング時の環境や、［JP1/ITDM2 パッケージング］ダイアログボックスのデフォルト値は、［デフォルト値のカスタマイズ］ダイアログボックスで変更できます。詳細については、「7.2.14　パッケージング環境のカスタマイズ」を参照してください。

7.1.3　保管したパッケージの確認

保管したパッケージの内容は、パッケージャの［パッケージ］ウィンドウから確認できます。

パッケージの内容を確認するには、［パッケージ］ウィンドウの［表示］メニューから、［表示する情報］−［パッケージ情報］を選択してください。選択したパッケージの内容が［パッケージ］ウィンドウの右枠に表示されるようになります。

パッケージのプロパティもパッケージャで確認できます。また、プロパティのダイアログボックスから表示できる［属性の詳細］ダイアログボックスで、パッケージング時の指定内容も確認できます。

(1)　パッケージのプロパティの確認方法

キャビネットに保管したパッケージのプロパティを確認する方法を次に示します。なお、複数のパッケージのプロパティは一度に確認できません。

［パッケージ］ウィンドウで、プロパティを確認したいパッケージを1つ選択する。

［ファイル］メニューから［プロパティ］を選択する。

［XXXXXのプロパティ］ダイアログボックス（XXXXXはパッケージ名）が表示されます。

［XXXXXのプロパティ］ダイアログボックスの［詳細］ボタンをクリックする。

［属性の詳細］ダイアログボックスが表示され、パッケージング時の指定内容を確認できます。［属性の詳細］ダイアログボックスを次に示します。

図7‒6　［属性の詳細］ダイアログボックス

(2)　パッケージの詳細確認時の注意事項

パッケージのプロパティ表示中にそのパッケージが削除された場合、属性の詳細は表示されません。

7.1.4　パッケージング時の注意事項

パッケージング時の注意事項を次に示します。

キャビネットは、1,296個まで作成できます。1つのキャビネットには、最大256個のパッケージを登録できます。

一度にパッケージングできるファイルまたはディレクトリについては、最大で65,531個までです。なお、パッケージング対象のファイルまたはディレクトリがショートファイル名を持つ場合は、ショートファイル名もカウントの対象となります。詳細については、マニュアル「JP1/IT Desktop Management 2 メッセージ」のメッセージ一覧の「KDSF0123-E」メッセージ注釈欄を参照してください。

一度キャビネットに保管されたパッケージは、名前を変更したり、ほかのキャビネットに移したりはできません。

パッケージ容量の上限は2ギガバイトです。パッケージ容量が2ギガバイトを超えないようにファイルをパッケージングしてください。なお、パッケージ容量が2ギガバイトを超える場合は、JP1/IT Desktop Management 2が提供するコマンドを使用して、管理対象のコンピュータに配布できます。詳細については、「7.6.14　2ギガバイトを超えるファイルを配布する」を参照してください。

更新日時およびアクセス日時が1970年〜2037年以外のファイルは、パッケージングの対象としないでください。

パッケージングするファイルまたはディレクトリが、ほかのアプリケーションで使用中の場合、パッケージングが失敗することがあります。

複数のディレクトリ下のファイルを一度にパッケージングできません。

圧縮ファイルなどのファイル形式の他社ソフトウェアをパッケージングする場合は、ディレクトリを作成し、パッケージングしたいファイルを中にコピーしてから、そのディレクトリを指定してパッケージングしてください。

複数のCD-Rに格納されているユーザデータをパッケージングする場合は、一度ハードディスク上にコピーしてから、そのディレクトリまたはファイルを指定してパッケージングしてください。

他社ソフトウェアなど、インストールするCD-Rの順序が決まっているソフトウェアをパッケージングする場合、CD-Rの挿入順序を間違えると、配布後の組み込み処理で失敗します。

インストール時にCDキーを入力する他社ソフトウェアのCDキーは、［AITファイルの設定］パネルの「シリアルナンバー」の欄に入力してください。

異なるキャビネット識別IDでキャビネット名が重複すると、キャビネットの管理が難しくなるため、キャビネット名とキャビネット識別IDは1対1になるように設定してください。また、同一キャビネット内では、パッケージ名とパッケージ識別IDが1対1になるようにしてください。

UNIX用のパッケージを作成する場合は、次の点に注意してください。

インストール先ディレクトリは、半角64文字を超えない範囲で指定してください（ドライブ名および「:」を含む）。

半角64文字を超えた場合、配布したパッケージはルートディレクトリの直下にインストールされます。

世代番号は、指定しないか、または4けたで指定してください。1〜3けたで指定すると、登録したパッケージの配布が世代番号の不正エラーとなって失敗します。

パッケージングするファイルまたはディレクトリの名称に、スペース、( )[ ]{ }で囲んだ文字列、および次の半角文字は使用できません。

「$」「!」「*」「?」「;」「&」「"」「'」「‘」「^」「¥」「|」「<」「>」

UNIX版のパッケージャ（資源登録システム）から、中継システムを経由してパッケージング（資源登録）することはできません。この場合、資源登録コマンドに指定した「-hオプション（ホスト名）」は無効になり、中継システムにパッケージング（資源登録）されます。

［パッケージ］ウィンドウでは、UNIX版のパッケージャで登録したキャビネットおよびパッケージは削除できません。

日立総合インストーラから直接パッケージングする場合は、パッケージャの［ファイル］ウィンドウでCD-ROMがマウントしてあるドライブのルートディレクトリを指定してください。このようにすると［実行］メニューから［パッケージング］選択時にリモートインストール対象製品一覧が表示されます。この一覧からリモートインストールしたい製品を選択してパッケージングするようにしてください。日立総合インストーラのルートディレクトリ以外のディレクトリを指定してパッケージングすると、リモートインストールに失敗します。

配布管理システム、中継システムおよび管理用中継サーバでキャビネット識別ID、パッケージ識別ID、バージョン/リビジョン、世代番号が重複しないようにパッケージの命名規則を取り決めてパッケージングしてください。

中継システムおよび管理用中継サーバにパッケージを転送する場合

キャビネット識別ID、パッケージ識別ID、バージョン/リビジョン、および世代番号が同じパッケージがすでに中継システムおよび管理用中継サーバに存在する場合、異なるソフトウェアのパッケージでも保管済みと判断され、パッケージが転送されません。

管理対象のコンピュータにリモートインストールする場合

パッケージ識別ID、バージョン/リビジョン、および世代番号が同じパッケージがすでにインストールされている場合、異なるソフトウェアのパッケージでもインストール済みと判断され、インストールされません。

キャビネット識別ID、パッケージ識別ID、バージョン/リビジョン、および世代番号が同一のパッケージが存在する場合、ジョブ作成時に［インストール条件の変更］ダイアログボックスの「同じパッケージがあったら上書き」を設定することでパッケージの転送、インストールを行う事ができます。

11-10より前のバージョンからJP1/IT Desktop Management 2をバージョンアップした場合で、かつバージョンアップ前に登録したパッケージに複数のパッケージ条件またはソフトウェア条件が設定されているとき、複数条件の判定方法は「いずれかの条件を満たす」で動作します。複数条件の判定方法を「すべての条件を満たす」に変更したい場合は、リモートインストール実行時（ジョブ作成時）に、［インストール条件の変更］ダイアログボックスで変更するか、またはパッケージを登録し直してください。

パッケージャでCD-Rに格納されるファイルをパッケージングする場合、ファイル名（MS-DOSファイル名）が8.3形式でないと、パッケージにそのファイルを含め一部のファイルが含まれないことがあります。このような現象が発生した場合は、HDDにいったんCD-Rの内容をコピーしてからパッケージングするか、CD-Rに格納されるファイル名（MS-DOSファイル名）が8.3形式になるように変更してからパッケージングしてください。

パッケージャのドライブ選択個所に接続済みのネットワークドライブが表示されないことがあります。対象のネットワークドライブを表示する場合は、［ディスク］−［ドライブの選択］−［ネットワーク］を選択し、ネットワークドライブを再度割り当ててください。

パッケージャで日立統合CD-ROMのパッケージングをした場合、パッケージング中に表示されるゲージダイアログ、およびパッケージ実行状況ウィンドウのパッケージ名には、「プログラムプロダクト一覧」ダイアログで選択した日立プログラムプロダクトの名称が表示されます。この名称は「JP1/ITDM2 パッケージング」ダイアログで指定した実際のパッケージ名とは異なる場合があります。

7.2　パッケージの詳細設定

パッケージング時には、パッケージをインストールする条件やインストールする日時などを設定できます。パッケージの詳細設定は、［JP1/ITDM2 パッケージング］ダイアログボックスで行います。

ここでは、［JP1/ITDM2 パッケージング］ダイアログボックスでの設定について説明します。

7.2.1　［JP1/ITDM2 パッケージング］ダイアログボックスでの設定

［JP1/ITDM2 パッケージング］ダイアログボックスには、表7-1に示す種類のパネルがあり、パッケージ種別によって表示されるパネルが異なります。必要な項目を設定していない状態でパッケージングを実行すると、エラーメッセージが表示されます。

他社ソフトウェアをパッケージングするには、次の方法があります。

AITファイルおよびPP識別情報ファイルを使用する方法

AITファイルを省略する方法

ここでは、1の方法を前提に説明します。2の方法でのパッケージングについては、「7.2.13　他社ソフトウェアのパッケージングのバリエーション」を参照してください。

表7‒1　［JP1/ITDM2 パッケージング］ダイアログボックスのパネルの種類

パネル名

パッケージ種別

日立プログラムプロダクト

他社ソフトウェア

ユーザプログラム、データ

パッケージング情報

○

○

○

システム条件

○

○

○

ソフトウェア条件

○

○

○

パッケージ条件

○

○

○

ファイル属性

−

○

○

スケジュール

○

○

○

インストール方法

○

○

○

オプション

○

○

○

外部プログラム

○

○

○

AITファイルの設定

−

○※1

−

コンポーネントの選択

○※2

−

−

（凡例）○：表示される　−：表示されない

注※1

AITファイルを使用する場合に表示されます。

注※2

パッケージャでJP1/IT Desktop Management 2 - Agentをパッケージングする場合に表示されます。

7.2.2　［パッケージング情報］パネル

パッケージの名称、保管先キャビネットなど、パッケージの基本的な情報を設定します。

図7‒7　［パッケージング情報］パネル

(1)　パッケージ情報

パッケージを識別するための情報を設定します。パッケージ識別ID、バージョン/リビジョン、および世代番号が既存のパッケージとすべて同じにならないように指定してください。

ヒント

パッケージ名は識別しやすい名称で重複しないように作成することを推奨します。

パッケージ種別が「日立プログラムプロダクト」または「他社ソフトウェア」の場合、パッケージ名、パッケージ識別ID、バージョン/リビジョン、および世代番号には値が表示され、原則として変更できません。値が表示されていない場合は「ユーザプログラム、データ」として扱われます。

パッケージ名（必ず設定）

パッケージ種別が「ユーザプログラム、データ」の場合に、パッケージングするユーザプログラム、データの名前を設定します。半角50文字（全角で25文字）までのパッケージ名が設定できます。「¥」は使用できません。

また、パッケージ種別が「日立プログラムプロダクト」の場合、表示されるパッケージ名を変更できます。エンドユーザから見て区別しやすい名称に変更するなどの工夫ができます。

UNIX版のJP1/IT Desktop Management 2 - Agentの用語ではプログラム名に相当します。

パッケージ識別ID（必ず設定）

パッケージ種別が「ユーザプログラム、データ」の場合、パッケージのIDを設定します。1〜44文字の半角英数字（英字は大文字だけ）、「-」（ハイフン）、または「_」（アンダーバー）で指定してください。

UNIX版のJP1/IT Desktop Management 2 - Agentの用語では資源名に相当します。

パッケージ識別IDの先頭には次の文字列を指定しないでください。

「DPT-」

「SPC-」

バージョン/リビジョン（必ず設定）

パッケージ種別が「ユーザプログラム、データ」の場合、パッケージのバージョン・リビジョンを、6けたまでの英数字（英字は大文字だけ）または「/」（スラッシュ）で設定します。

世代番号

パッケージ種別が「ユーザプログラム、データ」の場合、バージョン/リビジョンのほかに、世代番号を付けることができます。4けたまでの英数字（英字は大文字だけ）で設定してください。世代番号によって、同一のバージョン/リビジョンを区分できます。

(2)　パッケージ種別（必ず設定）

パッケージングするソフトウェアの種類を選択します。パッケージングするソフトウェアが「日立プログラムプロダクト」または「他社ソフトウェア」のときは、自動的にその項目が選択されます。それ以外の場合は、「ユーザプログラム、データ」として扱われます。

(3)　パッケージ保管先キャビネット

パッケージを保管するキャビネットを設定します。一度作成したキャビネットはパッケージャからは削除できません。

キャビネット名

キャビネット名をユニークに設定します。半角32文字（全角で16文字）までのキャビネット名が設定できます。「¥」、「/」、「*」、「"」、「:」、「;」、およびスペースは使用できません。

すでにあるキャビネット名をプルダウン形式の一覧から選択することもできます。

キャビネット識別ID（必ず設定）

キャビネットごとにユニークなIDを、2文字の半角英数字（英字は大文字だけ）で指定します。キャビネット名を新規に設定した場合は、必ず指定してください。既存のキャビネットを選択したときは、対応するキャビネット識別IDが表示されます。

JP1/IT Desktop Management 2は、このIDを基にキャビネットを識別します。UNIX版のJP1/IT Desktop Management 2 - Agentの用語では資源のグループ名に相当します。なお、Windows用のキャビネット識別IDとUNIX用のキャビネット識別ID（資源のグループ名）には、同じIDを指定できます。この場合、同じキャビネット識別IDでも、別のキャビネットとして扱われます。

7.2.3　［システム条件］パネル

リモートインストール時のインストール先ディレクトリ、およびインストールの前提となるコンピュータのハードウェアの条件を設定します。

図7‒8　［システム条件］パネル

(1)　インストール先ディレクトリ（必ず設定）

パッケージのリモートインストール先ディレクトリを指定します。

ドライブ

デフォルトのリモートインストール先のドライブが表示されます。任意のドライブを選択できますが、バックグラウンドインストールモードでは、ネットワークドライブを指定しないでください。

ドライブには、「A:」〜「Z:」、「1:」〜「9:」、または「なし」を指定できます。数字は、ドライブをABC順に並べたときのハードディスクドライブの順番です。例えば、あるPCのAドライブがDVD-Rドライブ、Cドライブがハードディスクドライブの場合、「1:」はCドライブを示します。また、別のPCのAドライブがハードディスクドライブの場合、「1:」は、Aドライブを示します。このとき、あて先のドライブに「1:」を指定すると、前者のPCにはCドライブを、後者にはAドライブを指定したことになります。「なし」は、UNCパス名でディレクトリを指定したい場合に指定します。

次の場合はドライブに「なし」以外を指定してください。

配布先がUNIXシステムの場合※

パッケージ種別が日立プログラムプロダクトまたは他社ソフトウェアの場合

注※　配布時には、指定したドライブは無視され、ディレクトリの指定に従って配布されます。

ディレクトリ

デフォルトのリモートインストール先のディレクトリが表示されます。任意のディレクトリのパスを、「¥」で始まる文字列で指定してください。配布先がWindowsシステムの場合は、ドライブ名を含めて半角で128文字まで指定できます。配布先がUNIXシステムの場合は、半角で64文字まで指定できます。

ディレクトリにUNCパス名を指定する場合は、ドライブに「なし」を指定します。例えば、サーバ「SRV010」で共有宣言されたディレクトリ「¥APP¥PROG」下にリモートインストールする場合は、ドライブを「なし」、ディレクトリを「¥¥SRV010¥APP¥PROG」と指定してください。

ディレクトリを指定するときは、次の点に注意してください。

インストール先のディレクトリのパスには、文字列「%HITACHI_REG¥xxx%」を含めることはできません（xxxは、任意の文字列）。この文字列は、各日立プログラムプロダクトの固有のパスを表すもので、JP1/IT Desktop Management 2の予約語です。一般ユーザは指定しないでください。

日立プログラムプロダクトをパッケージングする場合は、ディレクトリに「;」、「"」およびスペースは使用しないでください。

バックグラウンドインストールモードでは、アクセス権のないディレクトリに対するリモートインストールはできません（インストールが失敗します）。

存在しないディレクトリのパスを指定した場合、リモートインストール先のPCにディレクトリが作成されます。

メモ

UNIX版のパッケージャでパッケージングする場合、指定できるのはディレクトリだけです。

(2)　システム条件

リモートインストール時の、インストールの前提となるコンピュータのハードウェアの条件を設定します。

システム条件の作成

システム条件をGUI上で設定します。項目、比較値、値を選択して［追加］ボタンをクリックすると、選択に応じた条件式が枠内に表示され、ここで設定した条件に合うシステムにパッケージがリモートインストールされます。条件式は複数指定できます。条件を複数指定した場合は、すべての条件を満たす場合だけインストールされます。

項目

ハードディスクの空き容量、実メモリ容量、OSバージョンを選択できます。

比較値

選択した項目に合わせて、設定できる比較値が変化します。一覧から「=」、「>=」、「<>」などが比較値として選択できます。1つの式で使用できる比較値は1つだけです。

値

選択した項目に合わせて、設定できる値が変化します。一覧から選択したり、テキストボックスに値を設定したりできます。

「項目」にハードディスクの空き容量または実メモリ容量を指定した場合、「値」の上限値は32,767です。

「項目」にOSバージョンを指定した場合、「比較値」および「値」に設定したOSによって比較対象のOSが決定されます。OSごとの大小関係と、設定できるOSを次の表に示します。数値が小さいほどOSバージョンは古くなります。

OSごとの大小関係

設定できるOS

13

WindowsServer2019

12

WindowsServer2016

11

Windows10

10

WindowsServer2012R2

9

Windows8.1

8

WindowsServer2012

7

Windows8

6

WindowsServer2008R2

5

Windows7

4

WindowsServer2008

3

WindowsVista

2

WindowsServer2003

1

WindowsXP

例えば、「OSバージョン<WindowsServer2003」と指定した場合、Windows Server 2003の比較対象のうち、Windows Server 2003よりバージョンの古いWindows XPが、条件に一致したOSとなります。

7.2.4　［ソフトウェア条件］パネル

リモートインストールの前提となる、ソフトウェアまたは更新プログラムの条件を設定します。条件は100個まで設定できます。複数の条件を設定した場合の判定方法も選択できます。

条件に設定できる項目は次の2つです。

対象

判定の対象とするソフトウェアまたは更新プログラムを指定します。

条件

指定したソフトウェアまたは更新プログラムのインストール状況を指定します。

図7‒9　［ソフトウェア条件］パネル

(1)　対象

条件の対象とするソフトウェア名、または更新プログラムの文書番号を入力します。

ソフトウェア名は、完全一致した場合に判定の対象とされます。ソフトウェア名に入力できる文字数は2,048バイトまでです。

更新プログラムにはバージョンも指定できます。例えば、文書番号が「KB2536276」でバージョンが「v2」の更新プログラムを対象とする場合は、「KB2536276-v2」と入力してください。

(2)　条件

対象としたソフトウェアまたは更新プログラムの、インストールの有無およびバージョンの条件を指定します。

未インストール

対象としたソフトウェアまたは更新プログラムが、インストール先のコンピュータにないことを条件としてリモートインストールします。

インストール済

対象としたソフトウェアまたは更新プログラムが、インストール先のコンピュータにインストールされていることを条件としてリモートインストールします。［比較］および［バージョン］の組み合わせで、前提となるソフトウェアの条件を指定してください。

比較

指定するバージョンに合わせて、プルダウンメニューから演算子を選択します。

例えば、「<」を選択した場合は、指定したバージョンよりも古いバージョンのソフトウェアまたは更新プログラムがインストール先のコンピュータにあるときに、リモートインストールされます。

バージョン

比較したいバージョンを入力します。

対象にソフトウェア名を指定した場合のバージョンの比較方法について説明します。

対象にソフトウェア名を指定した場合、［バージョン］に入力された値を、メジャーバージョン、マイナーバージョン、リビジョンおよびビルドに分割して判定します。バージョンの区切りには「.」（ピリオド）、「,」（コンマ）および「-」（ハイフン）を使用できます。例えば、［バージョン］に「12.0.6.100」と入力すると、メジャーバージョンが「12」、マイナーバージョンが「0」、リビジョンが「6」、ビルドが「100」となります。［バージョン］に入力された値と対象のコンピュータにインストールされているソフトウェアのバージョンは、これらの区切りごとに比較されます。

また、バージョンは、「0」でけた数を補った文字列によって比較されます。例えば、次のような場合は条件に一致したと判定されます。

［比較］で指定した演算子：=

［バージョン］に入力した値：0100

対象のコンピュータにインストールされているソフトウェアのバージョン：100

メモ

指定したソフトウェアがJP1製品、かつ指定されたバージョンが日立PP形式の場合、ソフトウェアのバージョンは「0」でけた数を補わず、先頭からの文字比較となります。

指定できる文字の大小関係は、半角英字（A〜Z）>半角数字（0〜9）>「/」（スラッシュ）>「△」（半角スペース）となります。

JP1製品の条件を次に示します。

ソフトウェア名の先頭が「JP1/（JP1/TELstaffを除く）」「Performance Management - 」「Network Node Manager i」「Navigation Platform - 」「SNMP System Observer」「Extensible SNMP Agent」のどれかである。

日立PP形式のバージョンの条件を次に示します。

VVRRSS形式の、4〜6桁の文字列である。

VVRRは半角数字である。

SSは半角英数字である。（SSの先頭だけスラッシュを許可する）

例えば、「1200」「120003」「1100/A」「1050A」「1200SA」「1200A」などを指定した場合、日立PP形式となります。

(3)　複数条件の判定

複数の条件を設定した場合の判定方法を選択します。デフォルトは、「いずれかの条件を満たす」です。

いずれかの条件を満たす

設定した条件のうち1個以上の条件を満たすときにインストールされます。

すべての条件を満たす

すべての条件を満たすときだけインストールされます。

7.2.5　［パッケージ条件］パネル

リモートインストールの前提となる、パッケージの条件を設定します。条件は複数設定できます。複数の条件を設定した場合の判定方法も選択できます。

設定できる条件は次の2種類です。

指定したパッケージのバージョンおよび世代番号が、条件に合っている場合にインストールする。

指定したパッケージがインストールされていない場合にインストールする。

設定した条件はインストールの直前に判定されます。そのため、条件を満たしているかどうかに関係なく、パッケージは管理対象のコンピュータにダウンロードされます。

図7‒10　［パッケージ条件］パネル

(1)　パッケージ条件

リモートインストールの前提とするパッケージの条件式を作成します。条件を設定して［追加］ボタンをクリックすると、条件式がリストに表示され、有効になります。

(a)　パッケージ名/パッケージ識別ID

前提とするパッケージを、パッケージ名で特定するのか、パッケージ識別IDで特定するのかを選択します。デフォルトは「パッケージ名」です。

その後、テキストボックスでパッケージ名またはパッケージ識別IDを設定してください。一覧から選択することもできます。設定できるパッケージ名（パッケージ識別ID）は、JP1/IT Desktop Management 2でリモートインストールしたパッケージと「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブで取得したソフトウェアのパッケージの名称です。ワイルドカードなどは使用できません。

(b)　条件

パッケージのインストールの有無およびバージョンなどのチェック条件を設定します。

未インストール

指定したパッケージが、インストール先のコンピュータにないことを条件としてリモートインストールします。

インストール済

指定したパッケージが、インストール先のコンピュータにインストールされていることを条件としてリモートインストールします。［比較］、［バージョン］、および［世代番号］の組み合わせで、前提となるパッケージの条件を指定してください。

比較

次で設定する［バージョン］、［世代番号］に合わせて、プルダウンメニューから演算子を選択します。例えば、「<」を選択すると、次で設定するバージョンよりも古いバージョンのパッケージがインストール先のコンピュータにあるときに、リモートインストールされます。

バージョン

比較したいバージョンを選択または入力します。

世代番号

比較したい世代番号を選択または入力します。世代番号がない場合は、特に設定する必要はありません。

例えば、「PROGRAM<0200」という条件を指定した場合、0200より古いバージョンの「PROGRAM」がインストールされているコンピュータに対して、リモートインストールが実行されます。

なお、［パッケージ条件］パネルで指定する条件のバージョンおよび世代番号の比較は、先頭からの文字比較となります。指定できる文字の大小関係は、半角英字（A〜Z）>半角数字（0〜9）>「/」（スラッシュ）>「△」（半角スペース）となります。比較値に「<」「<=」「>」「>=」を選択してバージョンおよび世代番号を指定する場合、比較対象のパッケージのバージョンおよび世代番号と同じけた数で指定してください。例えば、パッケージ「PROGRAM」のバージョンが「0300」、世代番号「0000」がインストールされている環境に対しては、「PROGRAM>3 0」と指定しないで「PROGRAM>0300 0000」となるようにけた数をそろえて指定してください。

(2)　複数条件の判定

複数の条件を設定した場合の判定方法を選択します。デフォルトは、「いずれかの条件を満たす」です。

いずれかの条件を満たす

設定した条件のうち1個以上の条件を満たすときにインストールされます。

すべての条件を満たす

すべての条件を満たすときだけインストールされます。

7.2.6　［ファイル属性］パネル

リモートインストール後のファイルのアクセス権および所有者を、どのように決めるか選択します。デフォルトは「インストール先のアクセス権/所有者と同じ」です。このパネルは、パッケージ種別が「他社ソフトウェア」または「ユーザプログラム、データ」のときだけ表示されます。

図7‒11　［ファイル属性］パネル

インストール先のアクセス権/所有者と同じ

パッケージのリモートインストール先ディレクトリのアクセス権に合わせて、新しいファイルが作成されます。また、パッケージングするディレクトリが、リモートインストール先ディレクトリ下にすでに存在していた場合、そのディレクトリは既存ディレクトリのアクセス権と所有者を引き継ぎます。

リモートインストール先がUNIXエージェントの場合、この設定を有効にするには、UNIXエージェント上でファイル属性有効化ファイルを作成する必要があります。ファイル属性有効化ファイルの作成方法については、マニュアル「JP1/IT Desktop Management 2 - Agent(UNIX(R)用)」を参照してください。

なお、ファイル属性有効化ファイルを作成しないと、「JP1/ITDM2の標準値（アクセス権/所有者）と同じ」を選択したときと同様のファイル属性が設定されます。

JP1/ITDM2の標準値（アクセス権/所有者）と同じ

JP1/IT Desktop Management 2の標準のアクセス権と所有者が設定されます。設定される値は次のとおりです。

リモートインストール先がWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows 7、Windows Server 2012、Windows Server 2008、Windows Vista、Windows Server 2003、Windows XPの場合

フォルダおよびファイルのアクセス権

Administrators：フルコントロール

SYSTEM：フルコントロール

Everyone：読み取りと実行

フォルダおよびファイルの所有者：Administrators

リモートインストール先がUNIXの場合

ファイルモード：700（スーパーユーザの権限を持つユーザだけが読み書きできます）

所有者：root

グループ：sys

パッケージング元のアクセス権/所有者と同じ

パッケージング元のアクセス権と所有者が、インストール先に復元されます。

リモートインストール先がUNIXエージェントの場合、この設定は無効です。設定した場合、「JP1/ITDM2の標準値（アクセス権/所有者）と同じ」を選択したときと同様のファイル属性が設定されます。

重要

「パッケージング元のアクセス権/所有者と同じ」をインストール先に設定したい場合は、パッケージングするファイルおよびディレクトリの所有者が、Administratorsである必要があります。Windows Server 2019、Windows Server 2016、Windows Server 2012、Windows Server 2008、およびWindows Server 2003でも、ファイルおよびディレクトリの所有者がAdministratorsであることを確認してからパッケージングしてください。

7.2.7　［スケジュール］パネル

リモートインストールしたパッケージの、中継システム上での保管期限を指定します。また、管理対象のコンピュータでのインストールの日時およびタイミングを指定します。

なお、「クライアントユーザによるインストール」ジョブの場合は、管理対象のコンピュータでのインストールの日時およびタイミングを指定しても無視されます。

図7‒12　［スケジュール］パネル

(1)　中継でのパッケージ保管期限

中継システムおよび管理用中継サーバでパッケージを保管する期限を指定する場合は、「中継でのパッケージ保管期限」チェックボックスをオンにし、日付を指定します。年は西暦の下2けたを指定します（36〜99を指定した場合は1900年代として扱われます）。パッケージ保管期限の上限は2035年12月31日です。ここで指定した期限に達すると、中継システムおよび管理用中継サーバで保管中のパッケージは自動的に削除されます。保管期限を過ぎたパッケージや、当日期限のパッケージを配布すると、翌日削除されます。

チェックボックスをオフにした場合、パッケージの保管日数は、デフォルトの90日になります。デフォルトの保管日数は、［デフォルト値のカスタマイズ］ダイアログボックスで変更できます。詳細は、「7.2.14　パッケージング環境のカスタマイズ」を参照してください。

実際の運用では、その中継システムおよび管理用中継サーバ配下のすべてのコンピュータでインストールが完了するまで、パッケージを保管しておく必要があります。例えば、パッケージの配布とインストールに3週間必要であれば、3週間目以降の日を設定します。

(2)　インストール日時

管理対象のコンピュータでパッケージをインストールする日時を指定する場合は、「インストール日時」チェックボックスをオンにし、日時を指定します。年は西暦の下2けたを指定します。

ファイルのコピーだけでインストールが終了するバックグラウンドインストールモードの場合、リモートインストール先のPCが起動していれば自動的にインストールされます。

(3)　実行タイミング

管理対象のコンピュータでパッケージをインストールするタイミングを、プルダウン形式の一覧から選択します。

ソフトウェアのバージョンアップなど、すでに同一のソフトウェアがインストールされている場合、リモートインストール実行時にそのソフトウェアが稼働していると、インストールが失敗してしまいます。これを防止するために、インストールのタイミングはなるべく「次回起動時に実行」に設定することをお勧めします。利用者の業務への影響を少なくすることもできます。

なお、「次回起動時に実行」、またはインストール日時を指定しない「すぐに実行」を設定した場合、利用者がジョブを保留するおそれがあります。利用者にジョブを保留させたくない場合は、インストール日時を指定した「すぐに実行」を設定してください。ただし、インストール処理中は利用者の業務が一時的に停止することを考慮し、影響の少ない日付と時間を指定してください。

次回起動時に実行

コンピュータのシステム起動時に、パッケージがインストールされます。インストール日時を指定している場合は、指定した日時以降の最初のシステム起動時にパッケージがインストールされます。

なお、エージェント設定のポーリング関連項目の設定内容によって、配布・インストールのタイミングが異なります。ポーリングの設定と、配布・インストールのタイミングとの関係については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」のエージェント設定の説明を参照してください。

スタートアップで起動するソフトウェアをリモートインストールする場合、リモートインストールとソフトウェアの起動が同時に作動し、失敗することがあります。これを防止するには、管理対象のコンピュータで［スタートアップ］グループに登録されているソフトウェアのショートカットを、［ITDM2_Startup］フォルダに移動しておきます。エージェント設定で、［ITDM2_Startup］フォルダの作成とショートカットの自動移行ができます。［ITDM2_Startup］フォルダへのショートカットの移動については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」のエージェント設定の説明を参照してください。

すぐに実行

コンピュータのシステム稼働中に、パッケージがインストールされます。インストール日時を指定している場合は、指定した日時にパッケージがインストールされます。ただし、指定した日時にコンピュータが起動していないときは、次回のシステム起動時にインストールされます。

停止時に実行

コンピュータの停止時に、パッケージがインストールされます。インストール日時を指定している場合は、指定した日時以降の最初のシステム終了時にパッケージがインストールされます。

なお、この項目は、UNIXエージェントにパッケージをインストールする場合に、リモートインストールマネージャの［インストール条件の変更］ダイアログボックスで設定できます。Windowsエージェントへのパッケージに設定した場合は、ジョブの実行結果がエラーになります。

7.2.8　［インストール方法］パネル

ソフトウェアのインストーラの種類に合致したインストール方法を指定します。また、日立プログラムプロダクトをインストールする場合に、新規にインストールするのか、バージョンアップするのかを選択します。

図7‒13　［インストール方法］パネル

(1)　インストールモード

インストールモードとして、「GUIインストールモード」または「バックグラウンドインストールモード」を選択します。

パッケージ種別が「日立プログラムプロダクト」または「他社ソフトウェア」の場合は、常にGUIインストールモードとなります。

GUIインストールモード

特別なインストーラ（対話形式のインストーラなど）を使用するインストールモードです。インストーラがGUIを持たなくても、グラフィックデバイスインターフェースAPIを使っている場合は、このモードを使用します。

また、GUIインストールモードで画面応答が必要なソフトウェアをリモートインストールする場合は、インストール先のPCのパスワードロックを解除しておいてください。インストール先のPCがパスワードでロックされている（［Ctrl］+［Alt］+［Delete］キー入力要求ダイアログボックスが表示されている）と、画面応答ができないためインストールできません。なお、リモートインストールに対応した日立プログラムプロダクトをリモートインストールする場合は、画面応答が不要なため、ロックされていてもインストールできます。

バックグラウンドインストールモード

特別なインストーラを使用しないインストールモードです。ファイルのコピーだけでインストールが完了する場合に適用します。JP1/IT Desktop Management 2 - Agentをインストールしたユーザがログオンしていなくても、Windowsが起動していればリモートインストールされます。

(2)　日立PPのインストール

パッケージ種別が「日立プログラムプロダクト」の場合に、新規にインストールするのか、それともバージョンアップするのかを選択します。「更新インストール」を選択すると、インストール先のドライブとディレクトリは変更できません。

新規インストール

プログラムプロダクトを新規インストールする場合に、選択してください。

更新インストール

すでにインストールされているプログラムプロダクトをバージョンアップする場合に選択してください。

7.2.9　［オプション］パネル

リモートインストール時のオプションを指定するパネルです。

図7‒14　［オプション］パネル

パッケージデータを圧縮する

ソフトウェアを圧縮してパッケージングするかどうかを指定します。圧縮されたパッケージは、リモートインストール時に自動的に伸長されます。デフォルトはオフです。

パッケージを圧縮するとファイル転送は速くなり、キャビネット上でパッケージを保管するための容量を節約できます。ただし、パッケージング時やリモートインストール時に、圧縮・伸長処理の時間が掛かります。

圧縮する場合は、圧縮方法として次のどちらかを選択できます。デフォルトは「Windows専用」です。

Windows専用

UNIX共用よりパッケージ容量を削減して圧縮できます。ただし、UNIXエージェントには配布できない圧縮方法です。

UNIX共用

Windows専用よりパッケージ容量の圧縮効率は下がりますが、UNIXエージェントにも配布できる圧縮方法です。

圧縮率は、パッケージデータによって異なりますが、次の表を目安にしてください。圧縮前のデータを100%とした場合の、圧縮後のデータの割合です。

圧縮方法

100メガバイトのテキストデータ

145メガバイトのプログラムデータ

Windows専用

約1%

約47%

UNIX共用

約45%

約71%

バージョンアップ時リストア対象とする

この項目は、パッケージ種別が「ユーザプログラム、データ」のときだけ設定できます。バージョンアップ時リストア対象にすると、ソフトウェアのバージョンアップ時に、リモートインストール先にある前バージョンのバックアップが取得されます。そして、リモートインストールが失敗したときには、バックアップを基に前バージョンのソフトウェアが復元されます。デフォルトはオフです。

外部プログラムを指定している場合、バックアップは、インストール直前の起動を指定した外部プログラム起動後に取得されます。また、リストアは、インストールエラー時の起動を指定した外部プログラム起動後に実行されます。

UNIX版のパッケージャ（資源登録システム）からパッケージング（資源登録）したソフトウェアには、「バックアップの保存期間」が設定されています。リモートインストールに失敗し、さらにリストアに失敗しても、旧バージョンのバックアップが一定期間保存されているので、管理対象のコンピュータからの操作でリストアを再試行できます。バックアップファイルの確認、およびリストアの再試行の方法については、「12.5　バックアップファイルを管理する」を参照してください。

なお、この項目は、［インストール条件の変更］ダイアログボックスの「インストール時障害が発生した場合、バックアップからリストアを行う」に相当します。

インストール後コンピュータを再起動する

パッケージのインストール後に、管理対象のコンピュータを自動的に再起動させるかどうかを指定します。デフォルトはオフです。この項目をオンにすると、インストール後に管理対象のコンピュータで再起動の確認ダイアログボックスが表示され、指定された時間を過ぎると再起動が開始されます。確認ダイアログボックスの表示時間は、エージェント設定の［利用者への通知設定］で設定されています。

確認ダイアログボックスの表示時間に「シャットダウンまたは再起動を指示するダイアログでの、利用者の応答に従う」が指定されている場合は、ユーザの入力があるまで再起動は開始されません。

自動的に再起動できるのは、管理対象のコンピュータ（UNIXエージェントは除く）だけです。中継システムおよび管理用中継サーバでは、再起動を指定したパッケージをインストールしても自動的に再起動されません。

コンピュータを自動的に再起動させる場合の注意事項を次に示します。

JP1/IT Desktop Management 2 - Agentをリモートインストールする場合は、「インストール後コンピュータを再起動する」を設定しないでください。リモートインストールが正常に完了しないことがあります。

複数のパッケージにコンピュータの再起動を設定して1つのジョブでインストールした場合、すべてのパッケージのインストール後にコンピュータが自動的に再起動されます。

再起動を指定したパッケージを配布するジョブにクライアント制御によるコンピュータのシャットダウンが指定されていた場合、ジョブの終了後にシャットダウンします。

再起動を指定したパッケージを配布するジョブやクライアント制御によるシャットダウンを指定したジョブを含む複数のジョブが、管理対象のコンピュータ上で続けて実行された場合、すべてのジョブの終了後にシャットダウンします。

再起動を指定したパッケージがエージェントのパッケージセットアップマネージャからインストールされた場合、エージェント設定に確認ダイアログボックスの表示時間が設定されていても、「シャットダウンまたは再起動を指示するダイアログでの、利用者の応答に従う」の場合と同様に、ユーザの入力があるまで再起動しません。

Windowsのコンピュータでスクリーンセーバが起動され、パスワードで保護されている場合は、自動的に再起動できません。

再起動を指定したパッケージのインストール時に編集中のファイルが存在した場合は、自動的に再起動できません。

また、再起動を指定したパッケージを上位システムからリモートインストールした場合で、次に示すログオン状態のときは指定どおりの動作をしません。

ログオン前のとき

これらの状態では、エージェント設定で「指定する時間内に利用者の応答がない場合に、自動的に開始する」を選択していると、確認ダイアログボックスを表示しないで再起動します。「シャットダウンまたは再起動を指示するダイアログでの、利用者の応答に従う」を選択していると、再起動できません。

なお、ここでいう「パッケージを上位システムからリモートインストール」とは、エージェント側からパッケージセットアップマネージャを使用してパッケージをインストールする場合以外を示します。

処理中ダイアログの表示

パッケージのインストール時に、管理対象のコンピュータで処理中ダイアログを表示させるかどうかを指定します。対象となるのは、ダウンロード中ダイアログとインストール中ダイアログです。次に示す項目から選択できます。

エージェントの設定に従う

エージェント設定の［ジョブの設定］−［ジョブの処理中ダイアログの表示設定］に設定された内容に従って、ダウンロード中ダイアログとインストール中ダイアログの動作を決定します。処理中ダイアログとしてプログラム標準のダイアログを表示するか、またはユーザ作成プログラムを表示するかについても、［ジョブの処理中ダイアログの表示設定］に従います。

表示する

エージェント設定の［ジョブの設定］−［ジョブの処理中ダイアログの表示設定］の設定内容に関係なく、ダウンロード中ダイアログとインストール中ダイアログを表示します。

処理中ダイアログとしてプログラム標準のダイアログを表示するか、またはユーザ作成プログラムを表示するかは、［ジョブの処理中ダイアログの表示設定］に従います。

表示しない

エージェント設定の［ジョブの設定］−［ジョブの処理中ダイアログの表示設定］の設定内容に関係なく、ダウンロード中ダイアログとインストール中ダイアログを非表示にします。

パッケージの「処理中ダイアログの表示」と、［ジョブの処理中ダイアログの表示設定］をそれぞれ設定したときの、処理中ダイアログ表示の有無を次に示します。

［ジョブの処理中ダイアログの表示設定］

パッケージの設定

エージェントの設定に従う

表示する

表示しない

表示する

○

○

−

表示しない

−

○

−

（凡例）

○：対象ダイアログを表示する

−：対象ダイアログを表示しない

なお、パッケージに処理中ダイアログの表示を指定した場合、インストール中ダイアログを最前面表示するかどうかは［ジョブの処理中ダイアログの表示設定］に従います。

インストール前に表示するパッケージの説明

パッケージに添付する説明文を次の方法で入力します。

「説明」欄に直接入力する。

説明文は、半角30,000文字（全角15,000文字）以内で入力します。

［読み込み］ボタンをクリックしてテキストファイルを読み込む。

テキストファイルのサイズの上限は30,000バイトです。

この説明文は、パッケージを「クライアントユーザによるインストール」ジョブで配布する場合に有効です。管理対象のコンピュータから、パッケージセットアップマネージャを使用してインストールするパッケージを選択するときに、この説明文を閲覧できます。パッケージの内容やインストール方法など、インストール前に利用者に知っておいて欲しい情報がある場合に記述してください。

なお、この項目は、［インストール条件の変更］ダイアログボックスの「パッケージの説明」に相当します。

7.2.10　［外部プログラム］パネル

インストール前後およびインストールエラー時に、管理対象のコンピュータで起動させる外部プログラムを設定します。

図7‒15　［外部プログラム］パネル

(1)　外部プログラム起動

インストール直前、直後、およびインストールエラーのそれぞれの場合に、起動させたい外部プログラムのパス名を指定します。「インストール直前」、「インストール直後」、または「インストールエラー」の右側の［参照］ボタンをクリックして、表示されるダイアログから、選択したプログラムのフルパスを参考にして指定できます。

なお、JP1/IT Desktop Management 2 - Agentをリモートインストールする場合は、インストール直前だけ外部プログラムを起動できます。インストール直後、またはインストールエラー時に外部プログラムの起動を設定しても無視されます。

指定された外部プログラムは、処理が正常に終了したかどうかをサーバに通知する必要があります。終了通知の方法については、「7.2.10(2)　外部プログラムの終了通知」を参照してください。また、外部プログラムから取得した終了通知の扱いは、［詳細］ボタンをクリックして表示される［外部プログラム用詳細設定］ダイアログボックスで指定します。詳細は、「7.2.10(3)　外部プログラムの終了通知の扱い」を参照してください。

外部プログラムを設定するときの注意事項を次に示します。

外部プログラムとして指定できるのは、拡張子が*.exe、*.bat、*.cmdのファイルだけです。

外部プログラムのパスは、半角256文字以内で指定してください。

外部プログラムのパスにスペースを含める場合は「"」で囲んで指定してください。

外部プログラムのパスには、文字列「%HITACHI_REG¥xxx%」を含めることはできません（xxxは、任意の文字列）。この文字列は、各日立プログラムプロダクトの固有のパスを表すもので、JP1/IT Desktop Management 2の予約語です。

バックグラウンドインストールモード（Windows）でリモートインストールする場合は、GUIを持たないプログラムを指定してください。GUIを持つプログラムを指定しても、GUIは表示されません。

ただし、Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008またはWindows VistaでGUIを持つプログラムを実行した場合は、実行したプログラムに対して、GUIの表示を要求するダイアログボックスが表示されたままになることがあります。GUIが表示されたままになることを避けるためには、次の設定をしてください。

［外部プログラム］パネルの「外部プログラム監視時間」を1以上に設定してください。

［外部プログラム］パネルの［詳細］ボタンをクリックすると表示される［外部プログラム用詳細設定］ダイアログボックスで「外部プログラムの時間監視」にチェックしてください。

［外部プログラム］パネルの［詳細］ボタンをクリックすると表示される［外部プログラム用詳細設定］ダイアログボックスの「処理結果エラー時の取り扱い」設定で「エラーとして処理を中断する」を選択してください。

外部プログラムには16bitのアプリケーションを指定しないでください。Windowsのコンピュータに対して、外部プログラムに16bitアプリケーションを指定したバックグラウンドインストールモードのパッケージをリモートインストールすると、コンピュータがハングアップします。

「パッケージのインストール」ジョブと「リモートコレクト」ジョブの実行で、「外部プログラム起動」に、コンソールプログラムやBATファイルを指定した場合、Windowsの「対話型サービスの検出」ダイアログがタスクバー上に表示される現象が発生します。

UNIXへ配布するパッケージに外部プログラムの起動を設定する場合は、「7.2.10(5)　UNIXエージェントで外部プログラムを起動する場合の注意事項」を参照してください。

外部プログラム監視時間

「外部プログラム起動」で指定した外部プログラムの応答を監視する時間の、上限値と単位を指定します。外部プログラムが無限ループに陥ったときなどに備えて、外部プログラムの終了を待つ時間を、0〜21,600秒（360分、6時間）で指定してください。応答を監視しない場合は「0」を指定します。デフォルトは「1（秒）」です。なお、この指定は、［外部プログラム用詳細設定］ダイアログボックスで「外部プログラムの時間監視」チェックボックスをオンにしている場合に有効になります。［外部プログラム用詳細設定］ダイアログボックスについては、「7.2.10(3)　外部プログラムの終了通知の扱い」を参照してください。

この指定値は、「インストール直前」、「インストール直後」、「インストールエラー」で起動するすべての外部プログラムに対して有効です。外部プログラムごとに異なる監視時間を設定することはできません。

(2)　外部プログラムの終了通知

ユーザプログラムをリモートインストールする場合、インストールの前後、およびインストールエラー時に、外部プログラムを起動させることができます。

外部プログラムは、終了コードまたはWindows Messageで、処理が正常に終了したかどうかをサーバに通知する必要があります。終了コードで通知する場合、およびWindows Messageで通知する場合の値の設定方法を次に示します。

なお、インストール直後に外部プログラムを起動した場合、外部プログラムの実行が終了した時点で配布終了として通知されます。

終了コードを指定した場合

スクリプトに通知されるプログラムの終了コードについては、正常終了の場合は0を、正常に終了しなかった場合は1〜255のどれかの値を設定してください。スクリプトから起動されたプログラムが終了すると、shell関数は制御を戻します。

Windows Messageを指定した場合

Windows Messageによって処理を通知する場合はWindows APIのRegisterWindowMessage()関数で文字列「ITM_UAP_QUIT」を定義し、返されたメッセージ識別子を使ってすべてのトップレベルウィンドウに自プログラムの処理結果を通知してください。Windows APIのPostMessage()関数の第3引数が処理結果コードになります。

文字列「ITM_UAP_QUIT」を定義する方法を次に示します。この例では、変数DMRtnが処理コードとなります。

（例）

UINT MsgId;
WORD DMRtn;

MsgId = RegisterWindowMessage("ITM_UAP_QUIT");
DMRtn = 0;    /* 終了コードの設定：正常 */
(VOID)PostMessage(HWND_BROADCAST,
MsgId,
DMRtn,
NULL);

(3)　外部プログラムの終了通知の扱い

外部プログラムの終了通知の扱いについては、［詳細］ボタンをクリックすると表示される［外部プログラム用詳細設定］ダイアログボックスで設定します。「インストール直前」、「インストール直後」の［詳細］ボタンをクリックした場合と、「インストールエラー」の［詳細］ボタンをクリックした場合とでは、表示される内容が異なります。「インストールエラー」の［詳細］ボタンから表示した場合は、「監視時間経過時の取り扱い」および「処理結果エラー時の取り扱い」は表示されません。それぞれの場合に表示される［外部プログラム用詳細設定］ダイアログボックスを次に示します。

図7‒16　「インストール直前」、「インストール直後」の［詳細］ボタンから表示した［外部プログラム用詳細設定］ダイアログボックス

図7‒17　「インストールエラー」の［詳細］ボタンから表示した［外部プログラム用詳細設定］ダイアログボックス

外部プログラムの時間監視

［JP1/ITDM2 パッケージング］ダイアログボックスの［外部プログラム］パネルで指定した「外部プログラム監視時間」の設定を有効にするかどうかを指定します。デフォルトはオフです。

チェックボックスをオンにすると、「外部プログラム監視時間」で指定した時間だけ外部プログラムを監視します。

チェックボックスをオフにすると、無限に外部プログラムを監視します。「外部プログラム監視時間」の上限値以上の監視が必要なときだけオフにしてください。起動した外部プログラムが、データベースの更新など時間の掛かる処理をする場合に有効です。

注意

外部プログラムの監視をしないと、外部プログラムが無限ループに陥った時などにジョブのハングアップが発生し、配布結果が得られないことがあります。ジョブのハングアップ防止のため、外部プログラムの時間監視を有効にすることをお勧めします。

監視時間経過時の取り扱い

外部プログラム監視時間を経過した場合、リモートインストールジョブを中断し、エラーとするかどうかを指定します。デフォルトでは「エラーにする」がオンになっています。通常はデフォルトのまま運用してください。

エラーにする

監視時間を経過した場合、リモートインストールジョブを「エラー」として配布管理システムまたは中継システムに通知します。また、外部プログラムも終了させます。

エラーにしない

監視時間を経過した場合も、リモートインストールジョブを「成功」として配布管理システムまたは中継システムに通知します。外部プログラムを起動後、常駐させて使いたいなどの場合にだけ、こちらを選択してください。また、この場合は、「外部プログラム監視時間」を短く設定してください。

外部プログラム処理結果の取得方法

外部プログラムは、処理が正常に終了したかどうかをサーバに通知する必要があります。ここでは、外部プログラムの処理結果を取得する方法を選択します。次のパッケージの場合は、デフォルトで「外部プログラムのWindows Messageで通知」が選択されます。

パッケージャでパッケージングしたパッケージ

インストールモードが「GUIインストールモード」のパッケージ

外部プログラムのパスをジョブ作成時に指定したパッケージ

それ以外のパッケージの場合は、デフォルトで「外部プログラムの終了コードで通知」が選択されます。

設定を間違えるとエージェントがハングアップするおそれがあるため、ジョブ作成時に、デフォルトの設定のままで問題ないかどうかを必ず確認してください。

外部プログラムのWindows Messageで通知

管理対象のコンピュータから起動する外部プログラムから、さらに別のプログラムを起動したとき、そのプログラムの処理結果を取得できます。インストールモードが「GUIインストールモード」のときだけ選択できます。バックグラウンドインストールモード（Windows）で「外部プログラムのWindows Messageで通知」を選択した場合は、管理対象のコンピュータで自動的に「外部プログラムの終了コードで通知」に変更されます。

外部プログラムの終了コードで通知

一般的な終了コードを返却するプログラムに指定してください。

処理結果エラー時の取り扱い

取得した外部プログラムのリターン情報（終了コード、または処理結果コード）が0以外の値の場合、エラーにするかどうかを指定します。デフォルトでは、「エラーとして処理を中断する」がオンになっています。

エラーとして処理を中断する

外部プログラムからのリターン情報が0以外の場合、エラーにします。EXEファイルなど、リターン情報を正確に取得できるプログラムに指定してください。取得されたリターン情報は、保守コード中のユーザステータスに設定されます。保守コードは、リモートインストールマネージャの［ジョブ実行状況］ウィンドウから表示される［詳細情報］ダイアログボックスで確認できます。

エラーとせずに処理を続行する

外部プログラムからのリターン情報が0以外の場合でも、そのまま処理を続行します。

(4)　外部プログラムの実行権限

リモートインストール時に管理対象のコンピュータで外部プログラムを起動させる場合、管理対象のコンピュータのOSによって外部プログラムの実行権限が異なります。外部プログラムはシステム権限またはログオンユーザの権限で動作します。管理対象のコンピュータのOSごとの外部プログラムの実行権限を次の表に示します。

管理対象のコンピュータのOS

外部プログラムの実行権限

Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2

システム権限

(5)　UNIXエージェントで外部プログラムを起動する場合の注意事項

UNIXエージェントへ配布するパッケージに外部プログラムの起動を設定する場合、次のことに注意してください。

「<」「>」「|」「&」「$」などのシェルプログラムで特別な意味を持つ文字は使わないでください。

インストールエラー時の外部プログラム起動はできません。

インストール直前およびインストール直後の外部プログラム起動は、［スケジュール］パネルのインストール日時指定の有無によってパスの指定方法が違います。パスの指定方法が間違っていた場合、パッケージングとジョブの実行はできますが、配布先のUNIXで外部プログラムは起動しません。このとき、ジョブはエラーにならないで、正常終了するので注意してください。

指定方法の違いを次の表に示します。

インストール日時の指定

起動する外部プログラムのパス指定方法

インストール直前に起動

インストール直後に起動

あり

指定できません。

半角40文字以内で指定してください。

スペースを含んだパスは指定できません。

後処理プログラムに引数が存在する場合は、パスと引数全体を「"」（ダブルクォーテーション）で囲んでください。

引数がスペースを含む場合は、スペースを含む引数を「'」（シングルクォーテーション）で囲んでください。

なし

インストール直前に起動する外部プログラムだけ指定する場合、半角60文字以内で指定してください。

インストール直後に起動する外部プログラムだけ指定する場合、半角64文字以内で指定してください。

インストール直前と直後に起動する外部プログラムを両方指定する場合、合わせて半角60文字以内で指定してください。

文字列（引数）の数は最大18個指定できます。

複数の連続したスペースは1個の区切り文字として扱われます。

「'」（シングルクォーテーション）は引数として扱われません。

シェル変数は文字列として扱われるため、無効になります。

応答待ちになる処理を指定しないでください。

7.2.11　［AITファイルの設定］パネル

リモートインストール時にAITファイルを使用する場合に設定します。このパネルは、パッケージ種別が「他社ソフトウェア」で、かつAITファイルを使用するときだけ表示されます。

図7‒18　［AITファイルの設定］パネル

AITファイルの監視

AITファイルを使用したインストール処理の応答を監視するかどうか指定します。

インストール中に利用者がダイアログボックスに応答したり、キーボードやマウスを操作したりすると、インストーラの画面表示がAITファイルの期待するものと異なり、AITファイルによるリモートインストールが進まなくなることがあります。このような場合、インストールしている途中に放置されるのを防ぐため、一定時間内に応答がなければ、インストールを中断させることができます。

AITファイルの監視時間

「AITファイルの監視」を設定した場合に、AITファイルの応答を監視する時間の上限値を指定します。1秒〜21,600秒（360分、6時間）で指定してください。通常は、配布するソフトウェアをインストールするのに要した時間の約3倍の時間を目安に設定してください。デフォルトは5分です。

会社名

会社名は任意に設定します。ソフトウェアを所有するユーザの会社名を半角で80文字（全角で40文字）以内で設定します。

所有者名

所有者名は任意に設定します。ソフトウェアを所有するユーザのユーザ名を半角で40文字（全角で20文字）以内で設定します。

シリアルナンバー

ソフトウェアのシリアルナンバーを設定します。インストール時にCDキーの必要な他社ソフトウェアをパッケージングする場合は、この欄にCDキーを入力してください。

アイコングループ

利用者のコンピュータの、Windowsの［スタート］メニューに登録するフォルダ名を設定します。

7.2.12　［コンポーネントの選択］パネル

JP1/IT Desktop Management 2 - Agentをパッケージングする場合に表示されるパネルです。各プログラムのコンポーネントのうち、インストールが不要なコンポーネントのチェックボックスのチェックを外すとパッケージング対象になりません。これによって、不要なコンポーネント分のパッケージ容量を削減できます。

図7‒19　［コンポーネントの選択］パネル

JP1/IT Desktop Management 2 - Agentでリモートインストールできるコンポーネントは次のとおりです。

エージェント

中継システム

パッケージャ

リモコンエージェント

Automatic Installation Tool

なお、コンポーネントを選択して作成したパッケージをリモートインストールする場合、すでにインストールされているコンポーネントは、パッケージングされたコンポーネントにかかわらず、上書きインストールされます。

7.2.13　他社ソフトウェアのパッケージングのバリエーション

他社ソフトウェアをパッケージングするには、次の方法があります。

AITファイルおよびPP識別情報ファイルを使用する方法

AITファイルを省略する方法

前に説明した［JP1/ITDM2 パッケージング］ダイアログボックスの設定方法では1を前提に説明しているため、ここでは2の方法について説明します。

(1)　AITファイルを省略する方法

通常、JP1/IT Desktop Management 2では、インストーラの付属しているソフトウェアを配布する場合、インストーラの動作手順を定義したAITファイルを組み込んだパッケージを配布することで、利用者の手を煩わせることなく管理対象のコンピュータに自動的にリモートインストールしています。

これに対し、自動的にリモートインストールするのではなく、利用者自身がコンピュータに手動でパッケージをインストールする運用をしたい場合もあります。この運用方法では、AITファイルが不要となります。操作方法について、次に説明します。

(a)　AITファイルを省略する他社ソフトウェアのパッケージング方法

AITファイルを使用しないで、他社ソフトウェアをパッケージングする方法について次に示します。

インストール定義ファイルを用意する場合は、インストール定義ファイルを作成する。

パッケージャを起動して他社ソフトウェアをパッケージングして登録する。

マネージャ側でリモートインストールマネージャを起動し、手順2で登録したパッケージを「クライアントユーザによるインストール」ジョブとして、インストールを実行したいコンピュータに対してジョブを実行する。

管理対象のコンピュータ側でパッケージセットアップマネージャを起動し、［Package Setup Manager］ウィンドウから対象のパッケージを選択してインストールを実行する。

ソフトウェアの「インストール方法」は「手動」だけが活性化されるので、利用者自身でインストーラを操作してインストールします。

(b)　注意事項

AITファイルを省略したパッケージを配布するときは、必ず「クライアントユーザによるインストール」ジョブを実行して、パッケージセットアップマネージャからインストールしてください。「パッケージのインストール」を指定したジョブは最終的にエラーとなります。

(2)　インストール定義ファイルの作成

インストール定義ファイルには、セットアップ方法の種類やFDを入れる順番などを記述します。

パッケージャのPCで、次のディレクトリにインストール定義ファイル（INSTABL.DEF）を作成してください。

パッケージャのインストール先ディレクトリ¥DMPRM¥INSTABL.DEF

(a)　ファイルの形式

インストール定義ファイルの形式は、次のとおりです。

等号（=）の前後には，1文字以上の半角スペース、またはTABコードを入力してください。

[Package]
PackageID = パッケージ識別ID
Maker = メーカ名
Version = バージョン
Product = パッケージ名
InstallerName = インストールプログラム名
InstallKind = 番号.セットアップ方法
InstallDrive = インストールドライブ
InstallDirectory = インストール先ディレクトリ
JUser = 所有者のユーザ名（日本語の場合）
EUser = 所有者のユーザ名（英語の場合）
JCompany = 所有者の会社名（日本語の場合）
ECompany = 所有者の会社名（英語の場合）
SetFdNumber = FDをセットする順番
RecordFileDirectory = レコーダファイルのディレクトリ
RecordFileVersion = Visual Testのバージョン
[Package]
：
：

インストール定義ファイル内で、各ソフトウェアの定義は[Package]の記述で始めます。ソフトウェアが複数ある場合は、その数だけ[Package]の記述をしてください。[Package]に続く各項目は、「属性名 = 属性値」の形で定義します。これらの項目をすべて定義する必要はありませんが、必ず定義しなければいけない項目もあるのでご注意ください。各属性名の詳細を、次に示します。

PackageID = パッケージ識別ID（必ず定義）

パッケージ識別IDを指定します。使える文字は、半角の「A〜Z、-、0〜9」です。

指定できる長さは、半角で1〜44文字です。

Maker = メーカ名

ソフトウェアのメーカ名を指定します。使える文字に制限はありません。

指定できる長さは、半角で1〜30文字です。

Version = バージョン（必ず定義）

ソフトウェアのバージョンを指定します。使える文字は、半角の「A〜Z、0〜9、/」です。

指定できる長さは、半角で1〜6文字です。なお、世代番号は、「0000」固定になります。

Product = パッケージ名（必ず定義）

パッケージ名を指定します。「¥」は指定できません。

指定できる長さは、半角で1〜50文字です。

InstallerName = インストールプログラム名（必ず定義）

ソフトウェアをインストールするときの、インストールプログラム（インストーラ）名を指定します。使える文字に制限はありません。指定できる長さは、半角で1〜256文字です。

媒体がCD-ROMの場合はインストールプログラム名の先頭に、#を付加してください。

（例）

媒体がFDの場合

InstallerName = INSTALL.EXE

媒体がCD-ROMの場合

InstallerName = #INSTALL.EXE

InstallKind = 番号.セットアップ方法

選択できるセットアップ方法（インストール方法）と、それに対応する番号を次のように指定します。指定できる長さは、半角で最大256文字です。

1.セットアップ方法1, [2.セットアップ方法2, 〜 , n.セットアップ方法n]

nには、1から順に数字を記述してください。

（例）

InstallKind = 1.フルインストール,2.最小インストール

InstallDrive = インストールドライブ（必ず定義）

ソフトウェアをインストールするドライブ名を指定します。

使える文字は、半角の「A〜Z、a〜z、1〜9」です。

""1""は、ハードディスクの最初のドライブになります。

指定できる長さは、半角で1文字です。

InstallDirectory = インストール先ディレクトリ（必ず定義）

ソフトウェアをインストールするディレクトリを¥で始まるパス名で指定します。

使える文字に制限はありません。指定できる長さは、半角で1〜256文字です。

JUser = 所有者のユーザ名（日本語の場合）

ソフトウェアを所有するユーザの名前を日本語で指定します。

使える文字に制限はありません。指定できる長さは、半角で1〜40文字です。

EUserを指定した場合は、指定できません。

EUser = 所有者のユーザ名（英語の場合）

ソフトウェアを所有するユーザの名前を英語で指定します。

使える文字は、英数字です。指定できる長さは、半角で1〜40文字です。

JUserを指定した場合は、指定できません。

JCompany = 所有者の会社名（日本語の場合）

ソフトウェアを所有する会社の名前を日本語で指定します。

使える文字に制限はありません。指定できる長さは、半角で1〜80文字です。

ECompanyを指定した場合は、指定できません。

ECompany = 所有者の会社名（英語の場合）

ソフトウェアを所有する会社の名前を英語で指定します。

使える文字は、英数字です。指定できる長さは、半角で1〜40文字です。

JCompanyを指定した場合は、指定できません。

SetFdNumber = FDをセットする順番（必ず定義）

FDをセットする順番を次のように指定します。

SetFdNumber = 番号 [,番号, ...]

指定できる長さは、半角で最大256文字です。

媒体がCD-ROMの場合は、SetFdNumber = 0と指定してください。

（例）

1、2、5枚目のFDをセットする場合は、次のようにします。

SetFdNumber = 1,2,5

（例）

InstallKindを設定した場合は、次のようにSetFdNumberのあとにセットアップ方法の番号を「_番号」の形式で付けてください。

SetFdNumber_1 = 1,2,3,4,5

SetFdNumber_2 = 1,2,5

RecordFileDirectory = レコーダファイルのディレクトリ

レコーダファイルのあるディレクトリをドライブ名も含めて指定します。

使える文字に制限はありません。指定できる長さは、半角で1〜256文字です。

この属性名自体の指定を省略した場合、ジョブ実行時に必ず「クライアントユーザによるインストール」ジョブを指定し、クライアント側でパッケージセットアップマネージャからインストールしてください。「パッケージのインストール」を指定したジョブは最終的にエラーとなります。

RecordFileVersion = Visual Testのバージョン（必ず定義）

レコーダファイルの作成に使用したVisual Testのバージョンを、半角数字1けたで次のように設定してください。

Visual Test 6.0の場合

RecordFileVersion = 6

Visual Test 4.0の場合

RecordFileVersion = 4

(b)　インストール定義ファイルの例

インストール定義ファイルの例を次に示します。

[Package]
PackageID = ACROBATREADER405
Version = 0405
Product = Acrobat Reader 4.0
InstallerName = #Ar405jpn.exe
SetFdNumber = 0
RecordFileDirectory = c:¥recod¥ar40
RecordFileVersion = 6

7.2.14　パッケージング環境のカスタマイズ

次のパッケージング時の環境を、ユーザの運用に合わせて設定できます。

処理中ダイアログボックスの表示／非表示

［JP1/ITDM2 パッケージング］ダイアログボックスで設定する各項目のデフォルト値

ワークディレクトリ

監査ログの出力

パッケージャがJP1/IT Desktop Management 2 - Managerと異なるコンピュータにインストールされている場合だけ設定できます。

これらのパッケージング環境は、［JP1/ITDM2 パッケージャ］ウィンドウの［オプション］メニューから［デフォルト値のカスタマイズ］を選択し、表示される［デフォルト値のカスタマイズ］ダイアログボックスで設定します。

パッケージング環境をカスタマイズするには、レジストリ「HKEY_LOCAL_MACHINE」に対するアクセス権が必要です。

(1)　［処理中ダイアログ］パネル

パッケージング処理の実行中に、処理中であることを示すダイアログボックスを表示するかどうかを設定できます。上位システムと接続中であることを示すダイアログボックスと、パッケージング中であることを示すダイアログボックスについて、それぞれ設定できます。デフォルトでは、どちらの処理中ダイアログボックスも表示されます。

図7‒20　［処理中ダイアログ］パネル

(2)　［パッケージ属性］パネル

［JP1/ITDM2 パッケージング］ダイアログボックスで設定する各項目のデフォルト値を設定できます。

［パッケージ属性］パネルの「設定項目」には、［JP1/ITDM2 パッケージング］ダイアログボックスのパネル名に相当する項目が表示されます。「設定項目」から項目を選択したあと、パネルの右側で［JP1/ITDM2 パッケージング］ダイアログボックスのデフォルト値を設定します。

(a)　パッケージング情報

［JP1/ITDM2 パッケージング］ダイアログボックスの「パッケージ名」、「パッケージ識別ID」、「バージョン／リビジョン」、および「世代番号」のデフォルト値を設定できます。この設定は、パッケージ種別が「ユーザプログラム、データ」のパッケージングのときだけ有効になります。デフォルトは、すべてのチェックボックスがオフです。

図7‒21　［パッケージ属性］パネル（パッケージング情報）

パッケージ名／識別ID

「パッケージ名」および「パッケージ識別ID」のデフォルト値を設定する場合にチェックします。

ファイル／フォルダ名から取得する

パッケージング時に選択したフォルダまたはファイルの名称を、デフォルトの「パッケージ名」および「パッケージ識別ID」にします。パッケージ識別IDは、すべて大文字に変換されます。

ファイルを選択した場合、ピリオドと拡張子を除く名称が使用されます。複数のフォルダまたはファイルを選択した場合は、選択されている先頭のフォルダまたはファイルの名称が使用されます。使用できる最大文字数を超える文字列は削除されます。使用禁止文字およびスペースが含まれている場合は、削除されます。使用禁止文字だけの場合は、空欄になります。

パッケージングした日時から取得する

パッケージングした日時を、デフォルトの「パッケージ名」および「パッケージ識別ID」にします。「パッケージ名」と「パッケージ識別ID」は同じ名称になります。

日時の形式は「形式」から選択できます。YYYYまたはYYは年、MMは月、DDは日、HHは時、MMは分、SSは秒を意味します。年月日時分秒の値が1けたの場合は、前に0が付加されて、2けたになります。

バージョン

「バージョン／リビジョン」のデフォルト値を設定する場合にチェックします。

カウンタ

「カレント値」で指定した値を、デフォルトの「バージョン／リビジョン」にします。カレント値は、パッケージングが成功したときに、「増分値」で指定した値が足され、更新されます。ただし、パッケージング時に「バージョン／リビジョン」の値を変更した場合、カレント値は更新されません。また、カレント値は999,999を超えると、0に戻ります。「カレント値」に設定できる値は0〜999,999、「増分値」に設定できる値は0〜10です。

「バージョン／リビジョン」を固定値にしたい場合は、増分値を0に設定します。これによって、「カレント値」の値は更新されないで、「バージョン／リビジョン」には常に同じ値が表示されます。

パッケージングした日時から取得する

パッケージングした日時を、デフォルトの「バージョン／リビジョン」にします。日時の形式は「形式」から選択できます。YYMMDDは年月日、MMDDYYは月日年、DDMMYYは日月年、MMDDHHは月日時、HHMMSSは時分秒を意味します。年月日時分秒の値が1けたの場合は、前に0が付加されて、2けたになります。

世代番号

「世代番号」のデフォルト値を設定する場合にチェックします。

カウンタ

「カレント値」で指定した値を、デフォルトの「世代番号」にします。カレント値は、パッケージングが成功したときに、「増分値」で指定した値が足され、更新されます。ただし、パッケージング時に「世代番号」の値を変更した場合、カレント値は更新されません。また、カレント値は9,999を超えると、0に戻ります。「カレント値」に設定できる値は0〜9,999、「増分値」に設定できる値は0〜10です。

「世代番号」を固定値にしたい場合は、増分値を0に設定します。これによって、「カレント値」の値は更新されないで、「世代番号」には常に同じ値が表示されます。

パッケージングした日時から取得する

パッケージングした日時を、デフォルトの「世代番号」にします。日時の形式は「形式」から選択できます。MMDDは月日、DDMMは日月、HHMMは時分、MMSSは分秒、YYMMは年月、MMYYは月年を意味します。年月日時分秒の値が1けたの場合は、前に0が付加されて、2けたになります。

注意事項

「バージョン」または「世代番号」の「増分値」を指定したい場合は、「開始値」を次のとおり指定してください。

「バージョン」の「開始値」：100,000以上の6けたの値

「世代番号」の「開始値」：1,000以上の4けたの値

上記以外の値を指定すると、パッケージング時にパッケージ条件を指定しても、正しく判定されないことがあります。

(b)　ソフトウェア条件

リモートインストールするときの前提となるソフトウェア条件のデフォルト値を設定します。

図7‒22　［パッケージ属性］パネル（ソフトウェア条件）

条件

条件指定したソフトウェアがエージェントにインストールされていることを条件にするのか、インストールされていないことを条件にするのかを設定できます。デフォルトは「インストール済み」です。

複数条件の判定

複数の条件を設定した場合、1個以上の条件を満たすときにインストールするか、すべての条件を満たすときだけインストールするかを選択できます。デフォルトは、「いずれかの条件を満たす」です。

(c)　パッケージ条件

リモートインストールするときの前提となるパッケージ条件のデフォルト値を設定できます。

図7‒23　［パッケージ属性］パネル（パッケージ条件）

パッケージ名／パッケージ識別ID

前提とするパッケージをパッケージ名で特定するのか、パッケージ識別IDで特定するのかを設定できます。デフォルトは「パッケージ名」です。

条件

条件指定したパッケージが管理対象のコンピュータにインストールされていることを条件にするのか、インストールされていないことを条件にするのかを設定できます。デフォルトは「インストール済み」です。

複数条件の判定

複数の条件を設定した場合、1個以上の条件を満たすときにインストールするか、すべての条件を満たすときだけインストールするかを選択できます。デフォルトは、「いずれかの条件を満たす」です。

(d)　ファイル属性

リモートインストール後のファイル属性のデフォルト値を設定できます。ただし、「パッケージング元のアクセス権／所有者と同じ」を選択した場合、パッケージングするファイルまたはディレクトリが、FATファイルシステムのとき、［JP1/ITDM2 パッケージング］ダイアログボックスでは「インストール先のアクセス権/所有者と同じ」が選択されます。

図7‒24　［パッケージ属性］パネル（ファイル属性）

デフォルトは「インストール先のアクセス権／所有者と同じ」です。この設定は、次のパッケージングのときだけ有効になります。

パッケージ種別が「ユーザプログラム、データ」

パッケージ種別が「他社ソフトウェア」で、AITファイルを使用する場合

(e)　スケジュール

［JP1/ITDM2 パッケージング］ダイアログボックスの「中継でのパッケージ保管期限」と「実行タイミング」のデフォルト値を設定できます。

図7‒25　［パッケージ属性］パネル（スケジュール）

中継でのパッケージ保管日数

パッケージングを実行した日付に、ここで指定した日数を加算したものが、中継でのパッケージ保管期限のデフォルト値となります。1〜32,000日で指定します。デフォルトは90日です。最大値として32,000日（約88年に相当）まで指定できますが、パッケージング時の「中継でのパッケージ保管期限」が2036年1月1日以降になる場合は、自動的に2035年12月31日に変更されます。

中継でのパッケージ保管期限をオンにする

［JP1/ITDM2 パッケージング］ダイアログボックスの「中継でのパッケージ保管期限」のデフォルト値をオンにする場合はチェックします。デフォルトはオフです。

実行タイミング

パッケージをインストールするタイミングを設定します。デフォルトは「すぐに実行」です。［JP1/ITDM2 パッケージング］ダイアログボックスのデフォルトを空欄にしたい場合は、「デフォルト設定なし」を設定してください。設定できる項目を次に示します。

次回起動時に実行

すぐに実行

停止時に実行

この項目は、UNIXエージェントの場合だけ有効です。

デフォルト設定なし

(f)　インストール方法

［JP1/ITDM2 パッケージング］ダイアログボックスの「インストールモード」のデフォルト値を設定できます。デフォルトは「バックグラウンドインストールモード」です。この設定は、パッケージ種別が「ユーザプログラム、データ」のパッケージングのときだけ有効になります。

図7‒26　［パッケージ属性］パネル（インストール方法）

(g)　オプション

リモートインストール時のオプション項目のデフォルト値を設定できます。

図7‒27　［パッケージ属性］パネル（オプション）

パッケージデータの圧縮

パッケージング時、ソフトウェアを圧縮するかどうかのデフォルト値を設定できます。デフォルトはオフです。

バージョンアップ時リストア対象とする

バージョンアップ時に、リモートインストール先の前バージョンのソフトウェアをバックアップするかどうかのデフォルト値を設定できます。この設定は、パッケージ種別が「ユーザプログラム、データ」のパッケージングのときだけ有効になります。デフォルトはオフです。

インストール後コンピュータを再起動する

パッケージのインストール後に、管理対象のコンピュータを自動的に再起動させるかどうかのデフォルト値を設定できます。デフォルトはオフです。

処理中ダイアログの表示

パッケージのインストール時に、管理対象のコンピュータで処理中ダイアログを表示するかどうかのデフォルト値を設定できます。デフォルトは「エージェントの設定に従う」です。設定できる項目を次に示します。

エージェントの設定に従う

表示する

表示しない

(h)　外部プログラム

インストール直前、直後、およびインストールエラーのそれぞれの場合に、起動させたい外部プログラムと、外部プログラムの監視時間のデフォルト値を設定できます。「外部プログラム監視時間」のデフォルトは1秒、それ以外の項目のデフォルトはすべて空欄です。

図7‒28　［パッケージ属性］パネル（外部プログラム）

また、「設定項目」の「インストール直前起動外部プログラム詳細設定」、「インストール直後起動外部プログラム詳細設定」、または「インストールエラー時起動外部プログラム詳細設定」を選択することで、外部プログラムの詳細のデフォルト値を設定できます。デフォルト値を設定できる項目と、それぞれのデフォルトを次に示します。

設定できる項目

デフォルト

外部プログラムの時間監視

オフ

外部プログラム処理結果の取得方法

外部プログラムの終了コードで通知

処理結果エラー時の取り扱い※

エラーとして処理を中断する

注※

「インストールエラー時起動外部プログラム詳細設定」を選択したとき、この項目は設定できません。

(i)　AITファイルの設定

AITファイルを使用したインストール処理の応答を監視するかどうかのデフォルト値を設定できます。この設定は、パッケージ種別が「他社ソフトウェア」で、AITファイルを使用してパッケージングするときだけ有効になります。

図7‒29　［パッケージ属性］パネル（AITファイルの設定）

AITファイルを使用したインストール処理の応答を監視する場合は、「AITファイルの監視」をオンにし、「AITファイルの監視時間」に監視する時間の上限値を指定します。デフォルトはオフです。

(3)　［ディレクトリ］パネル

パッケージャがソフトウェアをパッケージングするときに使用するワークディレクトリを指定できます。パッケージングするソフトウェアの最大サイズ以上の容量が必要です。デフォルトは、「JP1/IT Desktop Management 2 - Agentのインストール先ディレクトリ¥PKG¥WORK」です。

図7‒30　［ディレクトリ］パネル

(4)　［監査ログ］パネル

パッケージング時の監査ログの出力について設定します。

なお、このパネルは、パッケージャがJP1/IT Desktop Management 2 - Managerと異なるコンピュータにインストールされている場合だけ表示されます。

図7‒31　［監査ログ］パネル

監査ログを出力する

監査ログを出力する場合にチェックボックスをオンにします。デフォルトはオフです。オンにすると、監査ログの出力に関する設定項目が活性化します。

監査ログの出力ディレクトリ

監査ログを出力するディレクトリを、4〜127バイトの全角または半角文字、および「_」、「¥」、「.」、「:」、「(」、「)」、「「」、「」」で指定します。

デフォルトでは出力先のディレクトリは指定されていません。指定した出力先のディレクトリには、JP1/IT Desktop Management 2を使用するユーザに対して書き込み権限を設定しておく必要があります。

監査ログは、ここで指定したディレクトリの直下に生成されるNETMAuditManager.LOGファイルに出力されます。

なお、監査ログの出力ディレクトリにJP1/IT Desktop Management 2 - Agentのインストール先ディレクトリを指定した場合、JP1/IT Desktop Management 2 - Agentをアンインストールすると監査ログも削除されてしまいます。出力ディレクトリは、監査ログの運用方法に合わせて指定してください。

7.3　リモートインストールの実行

リモートインストールは、配布管理システムのリモートインストールマネージャから実行します。

ここでは、リモートインストールを指示するジョブの作成・実行方法、および結果の確認方法について説明します。

なお、ジョブの作成・実行方法は、リモートインストール以外の作業でもほぼ同じです。すべてのジョブに共通の操作については、「10.　ジョブを管理する」を参照してください。

7.3.1　リモートインストールの実行手順

画面遷移を中心に、基本的なリモートインストールの実行手順を説明します。詳細な設定方法については、手順中に示す各参照先を参照してください。

リモートインストールの実行手順を次に示します。

リモートインストールマネージャの［パッケージ］ウィンドウで、リモートインストールするパッケージを選択する。

［実行］−［ジョブの実行］を選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されます。

図7‒32　［ジョブ定義の新規作成］ダイアログボックス

「パッケージのインストール」を選択し、［OK］ボタンをクリックする。

［ジョブの作成］ダイアログボックスが表示されます。

図7‒33　［ジョブの作成］ダイアログボックス

デフォルトでは［ジョブ］パネルが表示されます。ここではジョブ名を設定できます。［ジョブ］パネルの設定方法については、「10.2.3　［ジョブ］パネルの設定」を参照してください。

［あて先］タブをクリックする。

［あて先］パネルで、リモートインストールのあて先を設定します。必ず1つ以上のあて先を設定してください。

複数サーバ構成では、中継システムおよび配下の管理用中継サーバを経由するあて先も設定できます。

図7‒34　［あて先］パネル

［あて先］パネルの設定方法については、「10.2.4　［あて先］パネルの設定」を参照してください。

［パッケージ］タブをクリックする。

［パッケージ］パネルで、リモートインストールするパッケージを設定します。

図7‒35　［パッケージ］パネル

［パッケージ］ウィンドウでパッケージを選択してからジョブを作成した場合、選択したパッケージが表示されます。

［パッケージ］パネルの設定方法については、「7.3.2　［パッケージ］パネルの設定」を参照してください。

なお、そのほかのタブについては、リモートインストールの方法によって任意に設定してください。

［ジョブの配布属性］パネル

マルチキャスト配布および分割配布を設定できます。ただし、マルチキャスト配布の設定ができるのは、「パッケージのインストール」ジョブだけです。［ジョブの配布属性］パネルの設定方法については、「7.3.3　［ジョブの配布属性］パネルの設定」を参照してください。

［スケジュール］パネル

ジョブの登録日時、実行日時、および実行期限を設定します。［スケジュール］パネルの設定方法については、「10.2.5　［スケジュール］パネルの設定」を参照してください。

［クライアント制御］パネル

クライアント制御機能を使用するかどうかを設定できます。［クライアント制御］パネルの設定方法については、「10.2.6　［クライアント制御］パネルの設定」を参照してください。

設定が完了したら、［実行］ボタンをクリックする。

リモートインストールのジョブが実行されます。

ジョブの実行状況を確認する。

リモートインストールマネージャの［ファイル］メニューから、［新規作成］−［ジョブ実行状況］を選択して、［ジョブ実行状況］ウィンドウを表示します。

図7‒36　［ジョブ実行状況］ウィンドウ

リモートインストールのジョブは、［ジョブ実行状況］ウィンドウで［表示］−［すべてのジョブ詳細の表示］を選択すると、ジョブ名の前に次のアイコンが表示されます。

[図データ]：「パッケージのインストール」ジョブ

[図データ]：「中継までのパッケージの転送」ジョブ

[図データ]：「クライアントユーザによるインストール」ジョブ

実行したジョブを選択すると、右枠に実行状況が表示されます。ジョブの実行状況の確認方法については、「10.4　ジョブの実行状況を確認する」を参照してください。

なお、ジョブ実行時にジョブを保存しておくと、ジョブが失敗した場合に再実行したり、既存のジョブを編集してジョブの新規作成の手間を省いたりできます。［保存］または［保存&実行］ボタンを使用していったんジョブを保存することをお勧めします。

フォルダにジョブを保存するには、あらかじめ［ジョブ定義］ウィンドウに保存先のフォルダを作成しておく必要があります。フォルダの作成方法については、「10.3.2　保存したジョブおよびフォルダの管理」を参照してください。

注意事項

リモートインストールジョブおよび中継システムまでのパッケージ転送ジョブの編集では、パッケージパネルを一度も開かずに、あて先をすべて削除したあとにパッケージパネルを開くことはできません。

パッケージパネルを開く場合には、必ずあて先が1つ以上指定されている必要があります。

リモートインストールマネージャから新規作成したジョブ定義をリモートインストールマネージャが付与したデフォルトのジョブ名で保存する際に、「すでに同じ名前が存在します」というダイアログが表示された場合はキャンセルして、再度、ジョブの新規作成操作をしてください。ジョブ名を変更して保存しないでください。

OSの管理権限を持たないユーザがリモートインストールマネージャを実行する場合は、OSの管理権限を持つユーザに昇格してから実行してください。

7.3.2　［パッケージ］パネルの設定

リモートインストールジョブを作成する場合、［ジョブの作成］ダイアログボックスの［パッケージ］パネルで、リモートインストールするパッケージを設定します。

図7‒37　［パッケージ］パネル

［パッケージ］パネルでは次の操作ができます。

パッケージの追加

「パッケージ」枠にパッケージを追加します。

パッケージの削除

「パッケージ」枠からパッケージを削除します。

インストール条件の変更

パッケージング時に設定したインストール条件を、パッケージごとに変更します。

スケジュールの一括設定

インストール条件の1つである「スケジュール」情報を、すべてのパッケージに対して一括して設定します。

なお、リモートインストールするパッケージを複数設定した場合は、「1.3.7　ジョブの実行順序」を参照してください。

(1)　パッケージの追加

［パッケージ］パネルで［追加］ボタンをクリックすると、［パッケージの追加］ダイアログボックスが表示されます。［パッケージの追加］ダイアログボックスは、見やすいサイズに変更できます。サイズを変更した場合、次回から変更したサイズで表示されます。

図7‒38　［パッケージの追加］ダイアログボックス

このダイアログボックスで、追加するパッケージを指定します。「キャビネット」および「パッケージ」枠から、追加するパッケージを［->］［->>］ボタンで「選択したパッケージ」枠に移動し、［OK］ボタンをクリックしてください。［パッケージ］パネルにパッケージが追加されます。

(2)　パッケージの削除

［パッケージ］パネルで削除するパッケージを選択し［削除］ボタンをクリックします。

(3)　インストール条件の変更

［パッケージ］パネルで［変更］ボタンをクリックすると、［インストール条件の変更］ダイアログボックスが表示されます。このダイアログボックスでは、パッケージング時に設定したパッケージのインストール条件を、参照または変更できます。

図7‒39　［インストール条件の変更］ダイアログボックス

［インストール条件の変更］ダイアログに表示されるパネルは、パッケージャの［JP1/ITDM2 パッケージング］ダイアログボックスに表示されるものと同じです。設定内容については、「7.2　パッケージの詳細設定」を参照してください。ただし、パッケージの種別（UNIX専用、Windows専用、およびUNIXとWindows共用のパッケージ）によって参照だけで、編集できない項目があります。

［インストール条件の変更］ダイアログにだけ表示される項目は、次のとおりです。

「同じパッケージがあったら上書き」の設定

この項目を設定すると、管理対象のコンピュータに配布するパッケージと同じ名称のソフトウェアがインストールされていた場合に、インストール済みのソフトウェアを上書きしてパッケージをインストールします。

ただし、「同じパッケージがあったら上書き」チェックボックスをオンにすると、すでに同じパッケージがあて先に配布されているかいないかに関係なく、パッケージが送信されます。したがって、不要なネットワークトラフィックの増加を避けるため、次の場合にだけ使用してください。

配布済みのパッケージを上書きする必要がある場合

配布したパッケージをアンインストールするなどして削除してしまったあと、再度そのパッケージを配布したい場合

この場合、設定しないとパッケージをインストールできません。

なお、「同じパッケージがあったら上書き」を設定すると、バージョンが同じでも内容が異なるソフトウェアを上書きインストールできるため、JP1/IT Desktop Management 2のインストールパッケージ情報のバージョン管理ができなくなります。

(4)　スケジュールの一括設定

［パッケージ］パネルで［オプション］ボタンをクリックすると、［インストール条件の一括設定］ダイアログボックスが表示されます。このダイアログボックスでは、パッケージのインストール条件のうち、スケジュールに関する情報を、すべてのパッケージに対して一括して設定できます。

図7‒40　［インストール条件の一括設定］ダイアログボックス

このダイアログボックスの指定内容は、［インストール条件の変更］ダイアログボックスの［スケジュール］パネルと同じです。

7.3.3　［ジョブの配布属性］パネルの設定

［ジョブの配布属性］パネルでは、次の設定をします。

中断中のあて先への配布の設定

ジョブの配布方式の選択

パッケージの分割配布の設定

図7‒41　［ジョブの配布属性］パネル

このパネルは次のジョブ種別の場合だけ表示されます。

パッケージのインストール

中継までのパッケージの転送

クライアントユーザによるインストール（分割配布される範囲は管理対象のコンピュータの接続先システムまで）

ただし、ジョブの配布方式が選択できるのは、「パッケージのインストール」ジョブの場合だけです。「中継までのパッケージの転送」ジョブおよび「クライアントユーザによるインストール」ジョブの場合は、「ユニキャスト配布」が選択された状態で表示され、変更できません。

(1)　中断中のあて先への配布

中断中のあて先へジョブを配布するかしないかを選択します。デフォルトは「配布しない」です。

配布管理システムまたはあて先経路上のシステムが中断状態の場合、「配布しない」を選択したジョブはファイル転送が中断されますが、「中断中でも配布する」を選択したジョブは、システムが中断状態になっていてもファイル転送が中断されません。中断中のジョブを追い越して配布されます。

なお、「中断中でも配布する」を選択した場合、分割配布はできません。また、マルチキャスト配布のジョブは中断されないため、中断中のあて先へジョブを配布するかしないかの選択は、ユニキャスト配布に切り替わらないかぎり効果がありません。

(2)　配布の方式

「パッケージのインストール」ジョブの場合、ジョブの配布方式を「ユニキャスト配布」と「マルチキャスト配布」から選択できます。デフォルトは「ユニキャスト配布」です。

ユニキャスト配布では、上位システムから管理対象のコンピュータへ1対1でパケットを送信します。そのため、コンピュータ数が増加すると、上位システムから送信するパケット数も増加します。一方、マルチキャスト配布の場合、上位システムは1ジョブ分のパケットを送信するだけで、特定の多数のコンピュータへジョブを配布できます。そのため、次のジョブをマルチキャスト配布で実行すると、ユニキャスト配布に比べて送信量を削減できます。

あて先の数が多いジョブ

大容量のパッケージを配布するジョブ

ジョブのあて先が少ない場合や、パッケージの容量が小さい場合は、マルチキャスト配布すると効率が悪くなります。その場合は、ユニキャスト配布を設定してください。

なお、マルチキャスト配布を実行するには、中継システムおよびその上位システムで、設定が必要です。

また、マルチキャスト配布では、パッケージの分割配布はできません。「マルチキャスト配布」を選択した場合、次に説明する「分割配布の設定」はできなくなります。

あて先がUNIXエージェントの場合、選択できるのは「ユニキャスト配布」だけです。

(3)　分割配布の設定

パッケージを分割配布するかしないかを設定します。「分割配布する」を選択すると、パッケージを指定されたサイズで分割して転送します。また、指定された時間で転送と転送の間にインターバル（転送休止時間）を置くこともできます。したがって、大容量のパッケージでもネットワークに負荷を掛けないで配布できます。

分割サイズ

パッケージを分割するサイズを指定します。ここで指定されたサイズでパッケージを分割します。値はキロバイトまたはメガバイト単位で指定します。指定できる値の上限は、2,097,151キロバイトです。デフォルトは1メガバイトです。

分割サイズは転送先のエージェント設定で設定されている値とここで設定した値とを比較して、小さい方のサイズで分割します。また、この分割サイズは転送するパッケージごとに有効になります。したがって複数パッケージを転送する場合でも、パッケージ単位のサイズが分割サイズに満たない場合は、分割配布の対象にはなりません。

転送休止時間

パッケージを分割配布する場合に、分割したパッケージの転送と転送の間にインターバルを設定できます。指定できる値は1分〜24時間です。デフォルトは1時間です。

なお、実際の転送休止時間は、分割サイズで採用された側の転送休止時間でインターバルが置かれます。分割サイズが同じ値の場合は、下位システムでの値が採用され、転送休止時間も採用された側のインターバルになります。

注意事項

「分割配布する」を選択した場合、マルチキャスト配布はできません。

7.3.4　オフラインインストール

ここでは、オフラインインストールの操作について説明します。

なお、この機能はCitrix XenApp、Microsoft RDSサーバではサポートしていません。

(1)　オフラインインストールの手順

オフラインインストールの手順を次の図に示します。

図7‒42　オフラインインストールの手順

インストールするソフトウェアをパッケージングする。

パッケージャで、インストールするソフトウェアをパッケージングします。

ただし、［JP1/ITDM2 パッケージング］ダイアログボックスで無効になる設定項目があります。これらについては、「7.3.4(6)　オフラインインストールを実行するときの注意事項」を参照してください。

インストール媒体を準備する。

配布管理システムで、インストールするパッケージの情報を格納したパッケージ情報ファイルを作成します。パッケージ情報ファイルを作成すると、同時にインストール実行プログラムが出力されます。

インストール媒体の準備方法については、「7.3.4(2)　インストール媒体の準備」を参照してください。

インストール媒体をオフラインマシンへ搬送する。

パッケージ情報ファイルおよびインストール実行プログラムを、USBメモリなどの媒体に格納してオフラインマシンへ搬送します。

インストールを実行する。

オフラインマシンでインストール実行プログラムを実行すると、インストールパッケージ情報ファイルに含まれるパッケージがインストールされます。

インストールの実行方法については、「7.3.4(3)　オフラインマシンでのインストールの実行」を参照してください。

インストール結果ファイルを配布管理システムへ搬送する。

インストール時に出力されるインストール結果ファイルをUSBメモリなどの媒体に格納して、配布管理システムへ搬送します。オフラインマシンと配布管理システムがネットワークで接続されている場合は、このファイルをメールに添付して搬送することもできます。

インストール結果を確認する。

テキストエディタでインストール結果ファイルを開いて確認します。

インストール結果の確認方法については、「7.3.4(4)　オフラインマシンでのインストール結果の確認」を参照してください。

(2)　インストール媒体の準備

インストール媒体は、パッケージを管理している配布管理システムのリモートインストールマネージャで準備します。インストール媒体には、次のファイルを格納します。

パッケージ情報ファイル（ファイル名：ITDM2LINST.BIN）

インストール実行プログラム（ファイル名：ITDM2LINST.EXE）

パッケージ情報ファイルの作成方法を次に示します。なお、インストール実行プログラムは、パッケージ情報ファイルと同時に作成されます。

［パッケージ］ウィンドウで、インストールするパッケージを選択する。

同じキャビネット内のパッケージは複数選択できます。

［ファイル］メニューの［オフラインマシンの管理］から［インストール媒体作成］を選択する。

［インストール媒体作成］ダイアログボックスが表示されます。

図7‒43　［インストール媒体作成］ダイアログボックス

「インストールするパッケージのリスト」には、［パッケージ］ウィンドウで選択したパッケージが表示されます。

必要に応じて、パッケージのインストール順を変更する。

「インストールするパッケージのリスト」の上から順にパッケージがインストールされます。インストール順を入れ替える場合は、パッケージを選択して、［↑］または［↓］ボタンをクリックしてください。

必要に応じて、パッケージのインストール条件を変更する。

インストール先ディレクトリやソフトウェア条件などの、パッケージのインストール条件を変更する場合は、パッケージを選択して［変更］ボタンをクリックしてください。［インストール条件の変更］ダイアログボックスが表示され、インストール条件を変更できます。

このダイアログボックスは、リモートインストールの実行時に使用する［インストール条件の変更］ダイアログボックスと同じです。

ただし、ダイアログボックスの［スケジュール］パネルの機能は、すべて空白で非活性となり、変更できません。このほかの［インストール条件の変更］ダイアログボックスの指定内容については、「7.3.2(3)　インストール条件の変更」を参照してください。

［作成］ボタンをクリックする。

［フォルダの参照］ダイアログボックスが表示されます。

パッケージ情報ファイルおよびインストール実行プログラムを格納するフォルダを選択し、［OK］ボタンをクリックする。

インストール媒体の作成中を示すダイアログボックスが表示され、選択したフォルダに、パッケージ情報ファイルおよびインストール実行プログラムが作成されます。

(3)　オフラインマシンでのインストールの実行

準備したインストール媒体を、パッケージをインストールしたいオフラインマシンへ搬送してください。オフラインマシンでのインストール方法を次に示します。

なお、オフラインインストールの実行時には、管理対象のコンピュータの幾つかの設定が無効となります。詳細については、「7.3.4(6)　オフラインインストールを実行するときの注意事項」を参照してください。

オフラインマシンで、JP1/IT Desktop Management 2の機能が実行されていないことを確認する。

JP1/IT Desktop Management 2のほかの機能が実行されている間は、オフラインインストールできません。機能が終了されるまで待ってください。

パッケージ情報ファイルがインストール実行プログラムと同じフォルダにあることを確認し、インストール実行プログラムを実行する。

インストール実行中は［パッケージのインストール］ダイアログボックスが表示され、インストールの実行状況を確認できます。

また、インストール実行プログラムは、コマンド形式で実行することもできます。インストール実行コマンドについては、「7.3.4(5)　オフラインインストールの実行コマンド（ITDM2LINSTコマンド）」を参照してください。

インストール結果ファイルが出力できなかった場合は、表示される［インストール結果ファイルの保存］ダイアログボックスで出力先を選択し、［OK］ボタンをクリックする。

［キャンセル］ボタンをクリックすると、インストール結果ファイルは出力されません。

インストールが終わると、インストール実行ファイルと同じフォルダに、インストール結果ファイル（ファイル名：ITDM2linst.txt）が出力されます。出力先にインストール結果ファイルがすでにある場合は、ファイルの末尾にインストール結果が追加されます。

(4)　オフラインマシンでのインストール結果の確認

インストール時に出力されるインストール結果ファイルを、配布管理システムに搬送してください。インストール結果ファイルをテキストエディタで開いて、インストール結果を確認します。

ここでは、インストール結果ファイルの出力形式について説明します。インストール結果ファイルの出力形式を次の図に示します。

図7‒44　インストール結果ファイルの出力形式

インストール結果はパッケージごとに1行ずつ出力されます。各項目はタブ文字で区切られます。各項目の詳細は次のとおりです。

日付

パッケージをインストールした年月日が、YYYY/MM/DDの形式で出力されます。

時刻

パッケージをインストールした時分秒が、hh:mm:ssの形式で出力されます。

結果

インストール結果が、次のどちらかの値で出力されます。

OK：成功

NG：失敗

ホスト名

インストールを実行したコンピュータのホスト名が出力されます。ホスト名がないコンピュータの場合は、ホスト識別子から先頭の「#」を削除した値が出力されます。

IPアドレス

インストールを実行したコンピュータのIPアドレスが出力されます。IPアドレスがないコンピュータの場合は、「127.0.0.1」が出力されます。

パッケージ名

インストールしたパッケージの名称が出力されます。

パッケージ情報

インストールしたパッケージの情報が、次の形式で出力されます。

d.cc.pppppp.vvvv.ssss

d ：パッケージの種別

（UNIXを示す「C」、またはWindowsを示す「D」）

cc ：キャビネット識別ID

pppppp ：パッケージ識別ID

vvvv ：バージョン/リビジョン

ssss ：世代番号

保守コード

インストール結果を示す保守コードが出力されます。

ホスト識別子

インストールを実行したコンピュータのホスト識別子が出力されます。

(5)　オフラインインストールの実行コマンド（ITDM2LINSTコマンド）

オフラインマシンで実行する、ITDM2LINSTコマンドについて説明します。

機能

パッケージ情報ファイル（ファイル名：ITDM2LINST.BIN）に含まれるパッケージをオフラインマシンにインストールします。インストール結果は、インストール結果ファイル（ファイル名：ITDM2linst.txt）に出力されます。

形式

ITDM2LINST.exe [/I パッケージ情報ファイルのディレクトリ]
            [/O インストール結果ファイルの出力先ディレクトリ]
            [/S]

オプション

/I

パッケージ情報ファイル（ファイル名：ITDM2LINST.BIN）のディレクトリのフルパスを指定します。

省略した場合は、インストール実行プログラム（ファイル名：ITDM2LINST.EXE）と同じディレクトリにあるパッケージ情報ファイルが読み込まれます。

/O

インストール結果ファイル（ファイル名：ITDM2linst.txt）の出力先ディレクトリのフルパスを指定します。出力先にインストール結果ファイルがすでにある場合は、ファイルの末尾に結果が追加されます。

省略した場合は、インストール実行プログラム（ファイル名：ITDM2LINST.EXE）と同じディレクトリにインストール結果ファイルが出力されます。

/S

オフラインインストールの実行時に、次に示すダイアログボックスを表示させない場合に指定します。

・［パッケージのインストール］ダイアログボックス

・［インストール結果ファイルの保存］ダイアログボックス

・インストール結果を表示するダイアログボックス

・オフラインインストール固有のエラーダイアログボックス

実行例

パッケージ情報ファイルの格納先が「C:¥Program Files¥Hitachi¥JP1ITDMM¥MGR¥BIN¥DMPRM」、インストール結果ファイルの出力先が「A:¥」の場合の例を次に示します。

ITDM2LINST.exe /I "C:¥Program Files¥Hitachi¥JP1ITDMM¥MGR¥BIN¥DMPRM" /O "A:¥"

(6)　オフラインインストールを実行するときの注意事項

管理対象のコンピュータでオフラインインストールを実行するときには、次の点に注意してください。

インストール媒体のデータをネットワークドライブに格納してオフラインインストールを実行する場合、「ITDM2LINST.BINが見つかりません。」といったエラーが発生したときは、ネットワークドライブへのアクセスに失敗したおそれがあります。ネットワークドライブへのアクセス権があるかどうか確認してください。

管理対象のコンピュータでオフラインインストールを実行するときに必要なディスク容量は、リモートインストールを実行するときと同様です。

エージェント設定の［ジョブの設定］の設定、インストールするソフトウェアのパッケージング、およびインストール条件の変更で無効になる項目があります。

オフラインインストールの実行時に無効になるなどの注意が必要な設定項目を、次の表に示します。

表7‒2　オフラインインストールの実行時に注意が必要な設定項目

ダイアログボックス名

カテゴリまたはパネル名

設定項目

説明

ジョブの設定

インストール待ち時間の設定

InstallShieldからの応答待ち時間

無効になります。

ジョブの保留許可の設定

利用者による、ジョブの保留を許可する

通知抑止の設定

リモートインストール待ち、または収集待ちとなっている通知を抑止する※

JP1/ITDM2パッケージング

スケジュール

中継システムパッケージの保管期間

無効になります。

インストール日時

実行タイミング

オプション

インストール後コンピュータを再起動する

インストール条件の変更

オプション

インストール後コンピュータを再起動する

無効になります。

注※　設定に関係なく、リモートインストール待ち、または収集待ちとなっているジョブを通知しません。

JP1/IT Desktop Management 2 - Managerをクラスタシステム環境で使用する場合、リモートインストールマネージャを起動した際に［ログイン（リモートインストールマネージャ）］ダイアログボックスで入力する［管理用サーバ］には、クラスタリソースが稼働している実行系のサーバ上でリモートインストールマネージャを起動して「localhost」、物理ホスト名または物理IPアドレスを指定してください。論理ホスト名や論理IPアドレスを指定すると、［インストール媒体作成］が非活性になります。

7.3.5　リモートインストールを実行するときの注意事項

リモートインストールを実行するときの注意事項について説明します。

(1)　分割配布の注意事項

分割配布する場合の注意事項を次に示します。

複数の分割配布のジョブを同時に実行した場合

分割配布を指定した複数のジョブを同時に実行しても、転送元と転送先の区間では、複数のジョブのパッケージが同時に転送されるわけではありません。ジョブは1つずつシーケンシャルに実行されます。したがって、転送中以外のジョブは、パッケージのダウンロード待ち状態（ジョブの実行状態20%）になります。

あて先の指定方法の注意事項

中継システムおよび管理用中継サーバに分割配布を指定した「パッケージのインストール」ジョブを実行する場合、システム構成上の中継システムおよび管理用中継サーバのアイコンをあて先として指定しないでください。必ず、システム構成上の中継システムおよび管理用中継サーバ配下の管理対象のコンピュータのアイコンをあて先として指定してください。システム構成上の中継システムおよび管理用中継サーバのアイコンをあて先として指定した場合、分割配布ではなく通常の配布が実行されます。

IDジョブで運用する場合、管理用中継サーバ自身のIDの登録先は、必ず自ホストに設定してください。

中継システムおよび管理用中継サーバあての「パッケージのインストール」ジョブは、システム構成上の中継システムおよび管理用中継サーバ上の管理対象のコンピュータのアイコンをあて先として指定する必要があります。この場合、中継システムおよび管理用中継サーバとその管理対象のコンピュータ間では、分割配布は実行されません。

分割配布を指定した複数のジョブを同時に実行した場合、通常は転送元と転送先の拠点ごとにシーケンシャルに実行されます。しかし、ジョブ登録時に手入力であて先を指定したジョブと、システム構成、あて先情報からあて先を指定したジョブが混在した場合、複数のジョブが並行してパッケージ転送されてしまうことがあります。

パッケージのインストールの順序性が保証されなくなる条件

「パッケージのインストール」ジョブに複数のパッケージを指定した場合、ジョブに指定したパッケージのキャビネット識別ID、パッケージ識別ID、バージョン、および世代番号の順番で配布先システムにインストールされます。しかし、分割配布を指定したジョブの時、次の条件では順序が保たれなくなる場合があるので、注意してください。

あて先の途中にある管理用中継サーバに配布するパッケージが保管済みの場合

ジョブの実行中に分割配布を指定したジョブを強制完了させた場合

分割配布のダウンロード表示

分割配布のサイズが小さいと管理対象のコンピュータ上のダウンロードダイアログ表示が0%となることがあります。また、分割配布のジョブを連続して実行した場合、分割配布待ちのジョブについては管理対象のコンピュータ上のダウンロードダイアログで表示が0%で表示されることがあります。

強制的にジョブ登録時に指定した分割配布の設定を有効にする方法

エージェント設定でパッケージの分割配布の設定をデフォルト値にすると、ジョブ登録時に指定した分割配布の設定で、強制的に配布先システムまでパッケージを転送できます。エージェント設定でのデフォルトを次に示します。

「分割配布する」のチェックボックスがオン

分割サイズ：2,097,151キロバイト

転送休止時間：1時間

パッケージの分割配布とクライアント制御の関連

パッケージの分割配布を指定し、さらにクライアント制御の指定をした「パッケージのインストール」ジョブを実行した場合、次のような動作になります。

「対象のコンピュータが稼働していない場合に起動する」および「ジョブ実行後クライアントをシャットダウンさせる」を指定した場合

コンピュータの電源がオンになる。

1つ目の分割されたパッケージが転送される。

コンピュータの電源がオフになる。

1.の動作から繰り返す。

なお、あて先がUNIXエージェントの場合、「ジョブ実行後クライアントをシャットダウンさせる」は無効です。コンピュータの電源はオフになりません。

「対象のコンピュータが稼働していない場合に起動する」を指定した場合

コンピュータの電源がオンになる。

1つ目の分割されたパッケージが転送される。

パッケージの転送が続行され、コンピュータの電源はオンのままになる。

JP1/IT Desktop Management 2 - Agent（中継システム）での注意事項

ジョブ作成時に指定する分割サイズおよび転送休止時間は、下位システムのエージェント設定で指定された値と比較され、小さい値で分割配布が実行されます。ただし、ジョブ実行状況の詳細表示で表示される分割サイズおよび転送休止時間が参照するタイミングによっては、ジョブ作成時の設定値で表示されてしまうことがありますが、動作上の問題はありません。

(2)　ジョブの中断、再開時の注意事項

ジョブの中断、再開時の注意事項を次に示します。

リモートインストールマネージャの［実行］メニューで「ファイル転送の中断/再開」から「再開させる」を選択して、マネージャ自身にファイル転送の再開を指示した場合、実行表示が変わることがあります。例えば、中断状態のパッケージャの配布ジョブが実行状態になった場合、実行状況表示が50%から20%のように戻ります。

(3)　中断中のジョブ配布時の注意事項

ジョブの中断機能を使用しない環境では、「中断中でも配布する」を選択したジョブを実行しても効果がありません。「中断中でも配布する」を選択したジョブも、「中断中でも配布する」を選択しないジョブと同じように動作するため、配布される順序は変わりません。

(4)　UNIX版へのジョブ配布時の注意事項

UNIXの管理対象のコンピュータにジョブを配布するときの注意事項を次に示します。

次の場合、後処理プログラムが実行されます。

Windows版のパッケージャまたはdcmpackコマンドで、インストール日時および後処理プログラムを指定して作成したパッケージに対して、リモートインストールマネージャで後処理プログラムの指定を解除した場合

UNIXで、ゼネレータの種別に「NETM_DM_GF」を指定し、後処理プログラムを指定して作成したパッケージに対して、リモートインストールマネージャで後処理プログラムの指定を解除した場合

次の場合、後処理プログラムが実行されません。

UNIXで、ゼネレータの種別に「NETM_DM_GF」を指定し、インストール日時および後処理プログラムを指定しないで作成したパッケージに対して、リモートインストールマネージャで後処理プログラムを指定した場合

次の場合、ジョブがエラーとなります。

UNIXで、ゼネレータの種別に「NETM_DM_GF」を指定し、インストール日時を指定して作成したパッケージに対して、リモートインストールマネージャでインストール日時の指定を解除した場合

(5)　システム構成情報の自動反映機能使用時の注意事項

リモートインストールマネージャで、ID管理中継の追加や削除などのシステム構成情報を用いて操作した際に，操作対象となるノードが表示しているにも関わらず、「指定したID名称またはID管理中継名称はシステムに存在しません。ネットワークをダブルクリックして最新情報を取得し状態を確認してください。」等の指示をすることがあります。これはシステム構成情報の自動反映機能によって、操作対象となるノードの管理情報変更に伴ったメッセージです。メッセージの指示に従ってください。

(6)　その他の注意事項

日立プログラムプロダクトを空白を含むディレクトリにリモートインストールするとジョブが失敗することがあります。

リモートインストールマネージャによるソフトウェアの配布およびファイルの収集機能で、OneDriveファイルおよびフォルダにアクセスすることはできません。

ネットワーク切断などによって中断していたパッケージ転送を再開する場合は、転送済みのパッケージの続きから再開します。

7.4　キャビネットとパッケージの管理

ここでは、キャビネットとパッケージを管理する方法について説明します。

7.4.1　キャビネットの作成

キャビネットは1,296個まで作成できます。リモートインストールマネージャでのキャビネットの作成方法を次に示します。

［パッケージ］ウィンドウで、［ファイル］−［キャビネットの新規作成］を選択する。

［キャビネットの作成］ダイアログボックスが表示されます。各項目は、必ず設定してください。

図7‒45　［キャビネットの作成］ダイアログボックス

キャビネット名（必ず設定）

キャビネットごとにユニークな名称を、半角32文字（全角で16文字）以内で設定します。「¥」「/」「*」「"」「:」「;」およびスペースは使用できません。

キャビネット識別ID（必ず設定）

キャビネットごとにユニークなIDを、2文字の半角英数字（英字は大文字だけ）で設定します。

キャビネット種別（必ず設定）

格納するパッケージの作成元が、WindowsかUNIXかによって、「Windows用」または「UNIX用」を選択します。

項目を設定して［終了］ボタンをクリックする。

設定を保存して［キャビネットの作成］ダイアログボックスが閉じます。

このとき［追加］ボタンをクリックすると、続けてキャビネットを作成できます。

なお、キャビネットは、パッケージャからパッケージングするときに作成することもできます。パッケージャからパッケージングしたときに、誤って、異なるキャビネット識別IDに同じキャビネット名を付けてしまった場合、キャビネット内に不正なパッケージが表示されることがあります。このような場合は、重複しているキャビネット名のどちらか一方を、［ファイル］−［名前の変更］で変更してください。

7.4.2　キャビネットとパッケージの確認

キャビネットおよびパッケージの情報を、［パッケージ］ウィンドウの右側の枠で確認します。右側の枠にはタブがあり、これを選択することで、次のような情報を表示できます。

一覧

左側の枠で選択した項目の1つ下位の情報（キャビネットまたはパッケージ）を一覧表示します。

属性情報

キャビネット名称、パッケージ名称、パッケージング時に指定した条件など、キャビネットおよびパッケージの属性情報が表示されます。

図7‒46　［パッケージ］ウィンドウ（属性情報）（1/2）

図7‒47　［パッケージ］ウィンドウ（属性情報）（2/2）

パッケージ内容

パッケージ種別が「ユーザプログラム、データ」の場合に、パッケージに含まれているファイルの名称、サイズ、および最終更新日時を確認できます。圧縮されたパッケージは、解凍後に、その情報が表示されます。

図7‒48　［パッケージ］ウィンドウ（パッケージ内容）

削除中のパッケージの情報は表示されません。

また、パッケージ内容をCSV出力している最中に、パッケージ内容の最新情報表示を実行した場合、表示に失敗することがあります。

JP1/IT Desktop Management 2 - Managerのリモートインストールマネージャでは、パッケージのさらに詳細な属性情報を確認できます。属性の詳細の確認方法を次に示します。なお、複数のパッケージの詳細は一度に確認できません。

［パッケージ］ウィンドウの左側の枠で内容を確認したいパッケージを右クリックし、［プロパティ］メニューを選択する。

［XXXXXのプロパティ］ダイアログボックス（XXXXXはパッケージ名）が表示されます。

［XXXXXのプロパティ］ダイアログボックスの［詳細］ボタンをクリックする。

［属性の詳細］ダイアログボックスが表示され、パッケージング時の指定内容を確認できます。表示される項目については、「7.1.3　保管したパッケージの確認」を参照してください。

なお、次に示すパッケージは、属性の詳細を表示できません。

パッケージング中のパッケージ

プロパティ表示中に削除されたパッケージ

なお、パッケージの名称の変更や、コピー・移動はできません。もう一度パッケージャからパッケージングし、不要となったパッケージを削除してください。

7.4.3　キャビネット名の変更

一度設定したキャビネットの名称を変更する手順を次に示します。

［パッケージ］ウィンドウで、名称を変更するキャビネットを選択し、［ファイル］−［名前の変更］を選択する。

［キャビネットの名前の変更］ダイアログボックスが表示されます。

図7‒49　［キャビネットの名前の変更］ダイアログボックス

新しい名称を入力し、［OK］ボタンをクリックする。

キャビネット名が変更されます。

ヒント

キャビネット名称を変更しても製品の動作に影響はありません。

7.4.4　中継システムおよび管理用中継サーバへのパッケージの転送

中継システムおよび配下の管理用中継サーバへパッケージを転送する場合は、「中継までのパッケージの転送」ジョブを実行します。操作および設定内容の詳細については、「10.2　ジョブを作成する」を参照してください。

7.4.5　キャビネットおよびパッケージの削除

キャビネットまたはパッケージを削除する方法を次に示します。一度削除したキャビネットまたはパッケージを元に戻すことはできませんので注意してください。

［パッケージ］ウィンドウで、削除するキャビネットまたはパッケージを選択し、［編集］−［削除］を選択する。

削除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

削除を再確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

選択したキャビネットまたはパッケージが削除されます。

なお、パッケージング中のパッケージを誤って削除した場合、パッケージングが終了するまでパッケージの「削除」は待ち状態となり、リモートインストールマネージャは「応答なし」状態になります。この場合、リモートインストールマネージャを終了してください。

7.4.6　中継システムおよび管理用中継サーバ上のパッケージの削除

配布管理システムのリモートインストールマネージャから「中継のパッケージ削除」機能を使用して、各パッケージファイルごとのサイズを確認しながら選択して削除できます。手順を次に示します。

［システム構成］または［パッケージ］ウィンドウをアクティブにし、［編集］メニューから［中継のパッケージ削除］を選択する。

［中継のパッケージ削除］ダイアログボックスが表示されます。

接続先名称を設定して、［接続］ボタンをクリックする。

パッケージ一覧が表示されます。

削除するパッケージを選択する。

選択したパッケージが、反転表示され、パッケージ情報（バージョン、パッケージ識別ID、世代番号、容量、満了日付）が表示されます。

［削除］ボタンをクリックする。

削除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

パッケージが削除されます。

7.5　インストールパッケージ情報の削除

インストール済みパッケージ情報を削除する手順を次に示します。

［システム構成］ウィンドウまたは［あて先］ウィンドウの左枠で、インストールパッケージ情報を表示するホストを選択する。

右枠で［インストールパッケージ］タブを選択する。

インストールされているパッケージ情報が表示されます。

情報を削除するパッケージを選択する。

すべてのインストールパッケージ情報を削除したい場合は、ここでパッケージを選択する必要はありません。

［編集］メニューから［インストールパッケージ情報の削除］を選択する。

［インストールパッケージ情報の削除］ダイアログボックスが表示されます。

図7‒50　［インストールパッケージ情報の削除］ダイアログボックス

削除する情報を選択する。

対象インストールパッケージ情報

選択したパッケージ情報が削除対象として表示されます。

すべての情報を削除する場合は、「全インストールパッケージ情報」チェックボックスをオンにしてください。

対象ホスト

インストールパッケージ情報を削除する対象のホストが表示されます。表示する対象がない場合は、「全エージェント」チェックボックスがオンになります。

［対象から外す］ボタン

表示されているインストールパッケージまたはホストを削除の対象から外します。

［対象に戻す］ボタン

一度削除の対象から外したインストールパッケージまたはホストを、再度削除の対象とします。

［OK］ボタンをクリックする。

設定した内容に基づいて、情報が削除されます。

7.6　リモートインストールの運用例

ここでは、さまざまな目的に応じたリモートインストールの運用例について紹介します。

7.6.1　ハードディスクの空き容量などをチェックしてインストールする

リモートインストールの条件として、ハードディスクの空き容量や、実装メモリの状態を設定できます。

特に設定をしなくても、リモートインストールの処理中にハードディスクの容量が不足すると、その情報が管理対象のコンピュータからサーバに通知され、インストール時に使用したワークファイルなどがすべて削除されます。しかし、この場合の空き容量チェックでは余裕値を設けていないため、インストールしたあとに必ず空きができるとは限りません。必要に応じて、インストール処理後に10〜20メガバイト以上の空きが必要であるなどの条件を設定してください。

また、実装メモリの条件を設定すれば、インストールしても動作させられないといった失敗を防げます。

このような条件をシステム条件と呼びます。システム条件は、パッケージャの［JP1/ITDM2 パッケージング］ダイアログボックス、またはリモートインストールマネージャの［インストール条件の変更］ダイアログボックスの、［システム条件］パネルで設定します。

ハードディスクの空き容量をチェックしてインストールする例を次の図に示します。

図7‒51　ハードディスクの空き容量をチェックしてインストールする例

7.6.2　管理対象のコンピュータにインストールされているソフトウェアをチェックしてインストールする

流通ソフトウェアの中には、特定のソフトウェアの、特定のバージョンを前提として動作するというものがあります。このような場合に、特定のソフトウェアがインストールされているかどうかを、バージョンを指定してチェックできます。逆に、特定のソフトウェアが管理対象のコンピュータにない場合だけリモートインストールする、といった条件も設定できます。

このような条件をソフトウェア条件と呼びます。ソフトウェア条件は、パッケージャの［JP1/ITDM2 パッケージング］ダイアログボックス、またはリモートインストールマネージャの［インストール条件の変更］ダイアログボックスの、［ソフトウェア条件］パネルで設定します。

管理対象のコンピュータにインストールされているソフトウェアをチェックしてインストールする例を次の図に示します。

図7‒52　管理対象のコンピュータにインストールされているソフトウェアをチェックしてインストールする例

7.6.3　ユーザ固有の条件でインストールの適否をチェックする

JP1/IT Desktop Management 2では、ハードディスクの容量（システム条件）や、特定のソフトウェアのインストール状態（ソフトウェア条件）など、さまざまな条件を設定してリモートインストールの適否をチェックできます。通常の運用では、JP1/IT Desktop Management 2標準の機能を使用したチェックで十分ですが、ユーザプログラムのインストールでは、ユーザ固有のチェックが必要になる場合があります。例えば、各コンピュータに業務端末の識別IDを設定しておいて、識別IDが条件に合うコンピュータに対してだけリモートインストールを実行するような運用が考えられます。

このような場合に備え、JP1/IT Desktop Management 2では、インストールの直前に外部プログラムを起動させる機能を提供しています。ユーザ固有のインストール条件に合っているかどうかを調べる外部プログラムを、インストール直前に起動させることで、上記のような例外的な運用に対応できます。

インストールの直前に起動させる外部プログラムは、パッケージャの［JP1/ITDM2 パッケージング］ダイアログボックス、またはリモートインストールマネージャの［インストール条件の変更］ダイアログボックスの、［外部プログラム］パネルで指定します。

ユーザ固有の条件でインストールの適否をチェックする例を次の図に示します。

図7‒53　ユーザ固有の条件でインストールの適否をチェックする例

7.6.4　インストールしたソフトウェアの設定を変更する

iniファイルで設定を変更できるソフトウェアをインストールした場合、インストール後でもリモートインストールにより、設定を変更できます。

例えば、「ソフトウェアA」の設定を変更したい場合、次の方法で行います。

ソフトウェアAのサービスをnet stopコマンドで停止します。

設定を変更したiniファイルをリモートインストールで配布します。

ソフトウェアAのサービスをnet startコマンドで開始します。

7.6.5　決められた時刻にインストールする

リモートインストールではネットワーク経由で各コンピュータへソフトウェアを転送してインストールするため、ネットワークの混雑状況などによって、各コンピュータでのインストール時刻がばらつくことがあります。

JP1/IT Desktop Management 2では、あらかじめインストール日時を指定しておくことで、パッケージをいったん管理対象のコンピュータに転送しておき、指定した時刻に一斉にインストールさせることができます。

インストール日時は、パッケージャの［JP1/ITDM2 パッケージング］ダイアログボックス、またはリモートインストールマネージャの［インストール条件の変更］ダイアログボックスの、［スケジュール］パネルで指定します。

決められた時刻にインストールさせる例を次の図に示します。

図7‒54　決められた時刻にインストールする例

7.6.6　配布日時を2段階に分けて設定する

配布管理システム−中継システムまたは管理用中継サーバ間、中継システムまたは管理用中継サーバ−管理対象のコンピュータ間の、それぞれのネットワークの混雑する時間帯を避けてパッケージを転送しようとすると、パッケージの転送日時を別々に設定した方が効率良く転送できる場合があります。このような場合は、いったん「中継までのパッケージの転送」ジョブで中継システムおよび管理用中継サーバまでパッケージを転送しておき、その後「パッケージのインストール」ジョブを実行してください。1度目のジョブの実行日時が配布管理システム−中継システムまたは管理用中継サーバ間、2度目のジョブの実行日時が中継システムまたは管理用中継サーバ−管理対象のコンピュータ間のパッケージの転送日時になります。

ジョブの実行日時は、ジョブ作成時の［ジョブの作成］ダイアログボックスの［スケジュール］パネルで指定します。

配布日時を2段階に分けて設定する例を次の図に示します。

図7‒55　配布日時を2段階に分けて設定する例

さらに、パッケージごとのインストール日時も設定できるので、これを併せると3段階の日時指定ができます。

7.6.7　リモートインストールの失敗による旧バージョンの破壊を防ぐ

リモートインストールでソフトウェアをバージョンアップする場合、リモートインストールに失敗すると、旧バージョンのソフトウェアを破壊することがあります。旧バージョンが破壊されると、再度リモートインストールするまで一時的にそのソフトウェアが利用できなくなります。

これを防ぐために、JP1/IT Desktop Management 2では、パッケージのバックアップ・リストア機能を提供しています。バックアップ・リストア機能を使用すると、リモートインストール実行時に、管理対象のコンピュータが旧バージョンのバックアップを取得します。そして、リモートインストールに失敗した場合に、このバックアップから旧バージョンを回復します。この機能は、パッケージ種別が「ユーザプログラム、データ」のときだけ使用できます。

バックアップ・リストア機能は、パッケージャの［JP1/ITDM2 パッケージング］ダイアログボックスの［バージョンアップ時リストア対象とする］、またはリモートインストールマネージャの［インストール条件の変更］ダイアログボックス−［オプション］パネルの［インストール時障害が発生した場合、バックアップからリストアを行う］で指定します。

リモートインストールの失敗による旧バージョンの破壊を防ぐ例を次の図に示します。

図7‒56　リモートインストールの失敗による旧バージョンの破壊を防ぐ例

7.6.8　障害が発生した中継システムを回避してリモートインストールする

中継システムに障害が発生した場合、この中継システムに接続している管理対象のコンピュータへ、別の中継システムを経由してリモートインストールできます。

経路を変更してリモートインストールするには、［ジョブの作成］ダイアログボックスで、変更後の経路を指定したジョブを作成します。［あて先］パネルで［経路変更］ボタンをクリックし、［ジョブあて先経路変更］ダイアログボックスで変更後の経路を指定してください。

障害が発生した中継システムを回避してリモートインストールする例を次の図に示します。

図7‒57　障害が発生した中継システムを回避してリモートインストールする例

7.6.9　ジョブのパケットの送信量を削減してインストールする（マルチキャスト配布）

「パッケージのインストール」ジョブで大容量のパッケージを多数のコンピュータにインストールさせたい場合、ジョブをマルチキャスト配布するとパケットの送信量を削減できます。

通常のジョブの配布（ユニキャスト配布）では、コンピュータの数が増加すると、上位システムから送信するパケット数も増加します。しかし、ジョブをマルチキャスト配布すると、コンピュータの接続先の上位システムからは1ジョブ分のパケットを送信するだけで、指定した多数のコンピュータへジョブを配布できます。パケットの送信量が削減されるため、ネットワークの負荷を軽減できます。また、ジョブの配布時間も短縮できます。

マルチキャスト配布では、上位システムはマルチキャストグループと呼ばれる概念上のグループにパケットを送信します。パケットは、そのグループに所属する各コンピュータに配信されます。マルチキャストグループは、マルチキャストアドレスというグループ固有のIPアドレスを持っています。上位システムと、マルチキャストグループに参加する各コンピュータには、エージェント設定で同一のマルチキャストアドレスを設定しておきます。

マルチキャスト配布とユニキャスト配布の違いを次の図に示します。

図7‒58　マルチキャスト配布とユニキャスト配布の違い

ジョブのあて先が少ない場合や、パッケージの容量が小さい場合は、マルチキャスト配布するとかえって効率が悪くなります。その場合は、ジョブをユニキャスト配布してください。

マルチキャスト配布を実行するには、ジョブ作成時に、［ジョブの作成］ダイアログボックスの［ジョブの配布属性］パネルで、配布の方式を設定します。マルチキャスト配布をするためのシステム構成と設定については、「3.2　マルチキャスト配布をするための設定」を参照してください。

7.6.10　パッケージを分割して配布する（分割配布）

大容量のパッケージを分割して配布することで、ネットワークの負荷分散を図る運用です。また、分割したパッケージの転送と転送との間にインターバル（転送休止時間）を設定できるので、ネットワークの負荷をさらに軽減できます。パッケージを分割して配布するには、ジョブの作成時に［ジョブの配布属性］パネルの「分割配布する」をチェックしてください。

パッケージを転送する途中に中継システムおよび管理用中継サーバがある場合、パッケージを分割するサイズや転送休止時間は変化します。次のような条件に従って、分割サイズと転送休止時間は変化します。

転送元でジョブ作成時に指定した分割サイズと、転送先のシステムのエージェント設定で指定した分割サイズを比較して、小さい側の分割サイズと転送休止時間が有効になる。

転送元でジョブ作成時に指定した分割サイズと、転送先のシステムのエージェント設定で指定した分割サイズが同じ場合、転送先のシステムで指定した転送休止時間が有効になる。

パッケージを分割して配布する例を次の図に示します。

図7‒59　パッケージを分割して配布する例

なお、パッケージが配布される途中に中継システムおよび管理用中継サーバがある場合は、中継システムおよび管理用中継サーバは常に起動しておく必要があります。

分割配布を途中でやめ、未転送のパッケージを一括して転送し、通常配布で配布を完了させることもできます。これを分割配布の強制完了と呼びます。強制完了になったジョブは、システム直下のシステムから配布先システムに転送されるまで、分割しないでパッケージを一括して転送（通常配布）します。ただし、分割配布の強制完了は、強制完了を実行したシステム直下のすべてのシステムに対し、分割配布中の場合にだけ有効になります。また、中断中および再開中のジョブは強制完了できません。

分割配布の強制完了は、リモートインストールマネージャの［ジョブ実行状況］ウィンドウで、分割配布のジョブを選択状態にして［実行］メニューから［分割配布の強制完了］を実行してください。

なお、強制完了を実行したシステム直下の中継システムおよび管理用中継サーバに対してだけ分割配布を強制完了し、その中継システムおよび管理用中継サーバ下の配布先システムへの分割配布は実行させたい場合、同じパッケージを「中継までのパッケージの転送」ジョブで実行してください。中継システムおよび管理用中継サーバまでの分割配布については、強制完了を実行したこと（通常配布）になり、中継システムおよび管理用中継サーバ下の配布先システムへは分割配布になります。

7.6.11　起動していないコンピュータに対してインストールを実行する

深夜や休日にパッケージを配布したい場合、あて先のコンピュータが起動していないと、リモートインストールが失敗したり、ジョブが実行されなかったりします。JP1/IT Desktop Management 2では、あて先のコンピュータが起動していない場合は、クライアント制御を使ってコンピュータを起動してからジョブを実行できます。起動したコンピュータをシャットダウンする設定もできます。

クライアント制御を使ってあて先のコンピュータを起動するには、ジョブ作成時に［ジョブの作成］ダイアログボックス−［クライアント制御］パネルの［対象のコンピュータが稼働していない場合に起動する］で指定します。また、起動したコンピュータをシャットダウンするには、［ジョブ実行後コンピュータをシャットダウンさせる］で指定します。なお、あて先のコンピュータがUNIXエージェントの場合、［ジョブ実行後コンピュータをシャットダウンさせる］は無効です。

起動していないコンピュータに対してインストールを実行する例を次の図に示します。

図7‒60　起動していないコンピュータに対してインストールを実行する例

［ジョブの作成］ダイアログボックスの［クライアント制御］パネルの設定については、「10.2.6　［クライアント制御］パネルの設定」を参照してください。

7.6.12　実行中のジョブを中断、再開する

ネットワークの空いている時間帯にパッケージの配布を完了させたくても、その時間内に配布が完了しないことがあります。このような場合に、実行中のジョブを中断させることで、ジョブを実行する時間帯を制限できます。中断したジョブは、あとでその続きから再開できます。

ジョブを中断または再開するには、次の方法があります。

配布管理システムから、中継システムおよび管理用中継サーバに中断または再開を指示する

配布管理システムで「ファイル転送の中断」および「ファイル転送の再開」ジョブを実行することで、中継システムおよび管理用中継サーバに対してジョブの中断および再開を指示します。これらのジョブのスケジュールをあらかじめ指定しておくと、業務開始時間になったらパッケージの配布を中断し、業務終了時間を過ぎたら再開する、といった運用ができます。

配布管理システム自身に対して中断または再開を指示する

リモートインストールマネージャの［実行］メニューにある［ファイル転送の中断/再開］から、［中断させる］または［再開させる］を選択することで、リモートインストールマネージャが接続している配布管理システム自身に対して中断または再開を指示します。

配布管理システムでdcmsuspコマンドを実行する

dcmsuspコマンドを利用して中断と再開を自動実行できます。中断指示の対象には、中継システムおよび管理用中継サーバと自システムの両方を指定できます。

これらの方法は併用できます。例えば、中継システムに対して「ファイル転送の中断」ジョブを実行し中断状態にしたあと、dcmsuspコマンドを実行してファイル転送を再開できます。

中断と再開の適用範囲については、「3.1.6(6)(c)　ジョブの中断と再開の適用範囲」を参照してください。

(1)　ジョブの中断、再開とほかの運用との関連

ジョブの中断、再開とほかの運用との関連を次に示します。

マルチキャスト配布との関連

マルチキャスト配布を指定したジョブは中断できません。中継システムを中断状態にしても、そのまま実行されます。ただし、マルチキャスト配布を指定したジョブでも、すでに中断中の「パッケージのインストール」ジョブが1つ以上あるコンピュータに対して実行した場合は中断されます。

分割配布との関連

分割配布を指定したジョブは通常のジョブと同様に中断できます。分割されたパッケージの転送中に中断した場合、再開するとその続きからパッケージが転送されます。中断した時点でさらにパッケージが分割され、再開するまでの間が転送休止時間になります。

クライアント制御との関連

クライアント制御を指定したジョブは通常のジョブと同様に中断できます。クライアント制御を指定したジョブを中断、再開した場合、次のような動作になります。なお、UNIXエージェントの場合、「ジョブ実行後クライアントをシャットダウンさせる」は無効です。

「対象のコンピュータが稼働していない場合に起動する」および「ジョブ実行後クライアントをシャットダウンさせる」を指定した場合

コンピュータの電源がオンになる。

＜ジョブの中断指示＞

コンピュータの電源がオフになる。

＜ジョブの再開指示＞

コンピュータの電源がオンになる。

ジョブが完了する。

コンピュータの電源がオフになる。

「対象のコンピュータが稼働していない場合に起動する」を指定した場合

コンピュータの電源がオンになる。

＜ジョブの中断指示＞

コンピュータの電源はオンのままとなる。

＜ジョブの再開指示＞

ジョブが完了する。

コンピュータの電源はオンのままとなる。

「ジョブ実行後クライアントをシャットダウンさせる」を指定した場合

ジョブ実行中。

＜ジョブの中断指示＞

コンピュータの電源がオフになる。

＜ジョブの再開指示＞

コンピュータの電源はオフのまま、ジョブは再開されない。

(2)　ジョブの中断中にPCを経路変更した場合の動作

ジョブの中断中にPCを経路変更した場合の動作を次に示します。

中断状態の中継システムおよび管理用中継サーバを経路変更した場合、中断状態は解除されないで、中断中のジョブがそのまま残ります。ジョブの結果は変更前の経路で上位システムに通知されます。

中断中のジョブがあるコンピュータを経路変更した場合、すでにコンピュータに転送されたファイルは削除されます。

7.6.13　中断中にジョブを配布する

あるパッケージを早急に配布したくても、すでにほかの配布ジョブが実行待ちだったり実行中だったりすると、すぐには配布されません。このような場合、ほかのジョブを中断中にし、早急に配布したいパッケージを優先して配布するジョブにすることで、ほかのジョブより先にパッケージを配布できます。なお、中断中でない場合は、配布される順序は通常のジョブと同じです。

ジョブを中断中でも配布するには、ジョブの作成時に［ジョブの配布属性］パネルで「中断中でも配布する」を選択します。「中断中でも配布する」を選択したジョブは、選択しなかったジョブとは別のアイコンでリモートインストールマネージャに表示されます。また、コマンドを利用して中断中でも配布するジョブを自動で実行したい場合は、次の方法があります。

パラメタファイルまたはコマンドの引数で、中断中でも配布するよう指定してdcminstコマンドを実行する。

あらかじめリモートインストールマネージャで「中断中でも配布する」を選択したジョブを作成、保存しておき、dcmjexeコマンドでそのジョブを実行する。

中断中のジョブ配布とほかの運用との関連を次に示します。

マルチキャスト配布との関連

マルチキャスト配布を指定したジョブは中断できません。そのため、中断中でも配布するかどうかの選択は、マルチキャスト配布を指定したジョブでは効果がありません。

分割配布との関連

分割配布を指定したジョブは、中断中でも配布する指定はできません。

7.6.14　2ギガバイトを超えるファイルを配布する

2ギガバイトを超えるファイルを管理対象のコンピュータに配布する場合は、管理者のコンピュータでファイルを分割してパッケージを作成します。Windowsエージェントの場合の手順を、次に示します。

パッケージ登録用のキャビネットを作成する。

管理者のコンピュータで、リモートインストールマネージャまたはdcmpackコマンドを使用して、分割するファイルをパッケージ登録するためのキャビネットを新規作成します。リモートインストールマネージャの実行手順については、「7.4　キャビネットとパッケージの管理」を参照してください。

ファイル分割・パッケージングを実行する。

dcmpackコマンドを実行して配布対象ファイルを分割します。

コマンドが正常終了すると、指定したパラメタファイルの情報をもとに分割したファイルをパッケージングして、配布管理システムに登録されます。

dcmpackコマンドの詳細については、「14.9　dcmpack.exe（パッケージングの実行）」を参照してください。なお、コマンドの引数で指定するパラメタファイルには、インストール後に起動する外部プログラムとしてcatAndValidatePackagingFileコマンドを指定してください。

なお、コマンドが正常終了すると、一時ファイル領域のフォルダは自動的に削除されます。

リモートインストールジョブを実行する。

リモートインストールマネージャまたはdcminstコマンドを使用して、配布先のコンピュータに手順2でパッケージングしたファイルをそれぞれ配布します。リモートインストールマネージャの実行手順については、「7.3　リモートインストールの実行」を参照してください。

配布先のコンピュータに上記の手順でパッケージングされたファイルが配布されると、自動的にcatAndValidatePackagingFileコマンドによって、分割されたファイルを結合します。コマンドの詳細については、「14.18　catAndValidatePackagingFile.exe（分割ファイルの結合）」を参照してください。

(1)　配布先のコンピュータのJP1/IT Desktop Management 2 - Agentのバージョンが11-50以前の場合

配布先のコンピュータのJP1/IT Desktop Management 2 - Agentのバージョンが11-50以前の場合、ファイル結合コマンドを配布先のコンピュータに事前に配布しておいてください。配布手順を次に示します。

ファイル結合コマンドをパッケージングする。

バージョン11-51のJP1/IT Desktop Management 2エージェントで、ファイル結合コマンドをパッケージングして登録します。

次の格納先にあるファイル結合コマンドをパッケージングしてください。

JP1/IT Desktop Management 2 - Agentのインストール先フォルダ¥tools¥distribute¥catAndValidatePackagingFile

パッケージングでは次の属性を設定します。

パッケージ属性

値

パッケージング情報

任意

システム条件

インストール先には、エージェントのインストールフォルダ以外を指定します。

ソフトウェア条件

ソフトウェア名「JP1/IT Desktop Management 2 - Agent」のバージョンが"11.5.1.0000"より小さい

パッケージ条件

このパッケージがインストールされていない。

ファイル属性

任意

スケジュール

任意

インストール方法

任意

オプション

任意

外部プログラム

任意

リモートインストールジョブを実行する。

リモートインストールマネージャまたはdcminstコマンドを使用して、配布先のコンピュータにパッケージングしたファイル結合コマンドを配布します。

(2)　Windows 10の大型アップデートプログラムを配布する例

例として、Windows 10の大型アップデートプログラムを配布する場合について説明します。

Windows 10アップデートプログラムを入手する。

アップデートプログラムの入手方法については、OSのマニュアルを参照してください。

アップデート対象のコンピュータを抽出する。

アップデート対象のコンピュータ（Windows 10アップデートプログラムが適用されていないPC）を抽出し、グルーピングします。

アップデートプログラムを展開する。

管理者のコンピュータで、Windows 10のアップデートファイル（ISOイメージ）をドライブとしてマウントします。ISOイメージのファイルをドライブとしてマウントする方法については、OSのマニュアルを参照してください。

パッケージ登録用のキャビネットを作成する。

分割するファイルをパッケージ登録するためのキャビネットを、新規作成します。

ファイル分割・パッケージングを実行する。

dcmpackコマンドを実行して、配布対象ファイルを分割します。アップデートプログラムのISOファイルのマウントドライブが「E:¥」、パラメタファイルが「C:¥para.txt」の場合の実行例を次に示します。

dcmpack /k password /i C:¥para.txt /split /tempdir C:¥temp

パラメタファイル（C:¥para.txt）の内容

PACKAGING_SOURCE{
base_fullpath= E:
}
PACKAGING_INFORMATION
{
package_name=Windows10FCU
package_id=FD200304
version_revision=000001
generation=0000
cabinet_name=FCAB01
cabinet_id=F1
package_code=P
}
SYSTEM_CONDITIONS{
condition=H:c>=3072
directory=C:¥Temp¥windows
}

注　conditionには配布したファイルのファイルサイズ以上の値を指定してください。

dcmpackコマンドを実行すると、分割したファイルがパッケージとして配布管理システムに登録されます。

セットアップスクリプトを作成し、パッケージングする。

アップデートプログラムを配布先のコンピュータに配布したあと、Windows 10のセットアッププログラムを実行するためのスクリプトを作成し、パッケージングします。

セットアップスクリプトの例を次に示します。

@echo off
"C:¥Program Files¥HITACHI¥jp1itdma¥bin¥catAndValidatePackagingFile" /d "C:¥Temp¥Windows"
if not exist C:¥Temp¥Windows¥setup.exe (
  echo setup.exe not found.
  exit /b 10
)
C:¥Temp¥Windows¥setup.exe /auto upgrade /quiet /showoobe none

セットアップスクリプトを「C:¥temp¥setupfcu.bat」で作成した場合は、次の表に示す設定内容でパッケージとして配布管理システムに登録します。

パッケージ属性

項目

値

パッケージング情報

パッケージ名

任意

パッケージ識別ID

FD200304_255※

バージョン/リビジョン

000001

世代番号

0000

パッケージ種別

ユーザプログラム、データ

キャビネット名

FCAB01

キャビネット識別ID

F1

システム条件

インストール先フォルダ

C:¥temp

外部プログラム

インストール後起動外部プログラム

C:¥temp¥setupfcu.bat

注※　手順5で登録されたパッケージ識別IDを確認し、そのパッケージ識別IDより大きい値を指定してください。

リモートインストールを実行する。

リモートインストールマネージャまたはdcminstコマンドを使用して、配布先のコンピュータに、手順5および手順6のパッケージをそれぞれ配布します。

配布先のコンピュータに手順5および手順6でパッケージングされたファイルが配布されると、手順6で作成したセットアップスクリプトに従ってcatAndValidatePackagingFileコマンドが実行されます。そのあとWindows 10アップデートプログラムが実行されます。

7.6.15　配布用の上位システムを自動で切り替えてファイルを配布する

コンピュータの配布用の上位システム（中継システム）に障害が発生しているなどの理由で接続できない場合、マルチポーリング環境を設定することで、別の中継システム、または、さらに上位の管理用中継サーバに接続先を切り替えられます。このとき、中継システムにID登録されているコンピュータの情報は、自動的に別の中継システム、または、管理用中継サーバにID登録されるように構築できます。

本来の配布用の上位システムである中継システムが復旧して接続できるようになると、接続先が中継システムに変更され、ID登録も中継システムに変更されます。

あらかじめ、エージェント設定の［通信設定］−［複数の上位システムへのポーリングの設定］で、配布用の上位システムを設定する必要があります。また、次の設定をする必要があります。

［複数の上位システムへのポーリング形態］で［ホットスタンバイ］を選択する

［システム起動時に、[優先順]に従ってポーリングする］を選択する

［一定時間ポーリングに失敗する場合は配布用の上位システムを切り替える］をチェックする

［n時間後に切り替える］に、配布用の上位システムを切り替えるまでの時間を指定する

重要

配布用の上位システムを自動で切り替えてファイルを配布する場合の注意事項を次に示します。

中継システムの上位システム（管理用サーバ）を切り替えることはできません。

同じ管理用中継サーバの配下にある中継システムにだけ接続先を切り替えられます。別の管理用中継サーバの配下にある中継システムには接続先を切り替えられません。

接続先が自動で切り替えられた場合、接続先設定ファイル（itdmhost.conf）および上位接続先情報ファイル（dmhost.txt）の内容や、エージェント設定の［通信設定］−［複数の上位システムへのポーリングの設定］で指定する［ポーリング対象とする上位システム］の設定内容は変更されません。

インストールされているエージェントがJP1/IT Desktop Management 2 - Agent 12-00より前のバージョンの場合に配布用の上位システムを切り替える設定をしても、上位システムは切り替わりません。

IDジョブでファイルを配布中に配布用の上位システムが切り替わった場合、切り替わった上位システムから改めてファイルが配布されます。元の配布用の上位システムに切り替わった時、ダウンロードが中断されて残っているファイルは削除されます。

元の配布用の上位システムが故障やリプレースなどでエージェントにダウンロード中のファイルが残っている場合、元の配布用の上位システムと同じホスト名で中継システムを構築して、ダウンロード中のファイルを削除してください。

エージェント設定の変更が反映されるタイミングについて次に示します。

・［n時間後に切り替える］を変更した場合、配布用の上位システムが優先順位1の場合はポリシー反映時に時間の設定が有効となります。配布用の上位システムが優先順位2以降の場合、優先順位1の上位システムに戻った際に有効となります。

なお、切り替えまでの基準時刻は変更前から変更されません。

・［ポーリング対象とする上位システム］の優先順位を変更または上位システムを入れ替え・削除した場合、上位システムの設定はポリシー反映時に有効となりますが、変更前の配布用の上位システムは保持されます。このため、配布用の上位システムが優先順位1に戻るまでは［n時間後に切り替える］に指定した時間切り替えを待たない動作となります。

・［一定時間ポーリングに失敗する場合は配布用の上位システムを切り替える］のチェックを外した場合、優先順位1の配布用の上位システムと接続可能になった後、エージェントのコンピュータを再起動したタイミングでマネージャにシステム構成が反映されます。

メモ

配布用の上位システムを自動で切り替えてファイルを配布する場合、次の機能を使用します。詳細はそれぞれの参照先を参照してください。

表7‒3　配布用の上位システムを自動で切り替えてファイルを配布する場合に使用する機能

機能名

参照先

エージェントのマルチポーリング環境

3.4.2

エージェントの接続先の自動変更

3.4.3

IDを使用する配布

5.3

システム構成情報とIDを連携させる運用

5.4

配布用の上位システムを自動で切り替えてファイルを配布する運用例を次の図に示します。

この例では、管理対象コンピュータ（Clt01）のマルチポーリング環境の設定として、次の優先順位でポーリング対象とする上位システムが設定されています。

中継システム（Sub01）

管理用中継サーバ（Man01）

図中の番号に従って説明します。

(1)

管理対象コンピュータ（Clt01）の上位システムである中継システム（Sub01）が停止中のため、ポーリングに失敗します。

(2)

一定時間※ポーリングに失敗すると、管理対象コンピュータ（Clt01）はさらに上位の管理用中継サーバ（Man01）にポーリングします。ポーリングに成功すると、上位システムを管理用中継サーバ（Man01）に切り替えます。

注※

エージェント設定の［通信設定］−［複数の上位システムへのポーリングの設定］で、［n時間後に切り替える］に指定した時間です。

(3)

管理対象コンピュータ（Clt01）の上位システムが切り替えられたため、管理用中継サーバ（Man01）のシステム構成情報に管理対象コンピュータ（Clt01）が追加されます。これに連携して、IDの情報が変更されます。

これで、管理用中継サーバ（Man01）から管理対象コンピュータ（Clt01）に配布されるようになります。

(4)

中継システム（Sub01）が再開すると、管理対象コンピュータ（Clt01）は上位システムを中継システム（Sub01）に切り替えます。

(5)

管理対象コンピュータ（Clt01）の上位システムが切り替えられたため、中継システム（Sub01）のシステム構成情報に管理対象コンピュータ（Clt01）が追加されます。これに連携して、IDの情報が変更されます。

(6)

中継システム（Sub01）からのシステム構成情報変更を検知した管理用中継サーバ（Man01）では、システム構成情報が変更されます。これに連携して、IDの情報が変更されます。

これで、中継システム（Sub01）経由で管理対象コンピュータ（Clt01）に配布されるようになります。

8　更新プログラムを管理する

ここでは、Windowsの更新プログラムをリモートインストールマネージャでパッケージングして配布する方法について説明します。

8.1　クライアントに適用する更新プログラムの取得

ここでは、JP1/IT Desktop Management 2でWindowsの更新プログラムを取得する方法について説明します。

また、取得した更新プログラムを自動的にパッケージングする方法についても説明します。

8.1.1　更新プログラムの取得

Windowsの更新プログラムは、［更新プログラムの管理］ダイアログボックスから取得します。［更新プログラムの管理］ダイアログボックスでは、Microsoft社から提供されている更新プログラムを一覧表示し、任意の更新プログラムを取得できます。

注意事項

Windows 10のFeature Updateは、Microsoft社のサイトで提供されているISOファイルを手動でダウンロードしてください。

［更新プログラムの管理］ダイアログボックスの表示方法を次に示します。

リモートインストールマネージャを起動する。

［オプション］−［更新プログラムの管理］を選択する。

［更新プログラムの管理］ダイアログボックスが表示されます。

図8‒1　［更新プログラムの管理］ダイアログボックス

更新プログラム一覧

取得できる更新プログラムおよび取得済みの更新プログラムが一覧で表示されます。デフォルトはリリース日、言語、および更新プログラムIDの降順に表示されます。ラベルをクリックすることで、項目の並びを昇順または降順にソートできます。

［表示設定］ボタン

［表示設定］ダイアログボックスが表示され、「更新プログラム一覧」で表示する項目を設定できます。

［パッケージ］ボタン

「更新プログラム一覧」で選択した更新プログラムをパッケージングします。

［説明］タブ

「更新プログラム一覧」で選択した更新プログラムの説明を表示します。

［詳細］タブ

「更新プログラム一覧」で選択した更新プログラムの詳細情報を表示します。

［セットアップ］ボタン

更新プログラムを取得する接続先、更新プログラムの自動取得およびパッケージングの設定をします。

［閉じる］ボタン

ダイアログボックスを閉じます。

ここでは、更新プログラムを取得するための設定、更新プログラムの取得方法および削除方法について説明します。

(1)　更新プログラム取得時のネットワークの設定

更新プログラムを取得するために、インターネットへの接続方法など、ネットワークの情報を設定しておく必要があります。

更新プログラム取得時のネットワークの情報は、［更新プログラムの管理］ダイアログボックスから表示する、［ネットワーク設定］パネルで設定します。［ネットワーク設定］パネルの表示方法を次に示します。

［セットアップ］ボタンをクリックする。

［セットアップ］ダイアログボックスが表示されます。

［ネットワーク設定］タブを選択する。

［ネットワーク設定］パネルが表示されます。

図8‒2　［ネットワーク設定］パネル

［ネットワーク設定］パネルでの設定内容について説明します。

(a)　接続設定

インターネットへの接続および更新プログラム取得時の接続を設定します。

プロキシサーバ経由でインターネットに接続する

プロキシサーバを利用してインターネットに接続する場合、チェックボックスをオンにしてください。

デフォルトはチェックボックスがオフです。

インターネットオプションの接続設定を利用する

Internet Explorerのインターネットオプションの設定で更新プログラムを取得する場合に選択します。デフォルトで選択されています。

プロキシサーバを指定する

プロキシサーバを指定して更新プログラムを取得する場合に選択します。この項目を選択した場合は、プロキシサーバのIPアドレスとポート番号を指定してください。

認証情報

「アドレス」に指定したプロキシサーバの認証に使用するユーザ名とパスワードを指定します。ユーザ名は260文字以内、パスワードは30文字以内で指定してください。プロキシサーバの認証設定がない場合、指定する必要はありません。

(b)　通信設定

通信エラーが発生した場合の対処について設定します。

通信エラー発生時のリトライ間隔

データの転送中にエラーが発生した場合のリトライ間隔を1〜7,200秒で指定します。デフォルトは5秒です。

通信エラー発生時のリトライ回数

データの転送中にエラーが発生した場合のリトライ回数を0〜999回で指定します。デフォルトは5回です。0回を指定した場合、リトライは実行されません。

［通信エラー発生時のリトライ間隔］ごとに、ここで指定した回数分リトライします。

通信エラーのタイムアウト時間

データの転送中にエラーが発生した場合のタイムアウト時間を0〜60秒で指定します。デフォルトは20秒です。0秒を指定した場合は、OSでのタイムアウト時間が適用されます。

(2)　更新プログラムの一覧を更新する

「更新プログラム一覧」に表示されている更新プログラムの情報を更新するには、サポートサービスサイトから更新プログラム情報を取得します。詳細は、マニュアル「JP1/IT Desktop Management 2 運用ガイド」のサポートサービスと接続するための情報を設定する手順についての説明を参照してください。

更新プログラム情報の取得に成功すると、「更新プログラム一覧」に表示されている更新プログラムの情報が更新されます。

なお、取得した更新プログラム情報のバージョンは、「更新プログラム情報のバージョン」に表示されます。

8.1.2　更新プログラムのパッケージング

［更新プログラムの管理］ダイアログボックスで取得した更新プログラムをパッケージングできます。更新プログラムをパッケージングするには、あらかじめパッケージング時に設定される情報を設定しておく必要があります。

ここでは、パッケージングの設定と更新プログラムをパッケージングする方法について説明します。

(1)　パッケージングの設定

更新プログラムをパッケージングするときに設定されるパッケージの情報を設定します。

［更新プログラムの管理］ダイアログボックスで更新プログラムをパッケージングする場合、1つのパッチにつき、1つのパッケージが作成されます。

更新プログラムをパッケージングする場合、パッケージ名およびパッケージ識別IDは自動で設定されます。

セキュリティ更新プログラムの場合

パッケージ名

Windows 10以外のOSまたはWindows 10 1511より前のバージョンの場合、「DPT-拡張子を除いたファイル名」が設定されます。

Windows 10 1511以降のバージョンの場合、「DPT-拡張子を除いたファイル名-バージョン」が設定されます。

拡張子を除いたファイル名が47文字以上の場合、47文字目以降は削除されます。

ファイル名に「.」（ピリオド）が含まれる場合、「_」（アンダースコア）に変換されます。

パッケージ識別ID

大文字に変換したパッケージ名が指定されます。ただし、パッケージ名が45文字以上の場合、45文字目以降は削除されます。

Windows 10のFeature Updateの場合

パッケージ名

「DPT-Windows10-FU-バージョン-CPUアーキテクチャ-言語_通番」が設定されます。

パッケージ識別ID

大文字に変換したパッケージ名が指定されます。ただし、パッケージ名が45文字以上の場合、45文字目以降は削除されます。

パッケージの情報は、［更新プログラムの管理］ダイアログボックスから表示する、［パッケージング設定］パネルで設定します。［パッケージング設定］パネルの表示方法を次に示します。

［セットアップ］ボタンをクリックする。

［セットアップ］ダイアログボックスが表示されます。

［パッケージング設定］タブを選択する。

［パッケージング設定］パネルが表示されます。

図8‒3　［パッケージング設定］パネル

［パッケージング設定］パネルでの設定内容について説明します。

(a)　キャビネット名

パッケージが格納されるキャビネット名の設定方法を選択します。

更新プログラムのリリース日から自動で設定する

Microsoft社から更新プログラムが提供された西暦と、月の数字の組み合わせでキャビネット名が設定されます。例えば、2019年9月の場合は「201909」が設定されます。この項目はデフォルトで選択されています。

任意の値を設定する

任意のキャビネット名を指定したい場合に選択します。

キャビネット名を1〜16文字で指定します。ただし、次の記号およびスペースは指定できません。

「¥」「/」「*」「"」「:」「;」

(b)　キャビネット識別ID

パッケージが格納されるキャビネットの、キャビネット識別IDの設定方法を選択します。

更新プログラムのリリース日から自動で設定する

自動的にキャビネット識別IDを設定したい場合に選択します。

Microsoft社から更新プログラムが提供された西暦の下1けたと、1月〜12月をA〜Lで示した値の組み合わせでキャビネット識別IDが設定されます。例えば、2019年9月の場合は「9I」が設定されます。この項目はデフォルトで選択されています。

任意の値を設定する

任意のキャビネット識別IDを指定したい場合に選択します。

キャビネット識別IDを2文字の半角英数字で指定します。

なお、設定されたキャビネット識別IDと同じIDのキャビネットが存在する場合、生成されたパッケージは既存のキャビネットに格納されます。その際、更新プログラムの管理画面上の格納先キャビネット名称には［パッケージング設定］パネルで設定したキャビネット名称が表示されます。

(c)　パッケージバージョン/リビジョン

パッケージのバージョン/リビジョンを指定します。

バージョン/リビジョン

バージョン/リビジョンを1〜6文字の半角英数字および「/」で指定します。デフォルトは「0000」です。

(d)　パッケージ世代番号

パッケージの世代番号を指定します。

世代番号

パッケージの世代番号を1〜4文字の半角英数字で指定します。デフォルトは「0000」です。

(e)　インストール先ディレクトリ

インストール先ディレクトリを指定します。

ディレクトリ

インストール先ディレクトリを32文字以内で指定します。デフォルトは「C:¥ITDMWK_DPT」です。

(2)　パッケージングの実行

(a)　更新プログラムのパッケージング

取得済みの更新プログラムをパッケージングするには、「更新プログラム一覧」でパッケージングしたい更新プログラムのチェックボックスをオンにして、［パッケージ］ボタンをクリックします。複数の更新プログラムを選択してパッケージングすることもできます。

表示されている更新プログラムは、次の表に示すステータスアイコンで過去にパッケージングしたことがあるかどうかを確認できます。

表8‒1　各ステータスアイコンのパッケージング状況

項番

ステータスアイコン

パッケージング状況

1

過去にパッケージングしたことがない

2

過去にパッケージングしたことがある

未取得の更新プログラムを選択して［パッケージ］ボタンをクリックした場合、更新プログラムを取得してからパッケージングします。

なお、リモートインストールマネージャのインストール後、初めてパッケージングする場合、事前にパッケージャを起動してログインしておく必要があります。一度ログインしたあとは、パッケージャは終了してかまいません。

更新プログラムのパッケージングが開始されると、パッケージングの状況を示すダイアログボックスが表示されます。パッケージングが完了した項目から、［パッケージング設定］パネルでの設定に従ってパッケージが作成されます。パッケージングを中止する場合は、ここで［キャンセル］ボタンをクリックしてください。実行中のパッケージングが完了したら、それ以降はパッケージングされないまま完了します。なお、キャビネットに同名のパッケージがある場合は、そのパッケージは作成されないままパッケージングが続行します。

パッケージングが完了すると、結果を示すダイアログボックスが表示されます。

メモ

取得した更新プログラムは、パッケージングの実行後に削除されます。

(b)　Windows 10のFeature Updateのパッケージング

Windows 10のFeature Updateをパッケージングする場合、あらかじめFeature UpdateのISOファイルをMicrosoft社のサイトからダウンロードします。その後、「更新プログラム一覧」でパッケージングしたい更新プログラムのチェックボックスをオンにして、［パッケージ］ボタンをクリックします。［機能更新プログラムのパッケージ］ダイアログが表示されます。

注意事項

Windows 10のFeature Updateは1つだけ選択できます。

図8‒4　［機能更新プログラムのパッケージ］ダイアログ

［機能更新プログラムのパッケージ］ダイアログの設定内容を次に示します。

機能更新プログラムのISOファイル

ダウンロードしたFeature UpdateのISOファイルを指定します。

言語およびCPUアーキテクチャを含め、「更新プログラム一覧」でチェックボックスをオンにした更新プログラムに対応するISOファイルを指定してください。

キャビネット名

キャビネット名を1〜16文字で指定します。ただし、次の記号およびスペースは指定できません。

「¥」「/」「*」「"」「:」「;」

キャビネット識別ID

キャビネット識別IDを2文字の半角英数字で指定します。

［機能更新プログラムのパッケージ］ダイアログの［OK］ボタンをクリックすると、Feature Updateのパッケージングが実行されます。

パッケージングが完了すると、結果を示すダイアログボックスが表示されます。

(3)　パッケージングした更新プログラムの配布

更新プログラムのパッケージングが完了すると、指定したキャビネットにパッケージが保管されます。パッケージには、更新プログラムをインストールするためのスクリプトファイルが自動的に設定されます。スクリプトファイルの内容を次に示します。必要に応じて設定を変更してください。

サイレントインストール

更新プログラムのインストール中には、インストーラのダイアログボックスは表示されません。また、リモートインストール中を示すダイアログボックスも表示されません。

再起動の抑止

パッケージは、配布完了時にクライアントが再起動されない設定になっています。クライアントで更新プログラムをインストールしたあとに再起動を実行したい場合は、パッケージの設定で、「インストール後コンピュータを再起動する」チェックボックスをオンにしてから配布してください。

インストール後の更新プログラム実行ファイルの削除

クライアントで更新プログラムのインストールが完了すると、更新プログラムの実行ファイルが削除されます。

また、パッケージには［パッケージング設定］パネルで設定したインストール先ディレクトリ、およびインストール後起動外部プログラムには、スクリプトファイルが指定されています。これによって、特別な設定をすることなくパッケージを配布することで、クライアントにパッチを適用できます。

特定の更新プログラムを配布する場合、その更新プログラムが未適用のクライアントであて先グループを作成しておくことで、不要なジョブを実行することなく更新プログラムを配布できます。配布したい更新プログラムが未適用のクライアントをグルーピングして、更新プログラムを配布する手順を次に示します。

目的の更新プログラムが適用されていないコンピュータを確認する。

セキュリティ画面の［更新プログラム一覧］画面の［未適用コンピュータ］タブで、更新プログラムごとに未適用のコンピュータを確認します。詳細は、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」の更新プログラムの適用状況の確認についての説明を参照してください。

目的の更新プログラムが適用されていないコンピュータのあて先グループを作成する。

あて先グループの作成方法についての詳細は、「5.2　あて先グループを作成する」を参照してください。

作成したあて先グループに対して更新プログラムを配布する。

また、パッケージングまたはクライアントへの配布が完了した更新プログラムのパッケージのうち、不要と判断できるパッケージは、データベースの容量を確保するために削除しておくことをお勧めします。

重要

Windows 10のFeature Updateは容量が大きい更新プログラムのため、業務時間中に配布するとネットワークに負荷を与えます。夜間にコンピュータを起動して配布することを推奨します。また、一晩で配布が完了する単位にあて先を分割して実行してください。

8.1.3　更新プログラムの自動取得

パッチ情報ファイルの取得、更新プログラムの取得およびパッケージングを自動で実行できます。ただし、自動的に取得できる更新プログラムは、パッケージング実行時から60日前までのOSの更新プログラムだけです。

更新プログラムの自動取得は、次の流れで実行されます。

サポートサービスサイトからパッチ情報ファイルが取得される。

取得する更新プログラムの設定に従って、更新プログラムが取得される。

パッケージングの設定に従って、更新プログラムがパッケージングされる。

更新プログラムのパッケージングの設定については、「8.1.2(1)　パッケージングの設定」を参照してください。

更新プログラムを自動取得する前に、［自動設定］パネルで取得する更新プログラムの設定を完了しておく必要があります。ここでは、取得する更新プログラムの設定について説明します。

(1)　取得する更新プログラムの設定

自動的に更新プログラムを取得してパッケージングする場合、取得する更新プログラムの種類をあらかじめ設定しておく必要があります。

自動的に取得する更新プログラムの種類は、［更新プログラムの管理］ダイアログボックスから表示する、［自動設定］パネルで設定します。

［自動設定］パネルの表示方法を次に示します。

［セットアップ］ボタンをクリックする。

［セットアップ］ダイアログボックスが表示されます。

［自動設定］タブを選択する。

［自動設定］パネルが表示されます。

図8‒5　［自動設定］パネル

［自動設定］パネルでの設定内容について説明します。

更新プログラムを自動でダウンロードおよびパッケージングする

更新プログラムを自動でダウンロードおよびパッケージングする場合にチェックボックスをオンにしてください。デフォルトはチェックボックスがオフです。

パッケージ・ダウンロードの実行時刻

更新プログラムを自動でダウンロードおよびパッケージングする時刻を設定します。デフォルトはUTCの「0時0分」です。

対象製品

取得する更新プログラムの対象OSを選択します。

更新プログラムの自動取得が実行されると、ここで選択したOSの更新プログラムが取得されます。デフォルトでは、すべて選択されています。

クラス

取得するパッチのクラスを選択します。デフォルトでは、「重要な更新」と「セキュリティ問題の修正プログラム」が選択されています。

(2)　更新プログラムの自動取得の実行

［自動設定］パネルでの設定内容に従い、更新プログラムの自動取得を実行します。

更新プログラムの自動取得でエラーが発生した場合の詳細情報は、「JP1/IT Desktop Management 2のインストール先ディレクトリ¥LOG¥DPT.LOG」に出力されます。DPT.LOGの形式を次に示します。

図8‒6　DPT.LOGの形式

DPT.LOGに出力されるログの要因と対処を次の表に示します。

表8‒2　パッチ取得時に出力されるログの要因と対処

メッセージID

メッセージテキスト

要因

対処

DPT006-E

Another instance of the application is already running.

すでに［更新プログラムの管理］ダイアログボックスが起動されています。

リモートインストールマネージャから［更新プログラムの管理］ダイアログボックスを開いている場合は、［更新プログラムの管理］ダイアログボックスを閉じてください。リモートインストールマネージャから［更新プログラムの管理］ダイアログボックスを開いていない場合は、しばらくしてから、再度［更新プログラムの管理］ダイアログボックスを開いてください。

DPT101-E

Database connection failed. Reason: データベースのエラーメッセージ

データベースへの接続に失敗しました。

管理用サーバが起動しているか確認してください。

管理者ユーザIDまたはパスワードをサーバセットアップで確認してください。

DPT102-E

Error occurred while accessing database. Reason: データベースのエラーメッセージ

データベースへのアクセス中にエラーが発生しました。

管理用サーバとの通信環境を確認してください。

管理用サーバが起動されているか確認してください。

DPT103-E

Unable to get a DSN to connect or DSN invalid. Reason: データベースのエラーメッセージ.

データソースの取得に失敗した、またはデータソースが不正であるおそれがあります。

リモートインストールマネージャ起動後に再実行してください。

DPT204-E

Unable to configure the proxy settings.

プロキシサーバへの接続に失敗しました。

［ネットワーク設定］パネルの、プロキシサーバの設定を確認してください。

DPT205-E

Error in network settings information. Unable to connect to the internet.

ネットワークへの接続に失敗しました。

［ネットワーク設定］パネルの、ネットワーク接続の設定を確認してください。

DPT207-E

Unable to store the downloaded information in the file system.

ファイルのダウンロードに失敗しました。

ハードディスクに空き容量があることを確認してください。

JP1/IT Desktop Management 2 - Managerのインストール先ディレクトリに書き込み権限があることを確認してください。

DPT209-E

'サーバ名' login failure.

サーバへのログインに失敗しました。

［ネットワーク設定］パネルで、該当するサーバの認証情報を確認してください。

DPT254-E

Unable to establish connection with the JP1/ITDM2 - Manager.

パッケージャで、サーバへの接続に失敗しました。

パッケージャの接続先の設定を確認してください。

ネットワークに接続されていることを確認してください。

DPT255-E

Unable to communicate with the JP1/ITDM2 - Manager.

パッケージャで、サーバへの接続中にエラーが発生しました。

ネットワークに接続されていることを確認してください。

DPT256-E

Unable to transfer the file to the JP1/ITDM2 - Manager.

パッケージング中にネットワークが切断されたおそれがあります。

ネットワークに接続されていることを確認してください。

DPT257-E

Package 'パッケージ名' already exists.

パッケージの格納先キャビネットに、同じパッケージ識別IDのパッケージが存在するおそれがあります。

格納先のキャビネットに、同じパッケージ識別IDのパッケージが存在するか確認してください。存在する場合は、該当するパッケージを削除するか、格納先キャビネットを変更してください。

DPT258-E

Invalid password specified for JP1/ITDM2 - Manager login.

パッケージャで、サーバへの接続に失敗しました。

リモートインストールマネージャを再起動してください。

DPT260-E

Unable to execute the command 'パッケージングのコマンド名のフルパス'.

パッケージャの起動に失敗しました。

パッケージャがインストールされているか確認してください。インストールされていない場合は、パッケージャをインストールしてください。

DPT264-E

The packaging processing will now stop because an error occurred.

パッケージングに失敗しました。

ハードディスクの空き容量を確認してください。

［パッケージング設定］パネルの［ファイル分割作業フォルダ］で指定したフォルダに、書き込み権限があることを確認してください。

(3)　セキュリティポリシーによる更新プログラムの自動取得の無効化について

リモートインストールマネージャを使用して更新プログラムの自動取得・配布を行う場合は、セキュリティポリシーによる更新プログラムの自動取得を無効化することで、管理用サーバのリソース使用量を軽減できます。セキュリティポリシーによる更新プログラムの自動取得については、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」の更新プログラムの管理の説明を参照してください。

セキュリティポリシーによる更新プログラムの自動取得を無効化する場合は、コンフィグレーションファイル（jdn_manager_config.conf）のMgrsrv_Patch_AutoPackageKindプロパティに0を指定してください。Mgrsrv_Patch_AutoPackageKindプロパティの詳細については、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」のプロパティ一覧を参照してください。

9　管理対象のコンピュータのファイルを収集する

ここでは、管理対象のコンピュータからファイルを収集（リモートコレクト）する方法について説明します。

9.1　リモートコレクトの操作

ここでは、配布管理システムでリモートコレクトを指示するジョブを作成し、実行する方法、およびアンアーカイバを使用してファイルを復元する方法について説明します。

9.1.1　リモートコレクトの実行

リモートコレクトは、リモートインストールマネージャから実行します。リモートインストールマネージャは、Windowsの［スタート］メニューから［JP1_IT Desktop Management 2 - Manager］−［リモートインストールマネージャ］を選択して起動します。

(1)　ジョブの作成と実行

リモートコレクト時の、ジョブの作成手順を次に示します。操作および設定内容の詳細については、「10.2　ジョブを作成する」を参照してください。

［システム構成］ウィンドウまたは［あて先］ウィンドウで［実行］−［ジョブの実行］を選択する、または［ジョブ定義］ウィンドウで［ファイル］−［ジョブ定義の新規作成］を選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されます。

［ジョブ定義の新規作成］ダイアログボックスでジョブ種別を指定し、［OK］ボタンをクリックする。

リモートコレクトを実行するジョブのジョブ種別は、「リモートコレクト」、「中継までのリモートコレクト」、および「中継からのコレクトファイル収集」の3種類です。このうちの1つを選択してください。

［ジョブの作成］ダイアログボックスが表示されます。

［ジョブの作成］ダイアログボックスで、各パネルの項目を設定する。

ダイアログボックス上に表示されるパネルの種類および設定内容は次のとおりです。なお、［ジョブ］パネル、［あて先］パネル、および［スケジュール］パネルは、すべてのジョブに共通ですが、［コレクトファイル］パネルは、リモートコレクト関連のジョブを作成するときだけ表示されるものです。

［ジョブ］パネル

ジョブ名を設定します。

［ジョブ］パネルの設定方法については、「10.2.3　［ジョブ］パネルの設定」を参照してください。

［あて先］パネル

リモートコレクトの対象となるシステムを設定します。必ず1つ以上設定してください。

複数サーバ構成では、中継システムおよび配下の管理用中継サーバを経由するあて先も設定できます。

［あて先］パネルの設定方法については、「10.2.4　［あて先］パネルの設定」を参照してください。

［コレクトファイル］パネル

リモートコレクトするソフトウェアの情報を設定します。

［コレクトファイル］パネルの設定方法については、「9.1.1(2)　［コレクトファイル］パネルの設定」を参照してください。

［スケジュール］パネル

ジョブの登録日時、実行日時、および実行期限を設定します。

［スケジュール］パネルの設定方法については、「10.2.5　［スケジュール］パネルの設定」を参照してください。

［実行］、［保存］、または［保存&実行］ボタンをクリックして、ジョブを保存または実行する。

ジョブが保存または実行されます。

注意事項

「中継までのリモートコレクト」ジョブの実行中に「中継サーバからのコレクトファイル収集」ジョブを実行した場合、中継するシステムに次のイベントが出力されることがありますが、処理は正常に行われているので対処は不要です。

ソース：JP1ITDM2 (DMC)

種類：エラー

イベントID：0

ソース：JP1ITDM2 (DMC)

種類：エラー

イベントID：1002

ソース：JP1ITDM2 (DMC)

種類：エラー

イベントID：8039

ソース：JP1ITDM2 (DMC)

種類：エラー

イベントID：8006

(2)　［コレクトファイル］パネルの設定

リモートコレクトジョブを作成する場合、［ジョブの作成］ダイアログボックスの［コレクトファイル］パネルで、収集するファイル、および収集したファイルを格納するディレクトリを設定します。収集対象は、ファイルまたはディレクトリ単位に指定できます。ディレクトリを指定すると、ディレクトリ下のすべてのファイルがアーカイブされて（1つにまとめて）収集されます。アーカイブファイルには、拡張子にdmzを持つファイル名が付けられます。

図9‒1　［コレクトファイル］パネル

収集対象

リモートコレクトの対象として設定したファイル、またはディレクトリが表示されます。100個までの収集対象が設定できます。

異なるドライブの同一名のディレクトリを収集対象に設定するときは、ディレクトリ内に同一名のファイルがないことを確認してください。同一名のディレクトリ内に同一名のファイルがあると、上書きしてリモートコレクトされます。

収集ファイル格納ディレクトリ名

リモートコレクトしたファイルをどのディレクトリに格納するかを指定します。ここで指定したディレクトリの下位に、次に示す形式でファイルをリモートコレクトします。

あて先のホスト名またはIPアドレス（ノード識別キーによる）−ホスト識別子¥アーカイブファイル名

［コレクトファイル］パネルでは、次の操作ができます。

収集対象の追加

収集対象の削除

リモートコレクトのオプションの設定

(a)　収集対象の追加

［コレクトファイル］パネルで［追加］ボタンをクリックすると、［対象の設定］ダイアログボックスが表示されます。このダイアログボックスで、追加する収集対象を指定します。

図9‒2　［対象の設定］ダイアログボックス

「収集パス名」欄に、収集対象として追加するファイルまたはディレクトリのパスを指定します。収集対象のパス名の終端に「¥」を指定すると、ジョブがエラーとなるので注意してください。収集対象のパス名は、OSがWindowsのコンピュータに対しては半角256文字以内で、OSがUNIXのコンピュータに対しては半角63文字以内で指定してください。復元時のファイルのフルパスが半角259文字を超えると、ファイルの復元ができません。

(b)　収集対象の削除

「収集対象」から削除するファイルまたはパスを選択し、［削除］ボタンをクリックします。

(c)　リモートコレクトのオプションの設定

［コレクトファイル］パネルで［詳細］ボタンをクリックすると、［リモートコレクトの詳細オプション設定］ダイアログボックスが表示されます。このダイアログボックスでは、リモートコレクトのオプションとして、収集のタイミング、収集時の圧縮の有無、起動する外部プログラムなどを設定できます。

図9‒3　［リモートコレクトの詳細オプション設定］ダイアログボックス

このダイアログボックスの設定項目は次のとおりです。

収集タイミング

中継システム、管理用中継サーバ、および管理対象のコンピュータ側でのリモートコレクトのタイミングを設定します。

エージェント稼働中

中継システム、管理用中継サーバ、および管理対象のコンピュータの、システム稼働中にリモートコレクトします。ジョブ実行時にシステムが起動していない場合は、次回システムを起動したときにリモートコレクトします。

エージェント起動時

中継システム、管理用中継サーバ、および管理対象のコンピュータのジョブ実行時以降、最初にシステムを起動したときにリモートコレクトします。

圧縮指定

リモートコレクトするときに、ファイルを圧縮するかどうかを設定します。デフォルトは「圧縮あり」です。

エージェントでの外部プログラム起動

リモートコレクトをする際、中継システム、管理用中継サーバ、および管理対象のコンピュータ側では次のタイミングで外部プログラムを起動させ、ユーザ固有の処理を実行できます。

収集直前

リモートコレクトする直前に外部プログラムを起動します。あらかじめ中継システム、管理用中継サーバ、および管理対象のコンピュータのデータを加工（データ形式の変換など）してから収集したい場合などに設定します。

収集直後

リモートコレクトの直後に外部プログラムを起動します。

収集エラー

リモートコレクトのエラー時に外部プログラムを起動します。なお、UNIXに対しては指定できません。

起動させる外部プログラムのパス名を、ドライブ名を含めて128文字以内（Windows）または64文字以内（UNIX）で指定してください。外部プログラムを指定するときの注意事項を次に示します。

外部プログラムのパスにスペースを含める場合は「"」で囲んで指定してください。ただし、UNIXで外部プログラムを起動させる場合は、パスにスペースを含めることはできません。

外部プログラムのパスには、文字列「%HITACHI_REG¥xxx%」を含めることはできません（xxxは、任意の文字列）。この文字列は、各日立プログラムプロダクトの固有のパスを表すもので、JP1/IT Desktop Management 2の予約語となっています。一般ユーザは指定しないでください。

(3)　実行結果の確認

ジョブの実行状況は、配布管理システムによって一定の間隔で監視され、［ジョブ実行状況］ウィンドウに表示されます。［ジョブ実行状況］ウィンドウにはすべてのジョブの実行状況が表示されますが、ジョブ名の先頭に表示されるアイコンで、ジョブの種別を判断できます。

[図データ]：「リモートコレクト」ジョブ

[図データ]：「中継までのリモートコレクト」ジョブ

[図データ]：「中継からのコレクトファイル収集」ジョブ

[図データ]：「中継のコレクトファイル削除」ジョブ

左側の枠でリモートコレクトのジョブを選択すると、右側の枠には、ジョブの詳細情報としてリモートコレクトしたファイルのパスが表示されます。アーカイブされたファイルを復元するときは、このパスを確認してから、アンアーカイバを使用してください。

［ジョブ実行状況］ウィンドウに表示される内容や、ジョブごとの詳細情報の表示方法、ジョブの再実行の方法などについては、「10.4　ジョブの実行状況を確認する」を参照してください。

9.1.2　収集ファイルの復元

リモートコレクトしたファイルを復元するために、アンアーカイバを使用します。アンアーカイバを使用することで、リモートコレクト時にアーカイブまたは圧縮されたファイルが、元の形式に復元されます。

アンアーカイバを起動するには、［JP1_IT Desktop Management 2 - Manager］の［アンアーカイバ］メニューを選択します。

アンアーカイバを起動すると、［IT Desktop Management 2 アンアーカイバ］ウィンドウが表示されます。

図9‒4　［IT Desktop Management 2 アンアーカイバ］ウィンドウ

アンアーカイバの右側の画面は、ディレクトリ別・ファイル別にソートされて表示されます。ただし、そのドライブがFATファイルシステムの場合はソートされません。

注意事項

OSの管理権限を持たないユーザがアンアーカイバを起動する場合は、OSの管理権限を持つユーザに昇格してから起動してください。

(1)　ファイルの復元

復元するファイルがどのディレクトリにあるのかを、ファイルを復元する前に［ジョブ実行状況］ウィンドウで確認しておいてください。

復元するファイルは、ディレクトリに格納されている必要があります。ドライブの直下に格納されているファイルは、復元できません。

リモートコレクトしたファイルを復元する方法を次に示します。

復元するファイルまたはディレクトリを選択し、［ファイル］−［ファイルの復元］を選択する（または[図データ]をクリックする）。

［復元］ダイアログボックスが表示されます。

図9‒5　［復元］ダイアログボックス

復元先ディレクトリ

復元先のディレクトリを指定します。指定したディレクトリに、復元したファイルを格納します。復元先のディレクトリは有効なパスを指定してください。

使用するファイルシステムによっては、次に示す条件を満たす必要があります。

・ディレクトリのパスの長さが半角247文字以内であること。

・復元するファイルのフルパスの長さが半角256文字以内であること。

　フルパスの形式を次に示します。

「復元先ディレクトリ」+「作成ディレクトリ」+「復元後のファイル名またはディレクトリ名」

　「作成ディレクトリ」の形式を次に示します。

「アーカイブファイル名」+「_」+「アーカイブファイルの格納先ディレクトリ」

・次に示す半角記号を使用していないこと。

　「*」「"」「:」「<」「>」「|」「?」

複数のファイルを復元する場合の復元先ディレクトリについては、「9.1.2(2)　復元先のファイル構成」を参照してください。

内容

復元するファイルの名称や内容が表示されます。

アーカイブファイル名

復元するファイルの名称が表示されます。復元の対象としてディレクトリを選択したときは、ディレクトリ下にあるすべてのファイルの名称が表示されます。

内容一覧

「アーカイブファイル名」で選択したファイルの、内容が一覧で表示されます。

必要な項目を設定して、［OK］ボタンをクリックする。

ファイルの復元を開始します。復元中は、［ファイルの復元］ダイアログボックスが表示されます。

なお、上記の方法以外に、エクスプローラから［IT Desktop Management 2 アンアーカイバ］ウィンドウまたはアンアーカイバのアイコンに、復元するファイルをドラッグ&ドロップしてもファイルを復元できます。

(2)　復元先のファイル構成

アーカイブファイルを1つだけ復元する場合、復元されたファイルは、［復元］ダイアログボックスの「復元先ディレクトリ」で指定されたディレクトリの直下に格納されます。しかし、一度に複数のアーカイブファイルを復元する場合、別々のアーカイブファイル内に同じ名称のファイルが存在することがあります。このため、複数のアーカイブファイルを復元する場合は、「復元先ディレクトリ」で指定されたディレクトリの下に、次に示す名称のディレクトリを作成し、その下にファイルを格納します。

アーカイブされたファイル名（拡張子を除く）_上位ディレクトリ名

復元先ディレクトリ「C:¥TEMP¥DATA」に、複数のアーカイブファイルを復元する場合の例を次に示します。

アーカイブファイル名

ファイルの内容

C:¥user¥PC0001¥ED0001.dmz

E10.txt、E11.txt

C:¥user¥PC0001¥ED0002.dmz

E20.dat、E21.dat

C:¥user¥PC0002¥ED0001.dmz

E10.txt、E11.txt

C:¥user¥PC0002¥ED0002.dmz

E20.dat、E21.dat

図9‒6　復元先ディレクトリの構成

9.1.3　中継システムおよび管理用中継サーバ上のファイルの削除

リモートコレクト時の中継システムおよび管理用中継サーバでは、その中継システムおよび管理用中継サーバを経由して収集されるすべてのファイルを一時的に保管します。保管されたファイルは、配布管理システムへの収集と同時に自動的に削除されます。「中継までのリモートコレクト」ジョブを実行した場合も、「中継からのコレクトファイル収集」ジョブを実行すると、中継システムおよび管理用中継サーバに保管されていたファイルは削除されます。

しかし、中継システムおよび管理用中継サーバまでリモートコレクトしたファイルを配布管理システムへ転送しなかった場合など、中継システムおよび管理用中継サーバ上のコレクトファイルを強制的に削除したい場合は、配布管理システムから「中継のコレクトファイル削除」ジョブを実行してファイルを削除してください。

9.1.4　リモートコレクト実行時の注意事項

リモートコレクトのジョブ実行時、およびアンアーカイバ使用時の注意事項を次に示します。

次のような条件でのリモートコレクトは失敗するおそれがあります。

リモートコレクトするファイルが管理対象のコンピュータ側で使用されている場合

Windowsのネットワークドライブからのリモートコレクト

アクセス権のないディレクトリからのリモートコレクト

「中継からのコレクトファイル収集」ジョブおよび「中継のコレクトファイル削除」ジョブは、あて先として中継システムおよび管理用中継サーバを指定するジョブです。このジョブのあて先に「エージェント」を指定すると、エラー、または実行中（実行状況20%）のままとなります。

［ジョブの作成］ダイアログボックスや［IT Desktop Management 2 アンアーカイバ］ウィンドウに表示されているディレクトリまたはファイルは、途中で、ほかのアプリケーションから削除される場合があります。このような場合、画面にはその情報が反映されません。すでに削除されたファイルまたはディレクトリを画面上で選択すると、「ファイルのアクセスに失敗しました。」というエラーダイアログボックスが表示されます。

「収集ファイル格納ディレクトリ」には、サーバ上のディレクトリを指定してください。管理用サーバとリモートインストールマネージャが別のPCにインストールされている場合は特に注意してください。

「収集ファイル格納ディレクトリ」に、存在しないドライブを指定した場合は、JP1/IT Desktop Management 2 - Managerのインストール先ディレクトリ¥mgr¥tempに管理対象のコンピュータのホスト名でディレクトリが作成され、収集したファイルが格納されます。

WindowsシステムからのリモートコレクトとUNIXシステムからのリモートコレクトを1つのジョブで行うことはできません。

UNIXシステムに対してリモートコレクトジョブを実行する場合は、次の点に注意してください。

収集対象は、ルートディレクトリから指定してください。ただし、ドライブの指定は不要です。

収集対象ファイルまたはディレクトリは1つしか指定できません。複数指定した場合は、先頭の指定だけが有効になります。

収集パス名は、半角63文字以内で指定してください。64文字以上を指定した場合は、先頭から63文字分が有効となります（エラーにはなりません）。

起動する外部プログラムのパスは、半角64文字以内で指定してください。65文字以上を指定した場合は、先頭から64文字分が有効となります（エラーにはなりません）。

起動する外部プログラムのパスにスペースを含めることはできません。

起動する外部プログラムに引数は指定できません。

［コレクトファイル］パネルの［収集ファイル格納ディレクトリ名］にはローカルドライブのディレクトリを指定してください。ネットワークドライブにはリモートコレクトしたファイルを格納できません。

［コレクトファイル］パネルの［収集対象］、および［IT Desktop Management 2 アンアーカイバ］ウィンドウは、UNCパスに対応していません。ネットワーク上のファイルやディレクトリを使用する場合は、ネットワークドライブに割り当ててから使用してください。

一度にリモートコレクトできるファイル容量の上限は、合計で2ギガバイトです。

一度にリモートコレクトできるファイルまたはディレクトリの上限は、合計で65,531個です。ただし、リモートコレクト対象のファイルまたはディレクトリがショートファイル名を持つ場合は、ショートファイル名もカウントの対象となります。

dcmcollコマンドで収集したアーカイブファイルを復元中にマシンのログオフをしないでください。

アンアーカイバまたはdcmcollコマンドによるアーカイブファイルの復元が、復元後パス長の制限長超過やディスク容量不足などの理由で失敗すると、それまで復元されたファイルが残留する場合があります。ファイルが残留した場合は、手動で削除してください。

「中継までのリモートコレクト」ジョブの実行中に「中継のコレクトファイル削除」ジョブを実行した場合、収集途中のファイルが削除され「中継のコレクトファイル収集」ジョブで収集できなくなることがあります。

また、ジョブの実行タイミングによっては収集途中のファイルが残存する場合があります。この場合、「中継のコレクトファイル削除」ジョブを再実行して残存したファイルを削除してください。

9.2　リモートコレクトの運用例

ここでは、さまざまな目的に応じたリモートコレクトの運用例について紹介します。

9.2.1　管理対象のコンピュータでデータを加工してリモートコレクトする

リモートコレクトしたデータを配布管理システムで利用するとき、あらかじめ管理対象のコンピュータ側でデータを加工しておく方がよい場合があります。例えば、各コンピュータで処理したデータを基に、サーバのデータベースを更新する処理で、管理対象のコンピュータ側のデータをサーバ側のプログラムで解釈できなければ、データを加工しなければなりません。サーバにリモートコレクトしてから加工することもできますが、各コンピュータから送られてきた大量のデータを一度に加工しようとすると、サーバの負荷が大きくなってしまいます。

このような場合は、リモートコレクトの直前に外部プログラムを起動させる機能を利用すると便利です。リモートコレクトの直前に起動させる外部プログラムとして、データ加工のためのプログラムを指定することで、上記のような運用に対応できます。

管理対象のコンピュータで加工したデータのリモートコレクトを、次の図に示します。

図9‒7　管理対象のコンピュータで加工したデータをリモートコレクトする

リモートコレクトの直前または直後に起動させる外部プログラムは、［リモートコレクトの詳細オプション設定］ダイアログボックスで設定します。このダイアログボックスは、［ジョブの作成］ダイアログボックスの［コレクトファイル］パネルで［詳細］ボタンをクリックすると表示されます。

図9‒8　［リモートコレクトの詳細オプション設定］ダイアログボックス

9.2.2　ユーザアプリケーションの障害情報をリモートコレクトする

管理対象のコンピュータで発生したユーザアプリケーションプログラムの障害情報を、リモートコレクトできます。この場合、各ユーザアプリケーションプログラムは各コンピュータの決められた場所に障害ログを出力するようにしてください。リモートコレクトしたファイルはコンピュータごとに分けて格納されるので、同時に複数のコンピュータで障害が発生しても、別々にリモートコレクトできます。

ユーザアプリケーションの障害情報のリモートコレクトを、次の図に示します。

図9‒9　ユーザアプリケーションの障害情報をリモートコレクトする

9.2.3　Windowsのイベントログ情報をリモートコレクトする

Windowsの障害情報は、主にイベントログへ出力され、Windowsのイベントビューアで参照できるようになっています。しかし、イベントビューアでは、複数のコンピュータのイベントログを同時に参照できません。

そこで、イベントログをテキストファイルに変換するプログラムをコンピュータへ配布して、テキストファイルに変換したイベントログをリモートコレクトすることで、複数のコンピュータのイベントログを収集・参照できます。

イベントログ情報のリモートコレクトの手順を、次の図に示します。

図9‒10　イベントログ情報をリモートコレクトする

イベントログをテキストファイルに変換するプログラムを作成する。

プログラムは、WindowsのAPI関数で作成できます。OpenEventLog()関数でイベントログをオープンし、ReadEventLog()関数で1エントリずつ読み出したあと、読み出したデータをテキストファイルへ出力するプログラムを作成します。

作成したプログラムを各コンピュータにリモートインストールする。

すでに、このようなプログラムがコンピュータにインストールされている場合は不要です。

イベントログをリモートコレクトする。

このとき、リモートコレクトの直前に起動させる外部プログラムとして、上記のテキストファイル変換プログラムを指定します。また、リモートコレクトの対象としては、イベントログを直接指定しないで、テキストファイル変換プログラムが出力するファイルを指定します。

10　ジョブを管理する

リモートインストールやリモートコレクトなどの機能を管理対象のコンピュータに対して実行する場合、リモートインストールマネージャでジョブと呼ばれる命令を作成して管理対象のコンピュータに指示します。

ここでは、ジョブの作成方法、管理方法について説明します。

10.1　ジョブの作成、実行手順

リモートインストールやリモートコレクトなどの機能を実行する場合は、リモートインストールマネージャで、実行内容を指示するジョブを作成、実行します。ジョブ実行後は、ジョブの実行状況や実行結果を確認し、実行結果に応じた対処をしてください。

ジョブの作成、実行の操作の流れを次に示します。

ジョブを作成する。

ジョブは、［ジョブの作成］ダイアログボックスで作成します。ジョブの名称、ジョブのあて先、ジョブの実行条件などを指定します。ジョブの作成方法については、「10.2　ジョブを作成する」を参照してください。

ジョブの作成時に使用する画面は、デフォルト値を変更したり、項目の表示順を変更したりするなどのカスタマイズができます。カスタマイズの方法については、「10.2　ジョブを作成する」を参照してください。

図10‒1　［ジョブの作成］ダイアログボックス

作成したジョブは保存できます。保存したジョブを編集して使用すれば、同じようなジョブを何度でも簡単に実行できます。ジョブは、［ジョブ定義］ウィンドウで、「フォルダ」という単位で保存されます。ジョブの保存方法については、「10.3　ジョブを実行、保存する」を参照してください。

図10‒2　［ジョブ定義］ウィンドウ

ジョブを実行する。

ジョブ作成時の指定で、ジョブ作成後、すぐに実行するか、日時を指定して実行できます。ジョブの実行タイミングは、［スケジュール］パネルで設定できます。

図10‒3　［スケジュール］パネル

ジョブの実行方法については、「10.3.1　ジョブの実行と保存」を参照してください。

実行結果を確認する。

ジョブの実行状況や実行結果は、［ジョブ実行状況］ウィンドウで確認できます。［ジョブ実行状況］ウィンドウでは、実行したジョブの状況が、フォルダやジョブごとに階層的に表示されます。左枠にはフォルダやジョブなどの階層構造が、右枠には左枠で選択した階層内の情報（実行状況や実行状態など）が表示されます。ジョブの実行結果の確認方法については、「10.4　ジョブの実行状況を確認する」を参照してください。

図10‒4　［ジョブ実行状況］ウィンドウ

実行結果に応じて対処する。

［ジョブ実行状況］ウィンドウでジョブの実行結果を確認し、正常にジョブが終了した場合は、そのジョブを削除してください。正常にジョブが終了しなかった場合は、そのあて先に再度ジョブを実行する必要があります。ジョブの再実行は、［ジョブの再実行］ダイアログボックスで指示できます。

図10‒5　［ジョブの再実行］ダイアログボックス

また、中継システムに障害が発生したため、配下の管理対象のコンピュータでジョブが実行できない場合は、別の中継システムを使用してジョブを実行することもできます。分割配布中のジョブがある場合は、転送していない残りのパッケージを一括して転送することで、分割配布を強制的に完了することもできます。

このような、ジョブの削除や再実行といった対処の方法については、「10.5　ジョブの実行結果を確認したあとの対処」を参照してください。

注意事項

ジョブ名と実行時間が同一のジョブが存在する場合、そのジョブに対する削除や再実行などの操作が正しくできません。このようなジョブを作成しないでください。

10.2　ジョブを作成する

ジョブを作成するときは、まず、［ジョブ定義の新規作成］ダイアログボックスでジョブ種別を指定します。次に、［ジョブの作成］ダイアログボックスでそのほかの詳細な情報を設定します。

10.2.1　［ジョブ定義の新規作成］ダイアログボックスの表示方法

ジョブ種別は、［ジョブ定義の新規作成］ダイアログボックスで指定します。

図10‒6　［ジョブ定義の新規作成］ダイアログボックス

［ジョブ定義の新規作成］ダイアログボックスの表示方法は、リモートインストールマネージャのどのウィンドウからジョブを作成するかによって異なります。

(1)　［ジョブ定義］ウィンドウでジョブを作成する場合

［ファイル］−［ジョブ定義の新規作成］を選択します。

(2)　［あて先］ウィンドウまたは［システム構成］ウィンドウでジョブを作成する場合

［実行］−［ジョブの実行］を選択するか、またはジョブの作成ボタンをクリックします。

(3)　［パッケージ］ウィンドウでジョブを作成する場合

［パッケージ］ウィンドウでは、［実行］−［ジョブの実行］を選択する（またはジョブの作成ボタンをクリックする）ことで、次に示すジョブだけを作成できます。

パッケージのインストール

中継までのパッケージの転送

クライアントユーザによるインストール

なお、このとき、あらかじめジョブの実行対象となるホストまたはパッケージを選択しておくと、あとで表示される［ジョブの作成］ダイアログボックスに、その情報が設定されます。

また、「パッケージのインストール」、「中継までのパッケージの転送」または「クライアントユーザによるインストール」ジョブを作成する場合は、ドラッグ&ドロップの操作でも［ジョブ定義の新規作成］ダイアログボックスを表示できます。この場合も、あとで表示される［ジョブの作成］ダイアログボックスに、選択したホストおよびパッケージの情報が設定されます。ドラッグ&ドロップでの操作を次に示します。

パッケージ（またはキャビネット）のアイコンを、［パッケージ］ウィンドウからドラッグする。

キャビネットを選択したときは、キャビネット内のすべてのパッケージが対象になります。

［あて先］ウィンドウまたは［システム構成］ウィンドウ上の、ホストのアイコンにドロップする。

［ジョブ定義の新規作成］ダイアログボックスが表示されます。

10.2.2　［ジョブの作成］ダイアログボックスに表示されるパネル

ジョブ種別ごとに、［ジョブの作成］ダイアログボックスに表示されるパネルの一覧を次の表に示します。

表10‒1　［ジョブの作成］ダイアログボックスに表示されるパネル

項番

ジョブ種別

パネルの種類

ジョブ

あて先

パッケージ

ジョブの配布属性

コレクトファイル

取得項目

検索対象

スケジュール

クライアント制御

1

パッケージのインストール※

○

○

○

○

−

−

−

○

○

2

中継までのパッケージの転送

○

○

○

○

−

−

−

○

○

3

中継のパッケージの一括削除

○

○

−

−

−

−

−

○

○

4

リモートコレクト

○

○

−

−

○

−

−

○

○

5

中継までのリモートコレクト

○

○

−

−

○

−

−

○

○

6

中継からのコレクトファイル収集

○

○

−

−

−

−

−

○

○

7

中継のコレクトファイル削除

○

○

−

−

−

−

−

○

○

8

クライアントユーザによるインストール

○

○

○

○

−

−

−

○

○

9

コンピュータ（UNIX）のシステム情報の取得※

○

○

−

−

−

○

−

○

○

10

コンピュータ（UNIX）のソフトウェア情報の取得※

○

○

−

−

−

−

○

○

○

11

システム構成情報の取得

○

○

−

−

−

−

−

○

○

12

中継からの結果通知保留

○

○

−

−

−

−

−

○

○

13

中継の結果通知保留の解除

○

○

−

−

−

−

−

○

○

14

ファイル転送の中断

○

○

−

−

−

−

−

○

○

15

ファイル転送の再開

○

○

−

−

−

−

−

○

○

（凡例）○：表示される　−：表示されない

注※

このジョブはMacエージェントにも適用できます。

各パネルの設定方法の参照先を次に示します。

［ジョブ］パネル

［ジョブ］パネルの設定方法については、「10.2.3　［ジョブ］パネルの設定」を参照してください。

［あて先］パネル

［あて先］パネルの設定方法については、「10.2.4　［あて先］パネルの設定」を参照してください。

［パッケージ］パネル

［パッケージ］パネルの設定方法については、「7.3.2　［パッケージ］パネルの設定」を参照してください。

［ジョブの配布属性］パネル

［ジョブの配布属性］パネルの設定方法については、「7.3.3　［ジョブの配布属性］パネルの設定」を参照してください。

［コレクトファイル］パネル

［コレクトファイル］パネルの設定方法については、「9.1.1　リモートコレクトの実行」を参照してください。

［取得項目］パネル

［取得項目］パネルの設定方法については、「付録G.1(2)　［取得項目］パネルの設定」を参照してください。

［検索対象］パネル

［検索対象］パネルの設定方法については、「付録G.2(2)　［検索対象］パネルの設定」を参照してください。

［スケジュール］パネル

［スケジュール］パネルの設定方法については、「10.2.5　［スケジュール］パネルの設定」を参照してください。

［クライアント制御］パネル

［クライアント制御］パネルの設定方法については、「10.2.6　［クライアント制御］パネルの設定」を参照してください。

10.2.3　［ジョブ］パネルの設定

［ジョブ］パネルでは、ジョブ種別を確認し、ジョブ名を設定します。

図10‒7　［ジョブ］パネル

ジョブ名（必ず設定）

ジョブ名には、デフォルトで「ジョブ種別年_月_日_時_分秒」が表示されていますが、管理しやすい名称に変更することもできます。

ジョブ種別の部分はジョブによって異なり、例えばパッケージのリモートインストールのときは「リモートインストール」が付けられます。

デフォルトのジョブ名を変更するときは、半角で32文字（全角で16文字）までの名称をユニークに設定します。ジョブ名を指定するときは、次の点に注意してください。

次に示す記号とスペースは使用できません。

「¥」「/」「*」「"」「:」「'」「!」「|」「.」「<」「>」「?」

大文字と小文字は区別されません。

ジョブ種別

［ジョブ定義の新規作成］ダイアログボックスで指定したジョブ種別が表示されます。変更はできません。

10.2.4　［あて先］パネルの設定

［あて先］パネルでは、ジョブの実行対象となるホストやグループを設定します。

図10‒8　［あて先］パネル

まず、あて先の属性を選択してから、［追加］ボタンをクリックしてあて先を追加してください。「あて先」欄に、ジョブの実行対象として設定したID、あて先グループおよび管理対象のコンピュータが表示されます。一度設定したあて先を削除したり、あて先の経路を変更したりすることもできます。

あて先の属性、あて先の追加方法、および経路の変更方法について次に示します。

(1)　あて先の属性

［あて先］パネルであて先を設定する場合、まずあて先の属性を選択します。あて先の属性には、次の種類があります。

あて先グループ

ID

(a)　あて先グループ

ジョブのあて先として、あて先グループ、または特定のホスト（管理用中継サーバ、中継システム、エージェント）を指定したい場合に選択します。IDが設定されているジョブのあて先の属性を「あて先グループ」に変更すると、IDを管理している中継システムおよび管理用中継サーバ、またはIDに登録されている管理対象のコンピュータをあて先としたジョブが登録されます。

あて先グループまたはホストを指定した場合、ジョブの種類によってジョブが実行されるホストが異なります。次に、指定するあて先とジョブ種別の関係を示します。

表10‒2　指定するあて先とジョブ種別の関係

項番

ジョブ種別

指定するあて先

エージェント

中継システム

あて先グループ

管理用中継サーバ

1

パッケージのインストール

○

○

◎

○

2

中継までのパッケージの転送

×

○

△

○

3

中継のパッケージの一括削除

×

○

△

○

4

リモートコレクト

○

○

◎

○

5

中継までのリモートコレクト

○

○

◎

○

6

中継からのコレクトファイル収集

×

○

△

○

7

中継のコレクトファイル削除

×

○

△

○

8

クライアントユーザによるインストール

○

○

◎

○

9

システム構成情報の取得

×

○

×

○

10

コンピュータ（UNIX）のシステム情報の取得

○※1

×

○※2

×

11

コンピュータ（UNIX）のソフトウェア情報の取得

○※1

×

○※2

×

12

中継からの結果通知保留

×

○

△

○

13

中継の結果通知保留の解除

×

○

△

○

14

ファイル転送の中断

×

○

△

○

15

ファイル転送の再開

×

○

△

○

（凡例）

○：指定したホストでジョブが実行されます。

×：指定したホストではジョブが実行されません。

△：指定したあて先グループに属する中継システムおよび管理用中継サーバでジョブが実行されます。

また、指定したあて先グループの下位のあて先グループに属する中継システムおよび管理用中継サーバでもジョブが実行されます。

◎：指定したあて先グループに属するすべてのホストでジョブが実行されます。

また、指定したあて先グループの下位のあて先グループに属するすべてのホストでもジョブが実行されます。

注※1

あて先がUNIXエージェントまたはMacエージェントの場合だけ実行されます。

注※2

指定したあて先グループに属するUNIXエージェントまたはMacエージェントが対象になります。

(b)　ID

ジョブのあて先としてIDを指定する場合に選択します。あて先にIDを指定すると、IDに属しているコンピュータに対してジョブが実行されます。

新規に追加されるコンピュータに対してジョブを実行したい場合は、あて先にIDを指定すると便利です。コンピュータの接続先システムにIDジョブが保管されていれば、コンピュータがIDに登録されると、そのコンピュータに対して自動的にジョブが実行されます。なお、システム構成情報とIDの情報を連携している場合、IDに登録されたコンピュータの接続先を変更して経路が変更になったときには旧経路に存在しているコンピュータあてのIDジョブが削除され、新経路で再度、コンピュータあてのIDジョブが登録、実行されます。

あて先の属性に「ID」を指定できるジョブ種別を次に示します。

パッケージのインストール※

クライアントユーザによるインストール

コンピュータ（UNIX）のシステム情報の取得※

コンピュータ（UNIX）のソフトウェア情報の取得※

注※

このジョブはMacエージェントにも適用できます。

なお、経路を含むID管理元中継を指定する場合、あて先として複数のIDを指定できません。IDごとにジョブを分けて指定してください。例えば、あて先がID01とID02になる場合は、あて先として次のように指定したジョブを2つ作成してください。

ホスト識別子!%ID01

ホスト識別子!%ID02

(2)　あて先の追加方法

［あて先］パネル上であて先を追加する方法を次に示します。

［あて先］パネルで、追加するあて先の属性を選択し、［追加］ボタンをクリックする。

［あて先の追加］ダイアログボックスが表示されます。［あて先の追加］ダイアログボックスは、見やすいサイズに変更できます。サイズを変更した場合、次回から変更したサイズで表示されます。

図10‒9　［あて先の追加］ダイアログボックス

「追加元」、「グループ/中継名」を選択すると表示される「あて先/エージェント」の一覧から、「あて先」に追加するホストを選択します。

追加元

［システム構成］または［あて先］ウィンドウのどちらのウィンドウの情報を利用してあて先を追加するかを選択します。

グループ/中継名

「追加元」で「システム構成」を選択した場合は、中継システムおよび管理用中継サーバが階層構造で表示されます。「あて先」を選択した場合は、あて先グループまたはIDが表示されます。

あて先/エージェント

「追加元」で「システム構成」または「あて先」を選択した場合は、「グループ/中継名」で選択した管理用中継サーバ、中継システム、またはあて先グループに含まれるホストの一覧が表示されます。ネットワークの直下のコンピュータは、「グループ/中継名」で「ネットワーク」をクリックすると表示されます。

あて先入力

［システム構成］ウィンドウにないホストを追加する場合に、ホストまでの経路を設定します。経路は、「ホスト名1!ホスト名2」のようにホストを「!」で区切って設定します。

ホスト名は、ホスト識別子で入力してください。

ホスト名の指定方法は、「5.1.2　JP1/IT Desktop Management 2でのホスト名の付け方」を参照してください。

あて先として中継システムを指定するジョブで、あて先の経路を指定する場合は、次に示すとおり経路とあて先の両方に中継システムの名称を指定してください。

（例）

中継システムをあて先として指定する場合

中継システムのホスト識別子!中継システムのホスト識別子

IDを入力する場合は、IDの先頭に「%」を付けます。あて先グループは指定できません。なお、中継システムで管理しているIDを指定する場合は、IDの数は1つだけにしてください。

（例）

中継システムを使用する構成で、その中継システムで管理しているID（ID01）を設定する場合

中継システムのホスト識別子!%ID01

JP1/IT Desktop Management 2が管理しているID（IDSERVER）を設定する場合

%IDSERVER

左側の欄で、あて先として追加するホスト、あて先グループ、またはIDを選択し、［>］ボタンをクリックする。

選択した項目が、右側の「あて先」欄に追加されます。このとき［>>］ボタンをクリックすると、「あて先/エージェント」欄に表示されているすべてのホストまたはコンピュータが「あて先」欄に追加されます。

設定した項目を「あて先」欄から削除したい場合は［<］ボタンをクリックします。

［OK］ボタンをクリックする。

［あて先の追加］ダイアログボックスが閉じ、設定したあて先が［あて先］パネルの「あて先」欄に表示されます。

(3)　経路の変更方法

［あて先］パネルで［経路変更］ボタンをクリックすると、ジョブの実行経路を変更できます。障害が発生した中継システムを避け、別の中継システムを経由してジョブを実行するなどの運用ができます。

経路を変更する場合、次の点に注意してください。

管理用中継サーバ、および管理用中継サーバ配下の中継システムまたはエージェントは経路を変更できません。

ジョブのあて先があて先グループまたはIDの場合、経路変更はできません。

「クライアントユーザによるインストール」ジョブで経路を変更すると、ジョブの実行結果が実行待ち状態のままになることがあります。この場合、クライアントユーザによるインストールが行われる中継システムまたは管理対象のコンピュータの接続先ホストを、変更した経路で示す上位ホストへ設定し直してください。

［クライアント制御］パネルの「対象のコンピュータが稼働していない場合に起動する」は使用できません。

経路を変更する方法を次に示します。

［あて先］パネルで経路を変更するあて先を選択し、［経路変更］ボタンをクリックする。

［ジョブあて先経路変更］ダイアログボックスが表示されます。［あて先］パネルで選択したあて先、およびすべての中継システムが［システム構成］ウィンドウで定義した経路で表示されます。

図10‒10　［ジョブあて先経路変更］ダイアログボックス

経路を変更する中継システムを選択して、［変更］、［移動］または［追加］ボタンをクリックする。

［変更］ボタン

［変更中継の候補一覧］ダイアログボックスが表示されます。このダイアログボックスで指定した中継システム下に、［ジョブあて先経路変更］ダイアログボックスで指定した中継システムの配下の管理対象のコンピュータが移動されます。

［追加］ボタン

［追加中継の候補一覧］ダイアログボックスが表示されます。このダイアログボックスで指定した中継システムおよび配下の管理対象のコンピュータが、［ジョブあて先経路変更］ダイアログボックスで指定した中継システム下に移動されます。

［移動］ボタン

［移動先中継の候補一覧］ダイアログボックスが表示されます。このダイアログボックスで指定した中継システム下に、［ジョブあて先経路変更］ダイアログボックスで指定した管理対象のコンピュータが移動されます。

［リセット］ボタン

［ジョブあて先経路変更］ダイアログボックスの中継システムおよび配下の管理対象のコンピュータが、並びを変更する前の状態に戻します。

経路変更ウィンドウ内の管理対象のコンピュータや中継システムは、マウスのドラッグ&ドロップ操作で移動することもできます。また、アイコンの名称部分をクリックし、直接名称を入力して変更することもできます。

［OK］ボタンをクリックする。

［ジョブあて先経路変更］ダイアログボックスが閉じ、変更した経路が［あて先］パネルに表示されます。

(4)　あて先を設定するときの注意事項

あて先を設定するときの注意事項を次に示します。

(a)　あて先の長さの制限

あて先の長さが256文字以上のジョブは、［ジョブ実行状況］ウィンドウにジョブの実行状況が表示されません。あて先は、255文字以下の長さで指定してください。

(b)　あて先属性の変更について

すでにあて先グループが設定されているジョブのあて先の属性を「ID」に変更すると、ID以外のあて先は削除されます。逆に、IDが設定されているジョブのあて先の属性を「あて先グループ」に変更すると、IDを管理している中継システム、またはIDに登録されている管理対象のコンピュータをあて先としたジョブが登録されます。

(c)　存在しないあて先を指定したジョブの扱い

存在しないあて先を設定したジョブは作成しないでください。このようなジョブを実行すると、リモートインストールマネージャの動作が遅くなるなどの影響を与えることがあります。

設定したあて先に存在しないあて先が含まれているときは、存在するあて先だけを対象にしてジョブが実行されます。なお、存在しないあて先に対するジョブの実行後の状態は、JP1/IT Desktop Management 2 - Managerのセットアップの［アドレス解決の設定］パネルの設定によって異なります。「アドレス解決できないあて先へのジョブ」の項目の設定が「エラーとする」の場合は「エラー」、「エラーとしない」の場合は「実行待ち」となります。

(d)　管理用中継サーバの名称を指定する場合

管理用中継サーバの名称を直接入力する、または管理用中継サーバを経由するあて先の経路を指定するときは、ノード識別キーに関係なく、管理用中継サーバの名称を必ずホスト名で指定してください。

(e)　運用キーの設定について

JP1/IT Desktop Management 2 - Managerのセットアップの［アドレス解決の設定］パネル、またはエージェント設定の［中継システムの設定］−［運用キーの設定］で、キー項目を「ホスト名」にしている場合はアドレス解決の方法を「Windowsネットワークを使用する」に設定をしてください。

アドレス解決の方法を「JP1/IT Desktop Management 2のシステム構成情報を使用する」に設定している場合、ジョブ実行時に、次の方法であて先を指定すると、あて先に対するジョブ実行要求の送信ができません。しかし、「アドレス解決できないあて先へのジョブ」を「エラーとしない」設定にしている場合、あて先からのポーリングによって、ジョブは実行されます。

［あて先の追加］ダイアログボックスの「あて先入力」で、あて先を指定。

経路変更をして、あて先を指定。

10.2.5　［スケジュール］パネルの設定

［スケジュール］パネルでは、配布管理システムおよび管理対象のコンピュータでのジョブ実行日時を設定します。

なお、設定した実行日時は1分間隔で監視されるため、ジョブの実行は最大で1分遅延する場合があります。

図10‒11　［スケジュール］パネル

(1)　配布管理システムでのジョブ実行日時の指定

配布管理システム側でジョブをすぐに実行するか、日時を指定して実行するかを選択します。

即時実行

ジョブをすぐに実行します。

日時を指定して実行

指定した日時にジョブを実行します。ジョブの登録日時、および実行期限も指定できます。日時を指定する際、「年」には西暦の下2けたを指定してください。「年」に70〜99を指定した場合は1900年代、00〜36を指定した場合は2000年代として扱われます。

なお、「日時を指定して実行」を設定したジョブを保存した場合、保存後にメニューや［F5］キーでジョブを実行すると、ジョブの実行日時の設定が「即時実行」に変更されます。

登録日時

配布管理システムにジョブを登録する日時を指定します。登録日時を指定する場合は、チェックボックスをオンにしてください。

多数のジョブを同一の実行日時でスケジュールすると、配布管理システムに一時的に負荷が掛かり、ジョブを実行する時刻が遅れることがあります。登録日時を指定することで、ジョブを実行する時刻が遅れることを回避できます。

実行日時

ジョブを実行する日時を指定します。

実行期限

指定した実行日時に実行されなかったジョブの、実行期限を指定します。実行期限を指定する場合は、チェックボックスをオンにしてください。

通常、実行日時になったジョブは実行されますが、指定した日時に配布管理システムが起動していなかったときなどは、ジョブが実行されません。実行されなかったジョブは、次回の配布管理システムの起動時に、実行期限が過ぎていなければ実行され、実行期限が過ぎていれば実行期限を過ぎたジョブとして実行されないで残ります。実行期限を過ぎて残っているジョブは、確認後、削除してください。

なお、配布管理システムで実行日時を指定してジョブを実行した場合、そのジョブの実行日時より前に次に示す操作をしないでください。ジョブが実行できなくなりジョブ定義が削除されます。

ジョブ名の変更

あて先またはパッケージをすべて削除

(2)　エージェントでのジョブ実行日時の指定

エージェント側でジョブを実行する日時を設定します。エージェントでのジョブ実行日時を設定できるのは、次のジョブだけです。

コンピュータ（UNIX）のシステム情報の取得※

コンピュータ（UNIX）のソフトウェア情報の取得※

注※

このジョブはMacエージェントにも適用できます。

エージェントでのジョブ実行日時の設定方法を示します。配布管理システムでのジョブ実行日時の指定と同様にジョブをすぐに実行するか、日時を指定して実行するかを選択します。

即時実行

ジョブをすぐに実行します。

日時を指定して実行

エージェント側でジョブを実行する日時を設定します。「年」には西暦の下2けたを設定してください。「年」に70〜99を指定した場合は1900年代、00〜36を指定した場合は2000年代として扱われます。

実行タイミングの設定

エージェント側でジョブを実行するタイミングを設定します。なお、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブの場合、選択できるのは、「稼働中に実行」だけです。

起動時に実行

エージェントのシステム起動時にジョブが実行されます。実行日時を設定している場合は、設定した日時以降の最初のシステム起動時にジョブが実行されます。

稼働中に実行

エージェントのシステム稼働中にジョブが実行されます。実行日時を設定している場合は、設定した日時にジョブが実行されます。ただし、設定した日時にエージェントが稼働していない場合は、次回のシステム起動時にジョブが実行されます。

停止時に実行

エージェントのシステム終了時にジョブが実行されます。

10.2.6　［クライアント制御］パネルの設定

［クライアント制御］パネルでは、ジョブのあて先のPCが起動されていない場合、起動してジョブを実行させる設定ができます。あて先のPCを起動したあと、シャットダウンさせる指定もできます。なお、あて先がUNIXエージェントの場合、「ジョブ実行後クライアントをシャットダウンさせる」は無効です。また、UNIXエージェント、Macエージェントに適用する「コンピュータ（UNIX）のシステム情報の取得」ジョブ、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブではシャットダウンの指定はできません。

図10‒12　［クライアント制御］パネル

対象のコンピュータが稼働していない場合に起動する

あて先のPCが起動されていない場合、PCを起動させてからジョブを実行します。起動の対象は、ジョブのあて先として指定された、IDおよびあて先グループのPCです。したがって、あて先の途中に中継システムおよび管理用中継サーバが起動していない場合などは、ジョブの転送はそこで止まります。

ジョブ実行後クライアントをシャットダウンさせる

あて先のPCを起動したあと、シャットダウンさせたい場合に指定します。

なお、JP1/IT Desktop Management 2 - Agentをリモートインストールする場合は、この項目を設定しないでください。リモートインストールが正常に完了しないときがあります。また、「コンピュータ（UNIX）のシステム情報の取得」ジョブ、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブの場合、この項目は表示されません。

10.3　ジョブを実行、保存する

ジョブは、次の3とおりの方法で実行します。

ジョブ作成後そのまま実行する。

ジョブ作成後に一度保存してから実行する。

特定のあて先を検索して実行する。

また、ジョブを保存することで、ジョブを確認、修正、および実行できます。保存したジョブを修正して実行したり、ジョブを編集して何度も再利用したりできます。

ここでは、ジョブの実行方法に加え、保存したジョブの管理方法について説明します。

10.3.1　ジョブの実行と保存

作成したあとすぐにジョブを実行する方法と、保存してからジョブを実行する方法について説明します。また、特定のあて先を検索してジョブを実行する方法についても説明します。

(1)　作成後すぐに実行する

［ジョブの作成］ダイアログボックスで作成したジョブを、そのまま実行する方法を次に示します。

［ジョブの作成］ダイアログボックスで［実行］ボタンをクリックする。

ジョブが実行され、［ジョブの作成］ダイアログボックスが閉じます。

なお、日時を指定してジョブを実行する場合は、いったんジョブを保存する必要があります。

(2)　保存後に実行する

ジョブは、フォルダという単位でリモートインストールマネージャの［ジョブ定義］ウィンドウに保存されます。作成したジョブを保存してから実行する方法について説明します。

(a)　ジョブの保存

ジョブはリモートインストールマネージャの［ジョブ定義］ウィンドウに保存します。次に、ジョブの保存方法を示します。

［ジョブの作成］ダイアログボックスで［保存］または［保存&実行］ボタンをクリックする。

［ジョブの保存］ダイアログボックスが表示されます。［ジョブの保存］ダイアログボックスは、見やすいサイズに変更できます。サイズを変更した場合、次回から変更したサイズで表示されます。

図10‒13　［ジョブの保存］ダイアログボックス

ジョブを保存するフォルダを指定して、［OK］ボタンをクリックする。

選択したフォルダにジョブが保存されます。

手順1.で［保存&実行］ボタンをクリックした場合は、保存すると同時にジョブが実行されます。

(b)　保存したジョブの実行

保存したジョブは、リモートインストールマネージャの［ジョブ定義］ウィンドウで、確認および実行できます。

図10‒14　［ジョブ定義］ウィンドウ

［ジョブ定義］ウィンドウで選択したジョブを実行する方法を次に示します。

［ジョブ定義］ウィンドウで、実行するジョブを選択する。

選択したジョブが反転表示されます。

［実行］−［ジョブの実行］を選択する。

ジョブが実行されます。次のどちらかの方法でジョブを実行することもできます。

［ジョブ実行］ボタンをクリックする。

［F5］キーを押す。

［F5］キーを押した場合、ジョブを実行するかどうかを確認するダイアログボックスが表示されます。確認ダイアログボックスの「以後、確認メッセージを表示しない」チェックボックスをオンにしてジョブを実行すると、次回以降［F5］キーを押したときに、確認ダイアログボックスは表示されません。確認ダイアログボックスを再度表示させたい場合は、［Ctrl］＋［F5］キーを押してジョブを実行してください。

なお、ジョブ作成時に［スケジュール］パネルで「日時を指定して実行」を設定したジョブは、保存後にメニューや［F5］キーでジョブ実行すると、ジョブ実行日時の設定が「即時実行」に変更されます。

(3)　特定のあて先を検索して実行する

［システム構成］または［あて先］ウィンドウから特定のあて先を検索し、ジョブを実行する方法を次に示します。IPアドレス、あて先名、あて先グループ名、ID名などによる検索に加えて、ホストの登録日付による検索ができます。また、あるホストでジョブのエラーが発生したとき、そのホストを検索し、リモートコントロール機能を使って接続して、エラーの原因を調査することもできます。

［システム構成］または［あて先］ウィンドウで、それぞれ実行できる検索方法を次に示します。

ウィンドウ

名称による検索

日付による検索

［システム構成］ウィンドウ

○

○

［あて先］ウィンドウ

○

×

（凡例）○：検索できる　×：検索できない

(a)　名称による検索

IPアドレス、あて先名、あて先グループ名、ID名などの名称をキーにあて先を検索し、ジョブを実行する方法を説明します。

［システム構成］または［あて先］ウィンドウの［オプション］−［検索］を選択する。

［検索］ダイアログボックスが表示されます。［システム構成］ウィンドウから表示した場合と［あて先］ウィンドウから表示した場合とで、ダイアログボックスの表示項目は異なります。

図10‒15　［あて先］ウィンドウから表示した場合の［検索］ダイアログボックス

あて先（［あて先］ウィンドウから表示した場合だけ）

あて先名を検索対象とする場合に指定します。

あて先グループとID（［あて先］ウィンドウから表示した場合だけ）

あて先グループ名とID名を検索対象とする場合に指定します。

検索文字列

検索文字列を最大64バイトで指定します。ただし、次に示す記号および半角スペースは指定できません。

「¥」「/」「*」「"」「:」「!」「|」「<」「>」「?」「%」「@」「'」

指定した文字列を含むあて先が検索されます。

ホスト名を検索

ホスト名をキーにして検索する場合に選択します。

［検索］ダイアログボックスを［あて先］ウィンドウから表示した場合、検索対象に「あて先グループとID」を選択しているときは、非活性になります。

IPアドレスを検索

IPアドレスをキーにして検索する場合に選択します。

［検索］ダイアログボックスを［あて先］ウィンドウから表示した場合、検索対象に「あて先グループとID」を選択しているときは、非活性になります。

完全に一致するものだけを検索

指定した検索文字列と完全に一致するものだけを検索したい場合に、チェックボックスをオンにします。

大文字と小文字を区別する

大文字と小文字を区別して検索したい場合に、チェックボックスをオンにします。

検索条件を設定し、［検索］ボタンをクリックする。

検索が開始され、下部の「検索結果」リストに、検索結果が表示されます。

［検索］ダイアログボックスは、見やすいサイズに変更できます。

「検索結果」リストで、ジョブを実行したいあて先を右クリックし、［ジョブの実行］メニューを選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されますので、選択したあて先に対して、ジョブを実行できます。

(b)　日付による検索

ホストを管理用サーバへ登録した日付でホストを検索し、ジョブを実行する方法を説明します。日付による検索の詳細は、「6.1.2　日付によるホストの検索方法」および「6.1.5　システム構成情報のメンテナンスの例」を参照してください。

［システム構成］ウィンドウの［オプション］−［検索］を選択する。

［検索］ダイアログボックスが表示されます。

［日付による検索］タブを選択する。

図10‒16　［日付による検索］パネル

検索する日付の範囲を指定する。

範囲指定

検索する日付範囲の開始日と終了日の両方、またはどちらか一方を指定します。入力形式はYY/MM/DDで、YYは西暦下2けたを、MMは月を、DDは日を表します。検索できる日付の範囲は1971年1月1日〜2037年12月31日です。

なお、開始日または終了日のどちらか一方だけを指定する場合は、指定しない方のチェックボックスをオフにしておきます。

過去nか月間

現在の日付から何か月前までを検索範囲にするのかを指定します。指定できる月数は1〜999です。デフォルトは、1です。一度検索すると、前回検索時に指定した値が入力されます。ただし、指定した月数が、検索可能範囲である1971年1月1日以前になる場合は、1971年1月1日から現在の日付までが、検索範囲になります。

過去n日間

現在の日付から何日前までを検索範囲にするのかを指定します。指定できる日数は1〜999です。デフォルトは、1です。一度検索すると、前回検索時に指定した値が入力されます。ただし、指定した日数が、検索可能範囲である1971年1月1日以前になる場合は、1971年1月1日から現在の日付までが、検索範囲になります。

検索条件を設定し終わったら、［検索］ボタンをクリックする。

検索が開始され、下部の「検索結果」リストに、検索結果が表示されます。

［検索］ダイアログボックスは、見やすいサイズに変更できます。

「検索結果」リストで、ジョブを実行したいホストを右クリックし、［ジョブの実行］メニューを選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されますので、選択したホストに対して、ジョブを実行できます。

(c)　リモートコントロール機能を利用する

特定のホストを検索し、リモートコントロール機能を使って接続する方法を説明します。これによって、あるホストでジョブのエラーが発生したとき、エラーの原因を容易に調査できます。

［システム構成］または［あて先］ウィンドウの［オプション］−［検索］を選択する。

［検索］ダイアログボックスが表示されます。

あて先を検索する。

検索方法については、「10.3.1(3)(a)　名称による検索」および「10.3.1(3)(b)　日付による検索」を参照してください。

「検索結果」リストで任意のあて先を右クリックし、［リモートコントロールの開始］メニューを選択する。

コントローラが起動します。

次の場合は、［リモートコントロールの開始］ダイアログボックスが表示されますので、操作4を行ってください。

複数のホストを選択した場合

ID名とあて先グループ名で検索し、その検索結果に属するホストが複数存在する場合

図10‒17　［リモートコントロールの開始］ダイアログボックス

コントローラを起動するホストを選択し、［起動］ボタンをクリックする。

選択したホストに対し、コントローラが起動します。

なお、リモートインストールマネージャを使用しているPCで、運用キーをホスト名にしている場合は、次の点に注意してください。

ホスト名を選択して接続する場合は、リモートインストールマネージャを使用しているPCで、アドレス解決できている必要があります。

選択したホストが1台の場合で、そのホストのIPアドレスの情報があるときは、ホスト名とIPアドレスのどちらかを選択して接続できます。ただし、接続先のIPアドレスが動的に変化する環境では、IPアドレスを選択しても、意図したPCに接続できないことがあります。

10.3.2　保存したジョブおよびフォルダの管理

ここでは、フォルダの作成方法と、保存したジョブおよびフォルダを編集する方法について説明します。

(1)　フォルダの作成

フォルダは、ジョブの種類ごとに作成すると、ジョブの管理がしやすくなります。フォルダは階層構成にして作成できます。作成できるフォルダの階層は4階層までです。

フォルダの作成方法を次に示します。

［ジョブ定義］ウィンドウをアクティブにし、［ファイル］−［フォルダの新規作成］を選択する（または、［フォルダの新規作成］ボタンをクリックする）。

［フォルダの作成］ダイアログボックスが表示されます。

フォルダ名を入力する。

フォルダの名称をユニークに設定します。半角で32文字（全角で16文字）までのフォルダ名が設定できます。フォルダ名を設定するときは、次の点に注意してください。

次に示す記号とスペースは使用できません。

「¥」「/」「*」「"」「:」「'」「!」「|」「.」「<」「>」「?」

大文字と小文字は区別されません。

項目を設定後、［追加］ボタンをクリックする。

続けてフォルダを追加したい場合は、手順3.を繰り返してください。

［終了］ボタンをクリックする。

［フォルダの作成］ダイアログボックスが閉じます。

(2)　フォルダ名またはジョブ名の変更

一度設定したフォルダ名やジョブ名を変更する手順を次に示します。

なお、ジョブの実行前にフォルダ名やジョブ名を変更した場合、スケジュール中のジョブが無効になりますので注意してください。

［ジョブ定義］ウィンドウをアクティブにし、名称を変更するフォルダ、またはジョブを選択する。

選択したフォルダ、またはジョブが反転表示されます。

［ファイル］−［名前の変更］を選択する。

名称を設定後、［Enter］キーを押す。

設定した名称に変更されます。

(3)　保存したジョブの修正

ジョブは、保存後もあて先や、ジョブの実行日時・実行期限などの内容を変更できます。

保存したジョブを修正する方法を次に示します。

［ジョブ定義］ウィンドウで修正するジョブを選択し、［編集］−［ジョブ定義の編集］を選択する（または選択したジョブをダブルクリックする）。

［ジョブの編集］ダイアログボックスが表示されます。

このダイアログボックスでは、［ジョブの作成］ダイアログボックスと同様の操作でジョブの定義内容を変更できます。

図10‒18　［ジョブの編集］ダイアログボックス

定義内容を変更後、保存、または実行する。

(4)　フォルダ、ジョブの削除

フォルダ、またはジョブを削除する方法を次に示します。一度削除すると、元に戻すことはできません。フォルダを削除したときは、フォルダ内のジョブおよび下位のフォルダも削除されます。

(a)　削除方法

［ジョブ定義］ウィンドウをアクティブにし、削除するフォルダ、またはジョブを選択する。

選択したフォルダ、またはジョブが反転表示されます。

［編集］−［削除］を選択する。

削除を確認するダイアログボックスが表示されます。［キャンセル］ボタンをクリックすると、削除しないでダイアログボックスを閉じます。

(b)　フォルダまたはジョブを削除するときの注意事項

［スケジュール］パネルで実行日時を設定したジョブは、［ジョブ定義］および［ジョブ実行状況］ウィンドウの両方に表示されます。設定した日時以前に、このジョブを削除する場合、［ジョブ定義］ウィンドウだけでなく、［ジョブ実行状況］ウィンドウからも削除する必要があります。［ジョブ定義］ウィンドウからだけ削除すると、ジョブの定義が削除されるため、設定した実行日時にエラーになります。

10.4　ジョブの実行状況を確認する

ジョブの実行状況は、［ジョブ実行状況］ウィンドウで確認できます。この節では、ジョブの実行状況の確認方法について説明します。確認後に必要な作業については、「10.5　ジョブの実行結果を確認したあとの対処」を参照してください。

10.4.1　ジョブの実行状況を確認するときの設定

ジョブの実行状況を確認するときには、次に示す項目を設定してください。

(1)　記録する実行結果の設定

終了したジョブの実行結果が大量に残っていると、リモートインストールマネージャの動作が遅くなったりする場合があります。そのため、終了したジョブの実行結果は、確認が必要な実行状態のものだけ記録しておくことをお勧めします。記録する実行結果は、JP1/IT Desktop Management 2 - Managerのセットアップの［リモートインストールマネージャを使用した配布のセットアップ］画面の［結果記録オプション］パネルで、ジョブのあて先の属性ごとに設定できます。

(a)　通常のジョブの場合

通常のジョブ（あて先がIDでないジョブ）の場合、「エラー」、「正常終了」の実行状態の中から、配布管理システムに記録しておく状態を選択できます。

なお、次に示すジョブの場合、この設定は無効になり、すべての実行状態が配布管理システムに記録されます。

クライアントユーザによるインストール

コンピュータ（UNIX）のシステム情報の取得※

コンピュータ（UNIX）のソフトウェア情報の取得※

注※

このジョブはMacエージェントにも適用できます。このため、あて先がMacエージェントの場合も、この設定は無効になり、すべての実行状態が配布管理システムに記録されます。

(b)　IDジョブの場合

IDジョブの場合、「エラー」、「完了」、「正常終了」の実行状態の中から、配布管理システムに記録しておく状態を選択できます。

なお、中継システムが管理するIDに属しているコンピュータのジョブは、すべてのジョブ種別でこの設定が有効になります。また、配布管理システムが管理するIDに属しているコンピュータで、「10.4.1(1)(a)　通常のジョブの場合」で示すジョブの場合は、この設定が無効になり、すべての実行状態が配布管理システムに記録されます。

(2)　実行状況の監視間隔の設定

ジョブの実行状況は、一定の間隔で配布管理システムが監視しています。ジョブ実行状況の監視間隔は、［ジョブの環境設定］ダイアログボックスで設定できます。

ジョブの監視間隔を短く設定すると、負荷が大きくなりほかのアプリケーションの動作に影響を与えることがあります。ジョブの監視間隔は、30分〜1時間を目安に設定してください。

［ジョブの環境設定］ダイアログボックスは、［ジョブ実行状況］ウィンドウで、［オプション］−［ジョブ］を選択すると表示されます。

図10‒19　［ジョブの環境設定］ダイアログボックス

ジョブの監視

ジョブの監視間隔を設定します。「監視する」チェックボックスがオンのときに、ジョブ実行状況を監視します。ジョブの監視間隔は、1秒〜10日23時間59分59秒の間で設定できます。デフォルトでは、チェックボックスがオンにされ、監視間隔は15分に設定されます。

ジョブの監視時間を設定すると、［ジョブ実行状況］ウィンドウでは、監視時間が過ぎるたびに、ウィンドウの左枠で選択中の項目、および右枠の全項目の状態が更新されます。ジョブの監視時間を設定していない場合、またはジョブの監視時間外に、情報を更新したい場合は、［ジョブ実行状況］ウィンドウの左枠で、状態を表示させたい項目の1つ上の階層をダブルクリックして、再表示してください。

エージェントの部分読み込み

ジョブ実行状況ウィンドウでは、表示するジョブの対象になるホスト台数の読み込みデータ量を管理できます。

ウィンドウのサイズに合わせる

ウィンドウに表示できるホスト数の約2倍のデータ量を一度に読み込みます。読み込まれなかったデータについては、次回垂直スクロールバーを操作した時点で、新たに読み込まれます。

読み込み数を指定する

1〜2,147,483,647で指定してください。画面に表示できるホスト数に関係なく、指定したホスト数を表示する時点で読み込みます。数百台〜数千台のホストに対して実行されたジョブの結果を見る場合などは、このオプションを指定して読み込むデータ量を制限してください。ただし、指定したホスト数がウィンドウに表示できるホスト数の2倍よりも少ない場合は、ウィンドウに表示できるホスト数の約2倍のデータ量を読み込みます。

10.4.2　ジョブの実行状況を確認するときの注意事項

ジョブの実行状況を確認するときの注意事項を次に示します。

(1)　中継システムおよび管理用中継サーバからの結果通知の保留

配布管理システムからジョブを実行すると、管理対象のコンピュータでは、実行結果を自動的に上位システムに通知します。中継システムおよび管理用中継サーバを経由したジョブの場合、中継システムおよび管理用中継サーバが、配下の管理対象のコンピュータでの実行結果と中継システムおよび管理用中継サーバでの実行結果とをまとめて上位システムに通知します。

しかし、ネットワークが混み合っているときに、中継システムおよび管理用中継サーバからジョブの実行結果が通知されてくると、ネットワークに掛かる負荷が大きくなってしまいます。このような場合は、中継システムおよび管理用中継サーバからの結果の通知を一時的に中断させることができます。結果通知を中断させるには、あて先として中継システムおよび管理用中継サーバを指定した「中継からの結果通知保留」ジョブを実行します。また中断している結果通知を再開させるには、同様に「中継の結果通知保留の解除」ジョブを実行します。

現在中継システムおよび管理用中継サーバからの結果報告が中断されているかどうかは、［システム構成］ウィンドウまたは［あて先］ウィンドウで中継システムおよび管理用中継サーバを選択し、［属性］パネルで確認できます。

なお、通知保留状態となっている中継システムおよび管理用中継サーバがID管理元中継の場合、そのIDを指定したジョブの実行結果も中継システムおよび管理用中継サーバ上で保留されます。

(2)　ジョブを実行しているホストの表示が消えた場合

［ジョブ実行状況］ウィンドウから、ジョブを実行しているホストの表示が消えた場合、管理用中継サーバのリモートインストールマネージャ側で、中継中のジョブを削除していることがあります。

(3)　中継システムおよび管理用中継サーバを経由したジョブの実行状況が変わらない場合

次に示すジョブは、中継システムおよび管理用中継サーバと下位システムの間でファイルの転送が完了するまで、リモートインストールマネージャでは実行状況が変わりません。

パッケージの分割配布を指定したジョブ※

経由した中継システムおよび管理用中継サーバで、下位システムの起動失敗となったジョブ

注※　エージェント設定の［中継システムの設定］−［JP1/IT Desktop Management 2 - Manager への通知設定］で、［下位のJP1/IT Desktop Management 2 - Agentの分割配布の実行状況を、JP1/IT Desktop Management 2 - Managerに通知する］チェックボックスをオンにした場合、実行状況は変わります。

10.4.3　［ジョブ実行状況］ウィンドウで表示される項目

［ジョブ実行状況］ウィンドウで表示される項目について説明します。

(1)　表示項目

［ジョブ実行状況］ウィンドウでは、次の情報が表示されます。

図10‒20　［ジョブ実行状況］ウィンドウ

実行状況

現在のジョブの実行状況が、百分率（%）で表示されます。配布管理システムと管理対象のコンピュータの間に中継システムが1つある構成の場合、中継システムまでジョブが転送されると、50%と表示されます。中継システムが複数ある場合は、中継システムの数に応じて表示される値は変化します。

ジョブの実行状況は次のように変化します。

0%

配布管理システムでジョブが作成されましたが、転送していません。

20%

配布管理システムからジョブの転送を開始しました。なお、分割配布のジョブの場合は、分割配布の進行の割合によって表示が小刻みに進みます。

50%

中継システムまでジョブが転送されています。中継システムがない構成では、この値は表示されません。なお、分割配布のジョブの場合、エージェント設定の［中継システムの設定］−［JP1/IT Desktop Management 2 - Manager への通知設定］で、［下位のJP1/IT Desktop Management 2 - Agentの分割配布の実行状況を、JP1/IT Desktop Management 2 - Managerに通知する］チェックボックスをオンにしていると、分割配布の進行の割合によって表示が小刻みに進みます。

70%

管理対象のコンピュータへジョブが転送され、実行待ちの状態になっています。管理対象のコンピュータに転送された直後に実行されるジョブの場合、この値は表示されません。

100%

ジョブの処理が完了しました。

実行状態

現在のジョブの状態が表示されます。ジョブの実行状態については、「10.4.3(3)(a)　ジョブの実行状態の種類」を参照してください。

完了/エラー/総数

ジョブの完了数、エラー数および総数が表示されます。

選択されたあて先

ジョブの経路と、どの経路まで処理を終了したかが表示されます。青色で表示された経路は処理を開始したことを示し、黒色で表示された経路はまだ処理を終了していないことを示します。

予定日時

ジョブを実行する予定の日時が表示されます。

実行期限

ジョブを実行する期限が表示されます。

実行日時

ジョブを実行した日時が表示されます。

インストール予定日時

パッケージをインストールする予定の日時が表示されます。

(2)　実行状況を示す色

ジョブの実行状況は色分けして表示されます。表示される色と、対応する実行状況を次に示します。

緑色

正常終了したジョブです。

白色

実行中、またはコンピュータが起動していないために実行されていないジョブです。

また、管理対象のコンピュータでユーザのログオンが必要なジョブ、次回起動時に実行が指定されインストール待ちの状態であるジョブ、またはリモートコレクト時収集待ちの状態であるジョブです。

暗い灰色

ジョブの実行が中断されているジョブです。

赤色

エラーが発生したジョブです。

オレンジ色

ファイル転送時に通信エラーが発生したジョブです。ID管理元中継と管理対象のコンピュータ間の通信エラーについては表示されません。

通信エラーの状態になるのは次に示すジョブだけです。

パッケージのインストール※

クライアントユーザによるインストール

中継までのパッケージ転送

コンピュータ（UNIX）のシステム情報の取得※

中継からのコレクトファイル収集

システム構成情報の取得

中継からの結果通知保留

中継の結果通知保留の解除

ただし、通信エラーのジョブを監視するには配布管理システム側のセットアップでの設定が必要です。

注※

このジョブはMacエージェントにも適用できます。このため、あて先がMacエージェントの場合も、通信エラー監視の対象になります。

明るい灰色

中継システム、管理用中継サーバ、および管理対象のコンピュータで削除中のジョブです。デフォルトでは表示されません。

削除中のジョブを表示する方法については、「10.4.4(6)　削除中のジョブを表示する」を参照してください。

1つのジョブに複数の実行状況があるときは、最も悪い状況の色で表示されます。例えば、1つのジョブで複数のパッケージをリモートインストールした場合、実行状況がパッケージによって正常終了、実行中、またはエラーの状態になったときは、表示される色は赤色になります。

(3)　ジョブの実行状態

［ジョブ実行状況］ウィンドウに表示されるジョブの進行度や色、または実行状態からジョブの実行状況の遷移を確認する方法について説明します。

なお、IDジョブの実行状況の遷移を確認する方法については「10.4.5　IDジョブの実行状況の表示方法」を参照してください。

(a)　ジョブの実行状態の種類

［ジョブ実行状況］ウィンドウで表示されるジョブの実行状態の種類を次の表に示します。

表10‒3　ジョブの実行状態の種類

ジョブの実行状態

実行状況

実行状況を示す色

意味

実行待ち

0%

白色

ジョブが作成されたが、配布管理システムで転送待ちとなっている。

実行中

20%〜70%

白色

管理対象のコンピュータへジョブを転送中、またはジョブを実行中。

起動失敗※1

0%〜50%

白色

ジョブを転送しようとしたが中継システムまたは管理対象のコンピュータが起動していない。

中断中

20%〜70%

暗い灰色

中断指示が出ているため、ジョブの実行を中断している。

再開中

20%〜70%

白色

再開指示が出ているため、ジョブの実行を再開している。

インストール／収集待ち

70%

白色

管理対象のコンピュータ側で、リモートインストール待ちまたは収集待ちとなっている、またはジョブが保留されている。

インストール拒否

70%

明るい灰色

パッケージのインストール拒否はできないが、UNIXエージェントでインストール拒否コマンド（rdsinsset -d）が実行された。

正常終了※2

100%

緑色

正常に実行が終了している。

エラー

0%

赤色

実行時にエラーが発生した。

通信エラー

0%〜70%

オレンジ色

ファイルの転送時に通信エラーが発生している。

削除中

なし

明るい灰色

中継システム、管理用中継サーバ、および管理対象のコンピュータでジョブを削除中。

注※1

起動失敗要因を細分化するよう設定している場合、次のように表示されます。

JP1/IT Desktop Management 2が停止しているため起動失敗したとき：「起動失敗（JP1/IT Desktop Management 2停止状態）」

PCの電源がオフであるため起動失敗したとき：「起動失敗（電源オフ）」

上記以外の要因（ネットワーク障害など）で起動失敗したとき：「起動失敗」

なお、起動確認用のパケットが消失したときには、「起動失敗（電源オフ）」と表示されます。

注※2

ジョブ種別が「パッケージのインストール」の場合、次のように表示されます。

パッケージのインストールが実行されたとき：「正常終了」

パッケージが配布済みでインストールが実行されなかったとき：「正常終了（配布済み）」

(b)　ジョブの実行状態の遷移

ジョブの実行状態は、ジョブの実行状況に応じて変化します。ジョブの実行状態の遷移を次に示します。

図10‒21　ジョブの実行状態の遷移

(4)　ジョブの実行状況の遷移例

次に、システム起動時にパッケージをインストールするジョブの実行状況の遷移例を示します。

表10‒4　実行状況の遷移例（パッケージのインストールジョブ）

ジョブの実行状況

ジョブ実行状況ウィンドウに

表示される項目

ジョブの進行度

ジョブの色

実行状態

ジョブが作成され、配布管理システムで転送待ちとなっている

0%

白色

実行待ち

ジョブの転送が開始された

20%

白色

実行中

中継システムが配布管理システムから中断指示を受けて、ジョブの中断指示を出した

50%

暗い

灰色

中断中

中継システムが配布管理システムから再開指示を受けて、ジョブの再開指示を出した

50%

白色

実行中

ジョブを転送しようとしたが、管理対象のコンピュータが起動していない

50%

白色

起動失敗

管理対象のコンピュータにジョブが転送された

70%

白色

インストール/収集待ち

管理対象のコンピュータが起動され、ジョブの実行が開始された

70%

白色

実行中

ジョブがエラーになった

0%

赤色

エラー

ジョブの実行が正常に終了した

100%

緑色

正常終了

10.4.4　ジョブの実行状況の表示方法

ウィンドウで階層ごとに表示させるほかに、階層下のすべてのジョブまたはジョブの詳細を一度に表示させることもできます。ジョブまたはジョブの詳細を一度に表示させることで、複数のフォルダがあるときなどに、効率良く実行状況を表示できます。次に、それぞれの表示方法を説明します。

階層ごとの情報を表示する。

階層下のすべてのジョブを表示する。

階層下のすべてのジョブの詳細情報を表示する。

表示する日時項目を選択する。

条件を指定して情報の表示順序を変える。

削除中のジョブを表示する。

なお、IDジョブの実行状況の表示方法については「10.4.5　IDジョブの実行状況の表示方法」を参照してください。

(1)　階層ごとの情報を表示する

選択した階層内の情報を表示する方法を次に示します。

［ジョブ実行状況］ウィンドウで［表示］−［指定された情報のみ表示］を選択する。

情報を表示させる階層を選択する。

選択した階層内の情報が表示されます。

図10‒22　［ジョブ実行状況］ウィンドウ（階層ごとの情報を表示する）

(2)　階層下のすべてのジョブを表示する

選択した階層下のすべてのジョブを表示する方法を次に示します。

［ジョブ実行状況］ウィンドウで［表示］−［すべてのジョブの表示］を選択する。

情報を表示させる階層を選択する。

選択した階層下のすべてのジョブが表示されます。

図10‒23　［ジョブ実行状況］ウィンドウ（階層下のすべてのジョブを表示する）

ジョブの情報として、次の項目が表示されます。

ジョブ/あて先/パッケージ

ジョブまたはジョブの実行対象となるホストかパッケージの名称が表示されます。

実行日時

ジョブを実行した日時が表示されます。

実行状態

ジョブの実行状態が表示されます。

予定日時

ジョブを実行する予定の日時が表示されます。

実行期限

ジョブの実行期限が表示されます。

なお、ウィンドウの右枠でジョブを選択後、［表示］−［ジョブの詳細情報の表示］を選択（またはジョブをダブルクリック）すると、［ジョブ情報］ダイアログボックスが表示されます。

図10‒24　［ジョブ情報］ダイアログボックス

［ジョブ情報］ダイアログボックスには、次の項目が表示されます。

ジョブ名

ジョブの名称が表示されます。

日時項目

ジョブに設定された日時に関する情報が表示されます。

ジョブ実行日時

ジョブを実行した日時が表示されます。

ジョブ実行予定

ジョブを実行する予定の日時が表示されます。

ジョブ実行期限

ジョブを実行する期限が表示されます。

ジョブ詳細実行状態

ジョブの詳細な実行状態ごとに、該当する数が表示されます。［合計］には、該当する数を合計した数が表示されます。

(3)　階層下のすべてのジョブの詳細情報を表示する

選択した階層下のすべてのジョブの詳細を表示する方法を次に示します。

［ジョブ実行状況］ウィンドウで［表示］−［すべてのジョブ詳細の表示］を選択する。

情報を表示させる階層を選択する。

選択した階層下のすべてのジョブの詳細が表示されます。

図10‒25　［ジョブ実行状況］ウィンドウ（階層下のすべてのジョブの詳細情報を表示する）

ジョブの詳細情報として、次の項目が表示されます。

なお、リモートコレクト時には、リモートコレクトしたファイルのパス（ファイルを格納したディレクトリやファイルの名称）が、ジョブの詳細に表示されます。アーカイブされたファイルを復元するときは、ファイルのパスを確認後、アンアーカイバを使用してください。

ジョブ/あて先/パッケージ

ジョブまたはジョブの実行対象となるホストかパッケージの名称が表示されます。

あて先

ジョブの実行対象となるホストの名称が表示されます。

パッケージ

ジョブの実行対象となるパッケージの名称が表示されます。

パッケージ識別ID

ジョブの実行対象となるパッケージの識別IDが表示されます。

バージョン

ジョブの実行対象となるパッケージのバージョンが表示されます。

世代番号

ジョブの実行対象となるパッケージの世代番号が表示されます。

実行日時

ジョブを実行した日時が表示されます。

実行状態

ジョブの実行状態が表示されます。

組込みタイミング

パッケージをインストールするタイミングが表示されます。

上記の項目以外に、パッケージについての詳細やジョブのエラー原因、保守コードなどのさらに詳細な情報を表示することもできます。表示方法を次に示します。

ウィンドウの右枠でジョブの詳細を選択後、［表示］−［ジョブの詳細情報の表示］を選択する（またはジョブの詳細をダブルクリックする）。

［詳細情報］ダイアログボックスが表示されます。

図10‒26　［詳細情報］ダイアログボックス

パッケージ情報

パッケージ名、パッケージ識別ID、パッケージの保管期限など、パッケージに関する情報が表示されます。

詳細情報

ジョブ種別、ジョブの実行経路、保守コードなど、ジョブに関する情報が表示されます。また、「説明」の欄に、ジョブのエラー要因などが表示されます。

なお、「エラー関数」に「UNIX」と表示されている場合、「エラー理由」に表示される番号は、UNIX版、Mac版のJP1/IT Desktop Management 2 - Agentから通知されたメッセージIDです。

分割配布情報

分割配布のパッケージの場合に活性化されます。パッケージの分割サイズ、転送休止時間および分割配布状況が表示されます。

分割配布状況は、「転送済みサイズ / 全体サイズ（単位：キロバイト）」で表示されます。

転送済みサイズは中継システムを経由するたびにリセットされ、0から表示されます。

(4)　表示する日時項目を選択する

表示する日時項目を指定して表示する方法を次に示します。

［ジョブ実行状況］ウィンドウで［表示］−［表示情報の設定］を選択する。

［表示する項目の設定］ダイアログボックスが表示されます。

図10‒27　［表示する項目の設定］ダイアログボックス

ダイアログボックスに表示される項目を次に示します。

表示する日時項目の種類

表示する日時の項目を設定します。チェックボックスをオンにした項目について表示します。

予定日時

ジョブを実行する予定の日時を表示します。

実行期限

ジョブを実行する期限を表示します。

実行日時

ジョブを実行した日時を表示します。

インストール予定日時

パッケージのインストール日時を表示します。

コメントの種類

ジョブのあて先でキー項目のほかに表示したい場合に設定できます。キー項目として設定されている項目は淡色表示になっています。設定できるコメントは、「サブキー」、「ホスト識別子」または「コメント」です。

表示したい項目を設定して、［OK］ボタンをクリックする。

設定した項目が表示されます。

(5)　条件を指定して情報の表示順序を変える

［ジョブ実行状況］ウィンドウの右枠に表示する情報の並び順は、条件を設定して並べ替えることができます。ジョブの実行日時やあて先名などを条件にジョブの実行状況の表示を並べ替えることができ、実行状況の確認が容易になります。

情報の並べ替えの方法を次に示します。

［ジョブ実行状況］ウィンドウで［表示］−［並べ替え］を選択する。

［ソート順序の設定］ダイアログボックスが表示されます。このダイアログボックスで表示順を設定して［OK］ボタンをクリックすると、［ジョブ実行状況］ウィンドウの右枠に表示されている情報の表示順序が変更されます。

図10‒28　［ソート順序の設定］ダイアログボックス

優先順位の設定

並べ替えのキー（基準となる項目）を設定します。

並べ替えるときは、最初に「1番目に優先するキー」が基準になります。並べ替えたときに同じ順位のものがあれば、それらについて、「2番目に優先するキー」が基準になります。さらに、並べ替えたときに同じ順位のものがあれば、「3番目に優先するキー」が基準になります。

キーを設定しないときは「（なし）」を選択します。

未実行ジョブを優先してソートする

未実行のジョブを上方または下方に表示します。デフォルトでは、未実行のジョブを上方に表示します。未実行のジョブを下方に表示させる場合は、チェックボックスをオフにしてください。

(6)　削除中のジョブを表示する

［ジョブ実行状況］ウィンドウでジョブを削除したときに、削除対象のジョブが転送先の中継システム、管理用中継サーバ、および管理対象のコンピュータで削除されるまで、そのジョブを表示したままにできます。削除が完了していないジョブは「（削除中）」と表示され、システム全体で削除が完了してから、ジョブの表示が消えます。ただし、ジョブが中継システム、管理用中継サーバ、および管理対象のコンピュータで実行される前に削除されたかどうかは、エージェントのインストールパッケージ情報で確認してください。

削除中のジョブを表示する方法を次に示します。

［ジョブ実行状況］ウィンドウで［表示］−［削除中のジョブを表示する］を選択する。

中継システム、管理用中継サーバ、および管理対象のコンピュータで削除が完了していないジョブは、ジョブの名称の末尾に「（削除中）」と表示されます。「（完了/エラー/総数）」には、削除中のジョブの総数が表示されます。

図10‒29　［ジョブ実行状況］ウィンドウ（削除中のジョブを表示する）

10.4.5　IDジョブの実行状況の表示方法

あて先にIDを指定したジョブのうち、次に示すジョブは［ジョブ実行状況］ウィンドウで実行状況を確認できます。

パッケージのインストール

クライアントユーザによるインストール

次に、IDを指定したジョブの実行状況を確認する方法について説明します。

(1)　ID管理元中継ごとのジョブ実行状況を表示する

IDを指定したジョブを管理している中継システムごとに、実行状況を確認する方法について次に示します。

［ジョブ実行状況］ウィンドウで［表示］メニューの［IDジョブエージェント表示］のチェックをオフにする。

IDを指定したジョブをダブルクリックする。

ジョブの階層下にIDが表示されます。

図10‒30　ジョブの階層下にIDが表示された［ジョブ実行状況］ウィンドウ

IDをダブルクリックする。

IDの階層下に、IDを管理している中継システムが表示されます。右枠の「ジョブ/あて先/パッケージ」にはパッケージ名が表示されます。

図10‒31　IDの階層下に中継システムが表示された［ジョブ実行状況］ウィンドウ

(a)　IDジョブの実行状態の種類

［IDジョブエージェント表示］のチェックをオフにした場合に、［ジョブ実行状況］ウィンドウで表示されるIDジョブの実行状態の種類を次に示します。

［IDジョブエージェント表示］のチェックをオンにし、［ジョブ実行状況］ウィンドウの左枠で管理対象のコンピュータを選択したときに表示されるジョブの実行状態の種類については、「10.4.3(3)(a)　ジョブの実行状態の種類」を参照してください。

表10‒5　IDジョブの実行状態の種類

ジョブの実行状態

実行状況

実行状況を示す色

意味

実行待ち

0%

白色

ジョブが作成されたが、配布管理システムで転送待ちとなっている。

登録中

登録中

白色

ジョブをID管理元中継へ転送中。

マネージャからID管理元中継へジョブを転送中。

待機中

待機中

白色

ジョブをID管理元中継から管理対象のコンピュータへ転送中、またはジョブを実行中。

完了

完了

緑色

中継システムで管理しているパッケージが削除された。

実行待ち

0%

赤色

実行時にエラーが発生した。

(b)　IDジョブの実行状態の遷移

［IDジョブエージェント表示］のチェックをオフにした場合の、IDジョブの実行状態の遷移を次に示します。

図10‒32　IDジョブの実行状態の遷移

(2)　管理対象のコンピュータごとの実行状況を表示する

IDを指定したジョブの管理対象のコンピュータでの実行状況を確認する方法について次に示します。

［ジョブ実行状況］ウィンドウで［表示］メニューの［IDジョブエージェント表示］のチェックをオンにする。

IDを指定したジョブをダブルクリックする。

ジョブの階層下にIDが表示されます。

図10‒33　ジョブの階層下にIDが表示された［ジョブ実行状況］ウィンドウ

IDをダブルクリックする。

IDに属している管理対象のコンピュータがIDの階層下に表示されます。

図10‒34　IDの階層下に管理対象のコンピュータが表示された［ジョブ実行状況］ウィンドウ

管理対象のコンピュータをクリックする。

右枠に、選択した管理対象のコンピュータでのジョブの実行状況が表示されます。

図10‒35　選択した管理対象のコンピュータでのジョブの実行状況が表示された［ジョブ実行状況］ウィンドウ

パッケージをダブルクリックすると、［詳細情報］ダイアログボックスが表示されます。

図10‒36　［詳細情報］ダイアログボックス

(3)　IDジョブの実行状況を確認するときの注意事項

IDを指定したジョブの実行状況を確認するときには、次の点に注意してください。

配布管理システムでは、IDを管理している中継システムと管理対象のコンピュータ間で通信エラーが発生したジョブの実行状況の表示はできません。

10.4.6　特定の実行状況のジョブの表示方法

JP1/IT Desktop Management 2 - Managerでは、特定の実行状況のジョブだけを表示できます。これによって、エラーのジョブだけを表示したり、逆に、正常終了したジョブだけを表示したりできます。特定の実行状況のジョブだけを表示するには、［表示］−［ジョブの種類の指定］を選択し、［表示するジョブの選択］ダイアログボックスで、表示条件を設定します。特定の実行状況のジョブだけを表示したあと、再度すべてのジョブを表示するには、［表示］−［全種類のジョブの表示］を選択します。

次に、［表示するジョブの選択］ダイアログボックスで設定できる項目について説明します。

図10‒37　［表示するジョブの選択］ダイアログボックス

表示ジョブ

表示するジョブのあて先の種類を指定します。

すべてのジョブ

すべてのジョブを表示します。

通常ジョブ

あて先にノードを設定しているジョブを表示します。

IDジョブ

あて先にIDを指定しているジョブを表示します。

ジョブ種別

選択したジョブ種別のジョブを表示します。選択するときは、ジョブ種別の左側にあるチェックボックスをオンにします。デフォルトでは、すべて選択されています。

ジョブ実行状態

選択した実行状態のジョブを表示します。選択するときは、ジョブ実行状態の左側にあるチェックボックスをオンにします。この項目は、［ジョブ実行状況］ウィンドウで［表示］−［すべてのジョブの表示］を選択しているときだけ選択できます。

実行状態を複数選択したときは、選択した実行状態のうち1つでも該当するジョブをすべて表示します。

次に、それぞれの実行状態について説明します。

すべて正常終了

正常に実行が終了したジョブを表示します。

1つでもエラー

実行時にエラーが発生したジョブを表示します。

1つでもインストール/収集待ち

中継システム、管理用中継サーバ、および管理対象のコンピュータで、リモートインストール待ちまたは収集待ちがあるジョブを表示します。

1つでも実行中/登録中/待機中/起動失敗

実行中のジョブ、またはIDを指定したジョブのうち登録中もしくは待機中のジョブを表示します。

1つでも実行待ち

スケジュールされたジョブのうち、実行されていないジョブを表示します。

削除中

中継システム、管理用中継サーバ、および管理対象のコンピュータで削除中のジョブを表示します。

ジョブ詳細実行状態

選択した実行状態のジョブの詳細を表示します。選択するときは、ジョブ詳細実行状態の左側にあるチェックボックスをオンにします。この項目は、［ジョブ実行状況］ウィンドウで［表示］−［すべてのジョブ詳細の表示］を選択しているときだけ選択できます。

実行状態を複数選択したときは、選択した実行状態のうち1つでも該当するジョブの詳細をすべて表示します。

次に、それぞれの実行状態について説明します。

正常終了

正常に実行が終了したジョブの詳細を表示します。

エラー

実行時にエラーが発生したジョブの詳細を表示します。

中断中/再開中

中断状態のため実行を一時中断しているジョブ、または再開指示が出ているために実行を再開しようとしているジョブの詳細を表示します。

インストール/収集待ち

中継システム、管理用中継サーバ、および管理対象のコンピュータで、リモートインストール待ちまたは収集待ちとなっているジョブの詳細を表示します。

実行中/登録中/待機中/起動失敗

実行中のジョブ、またはIDを指定したジョブのうち登録中もしくは待機中のジョブの詳細を表示します。

実行待ち

スケジュールされたジョブのうち、実行されていないジョブの詳細を表示します。

削除中

中継システム、管理用中継サーバ、および管理対象のコンピュータで削除中のジョブを表示します。

実行日時

ジョブを実行した日時を条件として設定できます。設定するときは、実行日時の左側にあるチェックボックスをオンにします。また、日時の範囲を設定することもできます。日時の範囲は、次に示すプルダウン形式の一覧から選択できます。

この間

左枠に設定した日時から、右枠に設定した日時までを範囲とします。

より小さい

左枠に設定した日時未満の日時を範囲とします。

より大きい

左枠に設定した日時を超える日時を範囲とします。

より小さいか等しい

左枠に設定した日時以前を範囲とします。

より大きいか等しい

左枠に設定した日時以降を範囲とします。

と等しい

特定の日時を設定するときに選択します。日時は、左枠に設定します。

実行予定日時

ジョブを実行する予定の日時を条件として設定できます。設定するときは、実行予定日時の左側にあるチェックボックスをオンにします。日時の範囲の設定方法は、実行日時のときと同様です。

実行期限

ジョブを実行する期限を条件として設定できます。設定するときは、実行期限の左側にあるチェックボックスをオンにします。期限の範囲の設定方法は、実行日時のときと同様です。

10.5　ジョブの実行結果を確認したあとの対処

ここでは、ジョブ削除方法や実行エラーが発生したジョブの再実行方法など、ジョブの実行結果を確認してからの対処方法について説明します。

10.5.1　ジョブの削除

ここでは、ジョブ削除の流れ、ジョブを削除する方法、およびジョブを削除するときの注意事項について説明します。

(1)　ジョブ削除の流れ

上位システムでジョブの削除操作をした場合、そのジョブがすでに下位システムに転送されていたときは、下位システムにダウンロードされたジョブも連携して削除されます。ジョブを削除したときの流れを次の図に示します。

図10‒38　ジョブを削除したときの流れ

配布管理システムでジョブAを削除する。

［ジョブ実行状況］ウィンドウで削除中のジョブを表示する場合、削除対象のジョブAは「（削除中）」と表示されます。

中継システムおよび管理用中継サーバに転送されていたジョブAが削除される。

さらに下位のシステムにジョブAが転送されているので、［ジョブ実行状況］ウィンドウでは「（削除中）」と表示されたままです。

管理対象のコンピュータに転送されていたジョブAが削除される。

システム全体でジョブAを削除完了したことが配布管理システムに通知され、［ジョブ実行状況］ウィンドウからジョブAの表示が消えます。

(2)　ジョブの削除方法

［ジョブ実行状況］ウィンドウでジョブを削除する方法を次に示します。一度削除すると、元に戻すことはできません。フォルダを削除したときは、フォルダ内のジョブおよび下位のフォルダも削除されます。

［ジョブ実行状況］ウィンドウをアクティブにし、削除するフォルダ、またはジョブを選択する。

選択したフォルダ、またはジョブが反転表示されます。

［編集］−［削除］を選択する。

削除を確認するダイアログボックスが表示されます。［キャンセル］ボタンをクリックすると、削除しないでダイアログボックスを閉じます。

(3)　ジョブを削除するときの注意事項

ジョブを削除するときの注意事項を次に示します。

［スケジュール］パネルで実行日時を設定したジョブは、［ジョブ実行状況］および［ジョブ定義］ウィンドウの両方に表示されます。このジョブを、設定した日時以前に削除する場合、［ジョブ実行状況］ウィンドウだけでなく、［ジョブ定義］ウィンドウからも削除する必要があります。

削除中のジョブに対してさらに削除操作をすると、中継システム、管理用中継サーバ、および管理対象のコンピュータでジョブが削除されるのを待たないで強制削除します。また、強制削除のタイミングによっては、中継システム、管理用中継サーバ、および管理対象のコンピュータにジョブの削除が指示される前に配布管理システムのジョブが強制削除されることがあります。この場合、中継システム、管理用中継サーバ、および管理対象のコンピュータに送信されたジョブは、削除されないで実行されることがあります。中継システム、管理用中継サーバ、および管理対象のコンピュータにジョブの削除が指示されているかどうかは、ジョブの詳細情報で表示される保守コードの数値で確認できます。

保守コードの左から3〜4番目が「10」の場合

ジョブの削除が指示されている。

保守コードの左から3〜4番目が「20」の場合

ジョブの削除が指示されていない。

エージェント設定の［利用者への通知設定］−［通知ダイアログの表示設定］で、［ジョブの実行に失敗した場合に表示する］のチェックボックスをオンにしている場合、実行状態が実行待ちまたは通信エラーのジョブを削除すると、配布先システムでエラーダイアログボックスが表示される場合があります。

「クライアントユーザによるインストール」ジョブを［ジョブ実行状況］ウィンドウから削除すると、ジョブの削除と連携して、パッケージセットアップマネージャのパッケージ一覧からもパッケージが削除されます。

10.5.2　エラージョブの再実行

複数のあて先に対してジョブを実行すると、あて先によっては、ジョブが正常終了する場合もあれば、実行待ちまたは接続エラーなどによって実行エラーになりジョブが終了しない場合もあります。正常に終了しなかったあて先には再度ジョブを実行する必要がありますが、すべてのあて先に対してジョブを再実行する必要はありません。実行待ちまたはエラーになったあて先だけにジョブを再実行できます。

ここでは、ジョブを再実行するために必要な設定と、ジョブを再実行する方法について説明します。

(1)　エラージョブを再実行するために必要な設定

ジョブを再実行するためには、あらかじめ、配布管理システムでジョブの実行結果を記録するよう設定しておく必要があります。

(a)　通常のジョブを再実行する場合

通常のジョブ（あて先がIDでないジョブ）を再実行するには、配布管理システムで実行結果を管理しておく必要があります。JP1/IT Desktop Management 2 - Managerのセットアップで、［リモートインストールマネージャを使用した配布のセットアップ］画面の［結果記録オプション］パネルの［ジョブの実行結果を記録する］のチェックボックスをオンにしておいてください。

(2)　エラージョブの再実行方法

ジョブの再実行は、［ジョブ実行状況］ウィンドウで、実行待ちまたは実行エラーのあて先に指示できます。1回の指示で1ジョブの複数のあて先を指定できます。複数のジョブを同時に再実行することはできません。

次に、ジョブを再実行する方法を示します。

再実行するジョブを選択する。

IDジョブを再実行する場合は、IDを管理している中継システムを選択してください。

［ジョブ実行状況］ウィンドウのメニューから［実行］−［ジョブの再実行］を選択する。

［ジョブの再実行］ダイアログボックスが表示されます。

図10‒39　［ジョブの再実行］ダイアログボックス

再実行するジョブ

再実行を要求されたジョブのジョブ名が表示されます。ジョブ内の管理用中継サーバ、中継システム、および管理対象のコンピュータを選択して再実行を要求した場合も表示されます。

再実行するあて先

再実行の対象となる、管理用中継サーバ、中継システム、および管理対象のコンピュータが表示されます。［ジョブ実行状況］ウィンドウからあて先を複数選択した場合は2つ目以降のあて先の表示は省略されます。

すべてのあて先

［ジョブ実行状況］ウィンドウからジョブを選択して再実行を要求した場合に表示されます。ジョブ内のすべての管理用中継サーバ、中継システム、および管理対象のコンピュータが再実行の対象となります。

再実行の方法

再実行の対象となる管理用中継サーバ、中継システム、および管理対象のコンピュータの状態を指定します。

実行待ち

実行待ちとなっている管理用中継サーバ、中継システム、および管理対象のコンピュータに対して、選択されたジョブを受信するように、再度要求します。

一時エラー

通信エラーまたは起動失敗となっている中継システム、管理用中継サーバ、および管理対象のコンピュータに対して、再度ジョブの実行を促します。中継システムおよび管理用中継サーバ下での「一時エラー」に対しては、「中継下ノード再実行」フォルダに再実行要求ジョブが作成されます。「一時エラー」ジョブの再実行では、再実行によってジョブのステータスが変更されることはなく、通信障害の回復時に変更されます。再実行を繰り返すと、再実行要求ジョブがむだに作成されますのでご注意ください。

実行エラー

実行エラーとなっている要求だけを抽出し、管理用中継サーバ、中継システム、および管理対象のコンピュータに対して、再度実行を要求します。

［実行］ボタンをクリックする。

設定した内容でジョブが再実行されます。

10.5.3　障害が発生した中継システムを回避してジョブを実行する

中継システムに障害が発生した場合、この中継システムに接続している管理対象のコンピュータへ、別の中継システムを経由してジョブを実行できます。

経路を変更してジョブを実行するには、［ジョブの作成］ダイアログボックスで、変更後の経路を指定したジョブを作成します。経路の変更方法については、「10.2.4　［あて先］パネルの設定」を参照してください。

10.5.4　分割配布したジョブを強制完了する

強制完了は、分割配布のジョブを途中で中止し、転送していない残りのパッケージを一括して転送することです。分割配布したジョブを強制完了するには、［ジョブ実行状況］ウィンドウで［実行］−「分割配布の強制完了」を選択してください。強制完了になったジョブは、システム直下のシステムから配布先システムに転送されるまで、分割しないでパッケージを一括して転送（通常配布）します。ただし、分割配布の強制完了は、強制完了を実行したシステム直下のすべてのシステムに対し、分割配布中の場合にだけ有効になります。また、中断中および再開中のジョブは強制完了できません。

なお、強制完了を実行したシステム直下の中継システムおよび管理用中継サーバに対してだけ分割配布を強制完了し、その中継システムおよび管理用中継サーバ下の配布先システムへの分割配布は実行させたい場合、同じパッケージを「中継までのパッケージの転送」ジョブで実行してください。中継システムおよび管理用中継サーバまでの分割配布については、強制完了を実行したこと（通常配布）になり、中継システムおよび管理用中継サーバ下の配布先システムへは分割配布になります。

10.6　ジョブを作成する画面をカスタマイズする

［ジョブ定義の新規作成］ダイアログボックス、および［ジョブの作成］ダイアログボックスは、項目の並び順やデフォルト値をユーザの運用に合わせ、カスタマイズできます。

10.6.1　［ジョブ定義の新規作成］ダイアログボックスのカスタマイズ

［ジョブ定義の新規作成］ダイアログボックスに表示されるジョブ種別の並び順をカスタマイズする方法を次に示します。

［ジョブ定義］ウィンドウで［編集］−［ジョブ定義のカスタマイズ］を選択する。

［ジョブ定義のカスタマイズ］ダイアログボックスが表示されます。

［ジョブ新規作成ダイアログ］を選択する。

［ジョブ新規作成ダイアログのカスタマイズ］ダイアログボックスが表示されます。

図10‒40　［ジョブ新規作成ダイアログのカスタマイズ］ダイアログボックス

右枠に［ジョブ定義の新規作成］ダイアログボックスに表示するジョブ種別を表示します。初期状態ではすべてのジョブ種別が表示されています。左枠には、［ジョブ定義の新規作成］ダイアログボックスに表示しないジョブ種別を表示します。

左枠でジョブ種別を選択し、［>］ボタンをクリックすると、選択したジョブ種別が追加されます。右枠でジョブ種別を選択し、［<］ボタンをクリックすると、ジョブ種別が削除されて選択元に移動します。選択後のジョブ種別からすべてを削除したい場合は、［<<］ボタンをクリックしてください。

［↑］は、選択後のリストを上位方向に移動するときに使用します。［↓］は、選択後のリストを下位方向に移動するときに使用します。

ジョブ種別の並び順を設定し、［OK］ボタンをクリックする。

設定を保存して、［ジョブ新規作成ダイアログのカスタマイズ］ダイアログボックスを閉じます。

10.6.2　［ジョブの作成］ダイアログボックスのカスタマイズ

ユーザの運用に合わせて、［ジョブの作成］ダイアログボックスで設定する各項目のデフォルト値を変更できます。

(1)　操作方法

［ジョブの作成］ダイアログボックスのデフォルト値を変更するための操作方法を説明します。

［ジョブ定義］ウィンドウで［編集］−［ジョブ定義のカスタマイズ］を選択する。

［ジョブ定義のカスタマイズ］ダイアログボックスが表示されます。

「ジョブの作成ダイアログ」を選択する。

［ジョブの作成ダイアログのカスタマイズ］ダイアログボックスが表示されます。

図10‒41　［ジョブの作成ダイアログのカスタマイズ］ダイアログボックス

［ジョブの作成ダイアログのカスタマイズ］ダイアログボックスのパネル名および項目名は、［ジョブの作成］ダイアログボックスのパネル名および項目名と対応しています。［ジョブの作成ダイアログのカスタマイズ］ダイアログボックスで設定した値が、［ジョブの作成］ダイアログボックスのデフォルト値になります。

デフォルト値をカスタマイズできる項目については、「10.6.2(2)　カスタマイズできる項目」を参照してください。

デフォルト値を変更して、［OK］ボタンをクリックする。

［ジョブの作成］ダイアログボックスのデフォルト値が変更されます。

(2)　カスタマイズできる項目

［ジョブの作成ダイアログのカスタマイズ］ダイアログボックスのパネルごとに、カスタマイズできる項目とデフォルト値を示します。

［あて先］パネル

カスタマイズできる項目

デフォルト値

あて先の属性

あて先グループ

追加元※

あて先

注※　［追加］ボタンをクリックすると表示される項目です。

［ジョブの配布属性］パネル

カスタマイズできる項目

デフォルト値

中断中のあて先への配布

配布しない

配布の方式※1

ユニキャスト配布

分割配布の設定

分割配布しない

分割サイズ

非活性※2

転送休止時間

非活性※2

注

次に示すジョブ種別を指定した場合に表示されます。

・パッケージのインストール

・中継までのパッケージの転送

・クライアントユーザによるインストール

注※1

ジョブ種別が「中継までのパッケージの転送」または「クライアントユーザによるインストール」の場合、デフォルト値の設定に関係なく、［ジョブの作成］ダイアログボックスでは、常に「ユニキャスト配布」に設定されます。

注※2

「分割配布の設定」で「分割配布する」を選択すると、値を設定できます。

［コレクトファイル］パネル

［詳細］ボタンをクリックしたときに表示される［リモートコレクトの詳細オプション設定］ダイアログボックス中の、次の項目の値を設定できます。

カスタマイズできる項目

デフォルト値

収集タイミング

エージェント稼働中

圧縮指定

圧縮あり

エージェントでの外部プログラム起動

空欄

［取得項目（システム情報）］パネル

ジョブ種別が「コンピュータ（UNIX）のシステム情報の取得」の場合に表示される、［ジョブの作成］ダイアログボックスの［取得項目］パネルに対応しています。

カスタマイズできる項目

デフォルト値

システム情報

前回取得したシステム情報から変更された項目だけを取得する

［検索対象（ソフトウェア情報）］パネル

ジョブ種別が「コンピュータ（UNIX）のソフトウェア情報の取得」の場合に表示される、［ジョブの作成］ダイアログボックスの［検索対象］パネルに対応しています。

カスタマイズできる項目

デフォルト値

検索対象ソフトウェア

リモートインストールしたソフトウェア

検索リスト

非活性※

検索対象のファイルシステム

非活性※

注※

「検索対象ソフトウェア」で「すべてのソフトウェア」を選択すると、値を設定できます。

［スケジュール］パネル

カスタマイズできる項目

デフォルト値

サーバでのジョブ実行日時

即時実行

エージェントでのジョブ実行日時

即時実行

実行タイミングの設定

稼働中に実行

［クライアント制御］パネル

カスタマイズできる項目

デフォルト値

対象のコンピュータが稼働していない場合に起動する

オフ

ジョブ実行後クライアントをシャットダウンさせる

オフ

11　管理情報を出力する

ここでは、配布管理システムで管理している情報を、CSV形式ファイルに出力したり、印刷したりする方法について説明します。

11.1　CSVファイル出力でファイルを出力する

配布管理システムで管理している情報（管理情報）を、CSV形式ファイルに出力できます。

ここでは、CSVファイル出力を使って、管理情報をCSV形式ファイルに出力する方法について説明します。

11.1.1　CSV形式ファイルに出力できる項目

CSVファイル出力では、出力する情報のテンプレートを用意しています。テンプレートごとに、CSV形式ファイルに出力できる項目を次の表に示します。

表11‒1　CSV形式ファイルに出力できる項目

テンプレート名

出力項目

あて先属性

ホスト名称、IPアドレス、ホスト識別子、MACアドレス、タイプ、経路、所属グループ※1、結果通知の保留、ファイル転送中断、コメント、作成日時、更新日時、インストールパッケージ情報最終更新日時

パッケージ属性

キャビネット名称、キャビネット識別ID、パッケージ名称、パッケージ識別ID、バージョン、世代番号、パッケージ容量、転送サイズ、登録日、満了日付、パッケージ種別、インストールモード、パッケージ圧縮、リストア、再起動指定、処理中ダイアログ表示

パッケージ内容

キャビネット名称、キャビネット識別ID、バージョン、世代番号、ファイル名、サイズ、更新日時

インストール済みパッケージ情報

ホスト名称、IPアドレス、パッケージ名称、パッケージ識別ID、インストール、バージョン、世代番号、インストール日時/ソフトウェア検索日時

ジョブ実行状況※2

フォルダ名称、ジョブ名称、ジョブ属性、サーバ側実行日時、サーバ側実行予定日時、サーバ側実行期限、サーバ側登録予定日時、ジョブあて先名、ジョブ種別、あて先別ジョブ実行日時、パッケージ名称、パッケージ識別ID、キャビネット識別ID、DM識別コード、バージョン、世代番号、エージェント側インストール日時、実行状態、ステータス

注※1

所属するあて先グループ、およびIDの名称が出力されます。

注※2

ジョブ実行状況の出力内容の補足説明を次の表に示します。

表11‒2　ジョブ実行状況の出力内容の補足説明

出力項目

出力内容

ジョブ属性

フォルダ、通常ジョブ、IDジョブのうち、どれかが出力されます。

サーバ側実行日時

配布管理システムでジョブを実行した日時が出力されます。

サーバ側実行予定日時

ジョブ実行時に［スケジュール］パネルの「実行日時」で指定した日時が出力されます。

サーバ側実行期限

ジョブ実行時に［スケジュール］パネルの「実行期限」で指定した日時が出力されます。

サーバ側登録予定日時

ジョブ実行時に［スケジュール］パネルの「登録日時」で指定した日時が出力されます。

あて先別ジョブ実行日時

配布管理システムでジョブを実行した日時が出力されます。

DM識別コード

配布したパッケージがWindowsでパッケージングしたもの（PC資源）なのか、UNIXでパッケージングしたもの（WS資源）なのかが出力されます。

エージェント側インストール日時

リモートインストールジョブの場合、パッケージング時の［スケジュール］パネルまたはジョブ実行時の［パッケージ］パネルで指定したインストール日時が出力されます。

実行状態

ジョブの実行状態が出力されます。ただし、「削除中」は出力されません。

ステータス

［ジョブ実行状況］ウィンドウの［ジョブの詳細情報の表示］メニューで表示される、詳細情報の保守コードが出力されます。

11.1.2　CSV形式ファイルへの出力方法

管理情報をCSV形式のファイルへ出力する手順を説明します。

CSVファイル出力を起動する。

CSVファイル出力を起動するには、リモートインストールマネージャで、［ファイル］メニューから［CSVファイル出力］を選択してください。［CSVファイル出力］ダイアログボックスが表示されます。

［CSVファイル出力］ダイアログボックスで、出力項目や出力先のファイル名を設定する。

設定の詳細は、「11.1.3　CSV形式ファイルの出力範囲の設定」を参照してください。

11.1.3　CSV形式ファイルの出力範囲の設定

［CSVファイル出力］ダイアログボックスで、出力範囲を設定できます。［CSVファイル出力］ダイアログボックスでの出力範囲の設定方法について次に示します。

(1)　テンプレートの設定

CSV形式で出力するテンプレート名を選択します。

(2)　出力情報の設定

ファイルの列に出力する項目を設定します。あて先属性、インストール済みパッケージ情報、およびジョブ実行状況テンプレートを選択した場合に表示されます。

(3)　出力項目の条件設定

ファイルの行に出力する情報の出力条件を設定します。インストール済みパッケージ情報テンプレートおよびジョブ実行状況テンプレートを選択した場合に表示されます。

図11‒1　［CSVファイル出力］ダイアログボックス（出力項目の条件設定）

左端のチェックボックスをオンにしてから、値を設定してください。指定した条件に対して、インストール済みパッケージ情報テンプレートではパッケージ単位、ジョブ実行状況テンプレートではジョブ単位に情報が出力されます。

項目名

比較対象となる項目を設定します。3つまで設定できます。

比較条件

比較条件を選択します。

条件値

比較条件にする値を設定します。次の方法で入力してください。

複数指定する場合は、値を「,」で区切る。（例：値1,値2,値3,値4）

値の範囲を指定する場合は、値を「>」で区切る。（例：値1>値2）

ワイルドカードには「*」または「?」を使用する。「*」は複数の文字、「?」は1文字を示す。

次の項目については、「条件値」に日付のフォーマットを使用して入力してください。

インストール済みパッケージ情報テンプレート

インストール日時

ジョブ実行状況テンプレート

サーバ側実行日時

サーバ側実行予定日時

サーバ側実行期限

サーバ側登録予定日時

あて先別ジョブ実行日時

日付のフォーマットは、数字だけでYYYYMMDDhhmmです。YYYY（西暦）は必ず入力してください。YYYY（西暦）以外の部分は省略でき、省略した場合は最小値が設定されます。1けたの値を指定する場合は前に0を入れて、けた数をそろえてください。不足したけたがあるとエラーになります。

日時の指定例を次に示します。

200

エラーになる

2014

2014年1月1日0時0分

2014101

エラーになる

20141010

2014年10月10日0時0分

201401010101

2014年1月1日1時1分

201412312359

2014年12月31日23時59分

なお、これらに比較条件として「と等しい」、「以外」、「と等しい（複数）」、「ワイルドカード」、「以外（複数）」、または「ワイルドカード以外」を指定することはできません。

組み合わせ条件

複数の条件を設定する場合に、「かつ」か「又は」のどちらかを選択します。意味は次のとおりです。

かつ

複数の条件のどちらも該当するときに情報を出力します。

又は

どちらか一方の条件が該当するときに情報を出力します。

なお、複数の条件を設定する場合、2列目以降の左端のチェックボックスをオンにしてから、組み合わせ条件を設定してください。

説明

項目名または比較条件の選択が変更された場合、変更に応じた説明が表示されます。

(4)　ホストの出力範囲設定

特定のあて先グループ、ID、またはシステム構成に属するホストだけを出力対象にする場合に設定します。設定しない場合は、すべてのホストが出力対象になります。あて先属性テンプレートおよびインストール済みパッケージ情報テンプレートを選択した場合に表示されます。

図11‒2　［CSVファイル出力］ダイアログボックス（ホストの出力範囲設定）

範囲選択

出力対象をあて先グループ、ID、またはシステム構成から選択します。デフォルトはあて先グループです。

直接入力

［ホスト出力範囲の直接指定］ダイアログボックスを表示します。

図11‒3　［ホスト出力範囲の直接指定］ダイアログボックス

出力するホストをパス（ルート直下からの階層を「¥」で区切った形式）で指定できます。リモートインストールマネージャに表示されている名称で指定してください。

なお、出力対象によって指定するパスの制限が異なります。それぞれのパスの制限を次に示します。

出力対象があて先グループの場合

次の半角記号は使用できません。

「/」「*」「"」「'」「:」「!」「|」「.」「<」「>」「?」「@」「%」

「¥」はパスを区切るときだけ使用できます。

6階層以下で指定してください。

先頭の文字は「,」以外で指定してください。

出力対象がIDの場合

次の半角記号は使用できません。

「/」「*」「"」「'」「:」「!」「|」「.」「<」「>」「?」「@」「%」

「¥」はパスを区切るときだけ使用できます。

先頭の文字は「,」以外で指定してください。

出力対象がシステム構成の場合

次の半角記号または半角スペースは使用できません。

「!」「"」「$」「%」「&」「'」「(」「)」「=」「~」「|」「^」「[」「]」「{」「}」「:」「;」「+」「*」「_」「/」「?」「>」「<」「,」「@」「`」「"」

「¥」はパスを区切るときだけ使用できます。

6階層以下で指定してください。

先頭の文字は「,」以外で指定してください。

参照

［ホスト範囲選択］ダイアログボックスを表示します。

図11‒4　［ホスト範囲選択］ダイアログボックス

ホストを選択して［追加］ボタンをクリックしてください。

削除

選択したパスを削除します。

(5)　出力先の設定

出力先のファイル名を設定します。

11.1.4　CSV形式ファイルへ出力するときの注意事項

CSV形式ファイルへ出力するときの注意事項を次に示します。

パッケージ内容をCSV形式ファイルに出力しているときは、［パッケージ］ウィンドウでパッケージの内容を参照しないでください。CSV形式ファイルに出力しているときにパッケージの内容を参照すると、ファイルへの出力処理が失敗する場合があります。

CSVファイル出力でCSV形式ファイルを出力するには、必ず1件以上のデータが登録されている必要があります。データが登録されていない場合は出力できません。

11.2　管理情報を印刷する

配布管理システムで管理している情報を印刷する方法について説明します。［印刷情報の設定］ダイアログボックスで印刷したい項目を選択し、必要な情報を設定して印刷します。

11.2.1　印刷できる項目

印刷できる情報はウィンドウごとに異なります。印刷できる情報をウィンドウごとに説明します。

［システム構成］ウィンドウで印刷できる情報を次の表に示します。

表11‒3　［システム構成］ウィンドウで印刷できる情報

印刷項目

印刷情報

下位ホスト

キー項目名称、ホスト名、IPアドレス、ホスト識別子、タイプ、下位ホスト名

属性

キー項目名称、ホスト名、IPアドレス、ホスト識別子、MACアドレス、タイプ、経路、結果通知の保留、ファイル転送中断、コメント、作成日時、更新日時

インストールパッケージ情報

キー項目名称、ホスト名、IPアドレス、ホスト識別子、パッケージ名称、パッケージ識別ID、インストール、新バージョン、新世代番号、旧バージョン、旧世代番号、インストール日時/ソフトウェア検索日時※

注※

JP1/IT Desktop Manager 2で配布したソフトウェアの場合は、インストールの完了日時が出力されます。UNIXエージェントまたはMacエージェントで検出したソフトウェアの場合は、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブで情報を取得した日時が出力されます。

［あて先］ウィンドウで印刷できる情報を次の表に示します。

表11‒4　［あて先］ウィンドウで印刷できる情報

印刷項目

印刷情報

下位ホスト

あて先グループ/ID/キー項目名称、ホスト名、IPアドレス、ホスト識別子、タイプ、下位のあて先グループまたはホスト名

属性

あて先グループ/ID/キー項目名称、ホスト名、IPアドレス、ホスト識別子、MACアドレス、タイプ、経路、所属グループ、コメント、結果通知の保留、ファイル転送中断、作成日時、更新日時

インストールパッケージ情報

あて先グループ/ID/キー項目名称、ホスト名、IPアドレス、ホスト識別子、パッケージ名称、パッケージ識別ID、インストール、新バージョン、新世代番号、旧バージョン、旧世代番号、インストール日時/ソフトウェア検索日時※

ID管理元中継

ID名称、ID管理元中継の名称

注※

JP1/IT Desktop Manager 2で配布したソフトウェアの場合は、インストールの完了日時が出力されます。UNIXエージェントまたはMacエージェントで検出したソフトウェアの場合は、「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブで情報を取得した日時が出力されます。

［パッケージ］ウィンドウで印刷できる情報を次の表に示します。

表11‒5　［パッケージ］ウィンドウで印刷できる情報

印刷項目

印刷情報

パッケージ一覧

キャビネット名称、キャビネット識別ID、パッケージ名称、パッケージ識別ID、バージョン、世代番号

属性（キャビネット名称）

キャビネット名称またはパッケージ名称、キャビネット識別ID、キャビネット内パッケージ数

属性（パッケージ名称）

パッケージ識別ID、キャビネット名称、バージョン、世代番号、パッケージ容量、転送サイズ、登録日、満了日付、パッケージ種別、インストールモード、パッケージ圧縮、バックアップ/リストア、再起動指定、処理中ダイアログ表示、AITファイル

［ジョブ実行状況］ウィンドウで印刷できる情報を次の表に示します。

表11‒6　［ジョブ実行状況］ウィンドウで印刷できる情報

印刷項目

印刷情報

属性

フォルダ/ジョブ/ホスト名

属性（フォルダ名称）

下位フォルダまたはジョブ名

属性（ジョブまたはID名称）

ジョブ種別、完了数/エラー数/総数、実行状況、実行日時、予定日時、実行期限

属性（ホスト名称）

完了数/エラー数/総数、実行状況

属性（パッケージ名称）

実行状況、実行状態、選択されたあて先、予定日時、実行期限、実行日時、インストール予定日時

詳細情報

ジョブ名、あて先名、詳細情報※、値

注※

ジョブ種別によって印刷内容が異なります。ジョブ種別ごとの詳細情報の内容を次の表に示します。

表11‒7　ジョブ種別ごとの詳細情報の内容

ジョブ種別

詳細情報の内容

パッケージインストール

中継までのパッケージの転送

クライアントユーザによるインストール

ジョブ種別、パッケージ名称、パッケージ識別ID、バージョン/リビジョン、世代番号、実行日時、実行状態、ステータス

中継のパッケージの一括削除

中継からのコレクトファイル収集

中継のコレクトファイル削除

システム構成情報の取得

コンピュータ（UNIX）のシステム情報の取得

コンピュータ（UNIX）のソフトウェア情報の取得

中継からの結果通知保留

中継の結果通知保留の解除

ファイル転送の中断

ファイル転送の再開

ジョブ種別、実行日時、実行状態、ステータス

リモートコレクト

ジョブ種別、収集先ディレクトリ、収集ファイル名、実行日時、実行状態、ステータス

中継までのリモートコレクト

ジョブ種別、収集ファイル名、実行日時、実行状態、ステータス

11.2.2　印刷方法

印刷情報を設定して印刷する方法を次に示します。

情報を印刷したいウィンドウをアクティブにし、［ファイル］−［印刷］を選択する。

［印刷情報の設定］ダイアログボックスが表示されます。

図11‒5　［印刷情報の設定］ダイアログボックス

印刷項目

印刷項目を設定します。ウィンドウの種類によって、選択できる印刷項目は異なります。

印刷情報

印刷情報を選択し、チェックボックスをオンにします。印刷項目に対応して必ず印刷される情報は、チェックボックスがオンになり、さらに淡色表示されます。

印刷対象

印刷する範囲を選択します。

全体

ウィンドウ内の全情報の印刷イメージを表示します。

選択部分

ウィンドウ内であらかじめ選択しておいた範囲の印刷イメージを表示します。ウィンドウ内で範囲を選択していない場合は、この項目を選択できません。

［プリンタの設定］ボタン

［プリンタの設定］ダイアログボックスが表示され、印刷に使用するプリンタ、用紙のサイズなどを設定できます。

なお、印刷倍率を設定しても、使用しているプリンタによっては、拡大または縮小されない場合があります。このようなときは、フォントサイズを変更して印刷してください。

［フォントの設定］ボタン

［フォント］ダイアログボックスが表示され、印刷に使用するフォントを設定できます。フォントの推奨値を次に示します。

・フォント名：MSゴシック

・フォントサイズ：8

各項目を設定し、［OK］ボタンをクリックする。

Windowsの［印刷］ダイアログボックスが表示されます。

Windowsの［印刷］ダイアログボックスで［OK］ボタンをクリックする。

印刷が開始されます。

なお、［印刷情報の設定］ダイアログボックスは、［ファイル］メニューの［印刷情報の設定］または［印刷プレビュー］を選択した場合にも表示されます。

注意事項

リモートインストールマネージャのページ範囲指定の印刷で、実際のページ範囲外のページを指定するとタイトルだけが印刷されます。「すべて」を指定するか正しいページ範囲を指定して印刷してください。

12　エージェントを操作する

JP1/IT Desktop Management 2 - Managerをインストールした「管理用中継サーバ」、JP1/IT Desktop Management 2 - Agentをインストールした「中継システム」および「管理対象のコンピュータ」は、すべてエージェントとしての機能を持っています。エージェントの機能には、配布管理システムからのジョブを受ける機能や、自PCのシステムを管理する機能があります。

ここでは、エージェントの機能を使用する場合の操作について説明します。

12.1　エージェントを使用する前に

ここでは、リモートインストールマネージャを使用した配布に関するエージェントの機能を使用する前に必要な設定や、エージェントで表示されるアイコンの種類など、エージェントを使用する際の前提知識について説明します。

12.1.1　リモートインストールマネージャを使用した配布に関するエージェントのメニュー

JP1/IT Desktop Management 2 - Agent（エージェント）をインストールしたシステムでは、［スタート］メニューに、次のプログラムフォルダが作成されます。

［JP1_IT Desktop Management 2 - Agent］フォルダ

［ITDM2_Startup］フォルダ

［ITDM2_Startup］フォルダは、設定画面の［エージェント］−［Windows エージェント設定とインストールセットの作成］画面の［エージェント設定の追加／編集］−［スタートアップオプション］で、「IT Desktop Management 2 独自のスタートアップフォルダ（［ITDM2_Startup］）を作成する」を選択した場合に作成されます。

それぞれのプログラムフォルダおよびメニューの役割について説明します。

(1)　［JP1_IT Desktop Management 2 - Agent］フォルダ

ユーザがJP1/IT Desktop Management 2の機能を実行するときに使用するメニューが格納されています。ここでは、［JP1_IT Desktop Management 2 - Agent］フォルダに格納されているメニューのうち、エージェントの機能で使用するメニューについて説明します。

パッケージセットアップマネージャ

配布管理システムから配布されたソフトウェアを、管理対象のコンピュータ側からの指示でリモートインストールするための、パッケージセットアップマネージャを起動します。パッケージセットアップマネージャには、次の機能があります。

管理対象のコンピュータ側でソフトウェアを選択してインストールを実行する。

管理対象のコンピュータにインストールされているパッケージを確認する。

パッケージセットアップマネージャを使用したインストールの方法については、「12.4　パッケージセットアップマネージャを操作する」を参照してください。

IDへの登録

管理対象のコンピュータをIDに登録するメニューです。IDへの登録方法については、「12.2.1　IDへの登録」を参照してください。

(2)　［ITDM2_Startup］フォルダ

［ITDM2_Startup］フォルダは、スタートアッププログラムの起動のタイミングをずらし、JP1/IT Desktop Management 2を使用したリモートインストールと重ならないようにするためのフォルダです。

Windowsの［スタートアップ］グループに登録されたプログラムは、Windowsの起動と同時に起動するため、「次回起動時に実行」を使用したバージョンアップができません。リモートインストールでバージョンアップするおそれがあるスタートアッププログラムは、［ITDM2_Startup］フォルダに移動させておいてください。

ただし、Microsoft Officeショートカットバーのように、［ITDM2_Startup］フォルダにショートカットが移動されているとアンインストールが失敗するアプリケーションがあります。このようなアプリケーションの場合、ショートカットを［ITDM2_Startup］フォルダへ移動しないでおくこともできます。

スタートアッププログラムの移動の詳細については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」のエージェント設定の説明を参照してください。

12.2　エージェントの動作環境を設定する

ここでは、エージェントを使用する前に必要な動作環境の設定方法について説明します。

12.2.1　IDへの登録

管理対象のコンピュータでは、配布管理システムからのジョブを受け取るため、IDと呼ぶグループへ自システムを登録しておく必要があります。IDへの登録は、Windowsの［スタート］メニューから［IDへの登録］を選択すると表示される［IDへの登録］ダイアログボックスで行います。

図12‒1　［IDへの登録］ダイアログボックス

IDへの登録処理は、ID管理元中継と接続した状態で行います。ID管理元中継とは、IDを管理する上位システムのことで、エージェント設定で指定した上位サーバがこれに当たります。［IDへの登録］ダイアログボックスには、このサーバの名称が表示されます。なお、インターネットゲートウェイを経由する場合は、「インターネットゲートウェイ」が表示されます。

しかし、ID管理元中継と接続していない状態でも、IDへの登録やIDからの登録解除を待ち状態にできます。ID管理元中継と接続していない状態で処理した場合は、接続できる状態になったあとの、ログオン時または［IDへの登録］選択時に、実際の登録や登録解除がID管理元中継に通知されます。したがって、プレインストールやシステム構築の準備段階でもIDへの登録ができます。また、管理対象のコンピュータがリモートインストールなどを行っている最中は、ID管理元中継とは別機能で接続している状態です。この場合も、接続していないときと同じように扱われます。

ここでは、ID管理元中継との接続状態ごとの、［IDへの登録］ダイアログボックスでの操作方法を説明します。

(1)　ID管理元中継と接続しているときのID登録

ID管理元中継と接続している状態のとき（［IDへの登録］ダイアログボックスで「サーバとの接続状態」が「接続中」のとき）は、次に示す操作ができます。

管理対象のコンピュータをIDへ登録する。

管理対象のコンピュータの登録を解除する。

(a)　管理対象のコンピュータをIDへ登録する

IDへの登録方法を次に示します。

「所属しないID一覧」からIDを選択する。

選択されたIDは、反転表示されます。複数のIDを選択することはできません。

［>］ボタンをクリックする。

パスワードが必要でないIDの場合は、選択されたIDが「所属するID一覧」に移動し、IDへの登録は終了します。

パスワードが必要なIDの場合は、［IDへの登録の確認］ダイアログボックスが表示されます。

パスワードを入力し、［OK］ボタンをクリックする。

システム管理者などから通知されたIDのパスワード（半角英数字14文字以内）を入力してください。パスワードが正しい場合は、選択されたIDが「所属するID一覧」に移動し、IDへの登録は終了します。

(b)　管理対象のコンピュータの登録を解除する

IDへの登録を解除する方法を次に示します。

「所属するID一覧」からIDを選択する。

選択されたIDは、反転表示されます。複数のIDを選択できます。

［<］ボタンをクリックする。

IDからの登録解除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックすると、選択されたIDが［所属しないID一覧］に移動し、IDへの登録解除は終了します。

(2)　ID管理元中継と接続していないときのID登録

ID管理元中継と接続していない状態のとき（［IDへの登録］ダイアログボックスで「サーバとの接続状態」が「未接続」のとき）は、次に示す操作ができます。

IDへの登録待ちにする。

IDからの登録解除待ちにする。

登録待ちのIDを取り消す。

登録解除待ちのIDを取り消す。

ID情報を修正する。

(a)　IDへの登録待ちにする

ID管理元中継と接続したとき、そのサーバで管理しているIDに登録できる状態にします。

「ID入力」に登録したいIDを入力する。

IDは半角で32文字（全角で16文字）以内で設定してください。ただし、次に示す記号およびスペースは指定できません。また、先頭に「network ID」が付くID名称は設定できません。

「¥」「/」「*」「:」「"」「'」「|」「!」「.」「<」「>」「?」「%」

［>］ボタンをクリックする。

パスワードを確認する［IDへの登録の確認］ダイアログボックスが表示されます。ID登録するときパスワードが必要でないIDの場合は、［パスワード］に何も入力しないで［OK］ボタンをクリックしてください。IDへの登録準備は終了します。

パスワードを入力する。

パスワードが必要なIDの場合は、システム管理者などから通知されたIDのパスワードを入力し、［OK］ボタンをクリックしてください。IDへの登録準備は終了します。登録準備が終了したIDは、「所属するID一覧」に表示されます。「登録待ち」というコメントが付き、背景が黄色になります。

待ち状態になっている［IDへの登録］がID管理元中継に通知されるのは、ID管理元中継と通信できる環境になってから最初にログオンした時、または［IDへの登録］を選択した時です。

このとき、エラーが通知された場合は、ID情報を修正して再登録できます。

(b)　IDからの登録解除待ちにする

ID管理元中継と接続したとき、そのサーバで管理しているIDから登録を解除できる状態にします。

「所属するID一覧」からIDを選択する。

選択されたIDは、反転表示されます。複数のIDを選択することもできます。

［<］ボタンをクリックする。

IDからの登録解除を確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

［所属しないID一覧］に移動し、IDへの登録解除準備は終了します。

登録解除準備が終了したIDは、「所属しないID一覧」に表示されます。「解除待ち」というコメントが付き、背景が黄色になります。

(c)　登録待ちのIDを取り消す

登録待ちのIDを取り消す方法を次に示します。

「所属するID一覧」からIDを選択する。

選択されたIDは、反転表示されます。複数のIDを選択することもできます。

［<］ボタンをクリックする。

IDからの登録待ちの取り消しを確認するダイアログボックスが表示されます。

［OK］ボタンをクリックする。

IDが「所属するID一覧」から削除され、IDへの登録待ち取り消しは終了します。

(d)　登録解除待ちのIDを取り消す

登録解除待ちのIDを取り消す方法を次に示します。

「所属しないID一覧」からIDを選択する。

選択されたIDは、反転表示されます。複数のIDを選択することもできます。

［>］ボタンをクリックする。

選択されたIDが「所属するID一覧」に移動し、IDへの解除待ち取り消しは終了します。

(e)　ID情報を修正する

［IDへの登録］ダイアログボックスで、登録待ちのID情報を修正する方法を次に示します。

なお、エラーを通知する［IDへの登録］ダイアログボックスが表示された場合は、［再登録］ボタンをクリックすると、次に示す方法でID情報を修正できます。［OK］ボタンをクリックすると、エラーとなったIDの登録を取りやめ、処理を終了します。

「所属するID一覧」からIDを選択する。

「所属するID一覧」から、ID情報を修正したいIDを選択します。修正できるのは、登録待ち（背景が黄色）のID、および登録エラーとなったID（背景が赤色）のIDです。

［修正］ボタンをクリックする。

［ID情報の修正］ダイアログボックスが表示されます。

ID名称、パスワードを修正し、［OK］ボタンをクリックする。

ID情報が修正されます。修正されたIDには「登録待ち」というコメントが付き、背景が黄色になります。

(3)　IDへ登録するときの注意事項

［IDへの登録］ダイアログボックスを起動している間はエージェントの機能を使用できません。IDへの登録作業が終了したら、［IDへの登録］ダイアログボックスを終了させてください。

エージェント設定で接続先サーバを変更した場合は、IDを再登録してください。

12.2.2　リモートインストールマネージャを使用した配布に関するエージェントの機能を使用する場合の注意事項

ここでは、リモートインストールマネージャを使用した配布に関するエージェントの機能を使用する場合の注意事項について説明します。

(1)　インストールモードとユーザ権限

リモートインストール時のインストール方法には、ファイルのコピーだけでインストールが終了するバックグラウンドインストールモードと、GUIを使用するGUIインストールモードとがあります。日立プログラムプロダクト、他社ソフトウェアなどの流通ソフトウェアは、ほとんどがGUIインストールモードを使用します。

次のレジストリのアクセス権は、一般ユーザが変更できるようにしないでください。変更できるようにするとインストールできないおそれがあります。

OSが32ビット版の場合

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/IT Desktop Management - Agent¥DMP

OSが64ビット版の場合

HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥Hitachi¥JP1/IT Desktop Management - Agent¥DMP

なお、バックグラウンドインストールモードのパッケージは、ログオンしているユーザの権限に関係なくインストールされます。

また、Citrix XenApp、Microsoft RDSサーバへGUIインストールモードでインストールする場合、Citrix XenApp、Microsoft RDSサーバへは誰か一人以上のユーザがログオンしている必要があります。

(2)　一般ユーザ権限でのインストール時の制限事項

エージェントでは次のような制限があります。

(a)　スタートアッププログラムの移行

スタートアッププログラムの移行時には次に示す制限があります。

［ITDM2_Startup］フォルダの変更

エージェント設定の［スタートアップの設定］で、［IT Desktop Management 2 独自のスタートアップフォルダ（［ITDM2_Startup］）を作成する］をオンにした場合、一般ユーザ権限でインストールするかどうかで、［ITDM2_Startup］フォルダの作成位置が異なります。

一般ユーザ権限でインストールすると、共通プログラムフォルダに作成されます。

また、［スタートアッププログラムを［ITDM2_Startup］に移行する］を選択し、共通プログラムフォルダのスタートアップ、および個人プログラムフォルダのスタートアップの両方にショートカットなどが登録されている場合、共通プログラムフォルダおよび個人プログラムフォルダの両方に［ITDM2_Startup］フォルダが作成されます。

一般ユーザ権限とAdministrator権限とで共有する場合、［ITDM2_Startup］フォルダに作成するショートカットは、どちらの権限でもアクセスできるように設定してください。

スタートアッププログラムを自動移行する設定の適用範囲

エージェント設定の［スタートアップの設定］で、［スタートアッププログラムを［ITDM2_Startup］に移行する］をオンにした場合、すべてのユーザのスタートアッププログラムが自動移行の対象となります。

また、一般ユーザのスタートアッププログラムは［移行するスタートアッププログラム（ショートカット）］の一覧の設定に関係なく、すべて［ITDM2_Startup］フォルダに移行されます。一般ユーザのスタートアッププログラムを個人の「スタートアップ」グループに戻したい場合は、エージェント設定の［スタートアップの設定］で、［スタートアッププログラムを［ITDM2_Startup］に移行する］をオフにしてから手動で移行してください。

スタートアッププログラムを自動移行する場合のアンインストールの適用範囲

エージェント設定の［スタートアップの設定］で、［スタートアッププログラムを［ITDM2_Startup］に移行する］をオンにした場合、JP1/IT Desktop Management 2 - Agentをアンインストールすると、ログオンしているユーザについては次の操作が自動的に実施されますが、そのほかのユーザについては実施されません。

スタートアッププログラムの「スタートアップ」グループへの移行

［ITDM2_Startup］フォルダの削除

ログオンユーザ以外の各ユーザについては、これらの操作を手動で実施してください。

12.3　ジョブの実行を保留する

上位のシステム（配布管理システム）から一方的にジョブが実行されるのを防いだり、利用者の都合に合わせてジョブを実行したりする方法としてジョブの保留機能があります。

ジョブの保留機能を有効にするには、あらかじめエージェント設定の［ジョブの設定］−［ジョブの保留許可の設定］で、［利用者による、ジョブの保留を許可する］のチェックボックスをオンにしてください。

12.3.1　ジョブを保留する方法

ジョブの保留機能を有効にすると、次に示すタイミングで［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスが表示されます。

上位サーバからジョブの実行要求を受信したとき

パッケージセットアップマネージャを起動したとき、または［パッケージ］ウィンドウで情報を更新したとき

［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスには、ダウンロードされたジョブの一覧が表示されます。

図12‒2　［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックス

パッケージ名

パッケージの名称です。

動作

ジョブに対する動作（実行・保留）が表示されます。

タイミング

パッケージに設定されている実行タイミングです。

サイズ

パッケージのサイズです。

日付

ジョブが管理対象のコンピュータに到着した日付です。

［決定］ボタン

［インストール］ボタンまたは［保留］ボタンで選択した動作を実行してダイアログボックスを閉じます。

［インストール］ボタン

選択状態（反転表示）のジョブを即時に実行します。

［保留］ボタン

選択状態（反転表示）のジョブの実行を一時的に保留します。

ジョブの動作を変更したとき確認する。

［インストール］ボタンまたは［保留］ボタンでジョブの動作を変更したとき、および［決定］ボタンをクリックしたときに、そのつど確認のダイアログボックスを表示させたい場合にチェックします。

実行まで残りｎ秒

「n」に、エージェント設定で指定したダイアログボックス表示時間の残り秒数が示されます。

［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスでの保留の方法を次に示します。

ジョブを選択し、［動作］でジョブの実行方法を指定する。

［インストール］ボタンまたは［保留］ボタンでジョブの動作を変更し、［決定］ボタンをクリックします。ボタンをクリックするたびに確認のダイアログボックスを表示させたい場合は、「ジョブの動作を変更したとき確認する。」をチェックしてください。

［決定］ボタンをクリックする。

指定した動作に従ってジョブが処理されます。

［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスの「実行まで残りｎ秒」には、エージェント設定で指定したダイアログボックス表示時間の残り秒数が表示されます。ダイアログボックスに対してクリックなどの操作をするとこの表示はなくなります。ダイアログボックスをまったく操作しないで指定時間が経過し、残り秒数が「0秒」になると、表示された「動作」を実行してダイアログボックスが閉じます。

12.3.2　保留したジョブの実行方法

保留したジョブを実行するには、［パッケージセットアップマネージャ］アイコンを起動してください。

12.3.3　ジョブを保留する場合の注意事項

［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスは、Windowsにログオンしたあとでないと表示されません。このため、PCを起動したあと、Windowsにログオンしないまま一定時間が過ぎると、ジョブが実行される場合があります。

「次回起動時に実行」が指定されたパッケージのインストールジョブに対する動作は、［決定］ボタンをクリックした場合と、ダイアログボックスの表示時間が経過した場合とで、次のように異なります。

［決定］ボタンをクリックした場合

パッケージのダウンロードとインストールが一度に実行されます。

ダイアログボックスの表示時間が経過した場合

パッケージのダウンロードだけが実行されます。インストールは、次回のシステム起動時に実行されます。

接続先からのファイル転送が中断中の場合は、ジョブを実行できません。ファイル転送が再開されると、ジョブを実行できるようになります。

［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックスには、ジョブの送信元サーバとの通信ができないジョブも表示されます。

保留したジョブのインストール操作を実行した時に送信元サーバとの通信ができない場合、ダイアログボックスからはジョブが削除されますが、パッケージのダウンロードは実行されません。パッケージのダウンロードとインストールが実行されるのは、ジョブの送信元サーバとの通信が回復したあと、ジョブの保留機能が有効である別のジョブが実行された時になります。

12.4　パッケージセットアップマネージャを操作する

通常、管理対象のコンピュータは、配布管理システムからリモートインストールされるパッケージを受け取るだけです。しかし、配布管理システムから「クライアントユーザによるインストール」ジョブで配布されたパッケージは、インストールの許可だけが与えられた状態になっています。このようなパッケージは、管理対象のコンピュータから、パッケージセットアップマネージャを使用して、必要なソフトウェアを選択してインストールできます。

パッケージセットアップマネージャは、［スタート］メニューから［パッケージセットアップマネージャ］アイコンを選択して起動します。

12.4.1　［Package Setup Manager］ウィンドウの構成

パッケージセットアップマネージャを起動すると、［Package Setup Manager］ウィンドウが表示されます。［Package Setup Manager］ウィンドウは、次の2つのウィンドウを切り替えて操作します。

［パッケージ］ウィンドウ

［インストールパッケージ］ウィンドウ

(1)　［パッケージ］ウィンドウ

インストールを許可されたソフトウェアの一覧を表示するウィンドウです。表示されるソフトウェアは、管理対象のコンピュータの接続先（上位システム）によって異なります。この一覧から、必要なソフトウェアだけを選択してインストールできます。

図12‒3　［パッケージ］ウィンドウ

パッケージセットアップマネージャを使用してパッケージをインストールすると、その結果が上位システムに通知され、インストールに成功したパッケージのアイコンには青色の○印、インストールに失敗したパッケージのアイコンには赤色の×印が付けられます。パッケージセットアップマネージャを使用しないでインストールした場合も、その情報が反映されます（パッケージのアイコンに青色の○印が付けられます）。例えば、通常のリモートインストールのジョブで自動的にインストールされた場合や、利用者がローカルにインストールした場合などです。

［パッケージ］ウィンドウでの操作の内容については、「12.4.2　パッケージセットアップマネージャからのインストール」を参照してください。

(2)　［インストールパッケージ］ウィンドウ

リモートインストールマネージャでインストールしたパッケージの一覧を表示するウィンドウです。

図12‒4　［インストールパッケージ］ウィンドウ

［インストールパッケージ］ウィンドウの表示内容については、「12.4.3　ソフトウェアのインストール状況の確認」を参照してください。

(3)　ウィンドウの関連

［Package Setup Manager］ウィンドウ上の2種類のウィンドウは、互いに連動しています。パッケージセットアップマネージャを使用してパッケージをインストールすると、［パッケージ］ウィンドウ上で青色の○印が付くだけでなく、［インストールパッケージ］ウィンドウにも、該当するソフトウェアの情報が追加されます。

また、［パッケージ］ウィンドウに表示されているソフトウェアをローカルにインストールした場合、その情報が［インストールパッケージ］ウィンドウに表示されるのと同時に、［パッケージ］ウィンドウ上のアイコンにも青色の○印が付きます。

(4)　注意事項

インストール先のドライブを数字で指定してインストールしたパッケージは、［インストールパッケージ］ウィンドウでも、ドライブ名が数字で表示されます。対応するドライブ名に変換されません。

複数のIDに所属している場合、［パッケージ］ウィンドウに、まったく同じパッケージが複数表示されることがあります。

接続先からのファイル転送が中断中の場合は、パッケージをインストールできません。インストールできなかったパッケージのアイコンには赤色の×印が付けられますが、ファイル転送が再開されると、パッケージをインストールできるようになります。

パッケージを上書きインストールしようとしてエラーとなった場合は、エラー発生後も、インストール済みパッケージとして表示されます。

12.4.2　パッケージセットアップマネージャからのインストール

［Package Setup Manager］ウィンドウでは、表示されたパッケージに対して次の操作ができます。

パッケージをインストールする（自動インストール・手動インストール）。

パッケージの詳細情報を表示する。

(1)　パッケージをインストールする（自動インストール）

パッケージを自動的にインストールします。自動インストールする場合、パッケージごとにインストール先のディレクトリの設定をあらかじめ変更しておくことができます。インストール先ディレクトリはインストール実行時にも変更できます。

インストール先ディレクトリの変更方法、および自動インストールの方法を次に示します。

(a)　インストール先ディレクトリの変更

インストール先ディレクトリを変更したいパッケージを選択し、［編集］−［インストール先の変更］を選択する。

［インストール先の変更］ダイアログボックスが表示されます。

図12‒5　［インストール先の変更］ダイアログボックス

インストール先ディレクトリを変更し、［OK］ボタンをクリックする。

インストール先ディレクトリが変更されます。

(b)　パッケージの自動インストール

インストールしたいパッケージを選択し（複数選択可）、［実行］−［インストール］を選択する。

選択したパッケージが［インストール方法の指定］ダイアログボックスに表示されます。

図12‒6　［インストール方法の指定］ダイアログボックス

［インストール先の変更］ボタン

選択されているパッケージのインストール先を変更するための、ディレクトリ参照ダイアログボックスを表示します。

［パッケージの説明］ボタン

パッケージに添付されている説明のファイルを表示・閲覧できます。

［コマンドオプション］ボタン

インストーラの実行ファイルにオプションを指定できます。

インストール方法

パッケージを自動的にインストールするか、手動でインストールするかを選択します。

［実行］ボタン

表示されたパッケージのインストールを開始します。

「インストール方法」で「自動」を選択する。

インストール先のディレクトリを変更する場合は、［インストール先の変更］ボタンをクリックすると表示される［インストール先の変更］ダイアログボックスで、インストール先のディレクトリを指定してください。

パッケージに説明が添付されている場合は、［パッケージの説明］ボタンをクリックすると参照できます。

［実行］ボタンをクリックする。

選択したパッケージのリモートインストールが始まります。

(2)　パッケージをインストールする（手動インストール）

パッケージ種別が「日立プログラムプロダクト」または「他社ソフトウェア」の場合に、GUI上のインストーラに手動で応答してインストールできます。利用者の環境に合わせて、カスタムインストールしたい場合は手動でインストールしてください。ただし、一部の日立プログラムプロダクトには、手動インストールができないものもありますので注意してください。手動インストールの方法を次に示します。

インストールしたいパッケージを選択し、［実行］−［インストール］を選択する。

選択したパッケージが［インストール方法の指定］ダイアログボックスに表示されます。なお、手動インストールの場合、パッケージは複数選択できません。

［インストール方法］で［手動］を選択する。

［インストール先の変更］ボタンが非活性となります。インストール先ディレクトリの変更は、このあとの手動インストール中に操作してください。

インストールするパッケージに説明が添付されている場合は、［パッケージの説明］ボタンをクリックすると参照できます。

他社ソフトウェアの場合は、［コマンドオプション］ボタンをクリックすると［セットアップコマンドオプション指定］ダイアログボックスが表示されるので、インストーラの名称（setup.exeなど）と、必要であればそのオプションを1,024バイト以内で指定します。

図12‒7　［セットアップコマンドオプション指定］ダイアログボックス

［実行］ボタンをクリックする。

インストーラが起動します。

選択したパッケージのインストーラの指示に従ってインストールする。

インストールするソフトウェアによっては、インストール中のCD-Rを入れ替えるために、CD-Rのパス名を入力しなければならない場合があります。この場合、ダイアログボックス中に表示されているパス名の最後の数字を、次に読み込むCD-Rの数字に変更して入力してください。

インストーラの処理が終了すると、［手動インストール実行結果の設定］ダイアログボックスが表示されます。

図12‒8　［手動インストール実行結果の設定］ダイアログボックス

インストールの実行状態（実行結果）をJP1/IT Desktop Management 2 - Agent（中継システムまたはエージェント）に通知する。

利用者が手動で応答してリモートインストールした場合、パッケージセットアップマネージャは、インストールの実行結果を認識できません。そのため、［手動インストール実行結果の設定］ダイアログボックスで、実行結果を設定してください。「インストール完了」、または「インストール失敗」のどちらかを選択し、［設定］ボタンをクリックします。

［手動インストール実行結果の設定］ダイアログボックスは、セットアップコマンド終了時に表示されます。そのため、インストールがすべて終了する前に表示されることがあります。この場合、［設定］ボタンをクリックしてしまうとインストールは強制終了されます。［設定］ボタンをクリックするときは、インストールが完全に終了したことを確認してください。

(3)　パッケージの詳細情報を表示する

リモートインストールを許可されたパッケージの情報を表示できます。また、インストールに失敗したパッケージについては、失敗した要因も表示できます。必要に応じて参照してください。

情報を表示したいパッケージを選択し、［表示］−［詳細情報の表示］を選択する。

［パッケージの詳細］ダイアログボックスに、パッケージの情報が表示されます。

図12‒9　［パッケージの詳細］ダイアログボックス

12.4.3　ソフトウェアのインストール状況の確認

［インストールパッケージ］ウィンドウでは、管理対象のコンピュータにすでにインストールされているパッケージを確認できます。

図12‒10　［インストールパッケージ］ウィンドウ

ソフトウェア名の左側に付いているアイコンは、ソフトウェアの種類を表します。

[図データ]：日立プログラムプロダクト

[図データ]：他社ソフトウェア

[図データ]：ユーザプログラム、データ

［インストールパッケージ］ウィンドウには、リモートインストールマネージャでインストールしたパッケージの一覧が表示されます。

［インストールパッケージ］ウィンドウの情報は、次のタイミングで更新されます。

パッケージセットアップマネージャを起動したとき

パッケージセットアップマネージャからのインストールに成功したとき

［表示］−［最新の状態に更新］メニューを実行したとき

このウィンドウの情報は、パッケージセットアップマネージャの［パッケージ］ウィンドウと連動しています。［パッケージ］ウィンドウに表示されているソフトウェアが、ローカルにインストールされた場合、［パッケージ］ウィンドウ上の該当するパッケージのアイコンにも「インストール完了」のマーク（○印）が付きます。

12.5　バックアップファイルを管理する

バックアップ・リストア機能を使用したリモートインストールが失敗した場合、通常はバックアップファイルを使用したリストア（ファイルの回復）が自動的に実行されます。しかし、このとき実行されるリストアも、失敗または実行されないことがあります。

UNIX版のパッケージャ（資源登録システム）からパッケージングされたパッケージの場合、管理対象のコンピュータでは復元に失敗したバックアップファイルが、パッケージング時に指定した「バックアップ保存期間」の指定に従って保存されます。

保存されているバックアップファイルはコマンドで操作できます。必要に応じて、バックアップファイルを確認し、ファイルの削除またはリストアの再試行などの処置を取ってください。

保存されたバックアップファイルを管理するコマンドを次の表に示します。

表12‒1　バックアップファイルを管理するコマンド

コマンド名

機能

dmpbklst

バックアップファイルの一覧を出力する

dmpbkdel

バックアップファイルを削除する

dmprcvry

保存されているバックアップファイルを使ってリストアを再試行する

12.5.1　バックアップ取得状況一覧の出力（dmpbklstコマンド）

機能

保存されているバックアップファイルの一覧が、バックアップ取得状況一覧ファイル（ファイル名：DMPBKLST）に出力されます。バックアップ取得状況一覧ファイルには、保存されているバックアップのパッケージ識別ID（UNIX版JP1/IT Desktop Management 2 - Agentでの資源名）とバックアップの総数がテキスト形式で書かれています。

形式

dmpbklst /バックアップ取得状況一覧を出力するディレクトリ

引数

/バックアップ取得状況一覧を出力するディレクトリ

バックアップ取得状況一覧ファイル（ファイル名：DMPBKLST）の出力先ディレクトリのパスを指定します。

出力形式

NUMBER_OF_ENTRY  =  3         (1)
RESOURCE_NAME  =  UAP1        (2)
RESOURCE_NAME  =  UAP2
RESOURCE_NAME  =  USERDATA
END_OF_FILE                   (3)

(1)NUMBER_OF_ENTRY = バックアップ数

保存されているバックアップの総数です（1〜127）。

(2)RESOURCE_NAME = パッケージ識別ID

バックアップが保存されているパッケージ識別ID（UNIX版JP1/IT Desktop Management 2 - Agentでの資源名）です。最大文字数は、44文字です。パッケージ識別IDが44文字未満の場合は、44文字目までスペースが入っています。

(3)END_OF_FILE

バックアップ取得状況一覧ファイルの最後を示します。

終了コード

0

正常終了

1

バックアップファイルが存在しない

実行例

バックアップ取得状況一覧ファイルの出力先が「C:¥Program Files¥Hitachi¥JP1ITDMA」の場合の例を次に示します。なお、出力ファイル名は「DMPBKLST」固定です。

dmpbklst.exe /"C:¥Program Files¥Hitachi¥JP1ITDMA"

12.5.2　バックアップファイルの削除（dmpbkdelコマンド）

機能

指定したパッケージ識別ID（UNIX版JP1/IT Desktop Management 2 - Agentでの資源名）のバックアップファイルが削除されます。

形式

dmpbkdel /パッケージ識別ID

引数

/パッケージ識別ID

削除するバックアップファイルのパッケージ識別IDを指定します。

終了コード

0

正常終了

1

バックアップファイルのないパッケージ識別IDを指定した

2

バックアップの削除時にシステムエラーが発生した

実行例

パッケージ識別ID「TEST」のバックアップを削除する場合の例を次に示します。

dmpbkdel.exe /TEST

12.5.3　リストアの再試行（dmprcvryコマンド）

機能

指定したパッケージ識別ID（UNIX版JP1/IT Desktop Management 2 - Agentでの資源名）のバックアップを使ってリストアを再試行します。

形式

dmprcvry /パッケージ識別ID

引数

/パッケージ識別ID

リストアを再試行するパッケージ識別IDを指定します。

終了コード

0

正常終了

1

バックアップファイルのないパッケージ識別IDを指定した

2

リストア時にシステムエラーが発生した

3

リストア後の処理でエラーが発生した

実行例

パッケージ識別ID「TEST」のバックアップを使ってリストアを再試行する場合の例を次に示します。

dmprcvry.exe /TEST

12.6　管理対象のコンピュータがスリープ状態から復帰したあとのジョブの実行の注意事項

管理対象のコンピュータがスリープ状態（一定時間まったく操作しないと切り換わる電力の消費を抑えて待機している状態）から復帰したあとの注意事項を次に示します。

システム起動時からのポーリングおよびインストールは実行できません。実行するには、復帰したあとに、管理対象のコンピュータを再起動してください。

［ITDM2_Startup］のプログラムは起動しません。起動するには、復帰したあとに、エージェントを再ログオンしてください。

日時指定によるポーリングおよびインストールは、復帰時点で指定した日時を経過している場合に実行されます。

スリープ状態より前にダウンロードを実行していた場合、ジョブは実行できません。ジョブのリトライまたはポーリング実行後に再開されます。

スリープ状態より前にインストールを実行していた場合、スリープ状態から復帰したあとに再開されます。

13　JP1/IMへJP1イベントを通知する

JP1/Baseのイベントサービス機能を使用して、リモートインストールマネージャで実行したジョブの実行結果などをJP1/IMに通知できます。JP1/IMではJP1/IM - Viewの［イベントコンソール］画面で、JP1/IT Desktop Management 2から通知されたJP1イベントを確認できます。

ここでは、JP1/IT Desktop Management 2から通知されたJP1イベントをJP1/IMで確認するための情報（JP1イベントの種類およびJP1イベントの属性）について説明します。

13.1　JP1イベントの種類

JP1/IT Desktop Management 2がJP1/IMに通知するJP1イベントについて次に説明します。どのJP1イベントをJP1/IMに通知するかは、JP1/IT Desktop Management 2 - Managerのセットアップの、［リモートインストールマネージャを使用した配布のセットアップ］画面の［イベントサービス］パネルで設定してください。

ジョブ完了イベント

ジョブが完了したときに、実行結果を通知するJP1イベントです。JP1イベントとしてジョブの実行結果を通知できるのは、次のジョブです。

パッケージのインストール

中継までのパッケージの転送

リモートコレクト

中継までのリモートコレクト

中継からのコレクトファイル収集

クライアントユーザによるインストール

指令完了イベント

指令の実行結果を管理対象のコンピュータから通知されたときに、指令の実行結果を通知するJP1イベントです。指令とは、ジョブの最小単位で、あて先またはパッケージごとに配布管理システムで作成されます。例えば、2つのあて先に対して2つのパッケージを配布するジョブを実行した場合、4つの指令が作成されます。

実行結果を通知できる指令のジョブは、ジョブ完了イベントと同じです。

13.2　JP1イベントの属性

JP1イベントの属性には、基本属性と拡張属性があります。また、指令完了イベントでは、拡張属性の詳細情報をJP1/IMに通知します。拡張属性の詳細情報は、JP1/IM - Viewの［イベントコンソール］画面で確認できます。

JP1イベントの基本属性を表13-1、JP1イベントの拡張属性を表13-2、指令完了イベントの拡張属性の詳細情報を表13--3に示します。

イベントIDはJP1/NETM/DMと同じIDを使用しています。JP1/NETM/DMと本製品のJP1イベントを区別したい場合には、JP1/IMのフィルタ条件に製品名を定義してください。

表13‒1　JP1イベントの基本属性

JP1イベント名称

イベントID

メッセージ

指令完了イベント

正常終了

00010402

xxx（指令番号）の指令が正常終了しました

エラー終了

00010403

xxx（指令番号）の指令が異常終了しました

ジョブ完了イベント

正常終了

00010406

xxx（ジョブ名）が正常終了しました

エラー終了

00010407

xxx（ジョブ名）が異常終了しました

表13‒2　JP1イベントの拡張属性

属性名

意味

属性値

SERVERITY

重大度

システムに対する重大度

（Error、Information）

USER_NAME

ユーザ名

実行ユーザ

JP1_SOURCEHOST

発生元ホスト名

JP1イベントを発行する契機となる事象が発生したホスト名

PRODUCT_NAME

PP名

/HITACHI/JP1/ITDM2

OBJECT_TYPE

オブジェクトタイプ

JP1イベントの発生した階層

（DMJOB、COMMAND）

OBJECT_NAME

オブジェクト名

JP1イベントの発生個所の名称

（ジョブ番号、指令番号）

ROOT_OBJECT_TYPE

登録名タイプ

登録名の種別

（DMJOB）

ROOT_OBJECT_NAME

登録名

登録実行単位となる名称

（ジョブ番号）

OBJECT_ID

オブジェクトID

統合システム内で一意に識別できる文字列

（ジョブ番号、指令番号）

OCCURRENCE

事象種別

発生した事象の種別

（END）

START_TIME

開始時刻

実行開始時刻（1970/01/01 00:00:00からの秒数）

END_TIME

終了時刻

実行終了時刻（1970/01/01 00:00:00からの秒数）

RESULT_CODE

終了コード

終了コード

表13‒3　指令完了イベントの拡張属性の詳細情報

属性名

内容

S1

ジョブ名

S2

ジョブ番号

S3

ジョブ種別

「D」：パッケージのインストール

「M」：中継までのパッケージの転送

「G」：リモートコレクト

「S」：中継までのリモートコレクト

「A」：中継からのコレクトファイル収集

「J」：クライアントユーザによるインストール

S4

指令番号

S5

保守コード

S6

経路情報

P1

パッケージ名

P2

パッケージ識別ID

P3

パッケージのバージョン

P4

パッケージの世代番号

P5

キャビネット識別ID

P6

パッケージコード

「D」：Windowsからパッケージングしたパッケージ

14　リモートインストールマネージャを使用した配布機能のコマンド

ここでは、関連プログラムであるJP1/AJSと連携して、ジョブの実行やパッケージングなどの機能を自動化する方法について説明します。また、リモートインストールマネージャを使用した配布機能のコマンドについて説明します。

14.1　JP1/AJSと連携した自動運用の概要

JP1/IT Desktop Management 2では、パッケージングやリモートインストールなど、幾つかの機能をコマンドで提供しています。このコマンドをJP1/AJSと組み合わせることで、さまざまな機能を自動運用させることができます。

この節では、JP1/AJSを使用した、JP1/IT Desktop Management 2の自動運用の次の事例を紹介します。

ファイルの更新を検知して自動的にリモートインストールする。

リモートインストールのエラーを検知しリトライする。

各拠点のファイルを収集し、加工して再配布する。

14.1.1　ファイルの更新を検知して自動的にリモートインストールする

データの更新を監視するためのモデルとなるPCを用意しておき、特定のフォルダまたはファイルの更新を契機に、自動でデータのパッケージングおよびリモートインストールを実行できます。処理の概要を次の図に示します。

図14‒1　ファイルの更新を検知して自動的にリモートインストールする運用

この例では、管理者は配布対象のファイルを特定のPCの、特定のフォルダに格納するだけで、管理対象となるすべてのコンピュータのデータを更新できます。また、すべての操作を自動化することで、配布するファイルの間違いや誤操作を防止できます。

14.1.2　リモートインストールのエラーを検知しリトライする

JP1/IT Desktop Management 2でのリモートインストールの結果を監視し、リモートインストールが失敗したPCだけにデータを再度転送したり、リモートインストールが失敗したことをメールで管理者に連絡したりする一連の業務を自動化できます。処理の概要を次の図に示します。

図14‒2　リモートインストールのエラーを検知しリトライする運用

この例ではエラーを契機に次の処理を実行させていますが、エラーではなく、リモートインストールが正常に完了したのを契機に別の処理を実行させることもできます。

14.1.3　各拠点のファイルを収集し、加工して再配布する

JP1/IT Desktop Management 2のファイル収集機能を利用して各拠点のファイルを収集し、サーバ側でデータを加工したりデータベースを更新したりできます。また、加工したデータを再び各コンピュータに転送し、最新のデータに置き換えることもできます。処理の概要を次の図に示します。

図14‒3　各拠点のファイルを収集し、加工して再配布する運用

14.2　コマンドの種類と入出力情報

この節では、リモートインストールマネージャを使用した配布に関するコマンドの種類、およびコマンド実行時の入出力情報について説明します。

14.2.1　コマンドの種類

リモートインストールマネージャを使用した配布に関するコマンドの種類を、コマンドの目的別に示します。

(1)　ジョブの作成や実行に関連するコマンド

このコマンドは、JP1/IT Desktop Management 2 - Managerのインストール先ディレクトリの更新権限を持ったユーザが、管理用サーバで実行できます。ローカルホスト上の配布管理システムに接続し、ジョブの作成や実行を行います。

表14‒1　ジョブの作成や実行に関連するコマンド

機能

コマンド名

参照先

リモートインストール関連のジョブを作成、実行します。作成、実行できるジョブは次の4種類です。

パッケージのインストール

中継までのパッケージの転送

中継のパッケージの一括削除

クライアントユーザによるインストール

dcminst.exe

14.6

リモートコレクト関連のジョブを作成、実行します。作成、実行できるジョブは次の4種類です。

リモートコレクト

中継までのリモートコレクト

中継からのコレクトファイル収集

中継のコレクトファイル削除

また、収集したアーカイブファイルを復元します。

dcmcoll.exe

14.4

ファイル転送を中断、または再開します。

dcmsusp.exe

14.17

配布管理システムで定義されているジョブを実行します。

dcmjexe.exe

14.8

ジョブを再実行します。

dcmrtry.exe

14.14

実行したジョブを削除します。

dcmjbrm.exe

14.7

ジョブの定義を削除します。

dcmrmgen.exe

14.13

ジョブの実行状況を取得します。

dcmstat.exe

14.15

ジョブの実行状況を監視し、状況に応じて外部プログラムを起動します。

dcmstsw.exe

14.16

(2)　パッケージに関するコマンド

このコマンドは、JP1/IT Desktop Management 2のインストール先ディレクトリの更新権限を持ったユーザが実行できます。なお、catAndValidatePackagingFile.exeはすべてのユーザが実行できます。dcmpack.exeはパッケージャで指定した配布管理システムに接続し、パッケージングを行います。そのほかのコマンドについては、ローカルホスト上の配布管理システムに接続し、パッケージの削除、バックアップ取得、復元を行います。

表14‒2　パッケージに関するコマンド

機能

コマンド名

実行できるシステム

参照先

ユーザデータ、ユーザプログラムをパッケージングします。

dcmpack.exe

パッケージャをインストール済みのコンピュータ

14.9

キャビネットからパッケージを削除します。

dcmpkrm.exe

管理用サーバ

14.12

パッケージのバックアップを取得します。

dcmpkget.exe

管理用サーバ

14.10

パッケージをバックアップから復元します。

dcmpkput.exe

管理用サーバ

14.11

dcmpackコマンドで分割したファイルを結合し、分割前のファイルを復元します。

catAndValidatePackagingFile.exe

すべてのコンピュータ

14.18

(3)　システム構成に関連するコマンド

このコマンドは、ODBCシステムデータソースの更新権限を持ったユーザが、管理用サーバで実行できます。ローカルホスト上の配布管理システムに接続し、あて先グループへのポリシーの一括反映を行います。

表14‒3　システム構成に関連するコマンド

機能

コマンド名

参照先

作成したポリシーを一括反映し、登録されているホストをあて先グループに振り分けます。

dcmgpmnt.exe

14.5

14.2.2　コマンド実行時の入出力情報

コマンドの実行時の入出力情報を次の図に示します。

図14‒4　コマンド実行時の入出力情報

(1)　入力情報

コマンド実行時は、実行条件や、実行させるジョブの詳細な内容を、コマンドの引数およびパラメタファイルで指定します。コマンドの引数とパラメタファイルのどちらでも指定できる項目と、どちらかを指定できる項目があります。

コマンド

実行させるコマンドおよび引数を入力します。引数では、パラメタファイルや結果出力ファイルの名称を指定するほか、ジョブのさまざまな実行条件を定義できます。

パラメタファイル

リモートインストールのあて先やインストール条件など、ジョブ実行時に必要な情報を記述するファイルです。パラメタファイルの作成方法については、「14.19　パラメタファイルの作成」を参照してください。コマンド実行後に出力された結果出力ファイルを、別のコマンドでパラメタファイルとして入力することもできます。

(2)　出力情報

コマンドの実行結果は、次の情報で確認できます。

リターンコード

コマンドの実行結果が、リターンコードとして返却されます。

結果出力ファイル

コマンド実行時に指定した結果出力ファイルに、コマンドの実行結果が出力されます。ジョブを作成、実行したコマンドの結果出力ファイルは、ジョブの実行状況を取得したり、ジョブを再実行したりするコマンドを実行するときのパラメタファイルとして使用できます。

(3)　注意事項

WindowsのタスクスケジューラやJP1/AJSを使用してコマンドを実行する場合、コマンド実行ユーザにアクセス権のないネットワークドライブなどのディレクトリ、ファイルにパラメタファイル、結果出力ファイルを指定しないよう注意してください。

14.2.3　コマンドのエラー情報の確認方法

コマンドがエラーになった場合、Windowsのイベントビューアでイベントログを確認できます。

イベントビューアのソース欄に「JP1ITDM2 (DMU)」と表示されるイベントを確認してください（イベントIDは、1〜2018）。イベントの詳細情報では、コマンド名、エラー原因の詳細が確認できます。次に、詳細情報の表示例を示します。

dcmpack.exe /i C:¥dmbat¥in.txt /k********

パラメタファイルに不正な値が含まれています:L.23

この詳細情報は、パラメタファイル（C:¥dmbat¥in.txt）の23行目に誤りがあることを示しています。指定したパスワードは、「********」と表示されます。

14.2.4　コマンドの入力形式

リモートインストールマネージャを使用した配布に関するコマンドは次の形式で指定してください。

コマンド名 /引数1 [値1] [/引数2 [値2] … ]

引数は、「/」と英字で指定します。

「/」で始まる文字列はすべて引数として解釈されるため、値には「/」で始まる文字列は指定できません。

コマンド名と引数、引数と値の間には、それぞれ1つ以上のスペースが必要です。

値がスペースまたはMS-DOSの制御文字を含む場合は、値を「"」で囲んで指定してください。「"」で囲まれた文字列はMS-DOSの仕様に従って解析されます。「"」で囲まれた中に「"」を文字として指定する場合は、「¥"」と指定します。

（例）

dcmpack.exe /b "dcmpack /i ¥"C:¥dev 1¥parameter file1.txt¥"" /i "C:¥dev 2¥parameter file2.txt"

14.3　コマンドの説明形式

この章では、パラメタファイルを使用できるコマンドについては、パラメタファイルの使用を前提に説明します。パラメタファイルとコマンドの引数のどちらでも指定できる項目は、パラメタファイル中で指定する項目として説明します。なお、同じ内容をコマンドの引数を使って指定する場合については、各コマンドの「パラメタファイルを使用しない場合のコマンド形式」を参照してください。

パラメタファイルには、コマンド実行時に必要なパラメタを内容別のタグで分けて記述します。パラメタファイルを作成するには、まず設定するパラメタに対応するタグをパラメタファイルの指定内容の表で確認したあと、そのタグの指定方法を「14.19.3　タグの指定方法」で調べてください。タグの種類やパラメタファイルの形式については、「14.19　パラメタファイルの作成」を参照してください。

パラメタファイルとコマンドの引数の両方を指定した場合は、コマンドの引数で指定した内容が有効となり、パラメタファイルでの指定は無視されます。ただし、dcmpkgetコマンドの場合は、一部パラメタファイルの定義が有効になる場合があります。dcmpkgetコマンドの詳細は、「14.10　dcmpkget.exe（パッケージのバックアップの取得）」を参照してください。

各コマンドで説明する内容を、次に示します。

機能

コマンドの機能を示します。

形式

コマンドを指定するときの文法を示します。［　］で囲まれている引数は省略できます。パラメタファイルを使用できるコマンドについては、パラメタファイルの使用を前提に示しています。

形式の例

dcmXXXX.exe [/A] [/B]
             /i パラメタファイル1 [パラメタファイル2]

上記の形式では、「/i パラメタファイル1」以外の引数は省略できます。また、パラメタファイルは2つまで指定できます。

引数

「形式」で示した各引数について説明します。ここで説明する引数は、パラメタファイルでは指定できない引数です。

パラメタファイルの指定内容とコマンド引数との対応

コマンドで使用するパラメタファイルの指定内容を表で示します。また、パラメタファイルの内容をコマンドの引数を使っても指定できる場合は、各パラメタとコマンド引数の対応も示します。

パラメタファイルに指定する内容の詳細、および省略時のデフォルト値については、「14.19　パラメタファイルの作成」を参照してください。パラメタファイルとコマンドの引数の両方を指定した場合は、コマンドの引数で指定した内容が有効となり、パラメタファイルでの指定は無視されます。

パラメタファイルの内容が引数で指定できないコマンドでは、見出しは「パラメタファイルの指定内容」です。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを使用しないで、コマンド引数だけを使用して指定する場合のコマンド形式を示します。|（ストローク）で区切られた項目は、そのうちのどれか1つを指定することを示します。

形式の例

dcmXXXX.exe [/A|/B]
             /j ジョブ名称 [/l ジョブ格納フォルダパス]

上記の形式では、「/j ジョブ名称」以外の引数は省略できます。また、「/A」または「/B」を指定できます。

パラメタファイルの内容を引数で指定できないコマンド、およびパラメタファイルを使用できないコマンドについては、この項目はありません。

リターンコード

コマンド実行時のリターンコードを示します。

注意事項

コマンドの注意事項がある場合に説明します。

実行例

コマンドの実行方法を、実際の例を挙げて説明します。

14.4　dcmcoll.exe（ファイルの収集）

ファイルを収集するdcmcollコマンドについて説明します。

このコマンドで実行したジョブは、配布管理システムの［ジョブ実行状況］ウィンドウで実行結果を確認できます。

機能

次に示す、リモートコレクトに関連するジョブを作成、実行します。

リモートコレクト

中継までのリモートコレクト

中継からのコレクトファイル収集

中継のコレクトファイル削除

また、収集したアーカイブファイルを復元します。

形式

dcmcoll.exe [処理キー] [/G] [/Z] [/s]
            /i パラメタファイル1 [パラメタファイル2]
            [/o 結果出力ファイル名]

引数

処理キー

実行するジョブの種類を指定するキーです。コマンド名の直後に、次に示す処理キーのうち1つを指定してください。省略した場合は、「NETM_COLLECT」が仮定されます。

NETM_COLLECT

「リモートコレクト」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、あて先、収集するファイル、および収集したファイルの格納先ディレクトリを指定してください。

NETM_COLTOS

「中継までのリモートコレクト」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、あて先、収集するファイル、および収集したファイルの格納先ディレクトリを指定してください。

NETM_COLTOM

「中継からのコレクトファイル収集」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、あて先（中継システムおよび管理用中継サーバ）を指定してください。

NETM_COLRESET

「中継のコレクトファイル削除」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、あて先（中継システムおよび管理用中継サーバ）を指定してください。

NETM_UNARC

収集したアーカイブファイル（拡張子がdmzのファイル）を復元します。パラメタファイル（またはコマンドの引数）で、復元するファイルの名称と格納されているディレクトリ、復元先のディレクトリを指定してください。

/G

処理キーが「NETM_UNARC」の場合に、復元先として指定したディレクトリ下に、復元したファイルを直接格納します。「NETM_UNARC」以外の場合は、指定しても無視されます。

/Gを指定しない場合は、復元後の格納先として指定したディレクトリ下に、あて先のホスト名と同じ名称のディレクトリが自動で作成されます。

あて先を区別する必要がある場合は、指定しないでください。

/Z

処理キーが「NETM_UNARC」の場合に、ファイルの復元と同時にアーカイブファイルを削除します。アーカイブファイルが格納されていたディレクトリは削除されません。

「NETM_UNARC」以外の場合は、指定しても無視されます。

/s

ジョブを作成後、実行しないで保存します。処理キーが「NETM_UNARC」の場合は、指定しても無視されます。

この引数を指定してコマンドを実行したときの結果出力ファイルには、ジョブ番号が出力されません。

/i

使用するパラメタファイルのフルパスを、1つまたは2つ指定します。2つ指定する場合は間をスペースで区切ってください。3つ以上指定するとコマンドは失敗します。

パラメタファイルを2つ指定すると、JP1/IT Desktop Management 2は、それぞれのパラメタファイルの内容を連結して解釈します。あて先に関する情報と、収集・復元に関する情報を別のパラメタファイルに定義しておくと、どちらかを変更してコマンドを再実行する場合に便利です。

不要なパラメタは無視されるので、ファイルを収集する場合と復元する場合とで、パラメタファイルを共用できます。両方のファイルに同じパラメタを指定した場合は、エラーとなります。

/o

結果出力ファイルのフルパスを指定します。

処理キーが「NETM_UNARC」の場合は、指定しても無視されます。それ以外の場合は必ず指定してください。

コマンドが正常終了すると、指定した結果出力ファイルに次の項目が出力されます。結果出力ファイルがすでに存在する場合は上書きされます。

ジョブ名称

ジョブ番号

ジョブ格納フォルダパス

ジョブ番号（jobnoの値）は、開始されたジョブを識別する番号です。このジョブを削除したり実行状況を確認したりする場合は、jobnoの値をパラメタファイルに記述してください。

引数に/sを指定した場合、ジョブ番号は出力されません。

/sを指定した場合の結果出力ファイルは、そのままdcmjexeコマンドのパラメタファイルとして使用できます。また、/sを指定しなかった場合の結果出力ファイルは、dcmjbrmコマンド、dcmrtryコマンド、dcmstatコマンド、およびdcmstswコマンドのパラメタファイルとして使用できます。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒4　パラメタファイルとコマンドの引数の対応（dcmcollコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_DESTINATION

group

あて先グループ名

◎※1

/g 値

host_name

ホスト名

◎※1

/h 値

JOB_DESTINATION_ID

destination_id

ID名

◎※1

/X 値

FILE_COLLECTION

source_path

収集ファイル名

◎※2

/y 値

dmz_path

収集後の格納先フォルダ（収集時）、または復元対象ファイル/フォルダ（復元時）

◎※3

/z 値

unarc_path

復元後の格納先フォルダ

◎※4

/r 値

JOB_ATTRIBUTE

job_generator

ジョブ名称

○※5

/j 値

jobno

ジョブ番号

×

−

job_folder

ジョブ格納フォルダパス

○

/l 値

unsuspended

中断中の配布の有無

×

−

JOB_SCHEDULE

job_entry_date

ジョブの登録日時

○※6

/jst 値

job_execution_date

ジョブの実行日時

○※6

/jsx 値

job_expiration_date

ジョブの実行期限

○※6

/jsp 値

SCHEDULE

expiration_date

中継でのパッケージ保管期限

×

−

expiration_days

中継でのパッケージ保管日数

×

−

installation_date_and_time

インストール日時

×

−

installation_timing

インストール（収集）タイミング

○

/tSまたは/tN

OPTION

compress

圧縮の有無

○

/uYまたは/uN

restore

バージョンアップ時のリストア対象の有無

×

−

reboot

インストール後のコンピュータ再起動

×

−

processing_dialog

インストール時の処理中ダイアログの表示

×

−

USER_PROGRAM_INSTALLATION_CONDITIONS

external_program_executed_before_installation

インストール（収集）前起動外部プログラム

○

/b 値

external_program_executed_after_installation

インストール（収集）後起動外部プログラム

○

/a 値

external_program_error_handler

インストール（収集）エラー時起動外部プログラム

○※7

/e 値

external_program_handler

起動外部プログラム

×

−

exit

外部プログラム処理結果の通知方式

×

−

action

処理結果エラー時の取り扱い

×

−

wait

監視方式

×

−

timeout

監視時間

×

−

wait_code

監視コード

×

−

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

JOB_DESTINATIONとJOB_DESTINATION_IDは同時に指定できません。また、/gおよび/hは/Xと同時に指定できません。必ずどちらかを指定してください。

なお、処理キーが「NETM_COLTOM」または「NETM_COLRESET」の場合は、あて先として指定できるIDは、ID管理元中継として登録されたIDだけです。

処理キーが「NETM_UNARC」の場合は、指定しても無視されます。

注※2

処理キーが「NETM_COLLECT」および「NETM_COLTOS」の場合に必ず指定してください。

注※3

処理キーが「NETM_COLLECT」、「NETM_COLTOS」、および「NETM_UNARC」の場合に必ず指定してください。

注※4

処理キーが「NETM_UNARC」の場合に必ず指定してください。

注※5

job_generator（または/j）の指定を省略した場合、ジョブ名称として「処理キー＋ジョブの実行日時」が自動的に設定されます。このため、同じ処理キーのコマンドを同時に複数実行すると、ジョブ名称が重複しジョブが正しく実行されないことがあります。同じ処理キーのコマンドを同時に複数実行する場合は、job_generator（または/j）で、異なるジョブ名称を指定することをお勧めします。

注※6

処理キーが「NETM_UNARC」の場合は、指定しても無視されます。

注※7

UNIXのコンピュータからファイルを収集する場合は指定できません。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを使用しないで引数だけで指定する場合の、コマンドの形式を次に示します。

管理対象のコンピュータからファイルを収集する場合

dcmcoll.exe {[NETM_COLLECT]|NETM_COLTOS} [/s]
            {[/g あて先グループ名] [/h ホスト名]|/X ID名}
            /y 収集ファイル名 /z 収集ファイル格納フォルダパス
            [/j ジョブ名称] [/l ジョブ格納フォルダパス]
            [/jst ジョブの登録日時] [/jsx ジョブの実行日時]
            [/jsp ジョブの実行期限]
            [{/tS|/tN}] [ {/uY|/uN}]
            [/b ファイル収集前起動外部プログラム]
            [/a ファイル収集後起動外部プログラム]
            [/e ファイル収集エラー時起動外部プログラム]
            /o 結果出力ファイル名

中継システムおよび管理用中継サーバからコレクトファイルを収集する、または中継システムおよび管理用中継サーバ上のコレクトファイルを削除する場合

dcmcoll.exe {NETM_COLTOM|NETM_COLRESET} [/s]
            {[/g あて先グループ名] [/h ホスト名]|/X ID名}
            [/j ジョブ名称] [/l ジョブ格納フォルダパス]
            [/jst ジョブの登録日時] [/jsx ジョブの実行日時]
            [/jsp ジョブの実行期限]
            /o 結果出力ファイル名

ファイルを復元する場合

dcmcoll.exe NETM_UNARC [/G] [/Z]
            /z 復元対象ファイルまたはフォルダ
            /r 復元後の格納先

リターンコード

dcmcollコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

配布管理システムがジョブを開始した。

または、アーカイブファイルの復元が正常終了した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式に誤りがある。

パラメタファイルの指定または記述形式を確認してください。

2

コマンドの引数またはパラメタファイルに不正な値が指定されている。

コマンドの引数またはパラメタファイルの設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

結果出力ファイルをオープンできない。

結果出力ファイルの指定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

7

1つ以上のアーカイブファイルの復元に失敗した。

アーカイブファイルのパスを確認してください。

復元ファイルのフルパス（「復元後の格納先ディレクトリ」+「作成ディレクトリ」（「アーカイブファイルの格納先ディレクトリ」）+「復元後のファイル名またはディレクトリ名」）が半角259文字を超えているおそれがあります。

12

そのほかのエラーが発生した。

イベントログを参照してください。

注意事項

あて先および収集ファイルの指定数について

パラメタファイルで指定する場合は、dcmcollコマンド1回の実行につき、あて先（ホスト・あて先グループ・ID）は、それぞれ200個まで指定できます。また、あて先200個に対し、収集するファイルまたはディレクトリは100個まで指定できます。

あて先および収集ファイルをコマンドの引数で指定する場合は、それぞれ1個しか指定できません。

パラメタファイルであて先および収集ファイルを複数指定している場合でも、同じ項目をコマンドの引数で指定すると、すべて無効となります。

コマンド実行時にあて先を重複して指定しないでください。あて先に同じジョブが複数回実行されます。

あて先の経路について

あて先の経路を指定できます。同一のあて先を別の経路で複数指定すると、1番目の定義だけが有効になります。

中継システムおよび管理用中継サーバあてのジョブについて

「中継からのコレクトファイル収集」ジョブおよび「中継のコレクトファイル削除」ジョブは、あて先として中継システムおよび管理用中継サーバを指定するジョブです。このジョブのあて先に管理対象のコンピュータを指定すると、エラーまたは実行中のままとなります。

収集先および復元先のディレクトリについて

ファイルを収集するときは、収集先として指定したディレクトリ下に、あて先のホスト名と同じ名称のディレクトリが自動的に作成されます。ファイルは収集時にアーカイブされ、拡張子が「.dmz」のアーカイブファイルとして、各ホスト名のディレクトリ下に格納されます。

アーカイブファイルを復元するときは、収集時と同様に、復元先として指定したディレクトリ下に、ホスト名と同じ名称のディレクトリが自動的に作成されます。ただし、一度に複数のアーカイブファイルを復元する場合、別々のアーカイブファイルに同じ名称のファイルが存在すると、ファイルが上書きされてしまいます。同じ名称のファイルが含まれる複数のアーカイブファイルを復元する場合は、別の復元先ディレクトリを指定したdcmcollコマンドを実行してください。

復元時、コマンドの引数に/Gを指定すると、復元先として指定したディレクトリ下に、直接ファイルが展開されます。複数のあて先から収集したファイルを一度に復元すると、すべて上書きされ、あて先ごとに区別できません。アーカイブファイルを1つだけ復元する場合は、/Gを使用してください。

復元時、コマンドの引数に/Gを指定しない場合、復元後の格納先として指定したディレクトリ下に、あて先のホスト名と同じ名称のディレクトリが自動的に作成されます。ただし、/zまたは「FILE_COLLECTION」タグのdmz_pathパラメタに、復元対象ファイルを格納しているディレクトリを指定したときは、ディレクトリは作成されないで、直接ファイルが展開されます。

復元したファイルをあて先ごとに区別する必要がある場合は、/zまたは「FILE_COLLECTION」タグのdmz_pathパラメタに、ファイル収集時に指定したディレクトリをそのまま指定してください。

ジョブ格納フォルダパスの指定について

ジョブ格納フォルダパスに［ジョブ定義］ウィンドウで定義されていないフォルダを指定してコマンドを実行した場合、指定されたフォルダが作成されます。作成されたジョブ格納フォルダは、実行後も削除されないで残ります。使用しない場合は、ジョブが完了したら削除してください。

パラメタファイルを使用しない場合の注意事項

収集先がWS（UNIXシステム）の場合は、収集先ディレクトリのドライブには任意のドライブを指定してください。ただし、収集時には、指定されたドライブは無視され、ディレクトリの指定に従って収集されます。次の場合、c:は無視されます。

指定例：c:/user/tmp

なお、ディレクトリの区切りに「¥」を使用するときは、ドライブの指定は不要です。

指定例：¥user¥tmp

外部プログラムの指定について

収集先がWS（UNIXシステム）で外部プログラムを指定する場合は、パラメタファイルを使用してコマンドを実行してください。

リモートコレクトのジョブ実行時、およびアーカイブファイルの復元時の注意事項

「9.1.4　リモートコレクト実行時の注意事項」を参照してください。

コマンド実行時の注意事項

コマンドを実行途中で中断（［Ctrl］＋［C］など）すると、コマンドが作成したジョブ定義が削除されない場合があります。

コマンドを実行途中で中断した場合は、リモートインストールマネージャのジョブ定義画面を確認し、必要に応じてジョブ定義を削除してください。

実行例

JP1/IT Desktop Management 2 - Agent（エージェント）が稼働するホストdmp491およびdmp492から、C:¥temp下のディレクトリ「SD障害.dir」、「SD障害2.dir」、および「SD障害3.dir」のファイルを収集する例を次に示します。管理対象のコンピュータの起動を契機に収集を開始し、収集前、収集後、および収集エラー時に外部プログラムを起動するよう指定しています。

パラメタファイルの作成

ホストと収集ファイルの属性をパラメタファイルに次のように記述し、パラメタファイルを任意の名称で保存します。

** dcmcoll Parameter File Sample

JOB_DESTINATION{
host_name=dmp492.soft.hitachi.co.jp
host_name=dmp491
group = ¥grp¥gname1
group = ¥grp¥gname2;¥grp¥gname3
}
SCHEDULE{
installation_timing = S
}
OPTION{
compress=Y
}
USER_PROGRAM_INSTALLATION_CONDITIONS{
external_program_executed_before_installation = "C:¥test B.exe"
external_program_executed_after_installation = C:¥testA.exe -x "a aa"
external_program_error_handler = "C:¥test E.exe"
}
FILE_COLLECTION{
source_path= C:¥temp¥SD障害.dir
source_path= C:¥temp¥SD障害2.dir;C:¥temp¥SD障害3.dir
dmz_path= C:¥temp¥収集
}

コマンドの実行

作成したパラメタファイルをC:¥Dmbat¥dcmcoll.txtに保存し、結果出力ファイルをC:¥Dmbat¥out.txtに取得する場合は、次のように指定します。

dcmcoll.exe /i C:¥Dmbat¥dcmcoll.txt /o C:¥Dmbat¥out.txt /j temp収集

結果出力ファイルの確認

コマンドが正常終了すると、ジョブのジョブ名称、ジョブ番号、ジョブ格納フォルダパスが、C:¥Dmbat¥out.txtに次のように出力されます。

JOB_ATTRIBUTE{
job_generator= NETM_COLLECT_03_12_11_13_34_36
jobno= JB03121113315383
job_folder= ¥
}

14.5　dcmgpmnt.exe（あて先グループへのポリシーの一括反映）

あて先グループにポリシーを一括反映するdcmgpmntコマンドについて説明します。

機能

ローカルホスト上の配布管理システム（JP1/IT Desktop Management 2 - Manager）に接続し、作成したポリシーに従って、登録されているホストを一括してあて先グループに振り分けます。

形式

dcmgpmnt.exe [処理キー]

引数

処理キー

あて先グループに一括反映するポリシーの種別を指定するキーです。コマンド名の直後に、次に示す処理キーのうち1つ以上を指定してください。省略した場合は、「ALLGROUP」が仮定されます。

ALLGROUP

すべてのポリシーをあて先グループに一括反映します。

IPSCOPE

種別が「IPアドレス」のポリシーをあて先グループに一括反映します。

OSTYPE

種別が「OS種別」のポリシーをあて先グループに一括反映します。

HWASSETFIELD

種別が「ハードウェア資産情報の追加管理項目」のポリシーをあて先グループに一括反映します。

DEPARTMENT

種別が「部署」のポリシーをあて先グループに一括反映します。

LOCATION

種別が「設置場所」のポリシーをあて先グループに一括反映します。

「IPSCOPE」、「OSTYPE」、「HWASSETFIELD」、「DEPARTMENT」および「LOCATION」は、任意に組み合わせて指定できます。組み合わせる場合は間をスペースで区切ってください。なお、次のように指定した場合は、リターンコード「2」のエラーとなります。

「ALLGROUP」とそれ以外の処理キーを組み合わせて指定した場合

同じ処理キーを重複して指定した場合

リターンコード

dcmgpmntコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

正常終了、または該当ホストなし。

なし。

2

コマンドの引数に不正な値が指定されている。

コマンドの引数の設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

15

ほかのプロセスがデータベースを更新している。

しばらく待ってからコマンドを再実行してください。または更新中のプロセスを確認してください。

実行例

種別が「IPアドレス」および「OS種別」のポリシーをあて先グループに一括反映する例を次に示します。

dcmgpmnt.exe IPSCOPE OSTYPE

注意事項

あて先グループの一括メンテナンス機能は台数とポリシー数に比例して時間が掛かります。

一括メンテナンス実行中は、機器情報の更新時に行われるあて先グループの自動メンテナンス機能が動作しないため、あて先グループの一括メンテナンスは機器情報の更新が少ない時間帯に実施することをお勧めします。

14.6　dcminst.exe（ジョブの作成、実行）

ジョブを作成、実行するdcminstコマンドについて説明します。

このコマンドで実行したジョブは、配布管理システムの［ジョブ実行状況］ウィンドウで実行結果を確認できます。

機能

次に示す、リモートインストール関連のジョブを作成、実行します。

パッケージのインストール

中継までのパッケージの転送

中継のパッケージの一括削除

クライアントユーザによるインストール

形式

dcminst.exe [処理キー] [/f] [/s]
            /i パラメタファイル1 [パラメタファイル2]
            /o 結果出力ファイル名

引数

処理キー

実行するジョブの種類を指定するキーです。コマンド名の直後に、次に示す処理キーのうち1つを指定してください。省略した場合は、「NETM_INSTALL」が仮定されます。

NETM_INSTALL

「パッケージのインストール」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、インストールするパッケージおよびあて先を指定してください。

NETM_STORE

「中継までのパッケージの転送」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、パッケージおよびあて先（中継システムおよび管理用中継サーバ下の、中継システムおよび管理用中継サーバと同一名称のエージェント）を指定してください。

NETM_DELETE

「中継のパッケージの一括削除」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、あて先（中継システムおよび管理用中継サーバ下の、中継システムおよび管理用中継サーバと同一名称のエージェント）を指定してください。

NETM_USERINST

「クライアントユーザによるインストール」ジョブを実行します。パラメタファイル（またはコマンドの引数）で、インストールするパッケージおよびあて先を指定してください。

/f

インストール対象として指定したパッケージがあて先のコンピュータにインストール済みの場合に、上書きしてインストールします。この引数を指定しない場合は、インストール済みのパッケージは上書きしないで正常終了します。

処理キーが「NETM_DELETE」の場合は、指定しても無視されます。

/s

ジョブを作成後、実行しないで保存します。

この引数を指定してコマンドを実行したときの結果出力ファイルには、ジョブ番号が出力されません。

/i

使用するパラメタファイルのフルパスを、1つまたは2つ指定します。2つ指定する場合は間をスペースで区切ってください。3つ以上指定するとコマンドは失敗します。

パラメタファイルを2つ指定すると、JP1/IT Desktop Management 2は、それぞれのパラメタファイルの内容を連結して解釈します。あて先とパッケージとを別のパラメタファイルに定義しておくと、パッケージだけを変更して同じコンピュータに再配布したり、同じパッケージを別のあて先に配布したりできて便利です。この場合、dcmpackコマンドの結果出力ファイルを、パッケージの属性を指定したパラメタファイルとして使用できます。

/o

結果出力ファイルのフルパスを指定してください。コマンドが正常終了すると、指定した結果出力ファイルに次の項目が出力されます。結果出力ファイルがすでに存在する場合は上書きされます。

ジョブ名称

ジョブ番号

ジョブ格納フォルダパス

ジョブ番号（jobnoの値）は、開始されたジョブを識別する番号です。このジョブを削除したり、実行状況を確認したりする場合は、jobnoの値をパラメタファイルに記述してください。なお、コマンドの引数に/sを指定した場合、ジョブ番号は出力されません。

/sを指定した場合の結果出力ファイルは、そのままdcmjexeコマンドおよびdcmrmgenコマンドのパラメタファイルとして使用できます。また、/sを指定しなかった場合の結果出力ファイルは、dcmjbrmコマンド、dcmrtryコマンド、dcmstatコマンド、およびdcmstswコマンドのパラメタファイルとして使用できます。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒5　パラメタファイルとコマンドの引数の対応（dcminstコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_DESTINATION

group

あて先グループ名

◎※1

/g 値

host_name

ホスト名

◎※1

/h 値

JOB_DESTINATION_ID

destination_id

ID名

◎※1

/X 値

PACKAGING_INFORMATION※2

package_name

パッケージ名

◎

/p 値

package_id

パッケージ識別ID

◎

/I 値

version_revision

バージョン/リビジョン

◎

/v 値

generation

世代番号

◎

/G 値

cabinet_name

キャビネット名

◎

/c 値

cabinet_id

キャビネット識別ID

◎

/C 値

package_code

コード種別

○

/KWまたは/KP

JOB_ATTRIBUTE

job_generator

ジョブ名称

○※3

/j 値

jobno

ジョブ番号

×

−

job_folder

ジョブ格納フォルダパス

○

/l 値

unsuspended

中断中の配布の有無

○※4

/uns 値

JOB_SCHEDULE

job_entry_date

ジョブの登録日時

○

/jst 値

job_execution_date

ジョブの実行日時

○

/jsx 値

job_expiration_date

ジョブの実行期限

○

/jsp 値

JOB_SPLIT_DELIVERY※4

split_size

分割サイズ

○

/sds 値

wait_time

転送休止時間

○

/sdt 値

JOB_CLIENT_CONTROL

client_wake_up

クライアントの起動の有無

○

/WWU

client_shutdown

クライアントのシャットダウンの有無

○

/WUS

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

JOB_DESTINATIONとJOB_DESTINATION_IDは同時に指定できません。また、/gおよび/hは/Xと同時に指定できません。必ずどちらかだけを指定してください。

なお、処理キーが「NETM_STORE」または「NETM_DELETE」の場合、IDは指定できません。

注※2

このコマンドでは、PACKAGING_INFORMATIONタグのパラメタに予約語を使用できません。

注※3

job_generator（または/j）の指定を省略した場合、ジョブ名称として「処理キー＋ジョブの実行日時」が自動的に設定されます。このため、同じ処理キーのコマンドを同時に複数実行すると、ジョブ名称が重複しジョブが正しく実行されないことがあります。同じ処理キーのコマンドを同時に複数実行する場合は、job_generator（または/j）で、異なるジョブ名称を指定することをお勧めします。

注※4

JOB_ATTRIBUTEのunsuspendedおよびJOB_SPLIT_DELIVERYは同時に指定できません。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを使用しないで引数だけで指定する場合の、コマンドの形式を次に示します。

dcminst.exe [処理キー] [/f] [/s]
            {[/g あて先グループ名] [/h ホスト名]|/X ID名}
              /p パッケージ名 /I パッケージ識別ID
              /v バージョン・リビジョン /G 世代番号
              /c キャビネット名 /C キャビネット識別ID
            [{/KW|/KP}]
            [/j ジョブ名称] [/l ジョブ格納フォルダパス]
            [/uns 中断中の配布の有無]
            [/jst ジョブの登録日時] [/jsx ジョブの実行日時]
            [/jsp ジョブの実行期限]
            [/sds 分割サイズ] [/sdt 転送休止時間]
            [/WWU クライアントの起動の有無]
            [/WUS クライアントのシャットダウンの有無]
             /o 結果出力ファイル名

リターンコード

dcminstコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

配布管理システムがジョブを開始した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式に誤りがある。

パラメタファイルの指定または記述形式を確認してください。

2

コマンドの引数またはパラメタファイルに不正な値が指定されている。

コマンドの引数またはパラメタファイルの設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

結果出力ファイルをオープンできない。

結果出力ファイルの指定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

注意事項

あて先およびパッケージの指定数について

パラメタファイルで指定する場合、dcminstコマンド1回の実行につき、あて先は200個まで指定できます。また、パッケージは100個まで指定できます。

あて先およびパッケージをコマンドの引数で指定する場合は、それぞれ1個しか指定できません。ただし、あて先の場合、/gおよび/hは値を「;」で区切ることで、200個まで指定できます。

パラメタファイルでパッケージを複数指定している場合でも、同じ項目をコマンドの引数で指定すると、すべて無効となります。

コマンド実行時にあて先またはパッケージを重複して指定しないでください。あて先に同じジョブが複数回実行されます。

/fの指定について

引数に/fを指定すると、すでに同じパッケージがあて先に配布されているかいないかに関係なく、パッケージが送信されます。不要なネットワークトラフィックの増加を避けるには、配布済みのパッケージを上書きする必要がある場合だけ、/fを使用してください。

引数に/fを指定すると、バージョンが同じでも内容が異なるソフトウェアを上書きインストールできるため、JP1/IT Desktop Management 2のインストールパッケージ情報のバージョン管理ができなくなります。

JOB_ATTRIBUTEタグのjob_generatorパラメタに指定したジョブ名が既存のジョブ名として存在する場合について

既存のジョブ定義を基にジョブが作成されます。

クライアントの起動の指定について

クライアントの起動の有無を指定する場合は、ジョブのあて先に、あて先グループ名またはIDを指定してください。ホスト名を指定すると、クライアントの起動の指定は無視されます。中継システムの場合、クライアントの起動の指定は無条件に無視されます。

ジョブ格納フォルダパスの指定について

ジョブ格納フォルダパスに［ジョブ定義］ウィンドウで定義されていないフォルダを指定してコマンドを実行した場合、指定されたフォルダが作成されます。作成されたジョブ格納フォルダは、実行後も削除されないで残ります。使用しない場合は、ジョブが完了したら削除してください。

多重実行時のジョブ名称について

dcminstコマンドを多重実行する場合は、ジョブ名称を省略せず、重複しないジョブ名称を指定してください。また、リモートインストールマネージャとdcminstコマンドでリモートインストール関連のジョブを同時実行する場合も、重複しないジョブ名称を指定してください。

コマンド実行時の注意事項

コマンドを実行途中で中断（［Ctrl］＋［C］など）すると、コマンドが作成したジョブ定義が削除されない場合があります。

コマンドを実行途中で中断した場合は、リモートインストールマネージャのジョブ定義画面を確認し、必要に応じてジョブ定義を削除してください。

実行例

JP1/IT Desktop Management 2 - Agent（エージェント）が稼働するホストdmp491およびdmp492に、Finance Data 2003 5という名称でパッケージングしたソフトウェアを配布する例を次に示します。

パラメタファイルの作成

ホストとパッケージの属性をパラメタファイルに次のように記述し、パラメタファイルを任意の名称で保存します。

** dcminst Parameter File Sample

JOB_DESTINATION{
host_name=dmp491;dmp492
}
PACKAGING_INFORMATION
{
package_name=Finance Data 2003 5
package_id=FD200305
version_revision=000001
generation=0000
cabinet_name=FCAB01
cabinet_id=F1
package_code=P
}

コマンドの実行

作成したパラメタファイルをC:¥Dmbat¥dcminst.txtに保存し、結果出力ファイルをC:¥Dmbat¥out.txtに取得する場合は、次のように指定します。

dcminst.exe /i C:¥Dmbat¥dcminst.txt /o C:¥Dmbat¥out.txt /j 上書きインストール /f

結果出力ファイルの確認

コマンドが正常終了すると、ジョブのジョブ名称、ジョブ番号、ジョブ格納フォルダパスが、C:¥Dmbat¥out.txtに次のように出力されます。

JOB_ATTRIBUTE{
job_generator= NETM_INSTALL_2003_12_11_13_34_36
jobno= JB03121113315383
job_folder= ¥
}

14.7　dcmjbrm.exe（ジョブの削除）

実行したジョブを削除するdcmjbrmコマンドについて説明します。

機能

実行したジョブをパラメタファイルで指定し、配布管理システムで削除します。

形式

dcmjbrm.exe /i パラメタファイル名

引数

/i

パラメタファイルのフルパスを指定してください。

dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、dcmjexeコマンド、またはdcmsuspコマンド（/s指定なし）の結果出力ファイルを、パラメタファイルとして使用することもできます。

パラメタファイルの指定内容

dcmjbrmコマンドでのパラメタファイルの指定内容を次の表に示します。このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することはできません。

表14‒6　パラメタファイルの指定内容（dcmjbrmコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_ATTRIBUTE

job_generator

ジョブ名称

×

−

jobno

ジョブ番号

◎

−

job_folder

ジョブ格納フォルダパス

×

−

unsuspended

中断中の配布の有無

×

−

（凡例）

◎：必ず指定する　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

リターンコード

dcmjbrmコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

ジョブを削除中の状態にした、または指定されたジョブがない。

なし。

1

パラメタファイルをオープンできない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

パラメタファイルに不正な値が指定されている。

パラメタファイルの値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

注意事項

パラメタファイルには、dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、dcmjexeコマンド、またはdcmsuspコマンド（/s指定なし）の結果出力ファイルに出力されたジョブ番号を指定してください。

削除するジョブのジョブ番号が不明な場合は、dcmjbrmコマンドは実行できません。配布管理システムの［ジョブ実行状況］ウィンドウで、該当するジョブ名のジョブを削除してください。

実行例

dcmjexeコマンドで実行した、「伝票ファイル0001収集」ジョブを削除する例を次に示します。

パラメタファイルの作成

dcmjexeコマンドの結果出力ファイルに出力されたジョブ番号を、次のようにパラメタファイルに指定します。

なお、dcmjexeコマンドの結果出力ファイルが保存されていれば、このファイルをパラメタファイルとして指定できます。

** dcmjexe output->dcmjbrm input

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
jobno= JB03121113315383
job_folder= ¥バッチ定義
}

コマンドの実行

dcmjexeコマンドを実行したときの、結果出力ファイルがC:¥Dmbat¥out.txtに保存されている場合、コマンドは次のように指定してください。

dcmjbrm.exe /i C:¥Dmbat¥out.txt

14.8　dcmjexe.exe（ジョブの実行）

ジョブを実行するdcmjexeコマンドについて説明します。

機能

パラメタファイルに定義されたジョブを実行します。実行するジョブは、JOB_ATTRIBUTEタグで1つだけ指定できます。

形式

dcmjexe.exe /i パラメタファイル名 /o 結果出力ファイル名

引数

/i

パラメタファイルのフルパスを指定してください。

dcmcollコマンド（/s指定あり）、dcminstコマンド（/s指定あり）、またはdcmsuspコマンド（/s指定あり）の結果出力ファイルを、パラメタファイルとして使用することもできます。

/o

結果出力ファイルのフルパスを指定してください。コマンドが正常終了すると、指定した結果出力ファイルに次の項目が出力されます。結果出力ファイルがすでに存在する場合は上書きされます。

ジョブ名称

ジョブ番号

ジョブ格納フォルダパス

ジョブ番号（jobnoの値）は、ジョブを識別する番号です。このジョブを削除したり、実行状況を確認したりする場合は、jobnoの値をパラメタファイルに指定してください。結果出力ファイルを、dcmjbrmコマンド、dcmrtryコマンド、dcmstatコマンド、およびdcmstswコマンドのパラメタファイルとして使用することもできます。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドはパラメタファイルの使用は必須ですが、パラメタファイルの内容の一部は、コマンドの引数でも指定できます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒7　パラメタファイルとコマンドの引数の対応（dcmjexeコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_ATTRIBUTE

job_generator

ジョブ名称

◎

−

jobno

ジョブ番号

×

−

job_folder

ジョブ格納フォルダパス

○※

−

unsuspended

中断中の配布の有無

×

−

JOB_SCHEDULE

job_entry_date

ジョブの登録日時

○

/jst 値

job_execution_date

ジョブの実行日時

○

/jsx 値

job_expiration_date

ジョブの実行期限

○

/jsp 値

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※

省略した場合は、ルートフォルダ以下のすべてのフォルダまたはファイルを検索してジョブを実行します。

パラメタファイルの内容を引数で指定した場合のコマンド形式

ジョブの登録日時、ジョブの実行日時、およびジョブの実行期限をコマンド引数で指定した場合のコマンドの形式を次に示します。

dcmjexe.exe /i パラメタファイル名 /o 結果出力ファイル名
           [/jst ジョブの登録日時] [/jsx ジョブの実行日時]
           [/jsp ジョブの実行期限]

リターンコード

dcmjexeコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

配布管理システムがジョブを開始した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

パラメタファイルに不正な値が指定されている。

パラメタファイルの値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

結果出力ファイルをオープンできない。

結果出力ファイルの指定を確認してください。

ジョブが開始されている場合があります。ジョブの実行状況を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

実行例

配布管理システムのフォルダ「バッチ定義」に保存されている「伝票ファイル0001収集」ジョブを実行する例を次に示します。

パラメタファイルの作成

実行するジョブが保存されているフォルダ、およびジョブ名をパラメタファイルに次のように記述し、パラメタファイルを任意の名称で保存します。

** dcmjexe Parameter File Sample

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
job_folder= ¥バッチ定義
}

コマンドの実行

パラメタファイルをC:¥Dmbat¥dcmjexe.txtに保存し、結果出力ファイルをC:¥Dmbat¥out.txtに取得する場合は、次のように指定します。

dcmjexe.exe /i C:¥Dmbat¥dcmjexe.txt /o C:¥Dmbat¥out.txt

結果出力ファイルの内容

コマンドが正常終了すると、開始されたジョブのジョブ名称、ジョブ番号、およびジョブ格納フォルダパス（実行したジョブのフォルダ）がC:¥Dmbat¥out.txtに次のように出力されます。

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
jobno= JB03121113315383
job_folder= ¥バッチ定義
}

14.9　dcmpack.exe（パッケージングの実行）

ユーザデータまたはユーザプログラムのパッケージングを実行するdcmpackコマンドについて説明します。

機能

配布管理システム（JP1/IT Desktop Management 2 - Manager）に、ユーザデータまたはユーザプログラムをパッケージングします。

プログラムプロダクトはパッケージングできません。

形式

dcmpack.exe /k パスワード
            /i パラメタファイル名 [/o 結果出力ファイル名]
            [/split /tempdir 一時フォルダ名[/splitfilesize 分割サイズ]]

引数

/k

配布管理システムへ、ソフトウェアをパッケージングするためのパスワードを指定します。

配布管理システムのデータベースのパスワードを指定してください。

/i

パラメタファイルのフルパスを指定してください。

/o

結果出力ファイルのフルパスを指定してください。コマンドが正常終了すると、指定した結果出力ファイルに、作成したパッケージの属性情報が書き込まれます。この結果出力ファイルは、dcminstコマンド、dcmpkgetコマンド、およびdcmpkrmコマンドのパラメタファイルとして使用できます。

省略した場合、結果出力ファイルは作成されません。

/split

2ギガバイトを超えるファイルまたはフォルダを分割して配布する場合に、指定してください。

パッケージング対象がフォルダの場合は、パッケージングできるフォルダ全体の最大サイズは127GBです。フォルダ内ファイルの最大サイズは127GBです。

パッケージング対象がファイルの場合は、パッケージングできるファイルの最大サイズは255GBです。

/tempdir

2ギガバイトを超えるファイルまたはフォルダを分割して配布する場合に使用する、一時ファイルの出力先フォルダ名を指定してください。

/splitfilesize

2ギガバイトを超えるファイルを分割するサイズを、バイト単位で指定します。指定可能な範囲は1,024〜1,073,741,824です。省略時は1,073,741,824（1ギガバイト）です。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒8　パラメタファイルとコマンドの引数の対応（dcmpackコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

PACKAGING_SOURCE

file_path

パッケージ対象ファイル名

○

/P 値

base_fullpath

パッケージ基準ディレクトリパス

◎

/B 値

PACKAGING_INFORMATION

package_name

パッケージ名

◎

/p 値

package_id

パッケージ識別ID

◎

/I 値

version_revision

バージョン/リビジョン

◎

/v 値

generation

世代番号

◎

/G 値

cabinet_name

キャビネット名

◎

/c 値

cabinet_id

キャビネット識別ID

◎

/C 値

package_code

コード種別

×

−

SYSTEM_CONDITIONS

directory

インストール先ディレクトリ

○

/D 値

condition

システム条件

○※1※2

/O 値

SOFTWARE_CONDITIONS

condition

パッケージ条件

○※1※2

/l 値

INSTALLSOFTWARE_CONDITIONS

condition

ソフトウェア条件

○※3

−

FILE_PROPERTIES

permission

ファイルアクセス権の復元

○

/qYまたは/qN※4

SCHEDULE

expiration_date

中継でのパッケージ保管期限

○

/x 値

expiration_days

中継でのパッケージ保管日数

○

/ed 値

installation_date_and_time

インストール日時

○

/d 値

installation_timing

実行タイミング

○

/tSまたは/tN

INSTALLATION_METHOD

installation_mode

インストールモード

○

/mBまたは/mG

OPTION

compress

圧縮の有無

○

/uYまたは/uN

compress_type

圧縮方法

○

/ctNまたは/ctH※5

restore

バージョンアップ時のリストア対象の有無

○

/RYまたは/RN

reboot

インストール後のコンピュータ再起動

○

/reboot

processing_dialog

インストール時の処理中ダイアログの表示

○※2

/procS、/procY、または/procN

USER_PROGRAM_INSTALLATION_CONDITIONS

external_program_executed_before_installation※6

インストール前起動外部プログラム

○

/b 値

external_program_executed_after_installation

インストール後起動外部プログラム

○

/a 値

external_program_error_handler※7

インストールエラー時起動外部プログラム

○

/e 値

external_program_handler

起動外部プログラム

×

−

exit※7

外部プログラム処理結果の通知方式

○

/rbR、/rbM、/raR、/raM、/reR、または/reM

action※7

処理結果エラー時の取り扱い

○

/ybC、/ybS、/yaC、または/yaS

wait※7

監視方式

○

/wbU、/wbT、/wbG、/waU、/waT、/waG、/weU、または/weY

timeout

監視時間

○※8

/n 値

wait_code

監視コード

×

−

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

システム条件とパッケージ条件を複数指定すると、システム条件がすべての条件を満たし、かつパッケージ条件が1個以上の条件を満たす場合にインストールされます。コマンドの引数で指定する場合、/Oと/lは、合計10個まで指定できます。

注※2

UNIXのコンピュータへ配布するパッケージの場合は指定できません。

注※3

ソフトウェア条件を複数指定すると、どれか1つ以上の条件を満たす場合にインストールされます。

注※4

UNIXのコンピュータへ配布するパッケージの場合、「/qN」を指定してください。

注※5

UNIXのコンピュータへ配布するパッケージの場合、「/ctN」を指定してください。

注※6

UNIXのコンピュータへ配布するパッケージの場合、SCHEDULEタグのinstallation_date_and_timeパラメタと同時に指定すると、このパラメタは無視されます。

注※7

UNIXのコンピュータへ配布するパッケージの場合、パラメタを指定しても無視されます。

注※8

waitでUを指定した場合（コマンドの引数で/wbU、/waU、/weUを指定した場合）は、指定しても無視されます。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを使用しないで引数だけで指定する場合の、コマンドの形式を次に示します。

dcmpack.exe /k パスワード
            [/P パッケージ対象ファイル名]
             /B パッケージ基準ディレクトリパス
             /p パッケージ名 /I パッケージ識別ID
             /v バージョン・リビジョン /G 世代番号
             /c キャビネット名 /C キャビネット識別ID
            [/D インストール先ディレクトリ]
            [/O システム条件] [/l パッケージ条件]
            [{/qY|/qN}] [/x 中継でのパッケージ保管期限]
            [/ed 中継でのパッケージ保管日数]
            [/d インストール日時] [{/tS|/tN}] [{/mB|/mG}]
            [{/uY|/uN}] [{/ctH|/ctN}] [{/RY|/RN}]
            [/reboot] [{/procS|/procY|/procN}]
            [/b インストール前起動外部プログラム [{/rbR|/rbM}]
            [{/ybC|/ybS}] [{/wbU|/wbT|/wbG}] [/n 監視時間]]
            [/a インストール後起動外部プログラム [{/raR|/raM}]
            [{/yaC|/yaS}] [{/waU|/waT|/waG}] [/n 監視時間]]
            [/e インストールエラー時起動外部プログラム
            [{/reR|/reM}] [{/weU|/weY}] [/n 監視時間]]
            [/o 結果出力ファイル名]
            [/split /tempdir 一時フォルダ名[/splitfilesize 分割サイズ]]

リターンコード

dcmpackコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

正常終了した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

コマンドの引数またはパラメタファイルに不正な値が指定されている。

コマンドの引数またはパラメタファイルの設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

結果出力ファイルを作成できなかった、または予約語を使用したバージョン・リビジョンおよび世代番号の自動カウントアップに失敗した。ただしパッケージの登録には成功した。

パッケージングするファイルを指定したパスを確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

6

配布管理システムとのデータ送受信に失敗した。

通信環境を確認してください。

7

次のどちらかを意味する。

パッケージング対象のファイルまたはディレクトリがない。

パッケージ対象のファイルまたはディレクトリ数が上限値を超過した。

パッケージングするファイルまたはディレクトリを指定したパスを確認してください。

パッケージ対象のファイルまたはディレクトリ数を減らしてください。

9

パッケージング対象のパッケージはすでにパッケージングされている。

次の項目のうち、どれか1つを変更して再度パッケージングしてください。

キャビネット識別ID

パッケージ識別ID

バージョン番号

世代番号

12

そのほかのエラーが発生した。

イベントログを参照してください。

13

パスワードに誤りがある。

パスワードの指定を確認してください。

14

バージョン・リビジョンまたは世代番号を自動カウントアップした結果、指定できる最大けた数を超えたため、パッケージの登録に失敗した。

バージョン・リビジョンおよび世代番号の予約語の設定を確認してください。

32

分割ファイルの出力時にエラーが発生した。

/tempdir引数で指定したフォルダの有無やアクセス権、空き容量を確認してください。

注意事項

キャビネットの指定について

パラメタファイルまたはコマンドの引数で存在しないキャビネット識別IDを指定した場合、新規にキャビネットが作成されます。

キャビネット識別IDとキャビネット名が異なる組み合わせで複数指定された場合は、2つ目以降のパッケージはキャビネット識別IDで指定されたキャビネットに格納されます。エラーにはなりません。

パッケージの指定数について

パラメタファイルで指定する場合、コマンドの引数で指定する場合ともに、dcmpackコマンド1回の実行につき、1個のパッケージを指定できます。

バージョン・リビジョンおよび世代番号の自動カウントアップについて

予約語を使用することで、バージョン・リビジョンおよび世代番号を自動的にカウントアップさせる運用ができます。この場合、パラメタファイルからの指定とコマンドの引数からの指定では、次のように動作が異なります。

パラメタファイルから指定した場合

dcmpackコマンド実行時にカウントアップの初期値が更新され、パラメタファイル上に上書きされます。同じパラメタファイルを使用して再度実行すると、続きの値からカウントアップが開始されます。

コマンドの引数から指定した場合

dcmpackコマンドを実行しても、カウントアップの初期値は更新されません。コマンドを実行するたびに、初期値からカウントアップされます。

dcmpackコマンドの接続先について

レジストリのHKEY_LOCAL_MACHINEの更新権限を持つユーザでパッケージャを起動し、接続したサーバが接続先となります。接続先を変更する場合は、レジストリHKEY_LOCAL_MACHINEの更新権限を持つユーザでパッケージャを起動し、接続先を変更したあとで、dcmpackコマンドを実行してください。

パラメタファイルを使用しない場合の注意事項

外部プログラムには、スペースが含まれるパスを指定しないでください。

配布先がWS（UNIXシステム）の場合は、外部プログラムの格納先ディレクトリ、インストール先ディレクトリのドライブには任意のドライブを指定してください。ただし、配布時には、指定されたドライブは無視され、ディレクトリの指定に従って配布されます。次の場合、c:は無視されます。

指定例：c:/user/tmp

なお、ディレクトリの区切りに「¥」を使用するときは、ドライブの指定は不要です。

指定例：¥user¥tmp

パッケージャを新規インストールした場合の注意事項

パッケージャを新規にインストールした場合、dcmpackコマンドを実行する前にパッケージャを起動してサーバを指定してください。

バックグラウンドインストールモードの注意事項

バックグラウンドインストールモードでは、インストール先ディレクトリにネットワークドライブを指定しないでください。

/splitを指定した場合の注意事項

dcmpackコマンドを実行する前に/tempdir引数に指定するフォルダに、分割前のファイルサイズ以上の空きがあることを確認してください。

dcmpackコマンドを実行すると、一時ファイル領域として次のフォルダが作成されます。コマンドの実行中は、このフォルダを削除しないでください。

tempdir引数に指定した一時フォルダ¥<プロセスID>※

注※　dcmpackコマンドのプロセスIDです。

一時ファイル領域は、コマンド終了後に自動的に削除されます。

ファイルの分割数は最大255個です。分割したファイルをパッケージとして登録するキャビネットを新規に作成することを推奨します。

分割後のファイル数が最大数を超えた場合は、リターンコード「12」のエラーとなります。

なお、パッケージを登録するキャビネットに登録済みのパッケージがある場合、ファイルの最大分割数は登録済みパッケージ数だけ少なくなります。

パッケージ名は半角46文字（全角で23文字）以内で指定してください。また、パッケージ識別IDは1〜40文字で指定してください。

dcmpackコマンドのリターンコードが「3」〜「14」、または「32」で異常終了した場合、次の手順で一時ファイルおよびパッケージを削除してから、dcmpackコマンドを再実行してください。

一時ファイルの削除：

/tempdir引数に指定したフォルダに残っているファイルを削除します。

パッケージの削除：

パラメタファイルまたはコマンド引数で指定したキャビネットに登録されている、パッケージ名が「コマンドの引数の/p 値、またはパラメタファイルのpackage_nameで指定したパッケージ.連番」であるパッケージを削除します。パッケージの削除については、「7.4.5　キャビネットおよびパッケージの削除」または「14.12　dcmpkrm.exe（パッケージの削除）」を参照してください。

登録するパッケージのバージョン・リビジョンおよび世代番号の自動カウントアップはされません。引数に/splitを指定した状態で、コマンドの引数の/v、/Gまたはパラメタファイルのversion_revision、generationに「¥増分値［:開始値］」を指定した場合、「:開始値」に指定した値が使用されます。また、「:開始値」を省略した場合は0が使用されます。

パッケージ名（パラメタファイルのpackage_nameパラメタまたはコマンドの引数の/p 値）およびパッケージID（パラメタファイルのpackageidパラメタまたはコマンドの引数の/I 値）に「001」から始まる通番を付けたパッケージが複数個登録されます。パラメタファイルまたはコマンドの引数で指定した値のうち、パッケージインストール後に処理されるタイミングを次の表に示します。

パラメタ

対応する引数

処理タイミング

external_program_executed_before_installation

/b

分割したパッケージのうち、一番最初のパッケージインストール後に実行されます。

external_program_executed_after_installation

/a

分割したパッケージのうち、一番最後のパッケージインストール後に実行されます。

external_program_error_handler

/e

分割したすべてのパッケージのインストールでエラーが発生した際に実行されます。

reboot

/reboot

分割したパッケージのうち、一番最後のパッケージインストール後に実行されます。

なお、「7.6.14(2)　Windows 10の大型アップデートプログラムを配布する例」のように、配布後にインストールスクリプトをパッケージ・配布する場合は、パラメタファイルのrebootパラメタまたはコマンドの引数の/rebootは指定せず、インストールスクリプト側で再起動するようにしてください。

インストールスクリプト側で再起動する場合は、外部プログラムの監視時間を0（監視しない）にしてください。

バージョンアップ時のリストア対象の有無（パラメタファイルのrestoreパラメタまたはコマンドの引数/R）は無効となります。restoreパラメタにYを指定した場合（コマンドの引数で/RYを指定した場合）でも、バージョンアップ時のリストア対象となりません。

実行例

C:¥Finance¥data0401ディレクトリ下にあるファイルを、次のようにパッケージングする例を次に示します。

パッケージ名

Finance Data 2003 4

保管先のキャビネット名

FCAB01

パラメタファイルの作成

パラメタファイルを次のように作成します。

** dcmpack Parameter File Sample

PACKAGING_SOURCE{
file_path=FD200304.dat
base_fullpath= C:¥Finance¥data0401
}
PACKAGING_INFORMATION
{
package_name=Finance Data 2003 4
package_id=FD200304
version_revision=000001
generation=0000
cabinet_name=FCAB01
cabinet_id=F1
package_code=P
}
SYSTEM_CONDITIONS{
condition=H:c>=300
directory=C:¥Finance
}
USER_PROGRAM_INSTALLATION_CONDITIONS
{
external_program_executed_after_installation = C:¥Dmbat¥app¥normal_exit.exe
}

コマンドの実行

パラメタファイルをC:¥Dmbat¥para.txtに保存した場合、コマンドは次のように実行してください。

dcmpack.exe /i C:¥Dmbat¥para.txt

14.10　dcmpkget.exe（パッケージのバックアップの取得）

パッケージのバックアップを取得するdcmpkgetコマンドについて説明します。

機能

指定したパッケージのバックアップを作成します。

形式

dcmpkget.exe /i パラメタファイル /o 出力先ディレクトリ
             [/of 結果出力ファイル名]

引数

/i

パラメタファイルのフルパスを指定します。

dcmpackコマンドの結果出力ファイルを、パラメタファイルとして使用することもできます。ただし、PACKAGING_INFORMATIONタグ内のpackage_nameは無視されます。

/o

出力先ディレクトリのフルパスを指定します。指定したディレクトリが存在しない場合は、自動的に作成されます。出力先ディレクトリにネットワークドライブは指定できません。

/of

出力先ディレクトリに作成するバックアップファイル名を指定してください。省略すると、「dcmpkget」になります。ここで指定したファイル名にパッケージ属性（「パッケージ種別」、「キャビネット識別ID」、「パッケージ識別ID」、「バージョン」、および「世代番号」）を付加したものが、バックアップファイル名となり、「.DPF」、「.PKG」、および「.SCI」もしくは「.XML」の拡張子を持つファイルが作成されます。なお、「バージョン」に「/」が含まれている場合は、「$」に置き換えられて、ファイル名が作成されます。

バックアップファイル名は、半角で256文字（全角で128文字）まで指定できます。パッケージ属性を付加したときに、この文字数を超えると、最大文字数に収まるように、指定したファイル名は短縮されます。

/ofには、予約語「¥CY」、「¥CM」、「¥CD」、「¥CH」、「¥CN」、「¥CS」、「¥VERSION」、および「¥PKGID」を使用できます。「¥VERSION」および「¥PKGID」は1つ目のパッケージ定義を参照し、定義がなければ無視されます。予約語については「14.20　予約語の指定方法」を参照してください。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

パラメタファイルとコマンドの引数の両方を指定した場合は、コマンドの引数で指定した内容が有効となり、パラメタファイルでの指定は無視されます。ただし、コマンドの引数で一部のパッケージ属性だけを指定した場合は、パラメタファイルのPACKAGING_INFORMATIONタグ内の、1つ目のパッケージ情報だけが有効になります。

表14‒9　パラメタファイルとコマンドの引数の対応（dcmpkgetコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

PACKAGING_INFORMATION※1

package_name

パッケージ名

×

−

package_id

パッケージ識別ID

◎※2

/I 値

version_revision

バージョン/リビジョン

◎※2

/v 値

generation

世代番号

◎※2

/G 値

cabinet_name

キャビネット名

×

−

cabinet_id

キャビネット識別ID

◎

/C 値

package_code

コード種別

○

/KWまたは/KP

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

このコマンドでは、PACKAGING_INFORMATIONタグのパラメタに予約語を使用できません。

注※2

キャビネット識別IDだけを指定する場合は、省略できます。その場合、キャビネット内にあるすべてのパッケージが対象となります。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを使用しないで引数だけで指定する場合の、コマンドの形式を次に示します。

dcmpkget.exe /I パッケージ識別ID /v バージョン・リビジョン /G 世代番号
             /C キャビネット識別ID [/KW|/KP] /o 出力先ディレクトリ
             [/of 結果出力ファイル名]

リターンコード

dcmpkgetコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

ファイルの出力が成功した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式に誤りがある。

パラメタファイルのパスまたは記述形式を確認してください。

2

コマンドの引数またはパラメタファイルに不正な値が指定されている。

コマンドの引数またはパラメタファイルの設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

指定したパッケージが存在しない。

配布管理システムにパッケージが存在することを確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

14

結果出力ファイルまたはディレクトリを作成できない。

出力先ディレクトリおよび結果出力ファイルのパスを確認してください。

注意事項

複数のパッケージを指定して、このコマンドを実行したとき、指定したパッケージが存在しなければ、そのパッケージのバックアップ処理はスキップし、それ以降のパッケージのバックアップを続行します。その際、dcmpkgetコマンドはリターンコード4を返します。

複数のパッケージを指定して、このコマンドを実行したとき、途中でパッケージのバックアップに失敗すると、dcmpkgetコマンドは、パッケージのバックアップを中止します。その際、それまでに作成されたバックアップファイルはすべて削除され、障害発生時のリターンコードを返します。

スクリプトファイルを指定しないで作成したUNIX版のパッケージをバックアップした場合、SCIファイルは出力されません。

実行例

キャビネット識別ID「01」のキャビネットにある、パッケージ識別ID「0100」、バージョン/リビジョン「0100」、世代番号「0000」のパッケージのバックアップを取得する例を次に示します。

パラメタファイルの作成

バックアップを取得するパッケージおよびキャビネットを、パラメタファイルに次のように記述し、パラメタファイルを任意の名称で保存します。

** dcmpkget Parameter File Sample

PACKAGING_INFORMATION{
package_id=0100
version_revision=0100
generation=0000
cabinet_id=01
package_code=P
}

コマンドの実行

パラメタファイルをC:¥Dmbat¥dcmpkget.txtに保存し、バックアップをC:¥Dmbat¥buckupに取得する場合は、次のように指定します。

dcmpkget.exe /i C:¥Dmbat¥dcmpkget.txt /o C:¥Dmbat¥backup /of BackupFile

14.11　dcmpkput.exe（パッケージのバックアップからの復元）

パッケージをバックアップから復元するdcmpkputコマンドについて説明します。なお、このコマンドでは、パラメタファイルを使用しません。

機能

バックアップファイルからパッケージを復元し、指定したキャビネットに保管します。

形式

dcmpkput.exe [/C キャビネット識別ID] /i 入力先ディレクトリ
             [/of 入力ファイル名] [/f]

引数

/C

バックアップから復元したパッケージを保管するキャビネットの識別IDを指定します。指定したキャビネットが存在しない場合は、自動的に作成されます。キャビネット識別IDを指定しない場合は、元のキャビネットに保管されます。

/i

dcmpkgetコマンドで指定した出力先ディレクトリのフルパスを指定します。入力先ディレクトリにネットワークドライブは指定できません。

/of

dcmpkgetコマンドで作成したバックアップファイル名を指定します。/ofにはワイルドカード（*）が使用できます。省略すると「dcmpkget」で始まるすべてのバックアップファイルを対象にします。

/iで指定したディレクトリに、複数のバックアップファイルが存在している場合、次のような指定方法で、ディレクトリ下のすべてのバックアップファイルを指定することもできます。

dcmpkput.exe /i C:¥temp¥pkg /of *

/f

指定したキャビネットに同じパッケージがあった場合に上書きします。この引数を指定しない場合は、上書きしないで、リターンコード5を返します。

リターンコード

dcmpkputコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

パッケージの復元が成功した。

なし。

1

dcmpkgetコマンドの結果出力ファイルをオープンできない、またはファイル形式に誤りがある。

結果出力ファイルのパス、またはファイル形式を確認してください。

2

コマンドの引数に不正な値が指定されている。

コマンドの引数の設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

指定したバックアップファイルが存在しない。

バックアップファイルのパスを確認してください。

5

すでにパッケージが存在する、またはキャビネットにこれ以上のパッケージを登録できない。

JP1/IT Desktop Management 2のサービスの接続に失敗した。

キャビネット内のパッケージ名、およびパッケージ数を確認してください。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

注意事項

複数のパッケージを指定してこのコマンドを実行したとき、途中でパッケージの復元に失敗すると、dcmpkputコマンドはパッケージの復元処理を中止します。その際、障害発生時のリターンコードを返します。

UNIX版パッケージのバックアップを復元する場合、復元先にはキャビネット種別がUNIX用の、既存のキャビネットを指定してください。キャビネット種別がWindows用のとき、およびキャビネットが存在しないときは復元できません。

実行例

dcmpkgetコマンドで取得したバックアップファイルからパッケージを復元する例を次に示します。

C:¥Dmbat¥backupに取得したすべてのバックアップファイルを、キャビネット識別ID「01」のキャビネットに復元する場合は、次のように指定します。

dcmpkput.exe /C 01 /i C:¥Dmbat¥backup /of *

14.12　dcmpkrm.exe（パッケージの削除）

パッケージを削除するdcmpkrmコマンドについて説明します。

機能

配布管理システムのキャビネットから、パッケージを削除します。

形式

dcmpkrm.exe /i パラメタファイル名

引数

/i

使用するパラメタファイルのフルパスを指定してください。

dcmpackコマンドの結果出力ファイルを、パラメタファイルとして使用することもできます。

パラメタファイルの指定内容

dcmpkrmコマンドでのパラメタファイルの指定内容を次の表に示します。このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することはできません。

表14‒10　パラメタファイルの指定内容（dcmpkrmコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

PACKAGING_INFORMATION

package_name

パッケージ名

×

−

package_id

パッケージ識別ID

◎

−

version_revision

バージョン/リビジョン

◎

−

generation

世代番号

◎

−

cabinet_name

キャビネット名

×

−

cabinet_id

キャビネット識別ID

◎

−

package_code

コード種別

◎

−

（凡例）

◎：必ず指定する　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注

このコマンドでは、PACKAGING_INFORMATIONタグのパラメタに予約語を使用できません。

リターンコード

dcmpkrmコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

正常終了した。

なし。

1

パラメタファイルがない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

パラメタファイルに不正な値が指定されている。

パラメタファイルの値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

14.13　dcmrmgen.exe（ジョブ定義の削除）

ジョブ定義を削除するdcmrmgenコマンドについて説明します。

機能

パラメタファイルに指定されたジョブ定義を削除します。

形式

dcmrmgen.exe /i パラメタファイル名

引数

/i

パラメタファイルのフルパスを指定してください。

dcminstコマンド（/s指定あり）の結果出力ファイルを、パラメタファイルとして使用することもできます。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒11　パラメタファイルとコマンドの引数の対応（dcmrmgenコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_ATTRIBUTE

job_generator※1

ジョブ名称

◎※2

/j

jobno

ジョブ番号

×

−

job_folder

ジョブ格納フォルダパス

◎※2

/f

unsuspended

中断中の配布の有無

×

−

（凡例）ｓ

◎：必ず指定する　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

複数のジョブ名称を指定する場合は、ジョブ名称を「;」で区切ってください。

注※2

パラメタファイルの指定では、job_generatorおよびjob_folderのどちらかまたは両方を指定します。

job_generatorおよびjob_folderの両方が指定された場合は、指定したフォルダ下を検索し、最初に検出したジョブ定義を削除します。

job_generatorだけを指定した場合は、ルートフォルダ下が検索対象となります。job_folderだけを指定した場合は、job_folderで指定したフォルダ下のすべてのジョブ定義を、フォルダごと削除します。

コマンド引数で指定する場合は、/jと/fの両方を指定する必要があります。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを指定しないで引数だけで指定する場合の、コマンドの形式を次に示します。

dcmrmgen.exe /j ジョブ名称 /f ジョブ格納フォルダパス

「/j ジョブ名称」に複数のジョブ名称を指定する場合は、ジョブ名称を「;」で区切ってください。

/j（ジョブ名称）と/f（ジョブ格納フォルダパス）は必ず両方指定してください。両方を指定しないとエラーになります。

リターンコード

dcmrmgenコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

ジョブが削除された、または指定されたジョブがない。

なし。

1

パラメタファイルをオープンできない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

パラメタファイルに不正な値が指定されている。

パラメタファイルの値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

注意事項

ルートフォルダだけを指定して、すべてのジョブ格納フォルダとジョブ定義を一括して削除することはできません。

実行例

配布管理システムのフォルダ「バッチ定義」に保存されている「伝票ファイル0001収集」という名称のジョブを削除する例を次に示します。

パラメタファイルの作成

削除するジョブ定義が保存されているフォルダ、およびジョブ名称をパラメタファイルに次のように定義し、任意の名称で保存します。

** dcmjexe Parameter File Sample

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
job_folder= ¥バッチ定義
}

コマンドの実行

パラメタファイルをC:¥Dmbat¥dcmjexe.txtに保存した場合、コマンドは次のように実行してください。

dcmrmgen.exe /i C:¥Dmbat¥dcmjexe.txt

14.14　dcmrtry.exe（ジョブの再実行）

ジョブを再実行するdcmrtryコマンドについて説明します。

機能

配布管理システムで、パラメタファイルに指定されたジョブを再実行します。

形式

dcmrtry.exe [再実行対象キー]
            /i パラメタファイル名 /o 結果出力ファイル名

引数

再実行対象キー

再実行するジョブの実行状態を指定します。キーは、コマンド名の直後に指定してください。「ERROR」、「WAIT」、および「PENDING」は、任意に組み合わせて指定できます。組み合わせて指定する場合は、キーとキーの間をスペースで区切ってください。省略した場合は「ERROR」が仮定されます。

ERROR

エラーになったジョブを再実行します。

WAIT

実行待ちのジョブを再実行します。

PENDING

一時的に通信エラーになったジョブを再実行します。

/i

パラメタファイルのフルパスを指定してください。

dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、dcmjexeコマンド、またはdcmsuspコマンド（/s指定なし）の結果出力ファイルを、パラメタファイルとして使用することもできます。

/o

結果出力ファイルのフルパスを指定してください。コマンドが正常終了すると、結果出力ファイルには指定したパラメタファイルと同じ内容が出力されます。

パラメタファイルの指定内容

dcmrtryコマンドでのパラメタファイルの指定内容を次の表に示します。このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することはできません。

表14‒12　パラメタファイルの指定内容（dcmrtryコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_ATTRIBUTE

job_generator

ジョブ名称

×

−

jobno

ジョブ番号

◎

−

job_folder

ジョブ格納フォルダパス

×

−

unsuspended

中断中の配布の有無

×

−

（凡例）

◎：必ず指定する　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

リターンコード

dcmrtryコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

ジョブの再実行が開始された。

なし。

1

パラメタファイルをオープンできない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

パラメタファイルに不正な値が指定されている。

パラメタファイルの値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

結果出力ファイルをオープンできない。

結果出力ファイルの指定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

注意事項

パラメタファイルには、dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、dcmjexeコマンド、またはdcmsuspコマンド（/s指定なし）の結果出力ファイルに出力されたジョブ番号を指定してください。

再実行するジョブのジョブ番号が不明な場合、dcmrtryコマンドは実行できません。配布管理システムの［ジョブ実行状況］ウィンドウで、該当するジョブ名のジョブを再実行してください。

実行例

dcminstコマンドで実行したジョブのうち、実行待ちまたはエラーになったジョブを再実行する例を次に示します。

パラメタファイルの作成

dcminstコマンドの結果出力ファイルに出力されたジョブ番号を、次のようにパラメタファイルに指定します。

なお、dcminstコマンドの結果出力ファイルが保存されている場合は、このファイルをパラメタファイルとして指定できます。

JOB_ATTRIBUTE{
job_generator= NETM_INSTALL_2003_12_11_13_34_36
jobno= JB03121113315383
job_folder= ¥
}

コマンドの実行

dcminstコマンドを実行したときの、結果出力ファイルがC:¥Dmbat¥out.txtに保存されている場合、コマンドは次のように指定してください。

dcmrtry.exe WAIT ERROR /i C:¥Dmbat¥out.txt /o C:¥temp¥retryout.txt

14.15　dcmstat.exe（ジョブの実行状況の取得）

ジョブの実行結果を取得するdcmstatコマンドについて説明します。

機能

配布管理システムで、パラメタファイルに指定されたジョブの実行状態を取得します。ジョブの実行状況は、リターンコードで判別します。

ジョブの実行状態

リターンコード

ジョブがすべて正常終了した。

0

一部のジョブがエラーとなった。

30

ジョブは実行中。

31

ジョブは実行中で、一部のジョブがエラーとなっている。

32

ジョブは削除中で、一部のジョブが削除完了待ちとなっている。

33

JP1/IT Desktop Management 2 - Managerの配布管理システムで、ジョブの実行状態を指定して、その実行状態にあるホストの数を調べます。リターンコードの値から10,000を引いた値が、指定した実行状態にあるホストの数です。

形式

dcmstat.exe [ジョブ実行状態] /i パラメタファイル名

引数

ジョブ実行状態

特定の実行状態にあるホストの数を調べる場合に、ジョブの実行状態を指定します。下記の引数の中から1つ以上を、コマンド名の直後に指定してください。指定したジョブ実行状態にあるホストの総数に10,000を足した数がリターンコードとして返ります。

指定できるジョブ実行状態を次の表に示します。

ジョブ実行状態

説明

TRANS_WAIT

配布管理システムで転送待ち状態。

TRANSMITTED

管理対象のコンピュータへ転送中または実行中。

REGISTERED

IDジョブをID管理元中継へ転送中。

CLT_NOTREADY

起動に失敗した。

CLT_SERVICE_OFF※

エージェントが停止しているため、起動に失敗した。

CLT_POWER_OFF※

PCの電源がオフのため、起動が失敗した。

CLT_NETWORK_ERR※

ネットワーク障害などの理由のため、起動が失敗した。

SUSPENDED

中断指示があった。

INST_WAIT

インストールまたは収集待ち。

HOLD_EXEC

ジョブが保留された。

ID_NOPKG

IDジョブで中継保管パッケージが削除された。

CONNECT_ERROR

通信エラーが発生した。

ERROR

ジョブ実行エラーが発生した。

DELETING

中継システム、管理用中継サーバ、および管理対象のコンピュータでジョブを削除中。

注※

JP1/IT Desktop Management 2 - Managerのセットアップで、［リモートインストールマネージャを使用した配布のセットアップ］画面の［サーバカスタマイズオプション］パネルの「起動失敗要因を細分化する」チェックボックスがオンの場合に指定できます。ただし、「CLT_NOTREADY」と同時に指定しても無視されます。

なお、チェックボックスがオフの場合は、これらの引数を指定しても、ホストの総数にカウントされません。

ジョブ実行状態を指定しなかった場合は、パラメタファイルで指定したジョブの実行状態を調べ、実行状態に対応するリターンコード（0〜33）を返します。

/i

パラメタファイルのフルパスを指定してください。

dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、dcmjexeコマンド、またはdcmsuspコマンド（/s指定なし）の結果出力ファイルを、パラメタファイルとして使用することもできます。

パラメタファイルの指定内容

dcmstatコマンドでのパラメタファイルの指定内容を次の表に示します。このコマンドで使用するパラメタファイルの内容は、コマンドの引数で指定することはできません。

表14‒13　パラメタファイルの指定内容（dcmstatコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_ATTRIBUTE

job_generator

ジョブ名称

×

−

jobno

ジョブ番号

◎

−

job_folder

ジョブ格納フォルダパス

○※

−

unsuspended

中断中の配布の有無

×

−

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※

省略した場合は、ルートフォルダ以下のすべてのフォルダまたはファイルを検索して、ジョブの実行状況を表示します。

リターンコード

dcmstatコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

ジョブがすべて正常終了した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

パラメタファイルに不正な値が指定されている。

パラメタファイルの値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

30

少なくとも一部のジョブがエラーになった。

なし。

31

ジョブは実行中で、エラーのジョブは検知されていない。

なし。

32

ジョブは実行中で、一部のジョブがエラーとなっている。

なし。

33

ジョブは削除中で、一部のジョブが削除完了待ちとなっている。

なし。

また、ジョブの実行状態を指定した場合は、指定したジョブの実行状態にあるホストの総数+10,000がリターンコードとして返ります。

注意事項

パラメタファイルには、dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、dcmjexeコマンド、またはdcmsuspコマンド（/s指定なし）の結果出力ファイルに出力されたジョブ番号を指定してください。

実行状況を取得するジョブのジョブ番号が不明な場合、dcmstatコマンドは実行できません。配布管理システムの［ジョブ実行状況］ウィンドウで、該当するジョブ名の実行状況を確認してください。

実行例

dcmjexeコマンドで実行した「伝票ファイル0001収集」ジョブの実行状況を取得する例を次に示します。

パラメタファイルの作成

dcmjexeコマンドの結果出力ファイルに出力されたジョブ番号を、次のようにパラメタファイルに指定します。

なお、dcmjexeコマンドの結果出力ファイルが保存されていれば、このファイルをパラメタファイルとして指定できます。

** dcmjexe output -> dcmstat input

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
jobno= JB03121113315383
job_folder= ¥バッチ定義
}

コマンドの実行

dcmjexeコマンドを実行したときの結果出力ファイルが、C:¥Dmbat¥out.txtに保存されている場合、次のようにコマンドを指定してください。

dcmstat.exe /i C:¥Dmbat¥out.txt

dcmstatコマンドを実行すると、特定の状態のホスト数を調査できます。例えば、起動失敗のホスト数、および中断指示があったホスト数を調べる場合は、次のように指定してください。

dcmstat.exe CLT_NOTREADY SUSPENDED /i C:¥Dmbat¥out.txt

14.16　dcmstsw.exe（ジョブの実行状況の監視）

ジョブの実行状況を監視するdcmstswコマンドについて説明します。

機能

配布管理システムで、パラメタファイルまたはコマンドラインに指定されたジョブの実行状況を監視し、指定された実行状況になった場合に、外部プログラムを起動します。

形式

dcmstsw.exe [監視時間間隔] [監視条件] /i パラメタファイル名

引数

監視時間間隔

ジョブの実行状況を監視する間隔を、秒単位で指定してください。省略した場合は、900秒（15分）が仮定されます。

監視条件

外部プログラムを起動するタイミングを指定します。

「ALL」を指定すると、すべてのあて先が指定の実行状況になった場合に、外部プログラムを起動します。

指定を省略すると、1つ以上のあて先が指定の実行状況になった場合に、外部プログラムを起動します。

/i

パラメタファイルのフルパスを指定してください。

dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、およびdcmjexeコマンドの結果出力ファイルを、パラメタファイルとして使用することもできます。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用できるパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒14　パラメタファイルとコマンドの引数の対応（dcmstswコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_ATTRIBUTE

job_generator

ジョブ名称

×

−

jobno

ジョブ番号

◎

/jn 値

job_folder

ジョブ格納フォルダパス

○※1

/l 値

unsuspended

中断中の配布の有無

×

−

USER_PROGRAM_INSTALLATION_CONDITIONS

external_program_executed_before_installation

インストール（収集）前起動外部プログラム

×

−

external_program_executed_after_installation

インストール（収集）後起動外部プログラム

×

−

external_program_error_handler

インストールエラー時起動外部プログラム

×

−

external_program_handler

起動外部プログラム

◎

/ep 値

exit

外部プログラム処理結果の通知方式

×

−

action

処理結果エラー時の取り扱い

×

−

wait

監視方式

×

−

timeout

最大実行期間

○※2

/wt 値

wait_code

監視コード

○※3

/wc 値

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

省略した場合は、ルートフォルダ以下のすべてのフォルダまたはファイルを検索して、ジョブの実行状況を監視します。

注※2

監視時間間隔より大きな値を指定してください。省略した場合は、86,400秒（1日）が仮定されます。

注※3

「ジョブ実行状態」または「保守コード」を指定します。指定する値の詳細は、「14.19.20　USER_PROGRAM_INSTALLATION_CONDITIONS（外部プログラムの指定）」を参照してください。このパラメタを省略すると、ジョブ実行エラーの発生を契機に外部プログラムを実行します。

パラメタファイルを使用しない場合のコマンド形式

パラメタファイルを使用しないで引数だけで指定する場合の、コマンドの形式を次に示します。

dcmstsw.exe [監視時間間隔] [監視条件]
            /jn ジョブ番号 [/l ジョブ格納フォルダパス]
            /ep 起動外部プログラム [/wt 最大実行期間] [/wc 監視コード]

リターンコード

dcmstswコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

正常終了した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式が不正。

パラメタファイルの指定または記述形式を確認してください。

2

コマンドの引数に不正な値が指定されている。

コマンドの引数の設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

指定された外部プログラムが存在しない。

外部プログラムのパスを確認してください。

5

最大実行期間が経過した。ジョブは終了していない。

JP1/IT Desktop Management 2のサービスの接続に失敗した。

ジョブの実行状況を確認してください。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

システムエラー、コマンドの引数の文法不正、処理が拒否されたなどの原因が考えられます。

注意事項

パラメタファイルまたはコマンドの引数には、dcmcollコマンド（/s指定なし）、dcminstコマンド（/s指定なし）、またはdcmjexeコマンドの結果出力ファイルに出力されたジョブ番号を指定してください。

このコマンドの終了条件は次のとおりです。

外部プログラムを起動したとき

最大実行期間に指定した時間を超過したとき

監視コードに「NORMAL」以外を指定した場合で、監視しているジョブがすべて正常終了したとき

監視しているジョブが削除されたとき

配布管理システムが停止したとき

監視するジョブにIDジョブを指定した場合は、監視条件に「ALL」を指定しないでください。「ALL」を指定すると、リターンコード「2」のエラーとなります。

実行例

ローカルの配布管理システムで実行したジョブすべてが正常終了した際に、外部プログラム「C:¥aaa.exe」を実行する例を次に示します。なお、コマンドの監視時間間隔は5分、最大実行期間は1時間とします。

パラメタファイルの作成

dcmjexeコマンドの結果出力ファイルに出力されたジョブ番号を、次のようにパラメタファイルに指定します。

なお、dcmjexeコマンドの結果出力ファイルが保存されていれば、このファイルをパラメタファイルとして指定できます。

** dcmstsw Parameter File Sample

JOB_ATTRIBUTE{
job_generator= 伝票ファイル0001収集
jobno= JB02100720481602
job_folder= ¥バッチ定義
}

コマンドの実行

dcmjexeコマンドを実行した時の結果出力ファイルが、C:¥DMbat¥para¥.txtに保存されている場合、次のようにコマンドを指定してください。

dcmstsw.exe 300 ALL /i C:¥DMbat¥para.txt /ep C:¥aaa.exe /wt 3600 /wc NORMAL

14.17　dcmsusp.exe（ファイル転送の中断と再開）

ファイル転送を中断または再開するdcmsuspコマンドについて説明します。

機能

ローカルホスト上の配布管理システムに接続し、指定した中継システムおよび管理用中継サーバとその直下のシステム間のファイル転送を中断、再開します。また、接続先の配布管理システムとその直下のシステム間のファイル転送を中断、再開します。

形式

dcmsusp.exe [処理キー] [/s] /i パラメタファイル1 [パラメタファイル2]
            [/o 結果出力ファイル名]

引数

処理キー

実行する処理の種類を指定するキーです。コマンド名の直後に、次に示す処理キーのうち1つを指定してください。省略した場合は、「NETM_SUSPEND」が仮定されます。

NETM_SUSPEND

「ファイル転送の中断」ジョブを実行します。指定した中継システムおよび管理用中継サーバとその直下のシステム間のファイル転送を中断します。パラメタファイル（またはコマンドの引数）で、ジョブのあて先（中継システムおよび管理用中継サーバ下の、中継システムおよび管理用中継サーバと同一名称のエージェント）を指定してください。

NETM_RESUME

「ファイル転送の再開」ジョブを実行します。指定した中継システムおよび管理用中継サーバとその直下のシステム間のファイル転送を再開します。パラメタファイル（またはコマンドの引数）で、ジョブのあて先（中継システムおよび管理用中継サーバ下の、中継システムおよび管理用中継サーバと同一名称のエージェント）を指定してください。

NETM_MANSUSP

接続先の配布管理システムとその直下のシステム間のファイル転送を中断します。この処理キーを指定した場合、処理キー以外の引数はすべて無視します。

NETM_MANRESU

接続先の配布管理システムとその直下のシステム間のファイル転送を再開します。この処理キーを指定した場合、処理キー以外の引数はすべて無視します。

/s

ジョブを作成後、実行しないで保存します。処理キーが「NETM_MANSUSP」または「NETM_MANRESU」の場合は、指定しても無視されます。

ジョブの登録日時、実行日時、および実行期限を指定した場合は、これらのスケジュールも保存します。

/i

使用するパラメタファイルのフルパスを、1つまたは2つ指定します。2つ指定する場合は間をスペースで区切ってください。3つ以上指定するとコマンドは失敗します。

/o

結果出力ファイルのフルパスを指定します。処理キーが「NETM_SUSPEND」または「NETM_RESUME」の場合は、必ず指定してください。処理キーが「NETM_MANSUSP」または「NETM_MANRESU」の場合は、指定しても無視されます。

「NETM_SUSPEND」または「NETM_RESUME」を指定した場合、コマンドが正常終了すると、指定した結果出力ファイルに次の項目が出力されます。結果出力ファイルがすでに存在する場合は上書きされます。

ジョブ名称

ジョブ番号

ジョブ格納フォルダパス

/sを指定した場合の結果出力ファイルは、dcmjexeコマンドのパラメタファイルとして使用することもできます。また、/sを指定しなかった場合の結果出力ファイルは、dcmjbrmコマンド、dcmrtryコマンド、およびdcmstatコマンドのパラメタファイルとして使用することもできます。

パラメタファイルの指定内容とコマンド引数との対応

このコマンドで使用できるパラメタファイルの内容は、コマンドの引数で指定することもできます。パラメタファイルの指定内容と、コマンドの引数との対応を次の表に示します。

表14‒15　パラメタファイルとコマンドの引数の対応（dcmsuspコマンド）

パラメタファイルの指定内容

内容

指定の有無

コマンドの引数

タグ

パラメタ

JOB_ATTRIBUTE

job_generator

ジョブ名称

○※1

/j 値

jobno

ジョブ番号

×

−

job_folder

ジョブ格納フォルダパス

○

/l 値

unsuspended

中断中の配布の有無

×

−

JOB_DESTINATION

group

あて先グループ名

◎※2

/g 値

host_name

ホスト名

◎※2

/h 値

JOB_DESTINATION_ID

destination_id

ID名

◎※2

/X 値

JOB_SCHEDULE

job_entry_date

ジョブの登録日時

○

/jst 値

job_execution_date

ジョブの実行日時

○

/jsx 値

job_expiration_date

ジョブの実行期限

○

/jsp 値

（凡例）

◎：必ず指定する　○：省略できる　×：不要（指定しても無視される）

−：コマンドの引数では指定できない

注※1

job_generator（または/j）の指定を省略した場合、ジョブ名称として「処理キー＋ジョブの実行日時」が自動的に設定されます。このため、同じ処理キーのコマンドを同時に複数実行すると、ジョブ名称が重複しジョブが正しく実行されないことがあります。同じ処理キーのコマンドを同時に複数実行する場合は、job_generator（または/j）で、異なるジョブ名称を指定することをお勧めします。

注※2

JOB_DESTINATIONとJOB_DESTINATION_ID、/gおよび/hと/Xは、同時に指定できません。どちらかを必ず指定してください。groupとhost_name（/gと/h）は片方だけでも、両方同時に指定してもかまいません。

リターンコード

dcmsuspコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

配布管理システムがジョブを開始した。または、配布管理システム自身の中断状態を変更した。

なし。

1

パラメタファイルをオープンできない、またはファイル形式に誤りがある。

パラメタファイルの指定または記述形式を確認してください。

2

コマンドの引数またはパラメタファイルに不正な値が設定されている。

コマンドの引数またはパラメタファイルの設定値を確認してください。

3

データベースの接続に失敗した。

配布管理システムのセットアップで、データベースの設定を確認してください。

4

結果出力ファイルをオープンできない。

結果出力ファイルの指定を確認してください。

5

JP1/IT Desktop Management 2のサービスの接続に失敗した。

JP1/IT Desktop Management 2 - Managerのサービスが開始しているかどうかを確認してください。

12

そのほかのエラーが発生した。

イベントログを参照してください。

システムエラー、コマンドの引数の文法不正、または接続先配布管理システムに定義されていない値がパラメタファイルに指定され処理が拒否された、などの原因が考えられます。

注意事項

JOB_DESTINATIONタグのhost_nameまたはコマンド引数の/hの指定時には、次のことに注意してください。

host_nameまたは/hに、ホスト名またはIPアドレスを指定した場合は、指定したホスト名またはIPアドレスをホスト識別子に引き当ててジョブが実行されます。

host_nameまたは/hに指定した、ホスト名またはIPアドレスのノードがシステム構成に存在しない場合は、指定されたあて先名称でジョブが実行されます。この場合、ジョブが正常終了してもシステム構成にあて先ノードが存在しないため、リモートインストールマネージャなどであて先ノードの中断状態を確認することはできません。

host_nameまたは/hに指定したホスト名またはIPアドレスのノードがシステム構成に複数存在する（ホスト識別子の異なる同名ノードが存在する）場合は、該当するすべての中継システムおよび管理用中継サーバに対してジョブが実行されます。同名ノードの一部に対してジョブを実行したい場合は、実行したいあて先をあて先グループとして登録し、そのあて先グループに対してジョブを実行してください。

JOB_ATTRIBUTEタグのjob_folderまたはコマンド引数の/lの指定時には、次のことに注意してください。

ジョブ格納フォルダパスに［ジョブ定義］ウィンドウで定義されていないフォルダを指定してコマンドを実行した場合、指定されたフォルダが作成されます。作成されたジョブ格納フォルダは、実行後も削除されないで残ります。使用しない場合は、ジョブが完了したら削除してください。

また、コマンド実行時にあて先を重複して指定しないでください。あて先に同じジョブが複数回実行されます。

コマンド実行時の注意事項

コマンドを実行途中で中断（［Ctrl］＋［C］など）すると、コマンドが作成したジョブ定義が削除されない場合があります。

コマンドを実行途中で中断した場合は、リモートインストールマネージャのジョブ定義画面を確認し、必要に応じてジョブ定義を削除してください。

14.18　catAndValidatePackagingFile.exe（分割ファイルの結合）

分割されたファイルを結合するcatAndValidatePackagingFileコマンドについて説明します。

機能

dcmpackコマンドで分割されたファイルを1ファイルに結合します。フォルダを分割した場合は、フォルダ内のファイルがすべて存在するかチェックします。

形式

catAndValidatePackagingFile.exe /d 分割ファイル格納先フォルダ名

引数

/d

分割ファイルの格納先フォルダ名を255文字以内のフルパスで指定します。

フォルダ名に半角スペースを含む場合は、パスを「"」（ダブルクォーテーション）で囲んでください。結合したファイルは、分割ファイルの格納先フォルダに格納されます。コマンドが終了すると、分割ファイルは自動的に削除されます。

リターンコード

catAndValidatePackagingFileコマンド実行時のリターンコードを次の表に示します。

コード

意味

対処

0

正常終了した。

なし。

11

引数に誤りがある。

引数の設定値を確認してください。

21

分割ファイルが存在しない、または読み込みアクセス権がない。

分割ファイル格納先フォルダに、dcmpackコマンドで生成するパッケージのファイルが存在しているか確認してください。

ファイルが存在しない場合は、該当するパッケージのリモートインストールジョブを再実行してください。

32

結合ファイルの出力時にエラーが発生した。

分割ファイル格納先フォルダ有無、アクセス権、およびディスク空き容量を確認してください。

33

結合ファイルの検証エラーが発生した。

リモートインストールジョブを再実行してください。

150

そのほかのエラーでコマンドの実行が中断した。

保守資料を採取し、システム管理者に連絡してください。

14.19　パラメタファイルの作成

パラメタファイルには、コマンド実行時に必要な情報（配布するパッケージやあて先などの情報）を記述します。この情報をタグといいます。実行するコマンドの種類に応じて、必要なタグをパラメタファイルに記述する必要があります。

14.19.1　タグの種類

タグの種類および記述内容を次の表に示します。

表14‒16　タグの種類

項番

タグ

内容

1

FILE_COLLECTION

リモートコレクトするファイルの指定

2

FILE_PROPERTIES

ファイルアクセス権の復元の指定

3

INSTALLATION_METHOD

インストールモードの指定

4

JOB_ATTRIBUTE

ジョブの属性の設定

5

JOB_CLIENT_CONTROL

クライアント制御の指定

6

JOB_DESTINATION

ジョブのあて先（ホスト、またはあて先グループ）の指定

7

JOB_DESTINATION_ID

ジョブのあて先（ID）の指定

8

JOB_SCHEDULE

ジョブのスケジュールの指定

9

JOB_SPLIT_DELIVERY

パッケージの分割配布の指定

10

OPTION

オプションの指定

11

PACKAGING_INFORMATION

パッケージ属性情報の設定

12

PACKAGING_SOURCE

パッケージングするファイルの指定

13

SCHEDULE

リモートインストール、リモートコレクトのスケジュールの指定

14

SOFTWARE_CONDITIONS

パッケージ条件の指定

15

INSTALLSOFTWARE_CONDITIONS

ソフトウェア条件の指定

16

SYSTEM_CONDITIONS

システム条件の指定

17

USER_PROGRAM_INSTALLATION_CONDITIONS

外部プログラムの指定

14.19.2　パラメタファイルの形式

パラメタファイルには、複数のタグを記述できます。パラメタファイルの形式を次の図に示します。

図14‒5　パラメタファイルの形式

タグは、複数のステートメントで構成されます。ステートメントとは、左辺に各設定情報を表すパラメタを記述し、右辺に対応する設定値を記述したものです。

パラメタファイル作成の規則、および注意事項を次に示します。

1行に複数のステートメントを記述できません。

1ステートメントを複数行にわたって記述できません。

「{」および「}」は、データの区切り文字として扱われるため、それ以外の記述に使用しないでください。

1行の長さは4,096バイト以下です。

コメントを記述する場合は、コメントの先頭に「*」を付けてください。空行、コメントだけの行は無視されます。

タグの名称は大文字の英字および「_」で記述してください。また、パラメタの名称は小文字の英字および「_」で記述してください。

1つのパラメタファイルに、順不同に必要なタグを記述できます。ただし、同じ名称のタグを2つ以上記述するとファイル形式のエラー（リターンコード「1」）となります。

JOB_DESTINATIONタグとJOB_DESTINATION_IDタグは同時に指定できません。

文字コードはShift-JISの範囲内に限られます。範囲外の文字を使用した場合、文字化けすることがあります。

14.19.3　タグの指定方法

パラメタファイルでのタグの指定方法について次に説明します。

なお、dcmcollコマンド、dcminstコマンド、dcmpackコマンド、dcmpkgetコマンド、dcmrmgenコマンド、dcmstswコマンド、およびdcmsuspコマンドでは、パラメタファイルで指定する内容をコマンドの引数でも指定できます。ここでは、パラメタと引数との対応もあわせて示します。引数で指定する場合の記述規則はパラメタでの記述規則と同じですが、引数で指定する場合に固有の規則もあります。引数固有の入力規則については「14.2.4　コマンドの入力形式」を参照してください。

パラメタまたはコマンドの引数には予約語を使用できます。予約語の使用方法の詳細については「14.20　予約語の指定方法」を参照してください。

14.19.4　FILE_COLLECTION（収集するファイルの指定）

FILE_COLLECTIONタグでは、収集するファイルや収集したファイルの格納先ディレクトリなどを指定します。このタグは、dcmcollコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

source_path

収集対象ファイル名

/y 収集対象ファイル名

dmz_path

収集後の格納先フォルダ

/z 収集後の格納先フォルダ

unarc_path

復元後の格納先フォルダ

/r 復元後の格納先フォルダ

(1)　形式

FILE_COLLECTION{
source_path=収集するファイルまたはフォルダ
dmz_path=収集後の格納先フォルダ
unarc_path=復元後の格納先フォルダ
}

(2)　説明

source_path=収集するファイルまたはフォルダ

収集するファイルまたはフォルダを、256バイト以下のフルパスで指定します。

複数のファイルまたはフォルダを指定する場合は、各パスを「;」で区切るか、source_pathを複数記述してください。source_pathには100個までファイルまたはフォルダを指定できます。

指定値にスペースを含めることもできますが、「;」の前後にスペースを指定するとリターンコード「2」のエラーとなります。また、指定値を「"」で囲って指定しないでください。ただし、コマンドの引数で指定する場合は、スペースを含む指定値は「"」で囲んでください。

dmz_path=収集後の格納先フォルダ

ファイルを収集する場合（dcmcollコマンドの処理キーが「NETM_COLLECT」の場合）は、収集したファイルまたはフォルダの格納先をフルパスで指定します。パスは1個だけ指定できます。収集したファイルのパス長は、259バイトを超えないように格納先フォルダを指定してください。収集したファイルの格納先の設定方法については、「9.1.1(2)　［コレクトファイル］パネルの設定」を参照してください。

アーカイブファイルを復元する場合（dcmcollコマンドの処理キーが「NETM_UNARC」の場合）は、復元するアーカイブファイル（拡張子が「dmz」のファイル）またはアーカイブファイルが格納されたフォルダを、256バイト以下のフルパスで指定します。この場合は、ファイルまたはフォルダを複数指定できます。各パスを「;」で区切るか、dmz_pathを複数記述してください。

unarc_path=復元後の格納先フォルダ

アーカイブファイルを復元する場合（dcmcollコマンドの処理キーが「NETM_UNARC」の場合）に、復元したファイルまたはフォルダの格納先を、ドライブからのパスで指定します。パスは1個だけ指定できます。復元したファイルのパス長は、259バイトを超えないように格納先フォルダを指定してください。復元したファイルの格納先の設定方法については、「9.1.2　収集ファイルの復元」を参照してください。

14.19.5　FILE_PROPERTIES（ファイルアクセス権の復元の指定）

FILE_PROPERTIESタグでは、リモートインストールしたファイルまたはディレクトリのアクセス権を復元するかどうかを指定します。このタグは、dcmpackコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

permission

ファイルアクセス権の復元

/qYまたは/qN

(1)　形式

FILE_PROPERTIES{
permission=ファイルアクセス権の復元
}

(2)　説明

permission=ファイルアクセス権の復元

インストールしたファイルまたはディレクトリのアクセス権を復元するかどうかを次のどちらかで指定します。

S

パッケージング元のアクセス権がインストール先に復元されます。

T

アクセス権を復元しません。インストール先ディレクトリのアクセス権に合わせてファイルが作成されます。

コマンドの引数で指定する場合は、「/q」の直後に「Y」または「N」を指定します。デフォルトは「Y」（復元する）です。UNIXのコンピュータへ配布する場合は、「N」（復元しない）を指定してください。

14.19.6　INSTALLATION_METHOD（インストールモードの指定）

INSTALLATION_METHODタグでは、インストールモードを指定します。

このタグは、dcmpackコマンドで使用します。指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

installation_mode

インストールモード

/mBまたは/mG

(1)　形式

INSTALLATION_METHOD{
installation_mode=インストールモード
}

(2)　説明

installation_mode=インストールモード

パッケージのインストールモードを指定します。コマンドの引数で指定する場合は、「/m」の直後に「G」または「B」を指定します。デフォルトは「B」（バックグラウンドインストールモード）です。

G（GUIインストールモード）

特別なインストーラ（対話形式のインストーラなど）を使用するインストールモードです。インストーラがGUIを持たなくても、グラフィックデバイスインターフェースAPIを使っている場合は、このモードを使用します。

B（バックグラウンドインストールモード）

特別なインストーラを使用しないインストールモードです。ファイルのコピーだけでインストールが完了する場合に適用します。エージェントをインストールしたユーザがログオンしていなくても、Windowsが起動していればリモートインストールされます。

14.19.7　JOB_ATTRIBUTE（ジョブの属性設定）

JOB_ATTRIBUTEタグでは、ジョブの属性を指定します。このタグは、dcmcollコマンド、dcminstコマンド、dcmjbrmコマンド、dcmjexeコマンド、dcmrmgenコマンド、dcmrtryコマンド、dcmstatコマンド、dcmstswコマンド、およびdcmsuspコマンドで使用します。

指定できるパラメタの内容、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

job_generator

ジョブ名称

/j ジョブ名称

jobno

ジョブ番号

/jn ジョブ番号

job_folder

ジョブ格納フォルダパス

/l ジョブ格納フォルダパス

unsuspended

中断中の配布の有無

/uns 中断中の配布の有無

(1)　形式

JOB_ATTRIBUTE{
job_generator=ジョブ名称
jobno=ジョブ番号
job_folder=ジョブ格納フォルダパス
unsuspended=中断中の配布の有無
}

(2)　説明

job_generator =ジョブ名称

配布管理システムで定義されたジョブの名称を指定します。省略すると「（dcmcollコマンド、dcminstコマンド、またはdcmsuspコマンドの）処理キー＋実行日時」が仮定されます。

dcmjexeコマンドでは必ず指定してください。

jobno=ジョブ番号

配布管理システムが自動的に割り当てるジョブの識別子です。

job_folder=ジョブ格納フォルダパス

配布管理システムのフォルダ名を指定します。ルートを示す「¥」で始めます。フォルダが階層になっている場合は、「¥」で区切って指定してください。4階層まで指定できます。

フォルダ名の指定例を次に示します。

job_folder=¥folder1¥folder2¥folder3¥folder

省略した場合、ルートフォルダから指定されたジョブ名称を検索し、最初に見つけたジョブを処理の対象とします。同じ名称のジョブが異なるフォルダに複数ある場合は、ジョブが保存されているフォルダ名を指定してください。

なお、dcmcollコマンドまたはdcminstコマンドで、複数のパラメタファイルを使用する場合は、異なるパラメタファイルに同じフォルダ名が含まれないように指定してください。例えば、次のように指定しないでください。

パラメタファイルAの指定

job_folder=¥folder1¥folder2¥folder3

パラメタファイルBの指定

job_folder=¥folder1¥folder2

unsuspended=中断中の配布の有無

ファイル転送の中断中でも配布するかどうかを「Y」または「N」で指定します。

Y

ファイル転送の中断中でもパッケージを配布します。

N

ファイル転送の中断中の場合は、配布を中断します。

このパラメタを指定しない場合は、「N」が自動的に設定されます。

なお、このパラメタはdcminstコマンドだけで指定できます。dcminstコマンド以外で指定すると、エラーになります。

(3)　指定できる予約語

このタグで指定できる予約語は、次に示す実行するコマンドの種類によって異なります。

dcmcollコマンドで指定できる予約語

¥CY、¥CM、¥CD、¥CH、¥CN、¥CS、¥HOST、¥GROUP、¥ZDIR

dcminstコマンドで指定できる予約語

¥CY、¥CM、¥CD、¥CH、¥CN、¥CS、¥VERSION、¥HOST、¥GROUP、¥DSTID、¥PKGID

dcmsuspコマンドで指定できる予約語

¥CY、¥CM、¥CD、¥CH、¥CN、¥CS、¥HOST、¥GROUP、¥DSTID

14.19.8　JOB_CLIENT_CONTROL（クライアント制御の指定）

JOB_CLIENT_CONTROLタグでは、クライアントの制御を指定します。このタグは、dcminstコマンドでだけ使用します。ほかのコマンドでは、指定しても無視されます。

指定できるパラメタの内容、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

client_wake_up

クライアントの起動の有無

/WWU

client_shutdown

クライアントのシャットダウンの有無

/WUS

(1)　形式

JOB_CLIENT_CONTROL {
client_wake_up=クライアントの起動の有無
client_shutdown=クライアントのシャットダウンの有無
}

(2)　説明

client_wake_up=クライアントの起動の有無

クライアントを起動するかどうかを「Y」または「N」で指定します。

Y

クライアントを起動します。

N

クライアントを起動しません。

このパラメタを指定しない場合は、「N」が自動的に設定されます。

client_shutdown=クライアントのシャットダウンの有無

クライアントをシャットダウンするかどうかを「Y」または「N」で指定します。

Y

クライアントをシャットダウンします。

N

クライアントをシャットダウンしません。

このパラメタを指定しない場合は、「N」が自動的に設定されます。なお、UNIXエージェントの場合、このパラメタは無効です。

14.19.9　JOB_DESTINATION（あて先の指定）

JOB_DESTINATIONタグでは、ジョブのあて先を指定します。このタグは、dcmcollコマンド、dcminstコマンド、およびdcmsuspコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

group

あて先グループ名

/g あて先グループ名

host_name

ホスト名

/h ホスト名

(1)　形式

JOB_DESTINATION{
group=あて先グループ名
host_name=ホスト名
}

(2)　説明

group=あて先グループ名

配布管理システムで定義されたあて先グループ名を、ルートからのパスで指定します。あて先グループ名の指定例を次に示します。

group=¥group1¥group2¥group

複数のあて先グループ名を指定する場合は、あて先グループ名を「;」で区切ってください。「group=」を複数行記述して、複数のあて先グループ名を指定することもできます。groupには、host_nameとの合計で200個まであて先グループを指定できます。

host_name=ホスト名

配布管理システムで定義された管理対象のコンピュータのホスト名を指定します。あて先を対象のコンピュータまでの経路で指定するか、ホスト名ではなくホスト識別子を指定してください。

あて先を対象のコンピュータまでの経路で指定する場合は、次に示すように「¥」で始め、中継システムおよび管理用中継サーバを「¥」で区切って指定してください。

host_name=¥Submanager1¥host1

また、あて先として中継システムおよび管理用中継サーバを指定するジョブで、あて先の経路を指定する場合は、次に示すように経路とあて先の両方に中継システムおよび管理用中継サーバの名称を指定してください。

host_name=¥Submanager1¥Submanager1

複数のホストを指定する場合は、ホスト名を「;」で区切って指定してください。「host_name=」を複数行記述して、複数のホスト名を指定することもできます。host_nameには、groupとの合計で200個までホストを指定できます。

なお、コンピュータをIPアドレスで管理している場合は、IPアドレスを指定してください。

(3)　注意事項

JOB_DESTINATIONタグは、JOB_DESTINATION_IDタグと同時に指定できません。コマンドの引数で指定する場合も、/hおよび/gは、/Xと同時に指定できません。

運用キーをホスト名にしている場合、次のときは、host_nameパラメタを使用できません。

JP1/IT Desktop Management 2 - Managerのセットアップの［アドレス解決の設定］パネル、またはエージェント設定の［中継システムの設定］−［運用キーの設定］で、アドレス解決の方法を「Windowsネットワークを使用する」に設定しているが、アドレス解決に失敗する。

JP1/IT Desktop Management 2 - Managerのセットアップの［アドレス解決の設定］パネル、またはエージェント設定の［中継システムの設定］−［運用キーの設定］で、アドレス解決の方法を「JP1/IT Desktop Management 2のシステム構成を使用する」に設定している。

14.19.10　JOB_DESTINATION_ID（IDの指定）

JOB_DESTINATION_IDタグでは、ジョブのあて先としてID名を指定します。このタグは、dcmcollコマンド、dcminstコマンド、およびdcmsuspコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

destination_id

ID名

/X ID名

(1)　形式

JOB_DESTINATION_ID{
destination_id=ID名
}

(2)　説明

destination_id=ID名

作成済みのID名を指定します。ID管理元中継を指定して、IDジョブを実行する中継システムおよび管理用中継サーバを限定することもできます。ID管理元中継を指定する場合は、「¥」で始めてください。ID名は、「¥」で始め、ID名の前には「%」を付けてください。

なお、ID管理元中継を指定しない場合は、IDに登録されたすべてのID管理元中継でジョブが実行されます。

ID名の指定例を次に示します。

destination_id=¥dmp202¥%ID0001

なお、ID管理元中継名は、各ID管理元中継の運用キーに従って指定してください。

複数のIDを指定する場合は、ID名を「;」で区切って指定してください。「destination_id=」を複数行記述して、複数のIDを指定することもできます。IDは200個まで指定できます。

(3)　注意事項

JOB_DESTINATION_IDタグは、JOB_DESTINATIONタグと同時に指定できません。コマンドの引数で指定する場合も、/Xは、/hおよび/gと同時に指定できません。

dcmcollコマンドおよびdcmsuspコマンドでパラメタファイルを使用する場合、ID管理元中継は指定できません。ID管理元中継を指定してこれらのコマンドを実行した場合、エラーになります。

ID管理元中継を指定する場合、あて先の長さはID名を含めて256バイト以内にしてください。

存在しない中継システムおよび管理用中継サーバを指定してコマンドを実行した場合、ジョブは作成されますが、実行されません。

dcmcollコマンドおよびdcmsuspコマンドでは、destination_idパラメタに指定されたIDをあて先グループとして扱い、IDに登録されているあて先に対して通常のジョブが作成されます。

14.19.11　JOB_SCHEDULE（ジョブのスケジュールの指定）

JOB_SCHEDULEタグでは、ジョブの登録日時、実行日時、および実行期限のスケジュールを指定します。このタグは、dcmcollコマンド、dcminstコマンド、dcmjexeコマンド、およびdcmsuspコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

job_entry_date

ジョブの登録日時

/jst 値

job_execution_date

ジョブの実行日時

/jsx 値

job_expiration_date

ジョブの実行期限

/jsp 値

(1)　形式

JOB_SCHEDULE{
job_entry_date=ジョブの登録日時
job_execution_date=ジョブの実行日時
job_expiration_date=ジョブの実行期限
}

(2)　説明

job_entry_date=ジョブの登録日時

ジョブの登録日時を「YYMMDDhh:mm」の形式で指定します。

YY ：西暦年の下2けた（00〜36、70〜99）

MM ：月（01〜12）

DD ：日（01〜31）

hh ：時（00〜23）

mm ：分（00〜59）

このパラメタを省略するとジョブの登録日時はコマンド実行時の日時になります。

job_execution_date=ジョブの実行日時

ジョブの実行日時を「YYMMDDhh:mm」の形式で指定します。

ジョブの実行日時の値はjob_entry_dateと同じ形式です。

省略した場合、ジョブが即時実行されます。なお、このパラメタを省略できるのは、job_entry_dateおよびjob_expiration_dateの両方を省略した場合だけです。

job_expiration_date=ジョブの実行期限

ジョブの実行期限を「YYMMDDhh:mm」の形式で指定します。

ジョブの実行期限の値はjob_entry_dateと同じ形式です。

省略した場合、ジョブの実行期限は無期限になります。

(3)　注意事項

job_execution_date、job_entry_date、job_expiration_dateの指定値は次の条件を満たさない場合、エラーになります。

ジョブの登録日時、実行日時、または実行期限を指定した場合、サーバでジョブ定義が保存されます。保存されたジョブ定義をジョブが作成される前（指定した登録日時以前）に削除するとジョブを作成できなくなります。

ジョブの登録日時、実行日時、または実行期限を指定した場合、存在しないあて先、あて先グループ、またはIDを指定してもコマンドは正常終了しますが、ジョブは実行されません。

西暦年の下2けたの指定は次の意味になります。

70〜99：1900年代

00〜36：2000年代

14.19.12　JOB_SPLIT_DELIVERY（パッケージの分割配布の指定）

JOB_SPLIT_DELIVERYタグでは、パッケージの分割配布を指定します。このタグは、dcminstコマンドだけで使用します。ほかのコマンドでは、指定しても無視されます。

指定できるパラメタの内容、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

split_size

分割サイズ

/sds 値

wait_time

転送休止時間

/sdt 値

(1)　形式

JOB_SPLIT_DELIVERY {
split_size=分割サイズ
wait_time=転送休止時間
}

(2)　説明

split_size=分割サイズ

パッケージの分割サイズを1〜2,097,151の範囲で指定します。単位はキロバイトです。このパラメタを省略した場合は、1,024キロバイトが設定されます。

wait_time=転送休止時間

分割配布の転送休止時間を1〜1,440の範囲で指定します。単位は分です。このパラメタを省略した場合は、60分が設定されます。

split_sizeまたはwait_timeのどちらかを指定した場合、分割配布が行われます。分割サイズおよび転送休止時間は、転送先のセットアップで設定されている値と比較して次のように決定されます。

分割サイズは転送先のセットアップで設定されている値とsplit_sizeで設定した値を比較して、小さい方のサイズで分割されます。

転送休止時間は、小さい値の分割サイズが指定された側の転送休止時間が有効になります。分割サイズが同じ場合は、転送先の転送休止時間が有効になります。

14.19.13　OPTION（オプションの指定）

OPTIONタグでは、リモートインストール時のオプションを指定します。このタグは、dcmcollコマンドおよびdcmpackコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

compress

圧縮の有無

/uYまたは/uN

compress_type

圧縮方法

/ctNまたは/ctH

restore

バージョンアップ時のリストア対象の有無

/RYまたは/RN

reboot

インストール後のコンピュータ再起動

/reboot

processing_dialog

インストール時の処理中ダイアログの表示

/procS、/procY、または/procN

(1)　形式

OPTION{
compress=圧縮の有無
compress_type=圧縮方法
restore=バージョンアップ時リストア対象の有無
reboot=インストール後のコンピュータ再起動
processing_dialog=インストール時の処理中ダイアログの表示
}

(2)　説明

compress=圧縮の有無

dcmpackコマンドで使用する場合はソフトウェアを圧縮してパッケージングするかどうか、またdcmcollコマンドで使用する場合はファイルを圧縮して収集するかどうかを「Y」または「N」で指定します。

コマンドの引数で指定する場合は、「/u」の直後に「Y」または「N」を指定します。このパラメタを指定しない場合は、「N」（圧縮しない）が自動的に設定されます。

Y

パッケージング時またはファイル収集時に、パッケージまたはファイルを圧縮します。

圧縮されたパッケージは、リモートインストール時に自動的に伸長されます。パッケージを圧縮するとファイル転送は速くなります。また、キャビネット上でパッケージを保管するための容量を節約できます。ただし、パッケージング時やリモートインストール時に、圧縮・伸長処理のための時間が掛かります。

N

パッケージング時またはファイル収集時に、パッケージまたはファイルを圧縮しません。

compress_type=圧縮方法

dcmpackコマンドの場合、圧縮方法を「H」（Windows専用）または「N」（UNIX共用）で指定します。dcmcollコマンドでは指定できません。

コマンドの引数で指定する場合は、「/ct」の直後に「N」または「H」を指定します。このパラメタを指定しない場合は「H」（Windows専用）が自動的に設定されます。

H

Windows専用でファイルを圧縮します。UNIX共用よりもパッケージ容量を削減して圧縮できます。Windowsのコンピュータに配布するとき使用します。UNIXのコンピュータには配布できません。

N

UNIX共用でファイルを圧縮します。UNIXのコンピュータにも配布できます。

restore=バージョンアップ時リストア対象の有無

バージョンアップ時にリストア対象とするかどうかを「Y」または「N」で指定します。dcmcollコマンドでは指定できません。

コマンドの引数で指定する場合は、「/R」の直後に「Y」または「N」を指定します。このパラメタを指定しない場合は、「N」（リストア対象としない）が自動的に設定されます。

Y

バージョンアップ時にリストア対象とします。ソフトウェアのバージョンアップ時に、リモートインストール先にある前バージョンのバックアップが取得されます。そして、リモートインストールが失敗したときには、バックアップを基に前バージョンのソフトウェアが復元されます。

N

バージョンアップ時にリストア対象としません。

reboot=インストール後のコンピュータ再起動

パッケージのインストール後にエージェントを自動的に再起動させるかどうかを、「Y」または「N」で指定します。dcmcollコマンドでは指定できません。このパラメタを指定しない場合は、「N」（再起動させない）が自動的に設定されます

Y

パッケージのインストール後に、エージェントで再起動の確認ダイアログボックスが表示されます。エージェントで［OK］ボタンをクリックすると、再起動が開始されます。

N

パッケージのインストール後に、エージェントを再起動させません。

コマンドの引数で指定する場合、再起動させる場合は「/reboot」を指定し、再起動させない場合は省略します。

自動的に再起動できるコンピュータは、エージェントだけです。中継システムおよび管理用中継サーバでは、インストールしたパッケージに再起動が指定されていても自動的には再起動できません。

コンピュータを自動的に再起動させる場合の注意事項と、自動的な再起動ができない場合については、「7.2.9　［オプション］パネル」を参照してください。

processing_dialog=インストール時の処理中ダイアログの表示

パッケージのインストール時にエージェントで処理中ダイアログを表示させるかどうかを、「SETUP」、「Y」、または「N」で指定します。対象となるのは、ダウンロード中ダイアログとインストール中ダイアログです。dcmcollコマンドでは指定できません。

コマンドの引数で指定する場合は、「/proc」の直後に「S」、「Y」、または「N」を指定します。このパラメタを指定しない場合は、「SETUP」（エージェントの設定に従う）が自動的に設定されます（コマンドの引数の場合は「/procS」）。

SETUP

エージェント設定の［ジョブの設定］−［ジョブの処理中ダイアログの表示設定］に設定した内容に従って、処理中ダイアログの動作を決定します。ダウンロード中ダイアログとインストール中ダイアログで設定が異なる場合も、［ジョブの処理中ダイアログの表示設定］どおり表示します。

Y

エージェント設定の［ジョブの設定］−［ジョブの処理中ダイアログの表示設定］に設定した内容に関係なく、ダウンロード中ダイアログとインストール中ダイアログを表示します。

N

エージェント設定の［ジョブの設定］−［ジョブの処理中ダイアログの表示設定］に設定した内容に関係なく、ダウンロード中ダイアログとインストール中ダイアログを非表示にします。

「processing_dialog」パラメタと［ジョブの処理中ダイアログの表示設定］をそれぞれ設定したときの、処理中ダイアログ表示の有無を次の表に示します。

［ジョブの処理中ダイアログの表示設定］

パッケージの「processing_dialog」パラメタの設定

SETUP

Y

N

表示する

○

○

−

表示しない

−

○

−

（凡例）　○：対象ダイアログを表示する　−：対象ダイアログを表示しない

なお、パッケージに処理中ダイアログの表示を指定した場合、インストール中ダイアログを最前面表示するかどうかは［ジョブの処理中ダイアログの表示設定］に従います。

14.19.14　PACKAGING_INFORMATION（パッケージ属性情報の設定）

PACKAGING_INFORMATIONタグでは、パッケージを識別するための情報を設定します。このタグは、dcminstコマンド、dcmpackコマンド、dcmpkgetコマンド、およびdcmpkrmコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

package_name

パッケージ名

/p パッケージ名

package_id

パッケージ識別ID

/I パッケージ識別ID

version_revision

バージョン/リビジョン

/v バージョン/リビジョン

generation

世代番号

/G 世代番号

cabinet_name

キャビネット名

/c キャビネット名

cabinet_id

キャビネット識別ID

/C キャビネット識別ID

package_code

コード種別

/KWまたは/KP

(1)　形式

PACKAGING_INFORMATION{
package_name=パッケージ名
package_id=パッケージ識別ID
version_revision=バージョン/リビジョン
generation=世代番号
cabinet_name=キャビネット名
cabinet_id=キャビネット識別ID
package_code=コード種別
}

(2)　説明

package_name=パッケージ名

パッケージングするユーザプログラム、データの名前を設定します。半角50文字（全角で25文字）までのパッケージ名が設定できます。「¥」およびスペースは使用できません。

package_id=パッケージ識別ID

パッケージごとのユニークなIDを付けます。JP1/IT Desktop Management 2は、このIDを基にパッケージを識別します。IDは1〜44文字で指定してください。半角英数字（英字は大文字だけ）、「-」（ハイフン）、および「_」（アンダーバー）が使用できます。

version_revision=バージョン/リビジョン

パッケージのバージョン・リビジョンを設定します。6けたまで設定でき、半角英数字（英字は大文字だけ）および「/」（スラッシュ）が使用できます。また、「¥増分値［:開始値］」を指定すると、dcmpackコマンド実行時に自動的にカウントアップさせることができます。この場合、「¥増分値」の直前に任意の半角英数字を指定できます。ただし、「¥増分値」部分にセットされる数字とのけた数の合計が6けたを超えないよう注意してください。

自動カウントアップの運用では、開始値からスタートして、登録に成功するまで（すでに登録されているパッケージとバージョン/リビジョンの数値が重ならなくなるまで）増分値ずつ加算されます。開始値を省略した場合は0からスタートします。値が6けたを超えるとエラーとなります。

パラメタファイルで自動カウントアップを指定した場合は、dcmpackコマンドでパッケージングを実行するたびに、「:」直後に次回開始値（登録した値＋増分値）が上書きされます。開始値が6けたを超えると0にリセットされます。コマンドの引数で自動カウントアップを指定した場合は、開始値は毎回初期値にリセットされます。

generation=世代番号

バージョン/リビジョンのほかに、世代番号を付けられます。世代番号によって、同一のバージョン/リビジョンを区分できます。

世代番号は、4けたまでの半角英数字（英字は大文字だけ）で設定してください。また、「¥増分値［:開始値］」を指定すると、dcmpackコマンド実行時に自動的にカウントアップさせることができます。この場合、「¥増分値」の直前に任意の半角英数字を指定できます。ただし、「¥増分値」部分にセットされる数字とのけた数の合計が4けたを超えないよう注意してください。

自動カウントアップの運用では、開始値からスタートして、登録に成功するまで（すでに登録されているパッケージと世代番号の数値が重ならなくなるまで）増分値ずつ加算されます。開始値を省略した場合は0からスタートします。値が4けたを超えるとエラーとなります。

パラメタファイルで自動カウントアップを指定した場合は、dcmpackコマンドでパッケージングを実行するたびに、「:」直後に次回開始値（登録した値＋増分値）が上書きされます。開始値が4けたを超えると0にリセットされます。コマンドの引数で自動カウントアップを指定した場合は、開始値は毎回初期値にリセットされます。

なお、UNIXのコンピュータへ配布するパッケージの場合は、必ず4けたの値を指定してください。4けたで指定しないと、パッケージングは成功しますが、リモートインストール時にエラーとなります。

cabinet_name=キャビネット名

キャビネット名をユニークに設定します。半角32文字（全角で16文字）までのキャビネット名が設定できます。「¥」、「/」、「*」、「"」、「:」、「;」およびスペースは使用できません。

cabinet_id=キャビネット識別ID

キャビネットごとにユニークなIDを、2文字の半角英数字（英字は大文字だけ）で指定します。

package_code=コード種別

リモートインストールするパッケージの種別を「P」（Windows用）または「W」（UNIX用）で指定します。コマンドの引数で指定する場合は、「/K」の直後に「P」または「W」を指定します。

dcminstコマンド実行時にこのパラメタを省略すると、「P」（Windows用）が仮定されますが、UNIXのコンピュータにもリモートインストールできます。なお、UNIX版JP1/IT Desktop Management 2 - Agentで作成したパッケージをリモートインストールする場合は、「W」（UNIX用）を指定する必要があります。dcmpkgetコマンド実行時にこのパラメタを省略すると、「P」（Windows用）が仮定されます。dcmpkrmコマンドでは必ず指定します。dcmpackコマンドでは指定しても無効になります。

P

Windows用のパッケージです。

W

UNIX用のパッケージです。

(3)　指定できる予約語

このタグでは、予約語として¥CY、¥CM、¥CD、¥CH、¥CN、¥CS、¥BY、¥BM、¥BD、¥BH、¥BN、¥BS、¥VERSION、¥PKGID、¥FILE、¥SIZE、¥BASEが使用できます。ただし次の制限があります。

予約語が使用できるのは、このタグまたは引数をdcmpackコマンドで使用する場合だけです。dcminstコマンド、dcmpkgetコマンド、およびdcmpkrmコマンドでは、予約語は使用できません。

package_id（/I）に¥VERSIONおよび¥PKGIDは使用できません。

version_revision（/v）に¥VERSIONは使用できません。

version_revision（/v）およびgeneration（/G）に「¥増分値」と予約語とを同時に指定することはできません。

(4)　注意事項

dcminstコマンドおよびdcmpkgetコマンドで複数のパッケージを指定する場合、1つのPACKAGING_INFORMATIONタグ内に複数のパッケージのパラメタを指定できます。パッケージ情報ごとに括弧（{　}）で囲んで指定してください。PACKAGING_INFORMATIONタグに複数のパッケージを指定する例を次に示します。

PACKAGING_INFORMATION{
{*パッケージ1の情報
package_name=PACKAGE1
package_id=PACK01
       :
}
{*パッケージ2の情報
package_name=PACKAGE2
package_id=PACK02
       :
}
}

パッケージ条件で等符号に「<」「<=」「>」「>=」を指定して比較するパッケージで、自動カウントアップ運用とする場合、パラメタの開始値を次のように設定してください。

バージョン/リビジョン

100,000以上を指定する（有効けた数が6けたとなるように指定）。

世代番号

1,000以上を指定する（有効けた数が4けたとなるように指定）。

14.19.15　PACKAGING_SOURCE（パッケージングするファイルの指定）

PACKAGING_SOURCEタグでは、パッケージングするファイルまたはディレクトリを指定します。このタグは、dcmpackコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

file_path

パッケージ対象ファイル名

/P パッケージ対象ファイル名

base_fullpath

パッケージ基準ディレクトリパス

/B パッケージ基準ディレクトリパス

(1)　形式

PACKAGING_SOURCE{
file_path=パッケージ対象ファイル名
base_fullpath=パッケージ基準ディレクトリパス
}

(2)　説明

file_path=パッケージ対象ファイル名

パッケージングするファイルまたはディレクトリを、base_fullpathで指定したディレクトリからの相対パスで指定します。ただし、UNIXのコンピュータに配布するパッケージの場合は、階層の区切り文字には「¥」ではなく「/」を使用してください。パッケージのインストール時は、JP1/IT Desktop Management 2 - Agentのインストール先ディレクトリ下にbase_fullpathからのディレクトリ構造が復元されます。

同一ディレクトリ（ルートディレクトリも含む）下の複数のファイル、またはサブディレクトリを指定する場合は各パスを「;」で区切るか、file_pathを複数記述してください。

指定値にスペースを含めることもできますが、「;」の前後にスペースを指定するとリターンコード「2」のエラーとなります。また、指定値を「"」で囲って指定しないでください。ただし、コマンドの引数で指定する場合は、スペースを含む指定値は「"」で囲んでください。

file_pathを指定しない場合は、base_fullpathに指定されたパス以下のファイルがすべてパッケージングされます。base_fullpathにファイルが指定されている場合は、指定されたファイルだけがパッケージングされます。

base_fullpath=パッケージ基準ディレクトリパス

パッケージングするファイルまたはディレクトリの基準となるディレクトリのフルパスを指定してください。

ドライブを指定する場合は、コロン（:）までを指定してください。例えば、AドライブのDVD-Rの内容をすべてパッケージングするには、

　base_fullpath = A:

と記述してください。

　base_fullpath = A:¥

と記述するとエラーとなります。

14.19.16　SCHEDULE（リモートインストールのスケジュール指定）

SCHEDULEタグでは、リモートインストールのスケジュールなどを指定します。このタグは、dcmcollコマンドおよびdcmpackコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

expiration_date

中継でのパッケージ保管期限

/x 中継でのパッケージ保管期限

expiration_days

中継でのパッケージ保管日数

/ed中継でのパッケージ保管日数

installation_date_and_time

インストール日時

/d インストール日時

installation_timing

実行タイミング

/tSまたは/tN

(1)　形式

SCHEDULE{
expiration_date=中継でのパッケージ保管期限
expiration_days=中継でのパッケージ保管日数
installation_date_and_time=インストール日時
installation_timing=実行タイミング
}

(2)　説明

expiration_date=中継でのパッケージ保管期限

パッケージを中継システムおよび管理用中継サーバで保管する期限を「YYMMDD」の形式で指定します。

YY ：西暦年の下2けた（00〜35）

MM ：月（01〜12）

DD ：日（01〜31）

ここで指定した期限に達すると、中継システムおよび管理用中継サーバで保管中のパッケージは自動的に削除されます。保管期限を過ぎたパッケージや当日期限のパッケージを配布すると、翌日削除されます。

実際の運用では、中継システムおよび管理用中継サーバ下のすべてのコンピュータでインストールが完了するまで、パッケージを保管しておく必要があります。例えば、パッケージの配布とインストールに3週間必要であれば、3週間目以降の日を指定します。

このパラメタを省略すると、パッケージング時の日付にパッケージャで指定された「中継でのパッケージ保管日数」の日数を加算した日付が設定されます。

(例)

条件1　パッケージング時の日付：2001年8月22日

条件2　「中継でのパッケージ保管日数」の設定：10日

この場合にパラメタに設定される値：2001年9月1日

なお、パッケージャで値を指定していない場合は、90日後の日付が設定されます。

expiration_days=中継でのパッケージ保管日数

保管日数を数値で指定します。指定できる範囲は、1〜32,000です。指定した値が変換後に2035年12月31日以降になる場合、一律2035年12月31日に設定されます。

expiration_dateと同時に指定した場合は、expiration_dateが優先されexpiration_daysの指定は無視されます。

expiration_dateおよびexpiration_daysの指定がない場合、パッケージャのデフォルトとして設定された日数になります。パッケージャにデフォルトが指定されていない場合は、90日後が設定されます。

指定できる範囲外の数値が指定された場合は、「コマンド入力値不正」のエラーとなり、イベントビューアにメッセージが出力されます。

installation_date_and_time=インストール日時

パッケージをリモートインストールする日時を「YYMMDDhh:mm」の形式で指定します。

YY ：西暦年の下2けた（00〜35）

MM ：月（01〜12）

DD ：日（01〜31）

hh ：時（00〜23）

mm ：分（00〜59）

installation_timing=実行タイミング

dcmcollコマンドで使用する場合はファイルを収集するタイミングを、dcmpackコマンドで使用する場合はパッケージをインストールするタイミングを、「S」（システム起動時）または「N」（システム稼働中）で指定します。コマンドの引数で指定する場合は、「/t」の直後に「S」または「N」を指定します。デフォルトは、「N」（システム稼働中）です。

S（システム起動時）

エージェントのシステム起動時に、収集またはインストールされます。インストール日時を指定している場合は、指定した日時以降の最初のシステム起動時にパッケージがインストールされます。

N（システム稼働中）

エージェントのシステム稼働中に、収集またはインストールされます。インストール日時を指定している場合は、指定した日時にパッケージがインストールされます。ただし、指定した日時にコンピュータが起動していないときは、次回のシステム起動時にインストールされます。

14.19.17　SOFTWARE_CONDITIONS（パッケージ条件の指定）

SOFTWARE_CONDITIONSタグでは、リモートインストールの前提とするパッケージの条件を指定します。このタグは、dcmpackコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

condition

パッケージ条件

/l パッケージ条件

(1)　形式

SOFTWARE_CONDITIONS{
condition=パッケージ条件
}

(2)　説明

condition=パッケージ条件

リモートインストールの前提とするパッケージの条件を、次の形式で指定します。

パッケージ識別ID 等符号 比較バージョン/リビジョン:比較世代番号

パッケージ識別ID

リモートインストールの前提とするパッケージ識別IDを指定します。パッケージ識別IDは、PACKAGING_INFORMATIONタグのpackage_idで指定されたIDを指定してください。

等符号

「=」「>」「>=」「<」「<=」「<>」の中から指定してください。

比較バージョン/リビジョン

比較対象となるバージョン/リビジョンを8けたまでの数字で指定します。

比較世代番号

比較対象となる世代番号を4けたまでの数字で指定します。

(3)　注意事項

UNIXのコンピュータへ配布するパッケージの場合、このタグは指定できません。

パッケージ条件は複数指定できます。複数指定した場合は論理和（OR）の条件となります。1個以上の条件を満たした場合にインストールが実行されます。

パッケージ条件をコマンドの引数（/l）で指定する場合は、システム条件（/O）と合わせて10個まで指定できます。

パッケージ条件で指定する条件の比較は、先頭からの文字比較となります。

また、指定できる文字の大小関係は、半角英字（A〜Z）>半角数字（0〜9）>「/」（スラッシュ）>「△」（半角スペース）となります。

そのため、等符号に「<」「<=」「>」「>=」を指定して比較バージョン/リビジョン、比較世代番号を指定する場合は、比較対象のソフトウェアのバージョン/リビジョンおよび世代番号を同じけた数で指定してください。例えば、バージョン/リビジョンが「0300」、世代番号が「0000」のソフトウェア「PROGRAM」がインストールされている環境に対しては、「PROGRAM>2:0」と指定しないで、「PROGRAM>0200:0000」となるようにけた数をそろえて指定してください。

(4)　指定例

condition=P-2412-3554>0500:0000

バージョンが「05-00」、世代番号が「0000」より大きいバージョンのパッケージ識別IDがP-2412-3554であるソフトウェアがインストールされている場合にインストールを実行します。

condition=P-2412-3554<>0510:0000

バージョンが「05-10」、世代番号が「0000」と異なるバージョンのパッケージ識別IDがP-2412-3554であるソフトウェアがインストールされている場合にインストールを実行します。

14.19.18　INSTALLSOFTWARE_CONDITIONS（ソフトウェア条件の指定）

INSTALLSOFTWARE_CONDITIONSタグでは、リモートインストールの前提とするソフトウェアまたは更新プログラムの条件を指定します。このタグは、dcmpackコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

condition

ソフトウェア条件

−

（凡例）　−：コマンドの引数では指定できない

(1)　形式

INSTALLSOFTWARE_CONDITIONS{
condition=ソフトウェア条件
}

(2)　説明

condition=ソフトウェア条件

前提とするソフトウェアまたは更新プログラムの条件を指定します。ソフトウェア条件は複数指定できます。複数指定すると、どれか1つ以上の条件を満たす場合にインストールされます。

条件

前提とするソフトウェアまたは更新プログラムのインストール状況を、「Y」（インストール済）または「N」（未インストール）で指定します。

種別

ソフトウェアと更新プログラムのどちらを前提とするかを、「S」（ソフトウェア）または「U」（更新プログラム）で指定します。

ソフトウェア名

前提とするソフトウェアまたは更新プログラムの名称を、角括弧（[ ]）で囲んで指定します。名称に「]」が含まれている場合は、「]」を「]]」と指定してください。

（例）ソフトウェア名がSoft[sample]abcの場合の指定方法

[Soft[sample]]abc]

等符号

「=」「>」「>=」「<」「<=」「<>」のうち、条件に合うものを指定します。

バージョン

比較対象となるバージョンを指定します。条件が「N」（未インストール）の場合、および種別が「U」（更新プログラム）の場合は、指定しても無視されます。

(3)　注意事項

UNIXのコンピュータへ配布するパッケージの場合、このタグは指定できません。

種別が種別が「U」（更新プログラム）の場合、「等符号」を指定できません。

14.19.19　SYSTEM_CONDITIONS（システム条件の指定）

SYSTEM_CONDITIONSタグでは、リモートインストール時のインストール先ディレクトリ、およびインストールの前提となるコンピュータのシステム条件を指定します。このタグは、dcmpackコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

directory

インストール先ディレクトリ

/D インストール先ディレクトリ

condition

システム条件

/O システム条件

(1)　形式

SYSTEM_CONDITIONS{
directory=インストール先ディレクトリ
condition=システム条件
}

(2)　説明

directory=インストール先ディレクトリ

インストール先ディレクトリのパスを指定します。なお、「"」を含むパスは指定できません。指定例を次に示します。

（例1）配布先がWindowsの場合

directory=C:¥temp¥data

（例2）配布先がUNIXの場合

directory=/temp/data

省略すると、パッケージ基準ディレクトリパス（PACKAGING_SOURCEタグのbase_fullpath、またはコマンドの引数/Bで設定されたディレクトリ）が仮定されます。

condition=システム条件

配布先のコンピュータのシステム条件を指定します。配布先がWindowsの場合に指定できます。システム条件の指定方法を条件ごとに(3)、(4)に示します。

(3)　ハードディスクの空き容量を条件にする場合

ハードディスクの空き容量を条件にする場合のシステム条件の指定方法を次に示します。

condition= H:ドライブ名 等符号 容量

ドライブ名

ドライブを表す半角英数字1文字を指定します。

等符号

「>=」を指定します。

容量

メガバイト単位で、0〜32,767の値を指定してください。

指定例

「Cドライブに1ギガバイト以上の空き容量がある場合」という条件は次のように指定します。

condition=H:C>= 1024

(4)　実メモリを条件にする場合

実メモリを条件にする場合の、システム条件の指定方法を次に示します。

condition= 容量種別 等符号 容量

容量種別

R：実メモリ容量

等符号

「=」「>」「>=」「<」「<=」のうち、条件に合うものを指定します。

容量

メガバイト単位で指定してください。

指定例

「実メモリ容量が16メガバイト以上の場合」という条件は次のように指定します。

condition=R>=16

(5)　OSバージョンを条件にする場合

OSバージョンを条件にする場合のシステム条件の指定方法を次に示します。

condition= O 等符号OS

等符号

「=」「>」「>=」「<」「<=」のうち、条件に合うものを指定します。

OS

「WindowsServer2019」「WindowsServer2016」「Windows10」「Windows8.1」「Windows8」「WindowsServer2012」「WindowsServer2012R2」「Windows7」「WindowsServer2008」「WindowsServer2008R2」「WindowsVista」「WindowsServer2003」「WindowsXP」のうち、条件に合うものを指定します。「Any」は「すべてのWindows」を意味します。

指定例

「OSがWindows 7の場合」という条件は次のように指定します。

condition=O=Windows7

(6)　注意事項

UNIX用のパッケージを作成する場合は、次の点に注意してください。

システム条件は指定できません。ディレクトリの指定は有効になりますが、ドライブは指定しても無視されます。

インストール先ディレクトリは、半角64文字を超えない範囲で指定してください（ドライブ名および「:」を含む）。半角64文字を超えた場合、配布したパッケージはルートディレクトリの直下にインストールされます。

システム条件は複数指定できます。複数指定した場合は論理積（AND）の条件となります。すべての条件を満たした場合にインストールが実行されます。

システム条件をコマンドの引数（/O）で指定する場合は、パッケージ条件（/l）と合わせて10個まで指定できます。

14.19.20　USER_PROGRAM_INSTALLATION_CONDITIONS（外部プログラムの指定）

USER_PROGRAM_INSTALLATION_CONDITIONSタグでは、インストール前後およびインストールエラー時に管理対象のコンピュータで起動させる外部プログラムを指定します。このタグは、dcmcollコマンド、dcmpackコマンド、およびdcmstswコマンドで使用します。

指定できるパラメタ、およびコマンドの引数との対応を次の表に示します。

パラメタ

内容

コマンドの引数

external_program_executed_before_installation※1

インストール前起動外部プログラム

/b インストール前起動外部プログラム

external_program_executed_after_installation

インストール後起動外部プログラム

/a インストール後起動外部プログラム

external_program_error_handler※2

インストールエラー時起動外部プログラム

/e インストールエラー時起動外部プログラム

external_program_handler

起動外部プログラム

/ep 起動外部プログラム

exit※2

外部プログラム処理結果の通知方式

/rbR、/rbM、/raR、/raM、/reR、/reM

action※2

処理結果エラー時の取り扱い

/ybC、/ybS、/yaC、/yaS

wait※2

監視方式

/wbU、/wbT、/wbG、/waU、/waT、/waG、/weU、/weY

timeout

監視時間

最大実行期間（dcmstswコマンドの場合）

/n 監視時間

/wt 最大実行期間（dcmstswコマンドの場合）

wait_code

監視コード

/wc 監視コード

注※1

UNIXのコンピュータへ配布するパッケージの場合、SCHEDULEタグのinstallation_date_and_timeパラメタと同時に指定すると、このパラメタは無視されます。

注※2

UNIXのコンピュータへ配布するパッケージの場合、パラメタを指定しても無視されます。

起動する外部プログラムには、GUIを持たないプログラムを指定してください。GUIを持つプログラムを起動しても、GUIは表示されません。

また、外部プログラムには16bitのアプリケーションを指定しないでください。Windowsのコンピュータに対して、外部プログラムに16bitアプリケーションを指定したバックグラウンドインストールモードのパッケージをリモートインストールすると、コンピュータがハングアップします。

(1)　形式

USER_PROGRAM_INSTALLATION_CONDITIONS{
{
external_program_executed_before_installation=
インストール前起動外部プログラム
exit=外部プログラム処理結果の通知方式
action=処理結果エラー時の取り扱い
wait=監視方式（U、T、またはG）
}
{
external_program_executed_after_installation=
インストール後起動外部プログラム
exit=外部プログラム処理結果の通知方式
action=処理結果エラー時の取り扱い
wait=監視方式（U、T、またはG）
}
{
external_program_error_handler=
インストールエラー時起動外部プログラム
exit=外部プログラム処理結果の通知方式
wait=監視方式（UまたはY）
timeout=監視時間
}
{
external_program_handler=
起動外部プログラム
timeout=最大実行期間
wait_code=監視コード
}
}

(2)　説明

external_program_executed_before_installation=インストール前起動外部プログラム

インストール（またはファイル収集）の直前に起動する外部プログラムのパスをフルパスで指定します。スペースを含むパス名を指定する場合は、値を「"」で囲んで指定してください。

外部プログラムのパスはインストールの場合は半角で256文字まで、ファイル収集の場合は半角で128文字まで指定できます。これらの文字数を超えて指定した場合は、リターンコード「2」のエラーとなります。

external_program_executed_after_installation=インストール後起動外部プログラム

インストール（またはファイル収集）の直後に起動する外部プログラムのパスをフルパスで指定します。スペースを含むパス名を指定する場合は、値を「"」で囲んで指定してください。

外部プログラムのパスはインストールの場合は半角で256文字まで、ファイル収集の場合は半角で128文字まで指定できます。これらの文字数を超えて指定した場合は、リターンコード「2」のエラーとなります。

external_program_error_handler=インストールエラー時起動外部プログラム

インストール（またはファイル収集）エラー時に起動する外部プログラムのパスをフルパスで指定します。スペースを含むパス名を指定する場合は、値を「"」で囲んで指定してください。

外部プログラムのパスはインストールの場合は半角で256文字まで、ファイル収集の場合は半角で128文字まで指定できます。これらの文字数を超えて指定した場合は、リターンコード「2」のエラーとなります。

external_program_handler=起動外部プログラム

指定した実行状況になった時に起動する外部プログラムのパスをフルパスで指定します。スペースを含むパス名を指定する場合は、値を「"」で囲んで指定してください。

外部プログラムのパスは半角で256文字まで指定できます。256文字を超えて指定した場合は、リターンコード「4」のエラーとなります。

exit=外部プログラム処理結果の通知方式

外部プログラムの処理結果の通知方式を「R」（リターンコード）または「M」（メッセージ）で指定します。コマンドの引数で指定する場合は、「/rb」（インストール前起動プログラムの場合）、「/ra」（インストール後起動プログラムの場合）、または「/re」（インストールエラー時起動プログラムの場合）の直後に「R」または「M」を指定します。

デフォルトは、INSTALLATION_METHODタグのinstallation_mode（またはコマンドの引数/m）で指定されたインストールモードによって異なります。GUIインストールモードの場合は「M」、バックグラウンドインストールモードの場合は「R」になります。

R

外部プログラムのリターンコードで通知します。

M

外部プログラムが規定のメッセージを出すことで通知します。

action=処理結果エラー時の取り扱い

外部プログラムの処理結果がエラーの場合に、インストールを続行するかどうかを「C」（続行する）または「S」（中止する）で指定します。コマンドの引数で指定する場合は、「/yb」（インストール前起動プログラムの場合）または「/ya」（インストール後起動プログラムの場合）の直後に「C」または「S」を指定します。デフォルトは「S」です。

C

エラーであっても正常と見なし、インストールを続行します。

S

インストールをエラーとし、インストール処理を中止します。

wait=監視方式

外部プログラムが処理結果を通知するまでのインストール処理の取り扱いを「U」、「T」、「G」、または「Y」で指定します。コマンドの引数で指定する場合は、「/wb」（インストール前起動プログラムの場合）、「/wa」（インストール後起動プログラムの場合）、または「/we」（インストールエラー時起動プログラムの場合）の直後に「U」、「T」、「G」、または「Y」を指定します。デフォルトは「U」です。

「T」、「G」、または「Y」を指定した場合、「監視時間」で外部プログラムの応答を監視する時間の上限値を指定してください。

U

処理結果が通知されるまでインストール処理を中断します。

T

中断時間が監視時間を経過した場合、インストールをエラーと見なし、インストール処理を中止します。

G

中断時間が監視時間を経過した場合、正常と見なし、インストール処理を続行します。

Y

中断時間が監視時間を経過した場合、インストールエラー時起動プログラムの処理を続行します。

timeout=監視時間（dcmstswコマンドの場合は最大実行期間）

dcmpackコマンドの場合

外部プログラムの応答を監視する時間の上限値を指定します。監視時間は秒単位で、0〜21,600（6時間）の範囲で指定してください。応答を監視しない場合は「0」を指定します。デフォルトは「1」です。

監視時間の指定は、「インストール直前」、「インストール直後」、「インストールエラー」で起動するすべての外部プログラムに共通の値となります。なお、「監視方式」で「U」を指定した場合は指定が無効になります。

dcmstswコマンドの場合

ジョブの実行状況を監視する最大実行期間を指定します。実行期間は秒単位で、1〜10,000,000の範囲で指定してください。デフォルトは86,400（1日）です。

wait_code=監視コード

外部プログラムを起動する契機となる、ジョブ実行状態または保守コードを指定します。複数指定する場合は間を「,」（コンマ）で区切ってください。複数指定するとOR条件で設定されます。

ジョブ実行状態を指定する場合

次の値の中から1つ以上を指定してください。デフォルトは「ERROR」です。

・NORMAL

　正常終了した。

・TRANS_WAIT

　配布管理システムで転送待ち状態。

・TRANSMITTED

　管理対象のコンピュータへ転送中または実行中。

・REGISTERED

　IDジョブをID管理元中継へ転送中。

・CLT_NOTREADY

　起動に失敗した。

・CLT_SERVICE_OFF※

　JP1/IT Desktop Management 2が停止しているため、起動に失敗した。

・CLT_POWER_OFF※

　PCの電源がオフのため、起動が失敗した。

・CLT_NETWORK_ERR※

　ネットワーク障害のため、起動が失敗した。

・SUSPENDED

　中継で中断指示があった。

・INST_WAIT

　インストール／収集待ち。

・HOLD_EXEC

　ジョブが保留された。

・ID_NOPKG

　IDジョブで中継保管パッケージが削除された。

・CONNECT_ERROR

　通信エラーが発生した。

・ERROR

　ジョブ実行エラーが発生した。

・DELETING

　中継システム、管理用中継サーバ、および管理対象のコンピュータでジョブを削除中。

注※

JP1/IT Desktop Management 2 - Managerのセットアップで、［リモートインストールマネージャを使用した配布のセットアップ］画面の［サーバカスタマイズオプション］パネルの「起動失敗要因を細分化する」チェックボックスがオンの場合に指定できます。ただし、「CLT_NOTREADY」と同時に指定しても無視されます。

なお、チェックボックスがオフの場合は、これらの実行状態を指定しても、外部プログラムを起動できません。

保守コードを指定する場合

保守コードを12けたで指定してください。ワイルドカードを使用できます。

（例）

　保守コードの左から9番目が8、10番目が2："????????82??"

(3)　注意事項

「インストール前起動外部プログラム」、「インストール後起動外部プログラム」、「インストールエラー時起動外部プログラム」、および「起動外部プログラム」はそれぞれ1つまで指定できます。

インストール前後に起動する外部プログラムを指定する場合、システム条件（SYSTEM_CONDITIONS）またはパッケージ条件（SOFTWARE_CONDITIONS）を指定したときは、exit、action、waitの指定は無効になります。

dcmcollコマンドで使用する場合は、external_program_handler、exit、action、wait、およびtimeoutの指定は無効になります。

dcmstswコマンドで使用する場合は、external_program_handler、timeout、wait_code以外の指定は無効になります。

(a)　UNIXのコンピュータで外部プログラムを起動する場合の注意事項

dcmpackコマンドで、UNIXのコンピュータへ配布するパッケージに外部プログラムの起動を設定する場合、次のことに注意してください。

Windows向けパッケージと異なり、external_program_error_handler、exit、action、およびwaitパラメタは指定できません。

external_program_executed_before_installationおよびexternal_program_executed_after_installationパラメタは、SCHEDULEタグのinstallation_date_and_timeパラメタを指定したかどうかで外部プログラムのパスの指定方法が異なります。

「<」「>」「|」「&」「$」などのシェルプログラムで特別な意味を持つ文字は使わないでください。

指定方法の違いを次の表に示します。

installation_date_and_timeの指定

起動する外部プログラムのパス指定方法

external_program_executed_before_installation

external_program_executed_after_installation

あり

指定できません。

半角40文字以内で指定してください。

スペースを含んだパスは指定できません。

後処理プログラムに引数が存在する場合は、パスと引数の全体を「"」（ダブルクォーテーション）で囲んでください。

引数がスペースを含む場合は、スペースを含む引数を「'」（シングルクォーテーション）で囲んでください。

なし

external_program_executed_before_installationだけ指定する場合、半角60文字以内で指定してください。

external_program_executed_after_installationだけ指定する場合、半角64文字以内で指定してください。

external_program_executed_before_installationとexternal_program_executed_after_installationを両方指定する場合、合わせて半角60文字以内で指定してください。

文字列（引数）の数は最大18個指定できます。

複数の連続したスペースは1個の区切り文字として扱われます。

「'」（シングルクォーテーション）は引数として扱われません。

シェル変数は文字列として扱われるため、無効になります。

応答待ちになる処理を指定しないでください。

また、dcmcollコマンドでUNIXのコンピュータに対して外部プログラムの起動を設定する場合、次のことに注意してください。

Windowsのコンピュータの場合と異なり、external_program_error_handlerパラメタは指定できません。

起動する外部プログラムのパスは、半角64文字以内で指定してください。65文字以上を指定した場合は、先頭から64文字分が有効となります。

起動する外部プログラムのパスにスペースを含めることはできません。

起動する外部プログラムに引数は指定できません。

なお、パスの指定方法が間違っていた場合、パッケージングとジョブの実行はできますが、配布先のUNIXのコンピュータで外部プログラムは起動しません。このとき、ジョブはエラーにならず、正常終了しますのでご注意ください。

14.20　予約語の指定方法

JOB_ATTRIBUTEタグ、PACKAGING_INFORMATIONタグ、およびこれに該当するコマンドの引数では、指定値として予約語を使用できます。コマンドは、予約語を実際の値に置換して処理します。

14.20.1　JP1/IT Desktop Management 2のコマンドで使用できる予約語

JP1/IT Desktop Management 2のコマンドで使用できる予約語と、置換後の値について次の表に示します。

表14‒17　JP1/IT Desktop Management 2のコマンドで使用できる予約語

予約語

置換後の値

¥CY

コマンド実行時点の西暦年の下2けた。

¥CM

コマンド実行時点の月2けた。

¥CD

コマンド実行時点の日2けた。

¥CH

コマンド実行時点の時2けた。

¥CN

コマンド実行時点の分2けた。

¥CS

コマンド実行時点の秒2けた。

¥BY

base_fullpath指定値の最終更新時刻の、西暦年の下2けた。

¥BM

base_fullpath指定値の最終更新時刻の月2けた。

¥BD

base_fullpath指定値の最終更新時刻の日2けた。

¥BH

base_fullpath指定値の最終更新時刻の時2けた。

¥BN

base_fullpath指定値の最終更新時刻の分2けた。

¥BS

base_fullpath指定値の最終更新時刻の秒2けた。

¥VERSION

PACKAGING_INFORMATIONのversion_revisionに指定された1つ目の値。

¥GROUP

JOB_DESTINATIONのgroupに指定された1つ目の値。groupが空なら無視される。置換後の文字列に「¥」が含まれる場合は、さらに「¥」を除いた文字列に置換される。

¥HOST

JOB_DESTINATIONのhost_nameに指定された1つ目の値。host_nameが空なら無視される。置換後の文字列に「.」（ピリオド）が含まれる場合は、最初の「.」以降を除いた文字列に置換される。

¥DSTID

JOB_DESTINATION_IDのdestination_idに指定された1つ目の値。destination_idが空なら無視される。

¥PKGID

PACKAGING_INFORMATIONのpackage_idに指定された1つ目の値。

¥FILE

PACKAGING_SOURCEのfile_pathの1つ目の値から、相対ディレクトリ部分および「.」（ピリオド）以降を除いたファイル名称。file_pathが空なら無視される。

¥SIZE

PACKAGING_SOURCEのfile_pathの1つ目の値のファイルサイズ。file_pathが空なら無視される。file_pathに存在しないファイルが指定されている場合はコマンドが失敗する。

¥BASE

PACKAGING_SOURCEのbase_fullpathの値から、相対ディレクトリ部分および「.」（ピリオド）以降を除いたファイル名称。

¥ZDIR

FILE_COLLECTIONのdmz_pathの値から、相対ディレクトリ部分および「.」（ピリオド）以降を除いたファイル名称。

14.20.2　予約語を使用する場合の注意事項

パラメタファイルおよびコマンドの引数に、予約語を使用する場合の注意事項を次に示します。

置換後の文字列の長さがパラメタ（または引数）として指定できる最大けた数を超えないように指定してください。パラメタの最大けた数を超えた場合は、予約語または文字列の単位で切り捨てて処理されます。

（例）

ジョブ名称として「¥PKGIDを中継システム¥HOSTまで配布」と指定した場合、置換後に、予約語以外の文字列だった部分（「を中継システム」または「まで配布」）の途中で32バイトに達した場合は、その文字列の先頭からすべて切り捨てられます。つまり、ジョブ名は、置換前に「¥PKGID」だった部分まで、または「¥HOST」だった部分までとなります。

置換後に、予約語「¥HOST」だった部分の途中で32バイトに達した場合は、「XXXXXXを中継システム」までがジョブ名称となります。

置換後の文字列が、そのパラメタ（または引数）での使用禁止文字を含まないように指定してください。

14.20.3　予約語の使用例

予約語を使用して記述したパラメタファイルの例を次に示します。

(1)　dcminstコマンドで使用するパラメタファイルの例

JOB_ATTRIBUTE{
job_generator=¥PKGID他を各部に配布
      *予約語置換後に32バイトを超えると"他"以降を切り捨てる
      *ジョブ格納フォルダに定義済みの名前の場合失敗する
job_folder=¥配布¥CM月¥CD日¥CH時
      *この例ではルートフォルダ下にフォルダ(1階層)を作成。
      *保存(/s)指定がないと実行後に新規作成の階層から削除
}
JOB_DESTINATION{
      *あて先はJOB_DESTINATIONまたはJOB_DESTINATION_IDどちらかで指定する
host_name=host1;host2;host3
host_name=host4;host5;host6
group=¥全社¥営業部;¥全社¥資材部;¥全社¥技術部
group=¥全社¥人事部
}

PACKAGING_INFORMATION{      *3個のパッケージを配布する場合の例
{
      *PACKAGING_INFORMATIONはほかのタグとは別のファイルに
      *書くことができる
      *またはdcmpackを先に実行し、その出力ファイルを指定できる
package_name=1
package_id=1
version_revision=1
generation=1
cabinet_name=CAB01
cabinet_id=01
package_code=P
}
{
package_name=2
package_id=2
version_revision=2
generation=2
cabinet_name=CAB01
cabinet_id=02
package_code=P
}
{
package_name=3
package_id=3
version_revision=3
generation=3
cabinet_name=CAB01
cabinet_id=03
package_code=P
}
}

(2)　dcmpackコマンドで使用するパラメタファイルの例

PACKAGING_SOURCE{
file_path= pack1.txt;pack2.txt;pack 3.txt;pack4.txt
base_fullpath=C:¥dir1
}
PACKAGING_INFORMATION
{
package_name=¥FILE¥SIZEbytes¥CM月¥CD日¥CH時¥CN分
package_id=¥BASE-¥BM¥BD¥BH¥BM
version_revision=V0¥10:0
generation=G¥1
cabinet_name=¥PKGID
cabinet_id=¥CD
}
INSTALLATION_METHOD{
installation_mode=G
}
USER_PROGRAM_INSTALLATION_CONDITIONS{
{
external_program_executed_before_installation="C:¥test B.exe" "-B" bbb
exit=R
action=C
wait=T
}
{
external_program_executed_after_installation=C:¥testA.exe -c "a aa"
exit=R
action=C
wait=T
}
{
external_program_error_handler="C:¥test E.txt" -c "e e"
exit=R
wait=Y
}
timeout=404
}
SYSTEM_CONDITIONS{
directory=C:¥DestDir
condition=H:c>=1000
}
OPTION{
compress=Y
restore=Y
}
FILE_PROPERTIES{
permission=N
}
SCHEDULE{
expiration_date=001231
installation_date_and_time=04020100:50
installation_timing=S
}

(3)　dcmcollコマンドで使用するパラメタファイルの例

JOB_ATTRIBUTE{
job_generator=¥ZDIRに¥HOSTから¥FILE収集
      *サーバのジョブ格納フォルダに定義済みの場合は失敗する
job_folder=¥¥GROUP¥¥CM¥¥CD¥¥CH
      *この例ではルートフォルダ下にフォルダ(4階層)を作成
      *保存/s指定がないと実行後に新規作成の階層から削除
}
JOB_DESTINATION{
host_name=dmp492.soft.hitachi.co.jp
      *JOB_ATTRIBUTE内の¥HOSTは"dmp492"に置換される
host_name=dmp491
group = ¥グループ¥grp1
      *JOB_ATTRIBUTE内の¥GROUPは"グループgrp1"に置換される
group = ¥グループ¥grp2;¥グループ¥grp3
}
SCHEDULE{
installation_timing = S
}
OPTION{
compress=Y
}
USER_PROGRAM_INSTALLATION_CONDITIONS{
      *スペースを含む文字列は必ず「"」で囲む
external_program_executed_before_installation = "C:¥test B.exe"
external_program_executed_after_installation = C:¥testA.exe -x "a aa"
external_program_error_handler = "C:¥test E.exe"
}
FILE_COLLECTION{
source_path= C:¥tmp¥SD障害.dir
      *JOB_ATTRIBUTE内の¥FILEは"SD障害"に置換される
source_path= C:¥tmp¥SD障害2.dir;C:¥tmp¥SD障害3.dir
dmz_path=  C:¥
      *JOB_ATTRIBUTE内の¥FILEは"ROOT"に置換される
}

15　トラブルシューティング

この章では、リモートインストールマネージャを使用した配布機能を使用中にトラブルが発生した場合の、トラブル情報の確認方法やトラブルへの対処方法について説明します。

15.1　トラブル発生時の対処方法

JP1/IT Desktop Management 2を使用中にトラブルが発生した場合は、次の手順で対処してください。

メッセージが表示されているかどうかを確認する。

ジョブがエラーになった場合は、［詳細情報］ダイアログボックスでエラーの内容を確認できます。「15.2　ジョブのトラブルシューティング」を参照し、対処方法に従って対処してください。

JP1/IT Desktop Management 2では、トラブルが発生した場合、ログが取得されます。ログの内容を確認し、対処してください。JP1/IT Desktop Management 2 - Managerのログの確認方法については「15.3.1　ログファイルの確認」を、JP1/IT Desktop Management 2 - Agentのログの確認方法については「15.4.1　ログファイルの確認」を参照してください。

「正常に動作しないときの対処」に挙げられている事象に当てはまるかどうかを確認する。

JP1/IT Desktop Management 2 - Managerでの事象は「15.3.2　正常に動作しないときの対処」を、JP1/IT Desktop Management 2 - Agentでの事象は「15.4.2　正常に動作しないときの対処」を参照し、対処方法に従って対処してください。

1および2の対処で問題が解決しない場合は、保守資料を採取し、システム管理者に連絡する。

ログファイルには、運用上のトラブルにはならない一時的なエラーなどもメッセージ出力されることがあります。内容の確認をお勧めするメッセージについては、マニュアル「JP1/IT Desktop Management 2 メッセージ」を参照してください。

注意事項

GUI操作またはコマンドを実行した際に、サーバと接続できないことを示すメッセージが出力されたり、ダイアログが表示されたり、GUIが終了したりする場合、サーバPCの起動直後でサーバの起動が完了していない恐れがあります。

15.2　ジョブのトラブルシューティング

JP1/IT Desktop Management 2で実行したジョブがエラーになった場合の、詳細情報の確認方法と対処方法を説明します。

15.2.1　エラージョブの詳細情報を確認する方法

JP1/IT Desktop Management 2で実行したジョブがエラーになった場合、リモートインストールマネージャの［ジョブ実行状況］ウィンドウから表示される［詳細情報］ダイアログボックスで、エラーの詳細情報を確認できます。

［ジョブ実行状況］ウィンドウでは、階層ごとにジョブの情報が表示されます。［詳細情報］ダイアログボックスを表示するには、［ジョブ実行状況］ウィンドウに最下層の情報を表示した状態で、右枠のジョブを選択したあと、［表示］−［ジョブの詳細情報の表示］を選択します。または、右枠のジョブをダブルクリックします。

例えば、リモートインストールするジョブの場合、次に示すように、最下層の情報であるパッケージをダブルクリックすると、［詳細情報］ダイアログボックスが表示されます。

図15‒1　［ジョブ実行状況］ウィンドウ

図15‒2　［詳細情報］ダイアログボックス

「説明」欄には、エラーの要因や対処方法が表示されます。また、エラーの原因は保守コードとして表示されます。

なお、「説明」欄の「エラー関数」に「UNIX」が、「エラー理由」に番号が表示されている場合、この番号を4けたずつ区切ると、UNIX版、Mac版のJP1/IT Desktop Management 2 - Agentから通知されたメッセージIDになります。メッセージIDの内容については、マニュアル「JP1/IT Desktop Management 2 - Agent(UNIX(R)用)」を参照してください。

15.2.2　エラージョブを効率的に確認する方法

［ジョブ実行状況］ウィンドウには、特定の実行状態のジョブだけを表示できます。次に、エラーのジョブだけを表示する方法を示します。

［ジョブ実行状況］ウィンドウで、［表示］−［すべてのジョブ詳細の表示］を選択する。

［ジョブ実行状況］ウィンドウで、［表示］−［ジョブの種類の指定］を選択する。

［表示するジョブの選択］ダイアログボックスが表示されます。

図15‒3　［表示するジョブの選択］ダイアログボックス

「ジョブ詳細実行状態」で「エラー」だけを選択する。

この設定によって、［ジョブ実行状況］ウィンドウには、選択した階層下のエラーの情報だけが表示されるようになり、エラーのジョブが確認しやすくなります。

エラーとなったジョブをダブルクリックすると、［詳細情報］ダイアログボックスが表示され、エラーの詳細情報を確認できます。

15.3　JP1/IT Desktop Management 2 - Managerのトラブルシューティング

ここでは、JP1/IT Desktop Management 2 - Managerにトラブルが発生した場合の、情報の確認方法やトラブルへの対処方法について説明します。

15.3.1　ログファイルの確認

JP1/IT Desktop Management 2 - Managerでは、発生したイベントごとにログが取得されます。ユーザが確認できるログは、次の2種類です。

Windowsのイベントログ

MAIN.LOGファイル

Windowsのイベントログは、Windowsのイベントビューアから確認します。MAIN.LOGファイルは、JP1/IT Desktop Management 2 - Managerのインストール先ディレクトリ¥mgr¥log下に保存されますので、それらを確認する場合はテキストエディタを使用してください。次に、各ログについて説明します。

(1)　Windowsのイベントログを確認する

JP1/IT Desktop Management 2 - Managerの使用中に取得されたイベントログは、イベントビューアを使って表示できます。

イベントビューアの［ログ］メニューから［コンピュータの選択］を選ぶことで、Windowsの動作しているほかのホストのイベントも確認できます。イベントビューアの詳しい操作方法については、Windowsのマニュアルまたはヘルプを参照してください。

イベントビューアのイベント欄に表示される数字（イベントID）は、メッセージIDに相当します。数字の意味は、次のとおりです。

表15‒1　イベントIDとその意味（JP1/IT Desktop Management 2 - Managerの場合）

イベントID

内容

0〜999

Windowsとのインターフェース関連

1000〜1999

TCP/IP関連

7000〜7999

インストール関連

また、イベントビューアのウィンドウで各イベントをダブルクリックすると、イベントごとの詳しい説明が表示されます。例えば、配布管理システム、中継システム、または管理用中継サーバのディスク容量が不足し、システムエラーが発生したときは、イベントビューアのシステムログに、ディスク容量が不足したことを示すメッセージが出力されます。この場合、不要なファイルを削除するなどして、必要なディスク容量を確保してから、処理を再度実行してください。

イベントによっては、イベントの詳細の中でメモリダンプ情報が出力される場合があります。JP1/IT Desktop Management 2のエラーに関して、弊社にお問い合わせのときは、この情報もお知らせください。

なお、JP1/IT Desktop Management 2が出力するイベントログメッセージについては、マニュアル「JP1/IT Desktop Management 2 メッセージ」を参照してください。

(2)　MAIN.LOGファイルを確認する

JP1/IT Desktop Management 2は、MAIN.LOGファイルにもログを取得します。ファイルの形式を次に示します。

図15‒4　MAIN.LOGファイルの形式

MAIN.LOGファイル中に表示される「メッセージ種別」および「機能種別」の意味は次のとおりです。

表15‒2　Main.logファイルのメッセージ種別（JP1/IT Desktop Management 2 - Managerの場合）

メッセージ種別

意味

Informational

情報メッセージ

Warning

警告メッセージ

Error

エラーメッセージ

表15‒3　Main.logファイルの機能種別（JP1/IT Desktop Management 2 - Managerの場合）

機能種別

意味

TCP/IP

TCP/IPとのインターフェース

System

Windowsとのインターフェース

Server

JP1/IT Desktop Management 2のイベント

15.3.2　正常に動作しないときの対処

JP1/IT Desktop Management 2 - Managerを使用しているとき、正常に動作しない、エラーが発生するなどの現象が起こることがあります。次に、発生が考えられる現象とその対処について説明します。

(1)　ジョブの実行が進まない

ジョブの実行が進まない場合は、次に示すような原因が考えられます。

(a)　エージェントの自ホスト名と配布管理システムで指定したあて先が不一致

エージェントの名称が、配布管理システムのシステム構成やあて先で指定した名称と異なる場合、リモートインストールが終了しません。この場合には、ジョブ実行時に指定されたあて先が、意図したものかどうかを製品側で判断ができないため、JP1/IT Desktop Management 2 - ManagerおよびJP1/IT Desktop Management 2 - Agentのログにエラーとして出力できません。実行したジョブは、ジョブ実行状況に表示されます。実行したジョブのあて先が意図したものかどうか、エージェントの名称が正しいかどうかは、ジョブ実行状況で確認してください。

(b)　ホスト識別子が異なるが重複したあて先が存在する

ジョブ実行時に指定されたあて先が、意図したものかどうかを製品側で判断できません。ホスト識別子が異なるが、同じホスト名などのあて先が存在すると、存在しないあて先に対してジョブを実行している可能性があります。ジョブ実行時に指定されたあて先が、意図したものかどうかは、ジョブ実行状況で確認してください。

また、エージェントが重複して存在している場合、異なるあて先にジョブが実行されているためにジョブが終了しないことがあります。このような場合は、重複しているエージェントでresetnidコマンドを実行してください。resetnidコマンドの詳細については、「6.1.5　システム構成情報のメンテナンスの例」を参照してください。

(c)　コンピュータにログオンしていない

GUIインストールモードのジョブを実行している場合、コンピュータが起動されていても、ログオンされていないときはジョブが実行されません。この場合には、リモートインストールマネージャのジョブ実行状況が70％のまま進みません。エージェントの端末にユーザがログオンしていない可能性があります。エージェントの端末の利用ユーザにログオンしているかどうかを確認してください。

(d)　外部プログラム監視時間を設定していない

外部プログラム監視時間を設定していない場合、外部起動プログラムから制御が戻ってこないため、無限に待ち状態になります。実行した外部プログラムが応答を返さない場合には、応答待ちのままとなります。エージェントのUSER_CLT.LOGで、応答が返ってきていないかどうかを確認できます。KDSF0094-Iのメッセージのあとに、KDSF0095-Iのメッセージが出力されていない場合は、外部プログラムからの応答を待っている状態です。

なお、外部プログラム監視時間は、［JP1/ITDM2 パッケージング］ダイアログボックスの［外部プログラム］パネルで設定してください。

(e)　接続先設定ファイルまたは上位接続先情報ファイルの設定に誤りがある

接続先設定ファイルまたは上位接続先情報ファイルの設定に誤りがある場合、JP1/IT Desktop Management 2 - Agent から上位サーバに接続できないため、結果を通知できません。この場合、エージェントからJP1/IT Desktop Management 2 - Managerへの接続に失敗し、JP1/IT Desktop Management 2 - Managerのログに結果を出力できません。対象のエージェントのUSER_CLT.LOGで、接続先に対して通信ができているかどうかを確認してください。必要に応じて、接続先設定ファイルまたは上位接続先情報ファイルの内容を見直してください。

(f)　ITDM互換配布がエージェントで実行中である

エージェント上ではジョブは、ITDM 互換配布とは同時に実行できません。そのため、ITDM 互換配布がエージェントで実行中のときは、ジョブの状態が実行待ちのままになることがあります。この場合、JP1/IT Desktop Management 2 - Managerのログからは確認ができません。配布（ITDM 互換）画面の［タスク］画面で、該当のエージェントで実行中となっているタスクが存在しないかどうかを確認してください。

(g)　リモートインストール後の処理や、AITファイルの処理が正常に終了しない

リモートインストール後の処理や、AIT ファイルの処理が正常に終了しなかった場合、エージェント側のインストールは無限に待ち状態になります。

リモートインストールが完了しないときは、AIT ファイルで、終了時にRegisterWindowMessage を発行していないおそれがあります。この場合、JP1/IT Desktop Management 2 - Managerにジョブの結果が返されていない状態となるため、JP1/IT Desktop Management 2 - Managerのログで確認できません。対象のエージェントのUSER_CLT.LOGを確認し、インストール処理が実行されているかどうかを確認してください。

(h)　インストール前後に起動するユーザプログラムが終了していない

エージェント側のインストールが完了していても、配布管理システム側でジョブ実行状況が70%のままになっているときは、インストール前後に起動するユーザプログラムが終了していないことが考えられます。「(d)　外部プログラム監視時間を設定していない」と同様に、エージェントのUSER_CLT.LOGで確認してください。

(2)　ジョブが失敗する

リモートインストールなどのジョブがエラーになった場合、エラーの原因が保守コードとして表示されます。［ジョブ実行状況］ウィンドウから表示される［詳細情報］ダイアログボックスで、保守コードを確認してください。

(3)　中継システムにジョブはあるが、パッケージがない

中継システムで保管されているパッケージは、一定の期間が経過すると自動的に削除されます。パッケージング時、またはジョブの作成時に保管期限を指定しないと、リモートインストールの翌日に削除されます。また、指定していても、リモートインストールした翌日が休日だったり、エージェントの電源を何日も入れなかったりすると、パッケージが削除され、中継システムにジョブはあるが、パッケージがないという状況が発生します。

このような現象を回避するために、パッケージング時、またはジョブの作成時に指定するパッケージの保管期限を考慮して指定してください。ただし、あまり長い期間を指定すると中継システムのハードディスクを圧迫します。

表示される保守コードは次のとおりです。

保守コード：300097030000

(4)　パッケージ名の末尾にスペースが補填されたりされなかったりする

［パッケージのインストール］ジョブ実行以外で、エージェントからパッケージ情報が通知された場合、パッケージ名の末尾にスペースが補填される場合と、スペースが補填されない場合があります。

この現象を解消させる場合、すべてのエージェントに対して［最新情報の取得］を実行してください。

(5)　エージェントにインストールされた日立プログラムプロダクトのパッケージの名称のスペースが間引かれる

エージェントにインストールされた日立プログラムプロダクトのパッケージの名称のスペースが間引かれる場合があります。

パッケージ名の中のスペースが間引かれて格納されるのは、次の条件が重なった場合です。

日立プログラムプロダクトをパッケージングする際に、パッケージ名称を変更せず、デフォルトのまま実行する。

マネージャからこのパッケージを「パッケージのインストール」ジョブでITDM 互換配布する。

この現象を解消させる場合，すべてのエージェントに対して［最新情報の取得］を実行してください。

15.4　JP1/IT Desktop Management 2 - Agentのトラブルシューティング

ここでは、JP1/IT Desktop Management 2 - Agentにトラブルが発生した場合の、情報の確認方法やトラブルへの対処方法などについて説明します。

15.4.1　ログファイルの確認

トラブルが発生した場合は、JP1/IT Desktop Management 2 - Agentにログが取得されます。ログの内容を確認して対処してください。ログの内容はPCごとに確認できます。

JP1/IT Desktop Management 2 - Agentに取得される、リモートインストールマネージャを使用した配布機能に関するログは、次の3種類です。

エージェントの基本ログ（USER_CLT.LOGファイル）

JP1/IT Desktop Management 2 - Agent全体のログ（MAIN.LOGファイル）

接続先の自動変更関連のログ（USER.LOGファイル）

ログファイルは、JP1/IT Desktop Management 2 - Agentのインストール先ディレクトリ¥log下に保存されますので、それらを確認する場合はテキストエディタを使用してください。

次に、各ログについて説明します。

(1)　エージェントの基本ログ

エージェントの動作に関する基本的なログメッセージは、PCごとにUSER_CLT.LOGファイルに出力されます。エージェントの動作を確認する場合は、まずこのファイルを参照することをお勧めします。このファイルには、各処理の開始や終了についての簡単なメッセージが出力されます。処理が失敗した場合は、エラーの原因も出力されます。

USER_CLT.LOGファイルへの出力対象となる動作を次に示します。

製品およびプロセスの起動と終了

ログオンとログオフ

ジョブの実行要求の受信

ポーリング

ジョブの受信と実行

パッケージのダウンロード

ファイルのアップロード

システム構成情報への自動登録

IDへの登録とIDからの登録解除

パッケージング

内部エラーとアプリケーション例外

ファイル形式の詳細とメッセージ内容については、マニュアル「JP1/IT Desktop Management 2 メッセージ」を参照してください。

(2)　JP1/IT Desktop Management 2 - Agent全体のログ

JP1/IT Desktop Management 2 - Agent全体のログは、MAIN.LOGファイルに取得されます。

(a)　MAIN.LOGファイルを確認する

JP1/IT Desktop Management 2 - Agentは、PCごとにMAIN.LOGファイルにもログを取得します。ファイルの形式を次に示します。

図15‒5　MAIN.LOGファイルの形式

MAIN.LOGファイル中に表示される「メッセージ種別」および「機能種別」の意味は次のとおりです。

表15‒4　MAIN.LOGファイルのメッセージ種別（JP1/IT Desktop Management 2 - Agentの場合）

メッセージ種別

意味

Informational

情報メッセージ

Warning

警告メッセージ

Error

エラーメッセージ

表15‒5　MAIN.LOGファイルの機能種別（JP1/IT Desktop Management 2 - Agentの場合）

機能種別

意味

Package

パッケージング中（JP1/IT Desktop Management 2 - Agent内でのエラー）

Install

インストール中（JP1/IT Desktop Management 2 - Agent内でのエラー）

Setup

GUIインストールモードでのインストール中（JP1/IT Desktop Management 2 - Agent内でのエラー）

TCP/IP

TCP/IPとのインターフェース

System

Windowsとのインターフェース

User

ユーザログ（インストールスクリプトのLogFile関数からの出力）

Server

中継中（JP1/IT Desktop Management 2 - Agent内でのエラー）

(3)　接続先の自動変更関連のログ

接続先設定ファイルまたは上位接続先情報ファイルによってエージェントの接続先が自動的に設定・変更されると、PCごとにログがUSER.LOGファイルに取得されます。USER.LOGファイルの形式を次に示します。

図15‒6　USER.LOGファイルの形式

メッセージ中に表示される「メッセージテキスト」とその意味は次のとおりです。

メッセージ

意味

Match [最小のIPアドレス]-[最大のIPアドレス]:Change [旧接続先:旧接続先の製品種別]->[新接続先:新接続先の製品種別]

エージェントの接続先が、正常に変更されました。

接続先が接続先設定ファイルのITDMセクションに指定した管理用サーバの場合は、製品種別に「itdm」が表示されます。

接続先が接続先設定ファイルのDMセクションまたは上位接続先情報ファイルに指定した、リモートインストールマネージャを使用した配布用の上位システムの場合は、製品種別に「netmdm」または「netmdmw」が表示されます。

Match [最小のIPアドレス]-[最大のIPアドレス]:No Changed [既存の接続先: 既存の接続先種別]※

すでに設定されている接続先は、上位接続先情報ファイルの定義と一致しています。接続先は変更しません。

No Match IP Address List, No Changed [既存の接続先: 既存の接続先製品種別]

エージェントのIPアドレスは、接続先設定ファイルまたは上位接続先情報ファイルの定義範囲内にありません。接続先は変更しません。

接続先が接続先設定ファイルのITDMセクションに指定した管理用サーバの場合は、製品種別に「itdm」が表示されます。

接続先が接続先設定ファイルのDMセクションまたは上位接続先情報ファイルに指定した、リモートインストールマネージャを使用した配布用の上位システムの場合は、製品種別に「netmdm」または「netmdmw」が表示されます。

Section is not available:"[指定値]" :LineNo[行番号]

接続先設定ファイルの[行番号]行目に、無効なセクションが指定されています。この行の定義は無効です。

Not exist No.[項目の順番] Value: LineNo[行番号]

接続先設定ファイルまたは上位接続先情報ファイルの[行番号]行目で、[項目の順番]番目の項目が指定されていません。この行の定義は無効です。

IP Address is not available:"[指定値]" :LineNo[行番号]

接続先設定ファイルまたは上位接続先情報ファイルの[行番号]行目に、無効な値のIPアドレスが指定されています。この行の定義は無効です。

Higher manager value is over 64 character:"[指定値]" :LineNo[行番号]

接続先設定ファイルのDMセクションまたは上位接続先情報ファイルの[行番号]行目に、接続先として半角65文字以上の値が指定されています。この行の定義は無効です。

Higher manager value is over 255 character:"[指定値]" :LineNo[行番号]

接続先設定ファイルのITDMセクションの[行番号]行目に、接続先として半角256文字以上の値が指定されています。この行の定義は無効です。

Connection type value is not "netmdm" or "netmdmw":"[指定値]" :LineNo[行番号]

接続先設定ファイルのDMセクションまたは上位接続先情報ファイルの[行番号]行目に、接続先の製品種別として「netmdm」および「netmdmw」以外の値が指定されています。この行の定義は無効です。

Match [最小のIPアドレス]-[最大のIPアドレス]:Change Multicast IP Address [旧マルチキャストアドレス]->[新マルチキャストアドレス]

エージェントのマルチキャストアドレスが、正常に変更されました。

Match [最小のIPアドレス]-[最大のIPアドレス]:No Changed Multicast IP Address [マルチキャストアドレス]※

すでに設定されているマルチキャストアドレスは、上位接続先情報ファイルの定義と一致しています。マルチキャストアドレスは変更しません。

Multicast IP Address is not available:"[マルチキャストアドレス]":LineNo[行番号]

接続先設定ファイルのDMセクションまたは上位接続先情報ファイルの[行番号]行目に、無効な値のマルチキャストアドレスが指定されています。この行の定義は有効ですが、マルチキャストアドレスの設定だけ無効になります。

Multicast IP Address is under 224.0.0.0:"[指定値]":LineNo[行番号]

接続先設定ファイルのDMセクションまたは上位接続先情報ファイルの[行番号]行目に、224.0.0.0より小さい値のマルチキャストアドレスが指定されています。この行の定義は有効ですが、マルチキャストアドレスの設定だけ無効になります。

Multicast IP Address is over 239.255.255.255:"[指定値]":LineNo[行番号]

接続先設定ファイルのDMセクションまたは上位接続先情報ファイルの[行番号]行目に、239.255.255.255より大きい値のマルチキャストアドレスが指定されています。この行の定義は有効ですが、マルチキャストアドレスの設定だけ無効になります。

Use Option "MultiBoard Environment": Not Execution

エージェントのセットアップで「ネットワークアダプタの設定」をしているため、接続先の自動変更はできません。

Match [最小のIPアドレス]-[最大のIPアドレス]:Clear SubHostName [レジストリ番号]※

すでに設定されている接続先で、上位接続先情報ファイルの定義と一致しない接続先がレジストリから削除されました。

Match [最小のIPアドレス]-[最大のIPアドレス]:Clear SubServiceName [レジストリ番号]※

すでに設定されている接続先で、上位接続先情報ファイルの定義と一致しない製品種別がレジストリから削除されました。

Match [最小のIPアドレス]-[最大のIPアドレス]:Changed Multi Server Option [YES|NO]

複数の上位システムへのポーリングの設定が正常に変更されました。

複数の上位システムにポーリングする場合はYES、しない場合はNOが表示されます。

注※

接続先設定ファイルによる変更の場合、このメッセージは出力されません。

15.4.2　正常に動作しないときの対処

JP1/IT Desktop Management 2 - Agentを使用しているとき、正常に動作しない、エラーが発生するなどの現象が起こることがあります。次に、発生が考えられる現象とその対処について説明します。

(1)　上位システムと通信できていない

ジョブがエラーとなるような場合、エージェントが上位システムと正常に通信できていないおそれがあります。次に示す方法で、通信環境が正しく設定されているか確認してください。

pingコマンドで上位システムと通信できるかどうかを確認する。

現在のTCP/IP通信環境の設定を確認する場合、コマンドプロンプトからIPCONFIG /ALLコマンドを実行する。

ホスト名だけを確認する場合、コマンドプロンプトからHOSTNAMEコマンドを実行する。

(2)　インストールやパッケージングに失敗する

パッケージのインストールやパッケージングに失敗する場合は、ディスク容量が足りているかどうかを確認してください。必要なディスク容量については、マニュアル「JP1/IT Desktop Management 2 導入・設計ガイド」を参照してください。

(3)　ジョブを実行できない

ジョブ実行対象の機器が管理対象機器でない場合、ジョブは実行されません。操作画面からジョブ実行対象の機器が管理対象になっていることを確認してください。

16　AITファイルを使ったリモートインストール

JP1/IT Desktop Management 2では、ソフトウェアをリモートインストールするとき、コンピュータのユーザがインストーラに応答することなく、自動インストールできます。この章では、自動インストールのために必要なAITファイルと、AITファイルを使ったリモートインストールの方法について説明します。また、AITファイルを作成・使用する場合の注意事項について説明します。

16.1　AITファイルとは

AITファイルとは、ソフトウェアのインストーラに自動応答する内容を記述したスクリプトファイルです。配布するソフトウェアとともにAITファイルをパッケージングし、リモートインストールすると、コンピュータのユーザがインストーラに応答することなく、ソフトウェアを自動インストールできます。

他社ソフトウェアや、インストーラに応答する必要のあるユーザ作成のプログラムをリモートインストールする場合は、AITファイルを作成してください。AITファイルは、JP1/IT Desktop Management 2のコンポーネントであるAutomatic Installation Toolを使用して作成します。

AITファイルを使ったリモートインストールの概要を、次の図に示します。

図16‒1　AITファイルを使ったリモートインストール

16.2　AITファイルを使ったリモートインストール手順

AITファイルを使ったリモートインストールの手順を次の図に示します。

図16‒2　AITファイルを使ったリモートインストール手順

16.2.1　AITファイルおよびPP識別情報ファイルの作成

配布するソフトウェアのインストール手順を調査して、インストーラに自動応答するAITファイルを作成します。AITファイルは、Automatic Installation Tool独自のAIT言語で作成します。

また、AITファイルの作成時にPP識別情報ファイルを作成します。PP識別情報ファイルは、ユーザが作成したAITファイルを配布するソフトウェアと関連づけるために、ユーザが作成するファイルです。PP識別情報ファイルは、PPDEFAIT.DMPという名称で、決められた場所に格納しておく必要があります。

AITファイルおよびPP識別情報ファイルの作成方法については、「17.　AITファイルの作成」以降を参照してください。

16.2.2　作成したファイルの格納

ユーザが作成したPP識別情報ファイルは、パッケージャのPCで、次のディレクトリに格納してください。

パッケージャのインストール先ディレクトリ¥DMPRM¥PPDEFAIT.DMP

また、ユーザが作成したAITファイルは、パッケージャのPCの、PP識別情報ファイルの設定時に指定したパスに格納してください。

16.2.3　パッケージング

AITファイルとPP識別情報ファイルを所定の場所に格納したあと、配布するソフトウェアをパッケージャでパッケージングします。

パッケージングする際、［JP1/ITDM2 パッケージング］ダイアログボックスの［パッケージング情報］パネルには、AITファイルおよびPP識別情報ファイルで定義した「パッケージ識別ID」、「バージョン」、「パッケージ名」が表示されます。この値は変更できません。

［JP1/ITDM2 パッケージング］ダイアログボックスには、AITファイルで定義した次の情報も表示されます。この値は、パッケージング時またはリモートインストール時に変更できます。

インストール先ディレクトリ

会社名

所有者名

シリアルナンバー

アイコングループ

インストール中にコンピュータのユーザがダイアログボックスに応答したり、キーボードやマウスを操作したりすると、インストーラの画面表示がAITファイルの期待するものと異なるものになり、AITファイルによるリモートインストールが進まなくなる場合があります。このような場合に備えて、インストール中にユーザの応答待ち状態になってから一定の時間が経過したあと、インストールを強制的に中断する時間（AITファイルの監視時間）を設定しておくことができます。

通常は、配布するソフトウェアをインストールするのに要した時間の約3倍の時間を目安に設定してください。

パッケージングの詳細については、「7.1　パッケージングの方法」および「7.2　パッケージの詳細設定」を参照してください。

16.2.4　リモートインストールの実行

リモートインストールマネージャで、ソフトウェアを配布するジョブを作成して実行してください。リモートインストール操作については、「7.3　リモートインストールの実行」を参照してください。

重要

UNIXシステムの場合、AITファイルを使ったリモートインストールジョブはエラーになります。

16.3　AITファイルを作成および使用する場合の注意事項

AITファイルを作成および使用する場合の注意事項を次に示します。

Webページや、JavaおよびActiveXで作成されたソフトウェアには対応していません。

AITファイルに、レジストリのHKEY_CURRENT_USERを操作するAPIを定義している場合は、リモートインストール先のコンピュータにAdministrator権限を持っているユーザがログオンしている必要があります。

Administrator権限を持たないユーザは、HKEY_CURRENT_USERへのアクセス権がないため、APIで操作するレジストリが自動的にHKEY_USERS¥.DEFAULTに変更されます。これによって、インストールがエラーになることがあります。

なお、操作するレジストリが変更されても、インストール中のソフトウェアの動作に問題がない場合は、インストールが続行されます。

インストール完了後に管理対象のコンピュータを再起動するよう設定されたパッケージを、AITファイルを使用してリモートインストールする場合、管理対象のコンピュータを再起動しないでインストーラが完了するよう設定したAITファイルを使用してください。リモートインストールを正常に完了させるには、パッケージの設定から管理対象のコンピュータを再起動する必要があります。

次に示すカテゴリのAPIの引数に64ビット関連のデータ（レジストリ、フォルダ、またはファイル）を指定して、64ビット版のWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2上で動作させた場合、APIの操作対象が32ビット関連のデータに変更される（リダイレクトされる）ことがあります。

レジストリ操作

ディレクトリ操作

ファイル操作

INIファイル操作

AITファイルを使ったリモートインストールを実行したとき、AITのウィンドウ操作APIでアプリケーションにフォーカスが設定できない場合があります。その場合AIT_Exec()またはAIT_ExecCommand()実行後にレコーダ操作APIのAIT_PlayKey()によって［Alt］＋［Tab］キーをシミュレートし、フォーカスをデスクトップから移動することによって回避してください。

17　AITファイルの作成

Automatic Installation Toolは、AITファイルを作成するための統合された環境を提供しています。この章では、Automatic Installation Toolを使って、AITファイルを作成する方法について説明します。

17.1　Automatic Installation Toolの概要

Automatic Installation Toolの機能概要と、起動と終了方法について説明します。

17.1.1　Automatic Installation Toolの機能

AITファイルを作成するために、Automatic Installation Toolは次の機能を備えています。

編集ウィンドウで、AITファイルを作成および編集します。テキストの切り取り、コピー、貼り付け、インデントの設定などができます。

ウィンドウプロパティツールを使って、インストール画面のウィンドウ情報を取得できます。取得したウィンドウ情報はクリップボードにコピーし、AITファイル内でAPIの引数として使用できます。

レコーダを使って、実際のインストール操作をレコーディングすると、ユーザ操作をシミュレートするAITファイルを自動生成できます。

［文法チェック］は、AITファイルがAIT言語仕様に適合しているかどうかをチェックします。文法チェック時に発生したエラーは、アウトプットウィンドウに表示されます。

［実行］は、文法チェックをしたあと、AITファイルに記述されているインストール操作を再生します。

［デバッグ］は、文法の誤りの発見や修正を支援する機能を提供しています。AITファイル内に設定したブレークポイントまで実行したり、ステートメント単位に実行したりできます。また、AITファイル実行中に、変数の値を参照したり更新したりできます。

インストール操作の再生、レジストリ処理、ファイル処理、文字列処理などのさまざまな処理を実行できるように、APIが提供されています。

配布するソフトウェアをAITファイルに関連づけるためのPP識別情報ファイルを生成できます。

17.1.2　Automatic Installation Toolの起動と終了

Automatic Installation Toolを起動するには、［スタート］メニューから［JP1_IT Desktop Management 2 - Agent］−［管理者ツール］−［Automatic Installation Tool］を選択します。次のような［JP1/ITDM2 Automatic Installation Tool］ウィンドウが表示されます。

図17‒1　［JP1/ITDM2 Automatic Installation Tool］ウィンドウ

Automatic Installation Toolを終了するには、［ファイル］−［終了］を選択します。

なお、Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2版JP1/IT Desktop Management 2 - Agentでレコーディングを実行する場合は、プログラムを実行する権限と同じ権限で［JP1/ITDM2 Automatic Installation Tool］ウィンドウを起動してください。

また、Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2版JP1/IT Desktop Management 2 - Agentは複数の［JP1/ITDM2 Automatic Installation Tool］ウィンドウを起動できます。ただし、レコーディングおよびデバッグを実行する場合は、1つのウィンドウから実行してください。

17.2　AITファイルの構造と作成手順

AITファイルは、基本的に次の手順で作成します。実際には、この手順を一度だけ実行するのではなく、何度か繰り返しながらAITファイルを完成させることになります。

図17‒2　AITファイルの作成手順

レコーダを使用してインストール操作をレコーディングしたあと、パッケージ情報ツールでPACKAGE_INFOセクションを生成すると、次の図のような構造のAITファイルが自動生成されます。自動生成されたファイルは、作成したいAITファイルの原型になります。通常は、網掛けの部分を手作業で修正し、AITファイルを完成させます。

図17‒3　AITファイルの構造

図17-3に示すように、AITファイルは4つのセクションで構成されています。すべてのセクションは必須で、セクションの順序は変更できません。次に、各セクションの概要を説明します。

PACKAGE_INFOセクション

配布するソフトウェアの、パッケージ情報とセットアップに必要な情報を指定します。手作業でも作成できますが、パッケージ情報ツールを使って作成すると便利です。

DEFINEセクション

MAINセクションおよびERRORセクションで使用する変数の定義と初期化を行います。ほかのセクションで変数を定義することはできません。MAINセクションおよびERRORセクションで使用する変数を追加したり、初期値を変更したりする場合は、このセクションを修正してください。

MAINセクション

インストーラが出力するウィンドウに対する操作を記述します。レコーダで自動生成されたコードを手作業で修正し、インストーラが出力するすべてのウィンドウに対する操作を記述します。インストール結果のリターンコードを設定することもできます。

ERRORセクション

AITファイルの実行時に内部エラーが発生すると、このセクションに実行制御が移ります。エラーが発生したときの処理を変更する場合は、このセクションを修正してください。

AITファイル中には、コメントを記述できます。また、AIT言語は大文字と小文字を区別しません。AIT言語の詳細については、「18.　AIT言語リファレンス」を参照してください。

なお、PP識別情報ファイルは手作業でも作成できますが、パッケージ情報ツールで生成すると便利です。PP識別情報ファイルは、PACKAGE_INFOセクションを生成するときに合わせて生成できます。

パッケージ情報ツールによって生成されたPP識別情報ファイルは、JP1/IT Desktop Management 2のインストール先フォルダ¥DMPRMに、PPDEFAIT.DMPというファイル名で格納されます。

17.3　インストール画面の順序と属性を調査する

配布するソフトウェアのインストーラを起動して、そのインストール手順を調査します。次の項目について、OSごとにインストール方法を調べ、インストール手順を紙に記録してください。

インストール画面の順序と属性

各ダイアログボックスの属性

これらの属性を調査するとき、Automatic Installation Toolのウィンドウプロパティツールを利用すると便利です。ウィンドウプロパティツールは、ウィンドウおよびコントロールのGUI属性を取得できるツールで、次の属性を取得できます。

ウィンドウ属性

説明

ウィンドウテキスト

ウィンドウまたはコントロールのキャプションです。

クラス名

ウィンドウまたはコントロールのクラス名です。

モジュール名

ウィンドウを起動したアプリケーションです。

コントロールID

ウィンドウまたはコントロールのIDです。

コントロールの種類

ウィンドウ、ボタンなどのコントロールのタイプです。

関連付けるラベル

あるコントロールに対して、タブオーダーで1つ前のテキストが、そのコントロールの「関連付けるラベル」です。コントロールの1つ前にテキストがない場合、関連付けるラベルはありません。

使用可能

ウィンドウまたはコントロールが使用可能かどうかを識別します。

可視

ウィンドウまたはコントロールが見えるかどうかを識別します。

これらの属性は、ウィンドウやコントロールを識別するために、AITファイルの各種APIの入力値として使えます。

17.3.1　調査内容

インストーラが、ユーザに対して「どのような順序で、どういった操作を要求してくるか」を調査する必要があります。何度か手動でインストールして調査し、次の項目について一覧表にまとめてください。

インストール方法や、インストールするPCの状態（OSの種類、ハードディスクの空き容量、メモリの空き容量、インストール済みのソフトなど）によって、インストールの操作が変わりますので、入念に調査してください。

なお、配布するソフトウェアのインストールで再起動が発生する場合、再起動後の操作については、AITファイルではサポートしていません。したがって、再起動開始時点までのインストール操作を調査してください。

ウィンドウテキスト

ウィンドウプロパティツールを使って調査した「ウィンドウテキスト」を記述します。AIT言語は全角と半角を区別します。大文字と小文字は区別しません。

クラス名

ウィンドウプロパティツールを使って調査した「クラス名」を記述します。

コントロールID

ウィンドウプロパティツールを使って調査した「コントロールID」を記述します。

コントロールの種類

ウィンドウプロパティツールを使って調査した「コントロールの種類」を記述します。

操作

このダイアログボックスに対する操作（［OK］ボタンをクリックするなど）を記述します。

備考

コメントや特記事項がある場合に記述します。

次に、例として、Acrobat Reader 5.05のインストールの流れを調査した結果を示します。「コントロールID」欄のN/Aは、コントロールIDが適用されていないことを示しています。

表17‒1　Acrobat Reader 5.05のインストールの流れ

#

ウィンドウテキスト

クラス名

コントロールID

コントロールの種類

操作

備考

1

Acrobat Reader 5.0.5 のセットアップ

#32770

N/A

Window

［次へ］ボタンをクリックする。

なし

2

インストール先の選択

#32770

N/A

Window

1回目は［参照］ボタンをクリックする。

2回目は［次へ］ボタンをクリックする。

2回目は#4のあとへ

3

ディレクトリの選択

#32770

N/A

Window

パス名にインストールパスを指定する。

インストール先を変更する場合だけ表示

4

セットアップ

#32770

N/A

Window

［OK］ボタンをクリックする。

インストール先を変更する場合だけ表示

5

セットアップの完了

#32770

N/A

Window

［いいえ，後でコンピュータを再起動します］を選択する。

［完了］ボタンをクリックする。

なし

17.3.2　インストール画面の属性の取得

ウィンドウプロパティツールを使って、インストール画面の属性を取得する方法について説明します。

(1)　ウィンドウおよびコントロールの属性を取得する

［ツール］−［ウィンドウプロパティ］を選択する。

［ウィンドウプロパティ］ダイアログボックスが表示されます。

属性を取得したいソフトウェアを起動する。

調べたいウィンドウと［ウィンドウプロパティ］ダイアログボックスが、ともにデスクトップに表示されていることを確認してください。

調べたいウィンドウまたはコントロールの上に、ウィンドウプロパティツールのファインダ（[図データ]）をドラッグ＆ドロップする。

［ウィンドウプロパティ］ダイアログボックスに、ファインダをドラッグした先のウィンドウまたはコントロールの属性が表示されます。

図17‒4　［ウィンドウプロパティ］ダイアログボックス

ウィンドウプロパティツールで取得した属性は、クリップボードにコピーできます。

［ウィンドウプロパティ］ダイアログボックスの[図データ]をクリックしてください。属性は次のようにコピーされます。

ウィンドウテキスト：Acrobat Reader 5.0.5のセットアップ

クラス名：#32770

モジュール名：_INS5576._MP

コントロールID：N/A

コントロールの種類：Window

関連付けるラベル：N/A

使用可能：はい

可視：はい

(2)　関連するウィンドウおよびコントロールの属性を表示する

［ウィンドウプロパティ］ダイアログボックス上のツールバーのボタンを使って、親ウィンドウや最初の子ウィンドウの属性を表示したり、前面や背面のウィンドウの属性を表示したりできます。また、［ウィンドウプロパティ］ダイアログボックスの表示を調整できます。次に、［ウィンドウプロパティ］ダイアログボックス上のツールバーのボタンを示します。

ツールバーのボタン

説明

親ウィンドウにジャンプ：属性を取得したウィンドウまたはコントロールの、親ウィンドウの属性を表示します。

最初の子ウィンドウにジャンプ：属性を取得したウィンドウまたはコントロールの、最初の子ウィンドウの属性を表示します。

前のウィンドウにジャンプ：属性を取得したウィンドウまたはコントロールの、1つ前面のウィンドウの属性を表示します。

次のウィンドウにジャンプ：属性を取得したウィンドウまたはコントロールの、1つ背面のウィンドウの属性を表示します。

検索中に表示／非表示：ファインダをドラッグしたとき、［ウィンドウプロパティ］ダイアログボックスを非表示にし、ドロップしたときに［ウィンドウプロパティ］ダイアログボックスを表示できます。非表示にしておくと、対象のコントロールを選択しやすくなります。

常にトップに：［ウィンドウプロパティ］ダイアログボックスを、常に最前面に表示します。

17.4　インストール操作をレコーディングする

Automatic Installation Toolのレコーダを使用して、実際のインストール操作をレコーディングします。レコーダは、キーを押す、マウスをクリックする、コントロールの操作などのイベントを記録し、ユーザ操作をシミュレートするAITファイルを自動的に作成します。この自動生成されたファイルは、作成したいAITファイルの原型になります。

レコーダによって、PACKAGE_INFOセクションを除く、すべてのセクションが自動生成されます。Acrobat Reader 5.05のインストール操作をレコーディングした結果を例に、どのような情報が生成されるのかを次の図に示します。

図17‒5　Acrobat Reader 5.05のレコーディングで自動生成されたAITファイル（1/3）

図17‒6　Acrobat Reader 5.05のレコーディングで自動生成されたAITファイル（2/3）

図17‒7　Acrobat Reader 5.05のレコーディングで自動生成されたAITファイル（3/3）

17.4.1　インストール操作のレコーディング

レコーダを使用して、実際のインストール操作をレコーディングする方法について説明します。レコーディングによって、ユーザ操作をシミュレートするAITファイルの原型が自動生成されます。

レコーダでインストール操作を記録するとき、AITファイルに自動ロギング機能（AIT_LogMesssageステートメント）を追加することもできます。これによって、記録されたイベントを再生するとき、ログメッセージが出力されます。レコーダを使用してAITファイルを作成したあと、［ビルド］−［実行］で、このAITファイルを実行し、テスト対象のアプリケーションが、シミュレートされたユーザ操作と同じように動作するかどうかを検証するときに役立ちます。

なお、インストール操作では、マウスをできるだけ使用しないでください。マウスからの操作は、画面座標に依存してしまうため、AITファイルからインストーラへの確実な応答ができなくなってしまいます。また、マウスのホイールを利用した操作は、正しくレコーディングされない場合があります。そのため、レコーディングするときは、マウス操作ではなく、キーボード入力のイベントを記録するようにしてください。

レコーディングするときは、Automatic Installation Toolとインストーラ以外のすべてのアプリケーションを終了させておくことをお勧めします。別のアプリケーションに対する操作を行わない場合でも、レコーダは表示されているすべてのウィンドウを記録します。

［ツール］メニューから［レコーダ］を選択する。

［レコーダ］ダイアログボックスが表示されます。

図17‒8　［レコーダ］ダイアログボックス（レコーディング開始）

「インストールプログラム名」および「ログに出力する」を指定する。

インストールプログラム名

インストール操作を記録する前にレコーダによって呼び出される実行プログラムの名前を指定します。インストールプログラム名を指定しない場合は、あらかじめ、対象のアプリケーションを起動しておいてください。

ログに出力する

オンにすると、AITファイルにAIT_LogMesssageステートメントが追加され、AITファイルを再生したときに、エラーや情報メッセージが記録されます。

オフにすると、AITファイルは作成されますが、メッセージを記録するためのステートメントは追加されません。

［開始］ボタンをクリックする。

これ以降のユーザ操作が記録されます。

操作2で「インストールプログラム名」を指定していた場合、指定したインストールプログラムが呼び出されます。

実際に、ソフトウェアのインストール操作を行う。

ユーザ操作をシミュレートする記録シーケンスが作成されます。

ユーザ操作が記録されている間、［JP1/ITDM2 Automatic Installation Tool］のアイコンがWindowsのタスクバーに表示されます。

ソフトウェアのインストール作業が終わったら、Windowsのタスクバーで［JP1/ITDM2 Automatic Installation Tool］のアイコンをクリックする。

レコーディングの終了は基本的に左クリックで行ってください。

Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2上で右クリックした場合、Windowsのジャンプリストが表示されインストール操作としてレコーディングされるため実行しないでください。

［レコーダ］ダイアログボックスが表示され、レコーディングは一時停止の状態になります。

図17‒9　［レコーダ］ダイアログボックス（レコーディング一時停止）

［終了］ボタンをクリックする。

レコーディングが終了し、パッケージ情報を更新するかどうかを確認するメッセージが表示されます。

［はい］をクリックすると、［パッケージ情報］ダイアログボックスが表示され、引き続きPACKAGE_INFOセクションを生成できます。［パッケージ情報］ダイアログボックスについては、「17.5　PACKAGE_INFOセクションを生成する」を参照してください。

［いいえ］をクリックすると、［JP1/ITDM2 Automatic Installation Tool］ウィンドウ中に、作成されたAITファイルが表示されます。

図17‒10　AITファイルが表示された［JP1/ITDM2 Automatic Installation Tool］ウィンドウ

［ファイル］−［名前を付けて保存］を選択し、自動作成されたAITファイルに名前を付けて保存する。

AITファイルの拡張子は.aisです。このファイルを基に、必要なコーディングを追加していきます。

なお、レコーディング中に再起動イベントが発生した場合、レコーディング中にユーザによって実行された操作はAutomatic Installation Toolで保持されています。PCを再起動してAutomatic Installation Toolを起動したあと、AITファイルの生成を確認するメッセージが表示されますので、［はい］をクリックしてAITファイルを生成してください。

17.4.2　レコーディングの一時停止と再開

インストール操作のレコーディング中に、記録を一時停止したり、再開したりできます。操作方法を次に示します。

Windowsのタスクバーで［JP1/ITDM2 Automatic Installation Tool］のアイコンを選択する。

［レコーダ］ダイアログボックスが表示され、レコーディングは一時停止の状態になります。

図17‒11　［レコーダ］ダイアログボックス（レコーディング一時停止）

レコーディングが一時停止している状態で、［再開］ボタンをクリックする。

レコーディングが再開されます。インストール操作を続行してください。

17.4.3　再起動を伴うインストール操作のレコーディング

OSの再起動を要求されるインストール操作のレコーディングでは、OSが再起動するタイミングでレコーディングが完了します。

生成されたAITファイルを表示するには、OSの再起動後にAutomatic Installation Toolを起動してください。Automatic Installation Toolを起動すると、再起動前にレコーディングした内容を有効にするかどうかを選択するメッセージダイアログボックスが表示されます。

図17‒12　レコーディング内容の有効/無効を選択するメッセージダイアログボックス

［はい］ボタンをクリックすると、再起動前にレコーディングした内容のAITファイルが表示されます。

17.5　PACKAGE_INFOセクションを生成する

AITファイルには、配布するソフトウェアのパッケージ情報とセットアップに必要な情報を指定する、PACKAGE_INFOセクションが必要です。このPACKAGE_INFOセクションを作成、検証するには、パッケージ情報ツールを使うと便利です。

また、AITファイルを利用するためには、配布するソフトウェアをAITファイルに関連づけるためのPP識別情報ファイルが必要です。PP識別情報ファイルは、パッケージ情報ツールから自動で生成できます。生成したPP識別情報ファイルを編集する方法については、「付録F　PP識別情報ファイルの編集方法」を参照してください。

ここでは、パッケージ情報ツールを使用してPACKAGE_INFOセクションおよびPP識別情報ファイルを生成する方法について説明します。

17.5.1　PACKAGE_INFOセクションおよびPP識別情報ファイルの生成手順

PACKAGE_INFOセクションおよびPP識別情報ファイルを生成する手順について説明します。

PACKAGE_INFOセクションの詳細については、「18.2.1　PACKAGE_INFO」を参照してください。

［ファイル］−［開く］を選択し、対象のAITファイルを開く。

［ツール］−［パッケージ情報］を選択する。

［パッケージ情報］ダイアログボックスが表示されます。

図17‒13　［パッケージ情報］ダイアログボックス

AITファイルにPACKAGE_INFOセクションがすでにある場合は、該当する値が［パッケージ情報］ダイアログボックスに表示されます。

各項目に値を入力する。

どの項目にも、¥n、¥r、¥tのような特殊な意味を持つ文字は使用できません。また、ダイアログボックス中の各項目の先頭の*は、必ず指定する項目であることを示しています。各項目の意味は次のとおりです。

項目

説明

パッケージ識別ID

パッケージ識別IDを、1〜44バイトで指定します。

半角英数字（英字は大文字だけ）、「-」（ハイフン）、および「_」（アンダーバー）が使用できます。

パッケージ名

パッケージ名を、1〜50バイトで指定します。「¥」と「;」は使用できません。

バージョン／リビジョン

ソフトウェアのバージョン/リビジョンを、1〜6バイトで指定します。

英数字（英字は大文字だけ）、および「/」（スラッシュ）が使用できます。

インストールプログラム名

ソフトウェアをインストールするときの、インストールプログラム（インストーラ）の名前を、1〜256バイトで指定します。

次の記号は使用できません。

「*」「"」「:」「|」「<」「>」「?」

インストール先ドライブ

ソフトウェアをインストールするドライブを、2バイトで指定します。

半角英数字および「:」（コロン）で指定します。

インストール先ディレクトリ

ソフトウェアをインストールするディレクトリを指定します。¥で始まるパス名を、1〜128バイトで指定します。

アイコングループ

ソフトウェアのアイコングループを、1〜40バイトで指定します。

シリアルナンバー

インストールするソフトウェアのシリアルナンバーを、1〜64バイトで指定します。インストール時にCDキーの必要なソフトウェアは、CDキーを入力してください。

所有者名

ソフトウェアの所有者名を、1〜40バイトで指定します。

会社名

ソフトウェアを所有する会社名を、1〜80バイトで指定します。

AITファイルの格納パス

生成するAITファイルのフルパスを、ドライブ名も含めて1〜256バイトで指定します。「;」は使用できません。

識別用ファイル名

配布するソフトウェアをユニークに識別できるファイル名を、1〜477バイトで指定します。

パッケージング時に指定したファイルが存在すると、AITファイルを利用して配布するソフトウェアであると判断されます。複数のファイルを指定した場合は、すべてのファイルが存在するときだけ配布するソフトウェアであると判断されます。複数のファイルを指定する場合、ファイル名を「;」で区切って指定します。

なお、「AITファイルの格納パス」と「識別用ファイル名」の両方を指定しないでPACKAGE_INFOセクションを生成した場合は、PP識別情報ファイルは生成されません。

また、「インストールプログラム名」と「識別用ファイル名」の指定方法については、「17.5.2　インストールプログラムと識別用ファイルの指定方法」を参照してください。

［パッケージ情報の生成］ボタンをクリックする。

各項目の長さ、無効な文字、必須項目など、パッケージャと同様の検証が行われ、AITファイル内にPACKAGE_INFOセクションが生成、更新されます。

PACKAGE_INFO

{

PackageID = "ADOBEACROBATREADER";

Product = "Adobe Acrobat Reader";

Version = "505";

InstallerName = "ar505jpn.exe";

InstallDrive = "C:";

InstallDirectory = "'¥Program Files'¥Adobe";

}

また、［パッケージ情報］ダイアログボックスに設定された値で、PP識別情報ファイルが生成されます。すでにPP識別情報ファイルが存在する場合は、PP識別情報ファイルに情報が追加されます。

PP識別情報ファイルは、JP1/IT Desktop Management 2のインストール先フォルダ¥DMPRM下に、PPDEFAIT.DMPというファイル名で格納されます。

［ファイル］−［上書き保存］を選択し、生成、更新されたPACKAGE_INFOセクションを、AITファイルに保存する。

［パッケージ情報］ダイアログボックスで入力した値は、パッケージング時に［JP1/ITDM2パッケージング］ダイアログボックスに表示されます。このとき、「パッケージ識別ID」、「パッケージ名」、および「バージョン／リビジョン」の値は変更できません。そのほかの値は、パッケージング時またはリモートインストール時に変更することもできます。

17.5.2　インストールプログラムと識別用ファイルの指定方法

AITファイルで指定する「インストールプログラム名」とPP識別情報ファイルで指定する「識別用ファイル名」は、パッケージングするディレクトリからの相対パスで指定する必要があります。

次に、パッケージングするファイルがCD-ROMドライブ（E:）に入っていると仮定して、AITファイルおよびPP識別情報ファイルでの指定方法を説明します。

パッケージングするディレクトリにサブディレクトリが存在しない場合

パッケージングするディレクトリ

E:¥

AITファイルのパッケージ情報で指定する「インストールプログラム名」

setup.exe

PP識別情報ファイルで指定する「識別用ファイル名」

xxx.ini;yyy.exe

パッケージングするディレクトリにサブディレクトリが存在する場合

パッケージングするディレクトリ

E:¥

AITファイルのパッケージ情報で指定する「インストールプログラム名」

install¥setup.exe

PP識別情報ファイルで指定する「識別用ファイル名」

xxx.ini;install¥yyy.exe

パッケージングするディレクトリがサブディレクトリの場合

パッケージングするディレクトリ

E:¥disk1

AITファイルのパッケージ情報で指定する「インストールプログラム名」

setup.exe

PP識別情報ファイルで指定する「識別用ファイル名」

xxx.ini;yyy.exe

パッケージングするディレクトリがサブディレクトリで、その下にサブディレクトリが存在する場合

パッケージングするディレクトリ

E:¥disk1

AITファイルのパッケージ情報で指定する「インストールプログラム名」

install¥setup.exe

PP識別情報ファイルで指定する「識別用ファイル名」

xxx.ini;install¥yyy.exe

17.6　AITファイルを編集する

レコーディングでAITファイルの原型が自動生成されたあと、AITファイルを手作業で編集します。編集のためには、AITファイルで頻繁に使用されるウィンドウ処理のAPIについて理解しておく必要があります。

ここでは、ウィンドウ処理のAPIについて説明したあと、手作業でどのような修正を加えたらよいのかを説明します。

17.6.1　ウィンドウ処理について

MAINセクションでは、表示されたダイアログボックスに対して、コンピュータのユーザが誤って応答したり、キーボードやマウスを操作したりしたために、インストールが中断するような事態に備えて、メイン処理の部分を作成する必要があります。

AITファイルでのウィンドウ処理を次の図に示します。

図17‒14　AITファイルでのウィンドウ処理

AITファイルは、ループ中で繰り返しウィンドウを検索します。したがって、コンピュータのユーザが誤ってAウィンドウに応答してBウィンドウが表示された状態でも、AITファイルはAウィンドウの処理をスキップしてBウィンドウの処理を実行できます。

AITファイルを作成する場合は、出力されるウィンドウを調査し、そのウィンドウに対する処理を並べます。このような処理構造によって、出力されるウィンドウの順序やユーザの操作に関係なく処理を完結できます。

AITファイルでのウィンドウ処理は、次の処理を1つのパーツとしてループ中にシーケンシャルに並べます。

ウィンドウの検索

ウィンドウの操作

これらのウィンドウ処理では、表17-2および表17-3に示すAPIを使用します。

表17‒2　ウィンドウの検索で使用するAPI

API名称

説明

AIT_FocusWindow

ウィンドウを検索し、フォーカスを設定します。

AIT_CtrlSetFocus

特定のコントロールにフォーカスを設定します。

表17‒3　ウィンドウの操作で使用するAPI

API名称

説明

AIT_VerifyExistence

ウィンドウ中に、ボタンやチェックボックスなどのコントロールがあるかないかを確認します。

AIT_VerifyEnabled

コントロールが使用可能かどうかを確認します。

AIT_VerifyPos

コントロールの位置を確認します。

AIT_PlayKey

［Enter］キーを押すなどの、キーボード操作をシミュレートします。

ウィンドウ処理の注意事項

Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、またはWindows Server 2008 R2環境で、AITファイルを使用してソフトウェアをリモートインストールする場合、ウィンドウ操作のAPI（AIT_FocusWindowおよびAIT_CtrlSetFocus）ではアプリケーションにフォーカスが設定できないことがあります。その際は、レコーダ操作のAPIであるAIT_ExecまたはAIT_ExecCommandの実行後に、AIT_PlayKeyで［Alt］+［Tab］キーをシミュレートし、フォーカスをデスクトップから移動してください。

次に、これらのAPIの役割と使用方法について説明します。各APIのパラメタおよび戻り値の詳細については、「19.　APIリファレンス」を参照してください。

(1)　AIT_FocusWindow

AIT_FocusWindowはウィンドウを検索し、そのウィンドウにフォーカスを設定します。AIT_FocusWindowでウィンドウを検索してフォーカスを設定したあと、ウィンドウに対する処理を行います。

ウィンドウを検索するためには、パラメタとして、ウィンドウテキストとクラス名を指定します。ウィンドウテキストとクラス名を調査するには、ウィンドウプロパティツールを使用すると便利です。また、レコーダで自動生成したAITファイルのコードを利用する方法もあります。

戻り値は、ウィンドウの検索に成功した場合はウィンドウハンドル、検索に失敗した場合は0になります。

次に、AIT_FocusWindowの使用例を示します。

図17‒15　AIT_FocusWindowの使用例

(2)　AIT_CtrlSetFocus

AIT_CtrlSetFocusは、特定のコントロールにフォーカスを設定します。ウィンドウの中に複数のコントロールがある場合は、AIT_CtrlSetFocusでコントロールにフォーカスを設定し、そのあとユーザ操作をシミュレートします。

コントロールを指定するためには、コントロールのキャプションまたはコントロールIDを指定します。また、コントロールの種類（ボタン、リストボックスなど）も指定します。

次に、コントロールのキャプションを指定したAIT_CtrlSetFocusの使用例を示します。

図17‒16　AIT_CtrlSetFocusの使用例

(3)　AIT_VerifyExistence

AIT_VerifyExistenceは、コントロールの存在を確認します。

例えば、同じキャプションを持つウィンドウが複数存在する場合、AIT_FocusWindowでウィンドウにフォーカスを設定しても、そのウィンドウが操作対象でないおそれがあります。このような場合にAIT_VerifyExistenceを使用して、ウィンドウの中に特定のコントロールが存在することを確認し、そのウィンドウが操作対象であることを判定します。

コントロールを指定するためには、コントロールのキャプションまたはコントロールIDを指定します。また、コントロールの種類（ボタン、リストボックスなど）も指定します。戻り値は、コントロールが存在する場合は1、存在しない場合は0になります。

次に、コントロールのキャプションを指定したAIT_VerifyExistenceの使用例を示します。

図17‒17　AIT_VerifyExistenceの使用例

(4)　AIT_VerifyEnabled

AIT_VerifyEnabledは、コントロールが使用可能かどうかを確認します。

例えば、チェックボックスとボタンが関連づけられていて、チェックボックスをチェックするとボタンが活性化し（使用可能）、チェックを外すとボタンが非活性（使用不可）になる場合があります。このような場合は、AIT_VerifyEnabledでボタンが使用可能かどうかを確認し、使用できれば「ボタンを押す」というユーザ操作をシミュレートします。

また、AIT_VerifyEnabledは、AIT_VerifyExistenceやAIT_VerifyPosと組み合わせて使用します。AIT_VerifyExistenceやAIT_VerifyPosでコントロールの存在を確認したあと、そのコントロールが使用可能かどうかを確認します。

コントロールを指定するためには、コントロールのキャプションまたはコントロールIDを指定します。また、コントロールの種類（ボタン、リストボックスなど）も指定します。戻り値は、コントロールが使用可能な場合は1、使用できない場合は0になります。

次に、コントロールのキャプションを指定したAIT_VerifyEnabledの使用例を示します。

図17‒18　AIT_VerifyEnabledの使用例

(5)　AIT_VerifyPos

AIT_VerifyPosは、コントロールのタブオーダーを確認します。AIT_VerifyPosはAIT_VerifyExistenceと同様の目的に使用しますが、ウィンドウ中に同じキャプションを持つコントロールが複数存在する場合に、タブオーダーも指定することで、対象のコントロールの存在を確認します。

コントロールを指定するためには、コントロールのキャプションまたはコントロールIDを指定します。また、コントロールの種類（ボタン、リストボックスなど）とタブオーダーも指定します。戻り値は、コントロールのタブオーダーが指定したパラメタと一致した場合は1、一致しない場合は0になります。

次に、コントロールのキャプションを指定したAIT_VerifyPosの使用例を示します。

図17‒19　AIT_VerifyPosの使用例

(6)　AIT_PlayKey

AIT_PlayKeyは、キーボード操作をシミュレートします。

パラメタとして、キーボードから入力する文字列を指定します。例えば、パラメタとして「abcd」を指定すると、「abcd」という文字列が入力されます。また、［Esc］キーの入力を意味する{ESC}や［Alt］＋［F］キーの入力を意味する%(F)など、特殊な意味を持つ文字を入力することもできます。

次に、AIT_PlayKeyの使用例を示します。

図17‒20　AIT_PlayKeyの使用例

(7)　自動生成されたウィンドウ処理の例

レコーディングして自動生成されたAITファイルには、ウィンドウの情報やウィンドウに対する処理が記録されています。自動生成されたウィンドウ処理の例を次の図に示します。

図17‒21　自動生成されたウィンドウ処理の例

17.6.2　自動生成されたフラグについて

レコーディング中に、同じキャプションを持つ複数のウィンドウが処理される場合、生成されたAITファイルでは1つのウィンドウの処理として記録されます。生成されたAITファイルでは、次に示すフラグを利用して、各ウィンドウの処理を記述しています。

ウィンドウフラグ（AITFLAG1〜n）

イベントフラグ（AITEVENTFLAG1〜n）

無効フラグ（AITIGNORE）

それぞれについて説明します。

(1)　ウィンドウフラグ（AITFLAG1〜n）

ウィンドウフラグは、ウィンドウが表示される順序を指定します。ウィンドウフラグの生成例を次に示します。

図17‒22　ウィンドウフラグの生成例

(2)　イベントフラグ（AITEVENTFLAG1〜n）

イベントフラグは、ウィンドウ操作の順序を指定します。イベントフラグの生成例を次に示します。

図17‒23　イベントフラグの生成例

(3)　無効フラグ（AITIGNORE）

無効フラグは、ある一つのウィンドウが閉じる前に次の操作が実行されることを防ぎます。無効フラグの生成例を次に示します。

図17‒24　無効フラグの生成例

17.6.3　自動生成されたAITファイルの確認と修正のポイント

レコーダでAITファイルを自動生成したあと、次の事項に注意しながら、生成されたコードを確認、修正してください。

(1)　インストール条件を変えてレコーディングを繰り返す

ハードディスクの空き容量やOSなどのインストール条件に応じて、インストーラは異なるウィンドウを出力します。これらすべてのウィンドウ出力、すべての事象を1回のレコーディングで記録することはできません。すべてのウィンドウに対する操作をシミュレートするためには、インストール条件を変えてレコーディングを繰り返し、複数のAITファイルを生成する必要があります。インストール条件としては、次のような条件が考えられます。

インストール条件

説明

OS

OSが異なると、インストーラの出力するウィンドウが異なる場合があります。

PC環境

ハードディスクの空き容量不足、前提プログラムのインストール有無、新規インストールか上書きインストールかなど、インストール対象のPC環境によって、インストーラの出力するウィンドウが異なる場合があります。

ユーザ操作

インストール先ディレクトリの変更や、インストール操作のキャンセルなど、ユーザ操作が異なると、インストーラの出力するウィンドウも異なります。

インストール条件ごとに複数のAITファイルが自動生成されたら、それぞれのAITファイルから、必要なコードを抜き出して組み合わせます。必要なコードとは、インストール条件に応じて出力される、異なるウィンドウへの操作をシミュレートするコードです。

複数のAITファイルを組み合わせる場合の例を次の図に示します。

図17‒25　複数のAITファイルの組み合わせ例

(2)　インストール操作の終了を正しく判定する

レコーダは、最後にユーザ操作を行ったウィンドウに対して、インストール正常終了のウィンドウ処理を自動生成します。しかし、最後にユーザ操作を行ったウィンドウが、インストールの最後に出力されるウィンドウではないおそれもあります。

例えば、ユーザ操作の最後でReadmeを表示するための「メモ帳」を閉じて、レコーディングを終了した場合、「メモ帳」の操作に対して、インストールの終了処理が自動生成されます。そのため、インストール途中で「メモ帳」が表示されると、実際にはインストール途中であっても、インストールが終了してしまいます。

したがって、レコーディング時には、インストールの最後に出力されるウィンドウで、ユーザ操作を終了するようにしてください。または、手作業でAITファイルを修正し、インストールが終了するまで「メモ帳」を閉じないように順序を制御してください。次にAITファイルの修正例を示します。

図17‒26　AITファイルの修正例

また、同じキャプションのダイアログボックスが、インストールの途中と最後に出力される場合、インストール操作の終了判定が正しく行われるように、異なるラベルやボタンを記述して、2つのダイアログボックスを区別してください。

(3)　変化するテキストをウィンドウの判定に使わない

ウィンドウを判定するために、ウィンドウテキストだけでなく、ウィンドウ内のコントロールのテキストを判定条件として使用できます。このような場合、変化するテキストを判定条件に使用しないでください。

例えば、インストール時にPCの空きディスク容量が、「空きディスク容量：2252195 K」のように表示されることがあります。空きディスク容量はインストールするPCによって値が異なるので、「2252195 K」は、ウィンドウを判定する条件として使用できません。

自動生成されたAITファイルに、PC環境やOSによって変化するテキストが判定条件として使用されている場合は、削除してください。または、テキストの変化しない部分（例えば「空きディスク容量」）だけを判定条件として使用してください。

(4)　無関係なウィンドウに対するコードは削除する

レコーディング時に、インストーラとは別のアプリケーションが起動していた場合、インストーラとは無関係なウィンドウに対するコードが生成されているおそれがあります。このような場合には、無関係なウィンドウに対するコードは削除してください。

17.6.4　パッケージャおよびリモートインストールマネージャとの連動

パッケージング時またはリモートインストール時に、「インストール先ディレクトリ」や「所有者名」などのパッケージ内容を変更した場合、AITファイルのPACKAGE_INFOセクションは自動的に書き換えられますが、MAINセクションの関連部分は書き換えられません。そのため、必要に応じて、JP1/IT Desktop Management 2固有のグローバル変数を利用してください。使用できるJP1/IT Desktop Management 2固有のグローバル変数を示します。

JP1/IT Desktop Management 2固有のグローバル変数

説明

InstallerName

PACKAGE_INFOセクションで指定したインストールプログラム名です。この値は、パッケージング時またはリモートインストール時には変更できません。

なお、リモートインストール時は、コンピュータのインストールワークディレクトリのパスにインストールプログラム名を結合した値となります。そのため、リモートインストール時とAITファイルのデバッグ時で値が異なります。

InstallDrive

パッケージング時またはリモートインストール時に指定した、インストール先ドライブ名です。デフォルトは、PACKAGE_INFOセクションで指定したインストール先ドライブ名です。

InstallDirectory

パッケージング時またはリモートインストール時に指定した、インストール先ディレクトリ名です。デフォルトは、PACKAGE_INFOセクションで指定したインストール先ディレクトリ名です。

InstallPoint

InstallDrive変数とInstallDirectory変数の内容を結合したインストール位置です。つまり、ドライブ名を含むインストール先ディレクトリです。

JUser

パッケージング時またはリモートインストール時に指定した、所有者名です。

JCompany

パッケージング時またはリモートインストール時に指定した、会社名です。

SerialNumber

パッケージング時またはリモートインストール時に指定した、シリアルナンバーです。ライセンスキーの入力などに使用します。

IconGroupName

パッケージング時またはリモートインストール時に指定した、アイコングループです。アイコングループの変更などで使用します。

グローバル変数の利用例を次の図に示します。

図17‒27　グローバル変数の利用例

17.6.5　エラー処理の追加とリターンコードの設定

異常時にインストーラが出力するウィンドウにも自動応答するように、エラー処理を追加します。インストール時に異常が発生した場合、インストールを続行するか、それともインストールを中断して異常終了とするかを決めて、それに従ったウィンドウ処理をします。

また、インストールが正常に終了したのか、異常終了したのかがわかるようにリターンコードを設定します。リターンコードを設定しておくと、配布管理システムでエラーの内容を確認できます。リターンコードは、ジョブの［詳細情報］ダイアログボックスに表示される保守コードの、左から9番目と10番目に表示される2けたの値です。

異常発生時のエラー処理とリターンコードの設定例を次の図に示します。

図17‒28　エラー処理の追加とリターンコードの設定例（1/2）

図17‒29　エラー処理の追加とリターンコードの設定例（2/2）

17.6.6　AITファイルの完成例

Acrobat Reader 5.05をリモートインストールする場合の、AITファイルの完成例を示します。

PACKAGE_INFO
{
  PackageID         = "ADOBEACROBATREADER";
  Product           = "Adobe Acrobat Reader 5.05";
  Version           = "505";
  InstallerName     = "Ar505jpn.exe";
  InstallDrive      = "C:";
  InstallDirectory  = "'¥Program Files'¥Adobe'¥Acrobat 5.0";
}
DEFINE
{
  integer iLoopCount = 0;
  integer iLoopMax = 60;
  integer DM_RTN;
  integer WINH;
  bool bRtn;
  const integer OK_END = 0;
  const integer NG_END = -1;
  float SLEEP_TIME = 1.0;
  float SLEEP_TIME_RESTART = 10.0;
  float SLEEP_TIME_EVENTS = 0.5;
  integer InsufficientMemory;
  integer InvalidPath;
  integer DirectorySetFlag;
}
MAIN
{
  AIT_SetDefaultWaitTimeout(1.0);
  AIT_DMPSTRC();
  DM_RTN = NG_END;
  bRtn= AIT_Exec(InstallerName,SW_SHOWNORMAL);
  if(bRtn == false)
          iLoopCount = iLoopMax;
  Endif;
  while(iLoopCount < iLoopMax)
      if(AIT_FocusWindow("Acrobat Readerを解凍中です...", "#32770") > 0)
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("Unpacking Acrobat Reader...", "#32770") > 0)
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("セットアップの中止", "#32770") > 0)
          if (InvalidPath == 1 || InsufficientMemory == 1)
              AIT_PlayKey("%(y)");
              iLoopCount = iLoopMax;
          else
              AIT_PlayKey("%(n)");
              iLoopCount = 0;
          endif;
          AIT_Sleep(SLEEP_TIME);
      Endif;

      if(AIT_FocusWindow("上書き確認", "#32770") > 0)
          AIT_PlayKey("%(e)");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("セットアップ初期化エラー", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("PackageForTheWeb", "#32770") > 0)
          if (InsufficientMemory == 1)
              AIT_PlayKey("%(y)");
              iLoopCount = iLoopMax;
          else
              AIT_PlayKey("%(n)");
              iLoopCount = 0;
          endif;
          AIT_Sleep(SLEEP_TIME);
      Endif;

      if(AIT_FocusWindow("Error", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("セットアップの完了", "#32770") > 0)
          AIT_PlayKey("{DOWN}");
          AIT_PlayKey("{ENTER}");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
          DM_RTN = OK_END;
      Endif;

      if(AIT_FocusWindow("PackageForTheWeb Stub", "#32770") > 0)
          AIT_PlayKey("%(C)");
          InsufficientMemory = 1;
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("Ar505jpn", "#32770") > 0)
          AIT_PlayKey("%(C)");
          InsufficientMemory = 1;
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("_ins5576", "#32770") > 0)
          AIT_PlayKey("%(C)");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("PackageForTheWeb Error", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          InsufficientMemory = 1;
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("PackageForTheWeb エラー", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          InsufficientMemory = 1;
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("+TEMP", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("エラー", "#32770") > 0)
          if (AIT_VerifyExistence("中止(&A)",BUTTON_CTRL) > 0)
              AIT_PlayKey("%(a)");
              iLoopCount = iLoopMax;
          else
              if (AIT_VerifyExistence("OK",BUTTON_CTRL) > 0)
                  AIT_PlayKey("{ENTER}");
                  InsufficientMemory = 1;
                  iLoopCount = 0;
              endif;
          endif;
          AIT_Sleep(SLEEP_TIME);
      Endif;

      if(AIT_FocusWindow("警告", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("質問", "#32770") > 0)
          AIT_PlayKey("%(n)");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("ComponentMoveData Error Information", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("Acrobat Reader のセットアップ", "#32770") > 0)
          AIT_PlayKey("{ENTER}");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = iLoopMax;
      Endif;

      if(AIT_FocusWindow("ディスク空き容量不足", "#32770") > 0)
          AIT_PlayKey("{ESC}");
          InsufficientMemory = 1;
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("読み取り専用ファイルの検出", "#32770") > 0)
          AIT_PlayKey("%(y)");
          AIT_Sleep(SLEEP_TIME);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("Acrobat Reader", "#32770") > 0)
          InsufficientMemory = 1;
          if (AIT_VerifyExistence("再試行(&R)",BUTTON_CTRL) > 0)
              AIT_PlayKey("{ESC}");
              iLoopCount = iLoopMax;
          else
              if (AIT_VerifyExistence("OK",BUTTON_CTRL) > 0)
                  AIT_PlayKey("{ENTER}");
                  iLoopCount = iLoopMax;
              endif;
          endif;
          AIT_Sleep(SLEEP_TIME);
      Endif;

      if(AIT_FocusWindow("セットアップ", "#32770") > 0)
          if(AIT_VerifyExistence("~ディレクトリ",STATIC_CTRL) > 0)
              AIT_PlayKey("%(y)");
              AIT_Sleep(SLEEP_TIME);
          else
              if(AIT_VerifyExistence("~指定されたディレクトリ",STATIC_CTRL) > 0)
                  InvalidPath = 1;
                  AIT_PlayKey("{ENTER}");
                  AIT_Sleep(SLEEP_TIME);
                  iLoopCount = 0;
              endif;
          endif;
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("Acrobat Reader 5.0.5 のセットアップ", "#32770") > 0)
          AIT_PlayKey("%(n)");
          AIT_Sleep(SLEEP_TIME_EVENTS);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("インストール先の選択", "#32770") > 0)
          if ( (AIT_FindSubStr(InstallPoint,"%",0) != -1) || (AIT_FindSubStr(InstallPoint,"~",0) != -1) )
              InvalidPath = 1;
              DirectorySetFlag = 1;
          endif;
          if (DirectorySetFlag == 0)
              AIT_PlayKey("%(r)");
          else
              if (InvalidPath == 1 || InsufficientMemory == 1)
                  AIT_PlayKey("{ESC}");
              else
                  AIT_PlayKey("%(n)");
              endif;
          endif;
          AIT_Sleep(SLEEP_TIME_EVENTS);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("ディレクトリの選択", "#32770") > 0)
          if (InvalidPath == 1)
              AIT_PlayKey("{ESC}");
          else
              if (DirectorySetFlag == 1)
                  AIT_PlayKey("{ENTER}");
              else
                  AIT_PlayKey("%(p)");
                  AIT_PlayKey(InstallPoint);
                  AIT_PlayKey("{ENTER}");
                  DirectorySetFlag = 1;
              endif;
          endif;
          AIT_Sleep(SLEEP_TIME_EVENTS);
          iLoopCount = 0;
      Endif;

      if(AIT_FocusWindow("情報", "#32770") > 0)
          if (AIT_VerifyExistence("Acrobat Reader をご選択いただきありがとうございました。",STATIC_CTRL) == 1)
              AIT_PlayKey("{ENTER}");
              if(InsufficientMemory == 0)
                  DM_RTN = OK_END;
              endif;
          else
              if(AIT_VerifyExistence("セットアップを終了します。",STATIC_CTRL) == 1)
                  AIT_PlayKey("{ENTER}");
              endif;
          endif;
          iLoopCount = iLoopMax;
      Endif;

      if (AIT_FocusWindow("", "#32770") > 0)
          if(AIT_VerifyExistence("はい(&Y)",BUTTON_CTRL) > 0)
              AIT_PlayKey("%(y)");
              iLoopCount = iLoopMax;
          endif;
          AIT_Sleep(SLEEP_TIME);
      endif;

      if (AIT_FocusWindow("", "#32770") > 0)
          if(AIT_VerifyExistence("OK",BUTTON_CTRL) > 0)
              AIT_PlayKey("{ENTER}");
              iLoopCount = iLoopMax;
          endif;
          AIT_Sleep(SLEEP_TIME);
      endif;

      if(AIT_FocusWindow("Acrobat Reader のセットアップ", "InstallShield_Win") > 0)
          AIT_Sleep(SLEEP_TIME_EVENTS);
          iLoopCount=0;
      Endif;

      iLoopCount = iLoopCount + 1;
      AIT_Sleep(SLEEP_TIME);
  loop;
  WINH = AIT_RegisterWindowMessage("ITM_REC_QUIT");
  if(WINH != 0)
      AIT_PostMessage(HWND_BROADCAST,WINH,DM_RTN,0);
  Endif;
}
ERROR
{
  DM_RTN = NG_END;
  WINH = AIT_RegisterWindowMessage("ITM_REC_QUIT");
  if(WINH != 0)
      AIT_PostMessage(HWND_BROADCAST,WINH,DM_RTN,0);
  Endif;
}

17.7　AITファイルをデバッグする

一とおりAITファイルの作成が終わったら、文法チェック、実行、デバッグを繰り返し、ユーザ操作を正しくシミュレートするAITファイルを完成させます。AITファイルを実行するために、コンパイルする必要はありません。

なお、Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2版JP1/IT Desktop Management 2 - AgentでAdministrator権限を必要とするプログラムのAITファイルをデバッグする場合、Administrator権限で［JP1/ITDM2 Automatic Installation Tool］ウィンドウを起動してください。プログラムが一般ユーザ権限で実行できる場合は、Administrator権限および一般ユーザ権限のどちらからでもデバッグを実行できます。

AITファイルのデバッグの流れを次の図に示します。

図17‒30　AITファイルのデバッグの流れ

AITファイルを開くと、コーディングのバグを修正するための［ビルド］メニューと［デバッグ］メニューが使用可能になります。

［ビルド］メニューは、AITファイルの文法上の誤りを検出したり、アクティブなAITファイルを実行したりできます。

［デバッグ］メニューは、ブレークポイントを設定すると、AITファイルを指定した位置まで実行できます。また、監視ウィンドウで変数の値を参照したり、更新したりできます。

これらの機能は、拡張子.aisを持つAITファイルにだけ有効です。

デバッグ時の注意事項

PACKAGE_INFOセクションのInstallerNameには、インストールプログラム名が、パッケージングするディレクトリからの相対パスで記述されています。デバッグ時には、一時的にMAINセクションで、これを絶対パスに置き換える必要があります。デバッグが完了したら、元に戻しておいてください。ただし、［文法チェック］のときは、絶対パスに置き換える必要はありません。次に、InstallerNameを絶対パスに置き換える例を示します。

図17‒31　InstallerNameを絶対パスに置き換える例

17.7.1　文法チェックと実行

Automatic Installation Toolでは、次の［ビルド］メニューを使用して、AITファイルの文法チェックと実行ができます。

文法チェック

アクティブなAITファイルの文法をチェックし、アウトプットウィンドウに文法エラーと警告を表示します。

実行

アクティブなAITファイルの文法をチェックしたあと、エラーがなければ、AITファイルを実行します。AITファイルの実行が完了すると、終了コードがアウトプットウィンドウに表示されます。エラーがあった場合は、アウトプットウィンドウに文法エラーと警告が表示されます。

図17‒32　アウトプットウィンドウ

17.7.2　デバッグ

AITファイルのデバッグを容易にするために、特定の位置でAITファイルの実行を停止できます。AITファイルの実行が停止すると、監視ウィンドウでは変数の値が表示または更新されます。

AITファイルは、次の単位で実行できます。

設定したブレークポイントまで

カーソル行の前まで

ステートメント単位

(1)　ブレークポイントを設定する

ブレークポイントとは、デバッグプロセスを停止するポイントです。ブレークポイントは任意の行に追加でき、有効にしたり無効にしたりできます。ブレークポイントが行内に設定されている場合、それが有効な状態であれば、編集ウィンドウの左側にカラーの丸が表示され、無効な状態であれば白丸が表示されます。不要なブレークポイントは削除できます。また、設定したブレークポイントは、AITファイルを閉じると解除されます。

ブレークポイントの追加、削除、有効化、および無効化は、［ブレークポイントの設定］または［ブレークポイントの追加／削除］メニューで実行します。

(a)　［ブレークポイントの設定］を使って、ブレークポイントを設定する

［ブレークポイントの設定］ダイアログボックスで、ブレークポイントを追加、削除、有効化、無効化する方法を説明します。

AITファイルを開き、［デバッグ］−［ブレークポイントの設定］を選択する。

［ブレークポイントの設定］ダイアログボックスが表示されます。

図17‒33　［ブレークポイントの設定］ダイアログボックス

ブレークポイント行番号

ブレークポイントを追加したい行番号を入力し、［追加］ボタンをクリックすると、指定した行にブレークポイントが追加されます。

ブレークポイント

アクティブなAITファイルに設定されているすべてのブレークポイントが表示されます。行番号に対応するチェックボックスをオンにすると、ブレークポイントは有効になり、オフにすると無効になります。

［削除］ボタン

「ブレークポイント」欄で選択した行番号のブレークポイントを削除します。

［すべて削除］ボタン

設定しているすべてのブレークポイントを削除します。

ブレークポイントを設定して、［OK］ボタンをクリックする。

［ブレークポイントの設定］ダイアログボックスでの設定が、編集ウィンドウに反映されます。編集ウィンドウを次の図に示します。

図17‒34　編集ウィンドウ

(b)　［ブレークポイントの追加／削除］を使って、ブレークポイントを設定する

［ブレークポイントの設定］ダイアログボックスを使用しないで、編集ウィンドウ中で、ブレークポイントを追加、削除、および有効にする方法を次に示します。

AITファイルを開き、デバッグプロセスを停止させたい行にカーソルを移動する。

［デバッグ］−［ブレークポイントの追加／削除］を選択する。

選択した行によって、次の処理が実施されます。

ブレークポイントのない行

ブレークポイントが有効な状態で追加されます。

有効なブレークポイントがある行

ブレークポイントが削除されます。

無効なブレークポイントがある行

ブレークポイントが有効になります。

なお、［ブレークポイントの追加／削除］メニューを選択する代わりに、［F9］キーをショートカットキーとして使用することもできます。

(2)　特定の位置まで実行する

現在の位置から特定の位置までAITファイルを実行できます。

特定の位置で実行を停止させるには、次の方法があります。

ブレークポイントを設定して［デバッグ］−［実行］を選択する。

任意の位置にカーソルを移動して［デバッグ］−［カーソル行の前まで実行］を選択する。

［デバッグ］−［ステップオーバー］を選択し、ステートメント単位で実行する。

なお、デバッグを終了するには［デバッグ］−［デバッグの中断］を選択します。

(a)　ブレークポイントまで実行する

設定したブレークポイントまでAITファイルを実行します。コメントやブランクだけなどの実行できない行に設定されているブレークポイントは、デバッグが開始されると、その直後の実行可能な行に移動します。

AITファイルの任意の位置にブレークポイントを設定する。

ブレークポイントの設定方法については、「17.7.2(1)　ブレークポイントを設定する」を参照してください。

［デバッグ］−［実行］を選択する。

最初のブレークポイントまでステートメントが実行され、ブレークポイント行にデバッグカーソルが移動します。

操作2を繰り返して次のブレークポイントまで実行するか、そのほかの［デバッグ］メニュー項目を選択する。

(b)　カーソル行の前まで実行する

カーソルのある行の前までAITファイルを実行します。

AITファイルの任意の位置にカーソルを移動する。

［デバッグ］−［カーソル行の前まで実行］を選択する。

カーソル行の前までステートメントが実行され、操作1で指定した位置にデバッグカーソルが移動します。

操作1と操作2を繰り返して次のカーソル行の前まで実行するか、そのほかの［デバッグ］メニュー項目を選択する。

(c)　ステートメント単位で実行する

AITファイルの終わりまで、または「デバッグの中断」を選択してデバッグプロセスを中断するまで、スクリプトを1ステートメントずつ実行できます。

AITファイルを開く。

［デバッグ］−［ステップオーバー］を選択する。

最初のステートメント行が実行され、デバッグカーソルは次のステートメント行に移動します。

操作2を繰り返して現在のステートメント行を実行するか、そのほかの［デバッグ］メニュー項目を選択する。

(3)　変数を監視、変更する

AITファイルをデバッグするとき、指定した変数の値を監視ウィンドウに表示して、監視できます。特定の位置でAITファイルの実行が停止したとき、現在の変数の値が監視ウィンドウに表示されます。監視ウィンドウを使用して、変数の値を変更することもできます。

次に、監視ウィンドウで、指定した変数を監視する方法を示します。

AITファイルのデバッグ時に、［表示］−［監視ウィンドウ］を選択する。

監視ウィンドウが表示されます。

図17‒35　監視ウィンドウ

「変数」欄に変数名を入力し、［Enter］キーを押す。

編集ウィンドウから監視ウィンドウに、変数をドラッグ＆ドロップして、変数名を入力することもできます。

監視ウィンドウには、変数の値が表示されます。数値データは、デフォルトでは10進数で表示されますが、右クリックして表示されるメニューから［16進数表示］を選択して、16進数で表示することもできます。文字列データは文字列定数で表示されます。

監視ウィンドウで指定した変数名がAITファイルで定義されていない場合は、エラーメッセージが表示されます。

特定の位置まで、AITファイルを実行する。

現在の変数の値が監視ウィンドウに表示されます。

変数の値を変更したい場合は、監視ウィンドウで新しい値を入力して、［Enter］キーを押す。

AITファイル内の変数の値が変更されます。

監視が不要になった変数を監視ウィンドウから削除するには、監視ウィンドウで削除したい変数を選択し、［Delete］キーを押します。

18　AIT言語リファレンス

この章では、AITファイルの形式と、AIT言語の構文について説明します。

18.1　AITファイルの形式

AITファイルは、次の4つのセクションで構成されます。

PACKAGE_INFO

DEFINE

MAIN

ERROR

これらすべてのセクションは必須です。また、セクションの順序は変更できません。

AITファイルの形式を次に示します。AIT言語では、大文字と小文字が区別されません。また、スクリプト中にはコメントを記述できます。

AITファイルの形式

PACKAGE_INFO
{
   // パッケージ情報
}

DEFINE
{
   // 変数と定数の定義および初期化
}

MAIN
{
   // ウィンドウに対する操作
}

ERROR
{
   // エラー発生時の処理
}

18.2　セクション

AITファイルに記述するセクションについて説明します。

18.2.1　PACKAGE_INFO

配布するソフトウェアの、パッケージ情報とセットアップに必要な情報を指定します。

このセクションで指定する項目を次に示します。

(1)　形式

次に示す項目を指定できます。これら以外は指定できません。

PackageID = "パッケージ識別ID";
Product  =  "パッケージ名";
Version = "バージョン/リビジョン";
InstallerName = "インストールプログラム名";
InstallDrive = "インストール先ドライブ";
InstallDirectory = "インストール先ディレクトリ";
IconGroupName = "アイコングループ";
SerialNumber = "シリアルナンバー";
JUser = "日本語の所有者名";
JCompany = "日本語の会社名";
ScriptFileVersion = "AITファイルのバージョン";

(2)　記述する項目

PACKAGE_INFOセクションに記述する各項目について説明します。どの項目にも、「¥n」、「¥r」、「¥t」のような特殊な意味を持つ文字は使用できません。

項目名

内容

省略

PackageID

パッケージ識別IDを、1〜44バイトで指定します。

半角英数字（英字は大文字だけ）、「-」（ハイフン）、または「_」（アンダーバー）で指定します。

不可

Product

パッケージ名を、1〜50バイトで指定します。

「¥」は使用できません。

不可

Version

ソフトウェアのバージョン/リビジョンを、1〜6バイトで指定します。

英数字（英字は大文字だけ）と「/」（スラッシュ）で指定します。

不可

InstallerName

ソフトウェアをインストールするときの、インストールプログラム（インストーラ）の名前を、1〜256バイトで指定します。

次に示す記号は使用できません。

「*」「"」「:」「|」「<」「>」「?」

不可

InstallDrive

ソフトウェアをインストールするドライブを、2バイトで指定します。

半角英数字および「:」（コロン）で指定します。

不可

InstallDirectory

ソフトウェアをインストールするディレクトリを指定します。

「¥」で始まるパス名を、1〜128バイトで指定します。

不可

IconGroupName

ソフトウェアのアイコングループを、1〜40バイトで指定します。

可

SerialNumber

インストールするソフトウェアのシリアルナンバーを、1〜64バイトで指定します。

インストール時にCDキーの必要なソフトウェアは、CDキーを入力してください。

可

JUser

ソフトウェアの所有者名を1〜40バイトで指定します。

可

JCompany

ソフトウェアを所有する会社名を1〜80バイトで指定します。

可

ScriptFileVersion

「nn.nn.nn.nn」の形式で、数字で指定します。「.」（ドット）は連続して指定できません。「.」（ドット）で区切った4つのnnはすべて記述してください。4つ目の区切りの値が指定されていない場合、その区切りはゼロと見なされます。例えば、"1.0.0."は、"1.0.0.0"として扱われます。

この情報を指定することで、Automatic Installation Toolの新しいバージョンで作成されたAITファイルが、古いバージョンの実行エンジンで実行されなくなります。

なお、AITファイルのバージョンがPACKAGE_INFOセクションに記述されていない場合は、アクティブな実行エンジンのDLLのバージョンがAITファイルのバージョンとして取得されます。

可

(3)　記述例

PACKAGE_INFO
{
   PackageID = "D";
   Version = "1";
   Product = "パッケージ名";
   InstallerName = "インストールプログラム名";
   InstallDrive = "D:";
   InstallDirectory = "¥Plan14.1";
   JUser = "パッケージの所有者名";
   JCompany = "パッケージを所有する会社名";
   SerialNumber = "パッケージのシリアルナンバー";
   IconGroupName= "アイコングループ名";
   ScriptFileVersion = "1.0.0.0";
}

18.2.2　DEFINE

AITファイルに記述するすべての変数および定数を定義します。このセクションでは、変数と定数の宣言および初期化だけができます。変数および定数以外の構文は指定できません。

(1)　記述例

DEFINE
{
    const integer OK_END = 0, NG_END = -1 ;
    string sMsgText;
    float TimeOut;
    bool sInvalidPathFlag = false;
}

(2)　備考

変数の再定義はできません。

宣言していない変数を使用すると、文法チェック時に、アウトプットウィンドウに警告メッセージが表示されます。

18.2.3　MAIN

ソフトウェアの自動インストールに必要な処理を記述します。このセクションでは、データ型宣言以外のすべての構文を使用できます。

また、インストール結果のリターンコードをエージェントに通知する指定もできます。

(1)　記述例

MAIN
{
    AIT_SetDefaultWaitTimeout(1.0);
    AIT_DMPSTRC();
    DM_RTN = NG_END;
    AIT_InitLog(InstallerName);
    bRtn= AIT_Exec(InstallerName,SW_SHOWNORMAL);
    if(bRtn == false)
        iErrorNo = AIT_GetLastError();
        strErrorTxt = AIT_GetErrorText(iErrorNo);
        AIT_LogMessage(strErrorTxt);
        iLoopCount = iLoopMax;
    else
        AIT_LogMessage("Recorder File started");
    Endif;
    while(iLoopCount < iLoopMax)
        if(AIT_FocusWindow("check", "#32770") > 0)
            AIT_LogMessage("Window - Caption: check, Class Name: #32770");
            AIT_CtrlSetFocus("チェックボックス(&C)",CHECKBOX_CTRL);
            AIT_Sleep(SLEEP_TIME_EVENTS);
            AIT_LogMessage("AIT_CtrlSetFocus('"チェックボックス(&C)'",CHECKBOX_CTRL);");
            AIT_PlayKey("{ENTER}");
            AIT_Sleep(SLEEP_TIME_EVENTS);
            AIT_LogMessage("AIT_PlayKey('"{ENTER}'");");
            iLoopCount = iLoopMax;
            DM_RTN = OK_END;
            continue;
        Endif;
        iLoopCount = iLoopCount + 1;
        AIT_Sleep(SLEEP_TIME);
    loop;
    if(DM_RTN == OK_END)
        AIT_LogMessage("Recorder File ended normally");
    else
        AIT_LogMessage("Recorder File ended Abnormally");
    Endif;
    WINH = AIT_RegisterWindowMessage("ITM_REC_QUIT");
    if(WINH != 0)
        AIT_PostMessage(HWND_BROADCAST,WINH,DM_RTN,0);
    Endif;
}

18.2.4　ERROR

実行の異常終了時に実行されるステートメントを記述します。インストール結果のリターンコードをエージェントに通知する指定ができます。

AITファイルの実行時にエラーが発生すると、このセクションに実行制御が移ります。

(1)　記述例

ERROR
{
   WINH = AIT_RegisterWindowMessage("ITM_REC_QUIT");
     if  (WINH != 0)
       AIT_PostMessage (HWND_BROADCAST,WINH,-1,0);
     endif;
}

18.3　データ型

AITファイルに記述するデータ型について説明します。以降に示す基本データ型がサポートされています。

18.3.1　integer型

integer型は、-2,147,483,648〜+2,147,483,647の数字を含む基本データ型です。数字に小数や指数を含むことはできません。

キーワード「integer」を使用すると、integer型変数の宣言や、変数や定数を初期化できます。このキーワードはDEFINEセクションだけで使用できます。複数の変数を宣言するときは、変数を「,」（コンマ）で区切ってください。

また、キーワード「integer」と組み合わせてキーワード「const」を使用すると、定数を宣言できます。DEFINEセクションで宣言した定数は、値を参照できるようになりますが、MAINセクションやERRORセクションで値を変更することはできません。

(1)　形式

DEFINE
{
   [const] integer variable_name1 [= integer_constant1] [, variable_name2 [= integer_constant2] ] ;
}

(2)　記述例

DEFINE
{
    const integer OK_END = 0, NG_END = -1 ; // 有効
    integer end_status, return_code;        // 0に初期化
}

(3)　備考

変数や定数を初期化する場合、初期化の値は10進数でだけ指定できます。

integer型変数に割り当てられる値は、integer型、bool型、float型のどれかです。ただし、値がfloat型の場合は正確性を欠くおそれがあるため、文法チェック時に、アウトプットウィンドウに警告メッセージが表示されます。

すべての変数は、デフォルトで0に初期化されます。(2)の例での「end_status」および「return_code」は、0で初期化されています。

18.3.2　float型

float型は、32ビット浮動小数点数を含む基本データ型です。float型変数および定数は、+3.40282347e+38〜+1.175494351e-38の絶対値を持てます。

キーワード「float」を使用すると、float型変数または定数を宣言し初期化できます。このキーワードはDEFINEセクションでだけ使用できます。複数の変数を宣言するときは、変数を「,」（コンマ）で区切ってください。

また、キーワード「float」と組み合わせて、キーワード「const」を使用すると、定数を宣言できます。DEFINEセクションで宣言した定数は、値を参照できるようになりますが、MAINセクションやERRORセクションで値を変更することはできません。

(1)　形式

DEFINE
{
    [const] float variable_name1 [= float_constant1] [, variable_name2 [= float_constant2] ] ;
}

浮動小数点数には、小数点または指数表現（"E"または"e"）を含められます。指数部には、"E"または"e"と、その後に整数値を指定します。整数値には符号（"+"または"-"）を付けられます。浮動小数点定数には、1けた以上の数字が必要で、小数点または指数を指定する必要があります。

(2)　記述例

DEFINE
{
    float DefaultTimeOut = 0.01, DefaultSleep=5.0 ; // 有効
    float SleepMax;                                 // 有効
}

(3)　備考

浮動小数点定数は、10進数でだけ指定できます。

float型変数に割り当てられる値は、bool型、float型、integer型のどれかです。

float型変数は、デフォルトで0に初期化されます。(2)の例での「SleepMax」は、0で初期化されています。

float型で有効なけた数は11です（小数点を含む）。

18.3.3　bool型

bool型は、true（真）およびfalse（偽）という値を持つデータ型です。trueとfalseの間には、次の関係が成り立ちます。

「!false」は「true」と同じ意味

「!true」は「false」と同じ意味

キーワード「bool」を使用すると、bool型変数や定数を宣言し初期化できます。このキーワードは、DEFINEセクションでだけ使用できます。複数の変数を宣言するときは、これらの変数を「,」（コンマ）で区切ってください。

また、キーワード「bool」と組み合わせて、キーワード「const」を使用すると、定数を宣言できます。DEFINEセクションで宣言した定数は、値を参照できるようになりますが、MAINセクションやERRORセクションで値を変更することはできません。

なお、比較によって0と評価された式はfalse、0以外の数値と評価された式はtrueとして解釈されます。

(1)　形式

DEFINE
{
    [const] bool variable_name1 [= true|false] [, variable_name2 [= true|false] ] ;
}

(2)　記述例

DEFINE
{
    bool sInvalidPathFlag, sDirectorySetFlag = true;
    bool SMemoryInsuff = false;
    bool sEndGUI = false;
}

(3)　備考

bool型変数に割り当てられる値は、integer型、float型のどちらかです。ただし、どちらの場合も正確性を欠くおそれがあるため、文法チェック時に、アウトプットウィンドウに警告メッセージが発行されます。

すべての変数は、デフォルトでfalseに初期化されます。(2)の例での「sInvalidPathFlag」は、falseで初期化されています。

18.3.4　string型

string型は、可変長の文字列を持つ基本データ型です。

キーワード「string」を使用すると、string型変数や定数を宣言し初期化できます。このキーワードは、DEFINEセクションでだけ使用できます。複数の変数を宣言するときは、変数を「,」（コンマ）で区切ってください。

また、キーワード「string」と組み合わせて、キーワード「const」を使用すると、定数を宣言できます。DEFINEセクションで宣言した定数は、値を参照できるようになりますが、MAINセクションやERRORセクションで値を変更することはできません。

文字列定数を指定するには、文字を「"」（ダブルクォーテーション）で囲みます。文字列内部で「"」を使用するときは、直前に「'」（シングルクォーテーション）を指定してください。

(1)　形式

DEFINE
{
    [const] string variable_name1 [= "StringValue"] [, variable_name2 [= integer_constant2] ] ;
}

(2)　記述例

DEFINE
{
    string CaptionName="Setup";  // 有効
    string ErrorText;            // 有効
}

(3)　備考

string型変数は、連結操作の結果として文字列長が増えることがあります。

すべての変数は、デフォルトで空になります。(2)の例での「ErrorText」は空になります。

string型は、行末に「_」（アンダーバー）を記述することで次の行に続けることができます。次に示す例のように記述した場合、文字列変数「ErrorText」の値は「sample Testing success」になります。

例

DEFINE
{
   string ErrorText = "sample_
 Testing_
 success";   // stringは複数行に続いています。
}

次に示す文字は、文字列内で特殊な文字として扱われます。

文字

扱い

¥n

改行

¥r

復帰

¥t

タブ文字

'¥

「¥」

'"

「"」

''

「'」

文字列変数「ErrorText」に「"Sample Testing"」を代入する場合の記述例を次に示します。

例

DEFINE
{
   string ErrorText = "'"Sample Testing'"";
          // 「Sample Testing」を「'"」で囲みます。
}

文字列変数「Path」に「C:¥Windows¥system32」を代入する場合の記述例を次に示します。

例

DEFINE
{
   string Path = "C:'¥Windows'¥system32";
          // 「C:¥Windows¥system32」を「Path」に代入します。
}

18.4　演算子

演算子は、次の評価をするために指定します。

1つのオペランド（単項演算子）

2つのオペランド（二項演算子）

演算子を含む複数の式が評価される順番は、厳密な優先順位に従って定義されています。演算子は、左のオペランドと右のオペランドのどちらかと結合します。これを「結合順序」と呼びます。同じグループ内の演算子は同じ優先順位を持ち、「( )」（丸括弧）を使用して明示的に優先順位を変更しないかぎり、オペランドの左から右に評価されます。

AIT言語でサポートしている演算子を次に示します。

表18‒1　AIT言語でサポートしている単項演算子

単項演算子

意味

+

単項プラス

-

単項マイナス

!

単項否定

表18‒2　AIT言語でサポートしている二項演算子

二項演算子

意味

+ -

加法演算子

* / %

乗除演算子

< <= > >= != ==

比較演算子

& |

ビット単位演算子

&& ||

論理演算子

18.4.1　代入操作

代入操作では、右オペランドの値を左オペランドに割り当てます。代入操作の左オペランドは定数ではありません。

(1)　形式

代入ステートメント

assignment_expression END_STMT

代入式

identifier assign_operand expression

(2)　説明

代入操作では、右の値の型は左の値の型に変換され、割り当て後は左オペランドに値が格納されます。左オペランドは関数または定数にしないでください。

右オペランドと左オペランドの型が異なる場合は、型変更が実行されます。型変更は、指定された演算子と、オペランドまたは演算子の型に応じて実行されます。

AIT言語で実行される型変更を次の表に示します。警告やエラーは文法チェック時に表示されます。

左オペランドの型

右オペランドの型

結果

説明

integer

integer

integer

integer型変数の値が別のinteger型変数に代入されます。

integer

float

integer

切り捨て後の値がinteger型変数に代入されます。データの正確性が損なわれるため警告が表示されます。

integer

bool

integer

trueは1として、falseは0としてinteger型変数に代入されます。

integer

string

エラー

string値はintegerに型変更できないため、エラーが表示されます。

float

integer

float

integer型変数の値がfloat型変数に代入されます。

float

float

float

float型変数の値が別のfloat型変数に代入されます。

float

bool

float

trueは1.0として、falseは0.0としてfloat型変数に代入されます。

float

string

エラー

string値はfloatに型変更できないため、エラーが表示されます。

bool

integer

bool

0以外の値はtrueとして、0はfalseとしてbool型変数に代入されます。データが失われるため警告が表示されます。

bool

float

bool

bool

bool

bool

bool型変数の値が別のbool型変数に代入されます。

bool

string

エラー

string型変数の値はboolに型変更できないため、エラーが表示されます。

string

integer

エラー

integer型変数の値はstringに型変更できないため、エラーが表示されます。

string

float

エラー

float型変数の値はstringに型変更できないため、エラーが表示されます。

string

bool

エラー

bool型変数の値はstringに型変更できないため、エラーが表示されます。

string

string

string

string型変数の値が別のstring型変数に代入されます。

なお、AIT言語では多重代入ができます。多重代入によって、ある値を2つの変数に代入できます。

(3)　記述例

MAIN
    {
        a = 10;         // 10という値がaに代入されます。
        a = b = 20;     // 多重代入が指定されています。
                        // 20という値が始めに変数bに代入され、
                        // 次に変数aに代入されます。
    }

18.4.2　単項プラス

単項プラスは、数式の正の値を戻す単項演算子です。

(1)　形式

+[(]式[)]

(2)　説明

単項プラス演算子（+）のオペランドは、算術型でなければなりません。単項演算子はオペランドの前に配置され、右から左に結合します。

正の単項演算子を負の値に対して指定すると、戻り値は負の値になります。負の単項演算子を負の値に対して指定すると、戻り値は正の値になります。

(3)　記述例

const integer NG_END = +1;         // DEFINEセクション内のステートメント
sloopcnt = +(sloopmin - sloopmax); // MAINセクション内のステートメント

18.4.3　単項マイナス

単項マイナスは、数式の負の値を戻す単項演算子です。

(1)　形式

-[(]式[)]

(2)　説明

単項マイナス演算子（-）のオペランドは、算術型でなければなりません。単項演算子はオペランドの前に配置され、右から左に結合します。

負の単項演算子を負の値に対して指定すると、戻り値は正の値になります。正の単項演算子を負の値に対して指定すると、戻り値は負の値になります。

(3)　記述例

const integer NG_END = -1;            //DEFINEセクション内のステートメント
integer sloopcnt, sloopmax, sloopmin;
sloopcnt = -(sloopmax - sloopmin);    //MAINセクション内のステートメント

18.4.4　単項否定

単項否定は、式で論理否定をする単項演算子です。

(1)　形式

!(式)

(2)　説明

オペランドの否定がtrue（例えば、オペランドがfalse）の場合はtrueを戻します。逆に、オペランドの否定がfalse（例えば、オペランドがtrue）の場合はfalseを戻します。

単項演算子はオペランドの前に配置され、右から左に結合します。

(3)　記述例

bool IsLastDialog;
IsLastDialog = false;
if (!IsLastDialog)
   AIT_LogMessage("Installable Software Extracting... は開かれています");
else
   AIT_LogMessage("Installable Software Extracting... は開かれていません");
endif;

18.4.5　加法演算子

加法演算子は、加算（+）および減算（-）を実行します。

(1)　形式

加算式

式 + 式

除算式

式 - 式

(2)　説明

加法演算子は、integer型オペランドやfloat型オペランドの通常の算術変換をします。変換結果の型はオペランドの型になります。

加算演算子（+）は、2つのオペランドを加算します。両方のオペランドがstring型のときは、2つの文字列が連結されます。片方のオペランドだけがstring型のときは、エラーになります。

減算演算子（-）は、1つ目のオペランドから2つ目のオペランドを減算します。両方のオペランドが数値である必要があります。片方または両方のオペランドがstring型の場合は、結果がエラーとなります。

(3)　記述例

MAIN
{
         ...
         sloop_cnt = sloop_cnt+1;
         sloop_cnt = sloop_cnt-1;
         ...
         ...
}

(4)　備考

加法演算子がする変換処理は、オーバーフローやアンダーフロー状態に対応できないため、加法演算子の変換結果がオペランドの型で示されない場合は、情報が欠落するおそれがあります。

18.4.6　乗除演算子

乗除演算子は、乗算（*）、除算（/）、および剰余算（%）を実行します。

(1)　形式

乗算式

式 * 式

除算式

式 / 式

剰余算式

式 % 式

(2)　説明

乗除演算子は、オペランドの通常の算術変換をします。変換結果のデータ型は、オペランドのデータ型になります。両方のオペランドが数値である必要があります。オペランドの片方または両方がstring型の場合は、結果がエラーとなります。

乗算演算子（*）は、2つのオペランドを乗算します。オペランドはinteger型でもfloat型でもよく、型が異なっていてもかまいません。

除算演算子（/）は、1つ目のオペランドを2つ目のオペランドで除算します。オペランドはinteger型でもfloat型でもよく、型が異なっていてもかまいません。0で除算した場合の結果は未定義となりますが、文法チェック時またはランタイム時にエラーが発行されます。また、両方のオペランドが正の値または符号なしのときは、結果は0に切り捨てられます。

剰余演算子（%）オペランドは、整数でなければなりません。評価結果は、1つ目のオペランドが2つ目のオペランドで除算したあとの剰余になりますが、割り切れなければ評価結果は次の規則によって決まります。

右オペランドが0の場合は、結果は未定義となります。

両方のオペランドが正の値または符号なしの場合は、結果は正の値となります。

(3)　記述例

MAIN
{
if (sloop_cnt > 10)
   AIT_Sleep(SLEEP_TIME / 2);
else
   AIT_Sleep(SLEEP_TIME * 2);
endif;
}

(4)　備考

乗除演算子による変換処理は、オーバーフローやアンダーフロー状態に対応できないため、乗除演算子の変換結果がオペランドの型で示されない場合は、情報が欠落するおそれがあります。

ランタイム時に0で除算すると、プログラムはERRORセクションに制御を移します。

18.4.7　比較演算子

二項比較演算子は、第1オペランドを第2オペランドと比較し、指定された関係の妥当性を検証します。比較式の結果は、結果の評価がtrueの場合は1となり、falseの場合は0となります。結果の型はboolです。

(1)　形式

比較式

式 < 式
式 > 式
式 <= 式
式 >= 式

等式

式 == 式

不等式

式 != 式

(2)　説明

比較演算子による検査の対象となる関係を次に示します。

演算子

検査の対象となる関係

<

1つ目のオペランドが2つ目のオペランドより小さい

>

1つ目のオペランドが2つ目のオペランドより大きい

<=

1つ目のオペランドが2つ目のオペランドより小さいか等しい

>=

1つ目のオペランドが2つ目のオペランドより大きいか等しい

==

1つ目のオペランドが2つ目のオペランドと等しい

!=

1つ目のオペランドが2つ目のオペランドと等しくない

オペランドは、integer型、float型、またはstring型で指定できます。オペランドの型が異なってもかまいません。比較演算子は、integer型およびfloat型オペランドの通常の算術変換をします。さらに、オペランドの型と比較演算子や等号演算子を組み合わせて使うことができます。

次の表では、比較演算子と、比較結果がtrue、false、またはnullであるかどうかを判別するための状態を示します。

演算子

意味

trueの場合

falseの場合

<

より小さい

式1 < 式2

式1 >= 式2

>

より大きい

式1 > 式2

式1 <= 式2

<=

より小さいか等しい

式1 <= 式2

式1 > 式2

>=

より大きいか等しい

式1 >= 式2

式1 < 式2

==

等しい

式1 == 式2

式1 != 式2

!=

等しくない

式1 != 式2

式1 == 式2

次の表では、式の型に応じた式の比較結果を示します。

式の型

比較結果

式の両方が数値の場合

数値を比較する

式の両方がstring型の場合

文字列を比較する

一方の式が数値でもう一方がstring型の場合

エラーとなる

(3)　記述例

if (sloop_cnt < (sloop_max - 25))  // <
    AIT_LogMessage("Searching for Active windows");  //Search Active windows
    if (AIT_FocusWindow("Installable Software Extracting...", "#32770",0.0) > 0)   // >
        AIT_LogMessage("Installable Software Extracting... is opened");
        sloop_cnt= 0;
    endif;
endif;

18.4.8　ビット単位演算子

ビット単位演算子は、ビット単位AND（&）演算、およびビット単位OR（|）演算を実行します。

(1)　形式

ビット単位AND演算式

式 & 式

ビット単位OR演算式

式 | 式

(2)　説明

ビット単位演算子のオペランドは、integer型を必ず持たなければなりませんが、型が異なってもかまいません。ビット単位演算子は、通常の算術変換をします。変換結果の型は、オペランドの型になります。

ビット単位演算子の説明を次に示します。

演算子

説明

&

ビット単位AND演算子は、1つ目のオペランドの各ビットを2つ目のオペランドの対応するビットと比較します。両方のビットが1であれば、比較後の結果ビットを1に設定します。これ以外の場合は、比較後の結果ビットを0に設定します。

|

ビット単位OR演算子は、1つ目のオペランドの各ビットを2つ目のオペランドの対応するビットと比較します。どちらか一方のビットが1の場合は、比較後の結果ビットを1に設定します。これ以外の場合は、比較後の結果ビットを0に設定します。

ビット単位AND演算子は、2つの数式の同じ位置にあるビットをビット単位で比較して、次の表に基づき比較後の結果ビットを設定します。

式1のビット

式2のビット

比較結果

0

0

0

0

1

0

1

0

0

1

1

1

ビット単位OR演算子は、2つの数式の同じ位置にあるビットをビット単位で比較して、次の表に基づき比較後の結果ビットを設定します。

式1のビット

式2のビット

比較結果

0

0

0

0

1

1

1

0

1

1

1

1

18.4.9　論理演算子

論理演算子は、論理AND演算（&&）、および論理OR演算（||）を実行します。

(1)　形式

論理AND演算式

式1 && 式2

論理OR演算式

式1 || 式2

(2)　説明

論理演算子は通常の演算変換は実行しません。その代わりに、0と一致するかどうかという観点で各オペランドを評価します。論理演算の結果はtrueまたはfalseです。結果の型はboolです。

論理演算子の説明を次に示します。

演算子

説明

&&

両方のオペランドがtrueの場合、結果はtrueになります。どちらか一方のオペランドがfalseの場合、結果はfalseになります。論理AND演算の初めのオペランドがfalseの場合、2つ目のオペランドは評価されません。

||

両方のオペランドの評価がfalseの場合、結果はfalseになります。どちらか一方のオペランドの評価がtrueの場合、結果はtrueになります。論理OR演算の初めのオペランドがtrueの場合、2つ目のオペランドは評価されません。

論理ANDおよび論理OR式のオペランドは、左から右に評価されます。1つ目のオペランドの値だけで演算結果を判別できるときは、2つ目のオペランドは評価されません。これを「短絡評価」と呼びます。

(a)　論理AND演算子（&&）の場合

両方の式がtrueと評価された場合は、結果はtrueになります。式のどちらかがfalseと評価された場合は、結果はfalseになります。次の表では、評価結果の判別方法を示します。

式1の評価

式2の評価

評価結果

true

true

true

true

false

false

false

true

false

false

false

false

(b)　論理OR演算子（||）の場合

どちらか一方、または両方の式がtrueと評価された場合は、結果はtrueになります。次の表では、評価結果の判別方法を示します。

式1の評価

式2の評価

評価結果

true

true

true

true

false

true

false

true

true

false

false

false

(3)　記述例

DEFINE
{
   float varfloat1 = 1.567e-1;
   integer varint1 = 10;
   integer varfloat2 = 0;
   integer varint2 = 0;
   bool varbool;
   integer WINH;
}
MAIN
{
   varbool = varfloat1 && varint1;
   AIT_LogMessage("The expected value of varbool is: true");
   varbool =varfloat2 && varint1;
   AIT_LogMessage("The expected value of varbool is: false");
   varbool=varfloat1 && varint2;
   AIT_LogMessage("The expected value of varbool is: false");
   varbool=varfloat2 && varint2;
   AIT_LogMessage("The expected value of varbool is: false");
}

18.4.10　演算子の優先順位

演算子の優先順位および結合順序は、式のオペランドのグループ化や評価するうえで影響を与えます。演算子の優先順位は、同じ式の中に演算子の優先順位が高い、または低い別の演算子が含まれている場合にだけ意味を持ちます。式の中に高い優先順位の演算子が含まれているときは、その演算子が先に評価されます。演算子の優先順位が等しいときは、評価される順位はそれぞれが持つ結合順序によって決まります。

次の表では、演算子の優先順位と結合順序を示します。演算子は、優先順位の降順で表しています。

記号

演算子の型

結合順序

( )

括弧

左から右

+ - !

単項

右から左

* / %

乗除

左から右

+ -

加法

左から右

< > <= >=

比較

左から右

== !=

等号

左から右

&

ビット単位AND

左から右

|

ビット単位OR

左から右

&&

論理AND

左から右

||

論理OR

左から右

=

代入

左から右

18.5　変数と定数

変数と定数は、どちらもデータを象徴するものです。変数は値が変化するのに対し、定数は値を変更できません。

変数および定数は、宣言することで実体を持ち、使用できるようになります。これらの宣言は必ずAITファイルのDEFINEセクションでします。宣言は一度しかできません。変数名および定数名は、64文字以内で、必ず英字（Ａ〜Ｚ）から始まるようにします。「_」（アンダーバー）以外の記号は使えません。また、英字の大文字と小文字は区別されません。

変数名および定数名は、目的や用途を示す、わかりやすいものにすることをお勧めします。キーワード、ラベル名、およびマクロ名は、変数名にしないでください。

18.5.1　変数の例

integer LoopCount;
string CountryName;
bool answer;
float r_nTimeOut;
integer ABC;
integer abc;     //変数を再び定義しているため無効

上記の例の「integer」という記述は、リストされている変数がinteger型であることを意味します。つまり、「LoopCount」は整数です。同様に、「CountryName」は文字列です。

18.5.2　定数の例

const integer OK_END = 0;       //DM_RTN:OK_END
const integer NG_END = -1;      //DM_RTN:NG_END
const integer SET_SLEEP_TIME = 2;

18.6　プログラムフローの制御

一般に複数のステートメントは、順次に実行されます。ただし、フローを別のステートメントに移すには、以降に示すステートメントを使用します。

18.6.1　goto

gotoステートメントを使用すると、同じセクション内で宣言されている有効なラベルの位置に無条件にジャンプできます。

(1)　形式

ステートメント

ジャンプステートメント
ラベルステートメント

ジャンプステートメント

goto 識別子;

ラベルステートメント

識別子:

(2)　説明

gotoステートメントは、深くネストされたループの内側から直接ループを抜けられます。一方、breakステートメントは、繰り返しステートメントの1つのレベルからしか終了できません。

(3)　記述例

//MAINセクション
MAIN
{
   ...
   ...
   AIT_LogMessage("LBL030: JUMP TO LABEL");
   goto label1;
       AIT_LogMessage("LBL030: NOT DISPLAYED 1");   // 実行されない

       label1:                     // 制御はここに移る
          AIT_LogMessage("LBL030: JUMPING TO LABEL ");   // 実行される
}

(4)　備考

プログラミングスタイルとしては、できるだけgotoステートメントよりbreak、continue、およびreturnステートメントを使う方がよいでしょう。

18.6.2　ラベル

gotoステートメントを使用してプログラムの制御を特定のステートメントにダイレクトに移すには、移動先のステートメントにラベルを付ける必要があります。

ラベルを宣言するには、識別子の末尾に「:」（コロン）を付けます。ラベルの宣言は、MAINセクションまたはERRORセクションのどの位置でもかまいません。ラベル名は、変数または定数と同じ規則に従い、必ずユニークなものを指定します。また、変数や定数をラベルとして再使用してはいけません。

ラベルは、MAINセクションまたはERRORセクション以外では意味がなく、gotoステートメントと関連づけられている場合にだけ意味を持ちます。関連づけられていない場合はラベルが解釈されないでステートメントが実行されます。ラベルの付いたステートメントがgotoステートメントと関連づけられていない場合は、警告メッセージが表示されます。

(1)　形式

ラベルステートメント

識別子:

(2)　記述例

AIT_MessageBox("ss","xx");
goto label18;
   AIT_LogMessage("LBL040: NOT DISPLAYED 29");    // 実行されない
   label18:         // 制御がここに移る
   AIT_LogMessage("LBL040: INSIDE LABELLED STATEMENT"); // 実行される
   AIT_Exit();

18.6.3　if-else-endif

ifステートメントを使用すると、条件分岐を処理できるようになります。

条件が0以外の場合は、ifステートメントの本体が実行されます。条件が0の場合は、本体以外の部分が実行されます。

このステートメントの本体以外の部分はオプションです。条件は括弧で囲んでください。

(1)　形式

if (条件)
    [式1;]
[else
    [式2;]]
endif;

(2)　説明

評価の対象は条件です。条件が0以外の場合は(1)の式1に当たる部分が実行され、条件が0の場合は式2の部分が実行されます。

if-else-endifステートメントのelse文節は、対応するelseステートメントが存在しない直前のifステートメントと関連づけられています。

(3)　記述例

if(AIT_FocusWindow("Installable Software-Setup","#32770"))
                         // 次の2行はtrue（0以外）の場合に実行される
   AIT_LogMessage("INSIDE Installable Software SETUP");
   AIT_PlayKey("ENTER");
else
                         // 次の2行はfalse（0）の場合に実行される
   AIT_LogMessage("PROBLEM IN SETUP");
   AIT_Exit();
endif;

18.6.4　while-loop

while-loopステートメントは、指定した条件がfalseになるまで式を繰り返し実行します。条件は括弧で囲んで指定してください。

(1)　形式

while (条件)
    式1;
    式2;
loop;

(2)　説明

条件が評価されます。

条件が最初にfalseとなると、whileステートメントの本体は一度も実行されず、制御がwhileステートメントから同じプログラム内の次のステートメントに移ります。

条件がtrue（0以外）のときは、ステートメントの本体は実行され、式1から実行が繰り返されます。

ステートメント本体でbreakステートメントが指定されていると、その時点でループは終了します。

ステートメント本体でcontinueステートメントが指定されていると、それ以降の実行はスキップされ、条件が評価されます。条件がtrueのときは、実行が繰り返されます。

なお、ネストするwhileループの数は、255以内に抑えてください。

(3)　記述例

DEFINE
{
integer WINH,count,length;
float SLEEP_TIME=0.5;
string s1,s2;
integer i,sloop_cnt   = 0;
integer sloop_max = 30;
}
...
...
while ( sloop_cnt < sloop_max)
   AIT_LogMessage("アクティブウィンドウの検索");
   if (AIT_FocusWindow("アンパック中...", "#32770",0.0) > 0)
   if(AIT_FocusWindow("インストールするソフトウェアをアンパック中...", "#32770", 0.0) > 0)
          AIT_LogMessage("インストールするソフトウェアをアンパック中... が開かれました");
      sloop_cnt= 0;
      AIT_Sleep(SLEEP_TIME);
   endif;
   endif;
   AIT_Sleep(SLEEP_TIME);
   sloop_cnt = sloop_cnt + 1;
loop;

18.6.5　do-while

do-whileステートメントは、指定された終了条件がfalseと評価されるまで式を繰り返し実行します。条件は括弧で指定してください。

(1)　形式

do
   式1
   式2
   ...
   ...
while (条件);

(2)　説明

do-whileステートメントの本体が実行されます。

次に、条件が評価されます。条件がfalseのときは、do-whileステートメントは終了し、制御が同じプログラム内の次のステートメントに移ります。条件がtrue（0以外）のときは、式1から実行が繰り返されます。

ステートメント本体でbreakステートメントが指定されていると、その時点でループは終了します。

ステートメント本体でcontinueステートメントが指定されていると、それ以降の実行はスキップされ、条件が評価されます。条件がtrueのときは、実行が繰り返されます。

この結果、ループの本体は、最低1回は必ず実行されます。

なお、ループ内のbreakまたはcontinueステートメントの数は、255以内に抑えてください。また、ネストするdo-whileステートメントの数は、255以内に抑えてください。

(3)　記述例

DEFINE
{
integer WINH,count,length;
float SLEEP_TIME=0.5;
string s1,s2;
integer i,sloop_cnt   = 0;
integer sloop_max = 30;
}
...
...
do
   AIT_LogMessage("Searching for Active windows");
   if (AIT_FocusWindow("Installable Software", "#32770",0.0) > 0)
        if(AIT_FocusWindow("Unpacking Installable Software...", "#32770", 0.0) > 0)
            AIT_LogMessage("Unpacking Installable Software... is opened");
            sloop_cnt= 0;
            AIT_Sleep(SLEEP_TIME);
        endif;
   endif;
   AIT_Sleep(SLEEP_TIME);
   sloop_cnt = sloop_cnt + 1;
while ( sloop_cnt < sloop_max);
...
...

18.6.6　for-next

for-nextステートメントは、条件がfalseになるまで式を繰り返し実行します。for-nextステートメントのオプション式を使用すると、for-nextステートメントの実行中に初期設定や値を変更できます。

一般にループが繰り返される回数は、カウンタによって決まります。

(1)　形式

for ( [初期化式] ; [条件式] ; [ループ式] )
     式1;
     式2;
next;

(2)　説明

初期化式が指定されていると、この式が評価されます。この式は、ループの初期化を指定します。初期化式には、型の制限はありません。

条件式が指定されていると、この式が評価されます。この評価は、それぞれの繰り返しをする前に実行されますが、次の3つの結果が考えられます。

条件式がtrue（0以外）の場合は、ステートメントが実行されます。ループ式が指定されていると、次にこの式が評価されます。そして、条件式の評価から実行が繰り返されます。

条件式の指定が省略されているときは、条件式はtrueと解釈され、上記と同様に実行されます。引数で条件式を指定しないと、ステートメント本体の内部でbreakステートメントが実行されたとき、またはgotoステートメント（ステートメント本体の外側のラベル付きステートメントに対応したもの）が実行された時に、forステートメントは終了します。

条件式がfalse（0）のときは、for-nextステートメントの実行が終了し、制御が同じプログラム内の次のステートメントに移ります。

ステートメント本体でbreakステートメントが指定されていると、その時点でループは停止します。

ステートメント本体でcontinueステートメントが指定されていると、それ以降の実行をスキップし、条件式が評価されます。条件がtrueのときは、実行が繰り返されます。

なお、ネストするfor-next構造体の数は、255以内に抑えてください。

(3)　記述例

DEFINE
{
integer WINH,count,length;
float SLEEP_TIME=0.5;
string s1,s2;
integer i,sloop_cnt   = 0;
integer sloop_max = 30;
}
...
...
sloop_cnt=1;
AIT_LogMessage("Searching for Active windows - For");
for(; sloop_cnt < sloop_max ;sloop_cnt = sloop_cnt + 1)
    if (AIT_FocusWindow("Unpacking", "#32770",0.0) > 0)
        if(AIT_FocusWindow("Unpacking Installable Software...", "#32770", 0.0) > 0)
               AIT_LogMessage("Unpacking Installable Software... is opened");
               sloop_cnt= 0;
               AIT_Sleep(SLEEP_TIME);
        endif;
        endif;
   AIT_Sleep(SLEEP_TIME);
next;

18.6.7　continue

continueステートメントは、これを囲むいちばん小さいdo、for、またはwhileステートメントの次の繰り返し位置に制御を移します。

一般にcontinueステートメントは、深くネストされたループの内側からループの開始位置に戻すために使用します。

(1)　形式

ジャンプステートメント

continue;

(2)　説明

continueステートメントに達すると、do、forまたはwhileステートメントの次の繰り返し位置は、次のように決定されます。

doまたはwhileステートメントの内側で、doまたはwhileステートメントの式が再評価されることで、次の繰り返しが開始されます。

forステートメントでcontinueステートメントが指定されていると、forステートメントの条件式を再評価して、その結果に応じてステートメント本体の実行を終了するか、または繰り返します。

なお、ループ構造体に含めるcontinueステートメントの数は、255以内に抑えてください。

(3)　記述例

for (count=1;count<=10;count=count+1)
    if (count < 5)
           continue;
    endif;
    ...
next;

上の例では、continueステートメント以降のコードは、countが5になるまで処理が省略されます。

18.6.8　break

breakステートメントは、これを囲むいちばん近いdo-while、for-next、switch-endswitch、またはwhile-loopステートメントの実行を終了します。制御は、終了したステートメントの後ろにあるステートメントに移ります。breakステートメントは、繰り返しから脱出するために使用します。

(1)　形式

ジャンプステートメント

break;

(2)　説明

breakステートメントは、ループ内では、終了基準が評価される前にループを終了するために使用します。また、switchステートメント内部で、特定の場合に実行を終了するときにも使用します。繰り返しステートメントまたはswitchステートメントを指定しなければ、エラーが発生します。

なお、ループ構造体の中に含めるbreakステートメントは、255以内に抑えてください。

(3)　記述例

i = 0;
for(;;)
   AIT_LogMessage("Inside Loop");
   i = i + 1;
   if(i>100)
      break;
   endif;
next;

18.6.9　switch-endswitch

switchステートメントを使用すると、式の値に応じてコードにある複数の選択肢の中から処理を選択できます。式は括弧で囲んで指定してください。

switchステートメントには、caseラベルまたはdefaultラベルが付いているものがあり、それらが選択肢となります。各caseラベルは、定数値を持てます。switchステートメントはcaseラベルがなければ意味を持たないため、switchステートメント中には、1つ以上のcaseラベルを付けるようにしてください。

defaultラベルは、1つしか指定できません。defaultラベルはオプションであり、これに値を指定しないようにしてください。

(1)　形式

switch (式)

  [case 定数値:]+
       [式;]*
  ...
  ...
 [default:]
       [式;]*

endswitch;

(2)　説明

式が評価されます。

式の値と等しいcaseラベル値を持つブロックに制御が移ります。breakに達するまでは、（caseラベル値とは関係なく）引き続きすべてのステートメントが実行されます。

breakステートメントに達すると、switchステートメントの外側に制御が移ります。

式の値がcaseラベル値と等しくないときは、defaultラベルが指定されていると、その位置に制御が移ります。

switch-endswitchステートメントを指定するには、次の規則に従います。

switchステートメントの式のデータ型は、定数値のようなラベル定数のものと同一にします。

ネストするswitchステートメントの数は、255以内に抑えてください。

すべてのcaseラベルが、関連づけられた実行ステートメントを持つ必要はありませんが、最終のcaseステートメントは、関連づけられた実行ステートメントを最低1つ持つようにします。

switch-endswitchステートメントは、最大255のcaseラベルを持てます。

caseラベルに指定できるのは、数値定数、string定数、またはAIT言語のマクロで、式は指定できません。

例

case -5:        // 有効
case +6:        // 有効
case "String":  // 有効
case intvar:    // 無効
case 3+2:       // 無効

caseラベルで指定する定数は、switchステートメントの式と同じ型にします。

例

switch (Stringvar1+Stringvar2)  // 変数はどちらもstring型
case 1:                        // 無効
case "キャプション1":           // 有効
..
..
endswitch;

switch caseステートメントとともにcaseステートメントを指定しなければ、文法エラーとして解釈されます。

switch caseステートメント内に記述できるbreakステートメントは、255個までです。

switch caseステートメント内のcaseステートメントに別のステートメントを指定する必要はありませんが、最終のcaseステートメントには、必ず別のステートメントを追加してください。

例

switch(i)
{
  case 1:
  case 2:
    a=b+c; // "a=b+c;"ステートメントを指定しなければ、
           // スクリプトアナライザーから文法エラーが発行される
}

(3)　記述例

s1="abcdefghijk";
switch (!AIT_IsEmpty(s1 ))
case true:            // s1が空の場合実行されます
    s2 = AIT_StrUpper(s1);
    AIT_MessageBox("s2",s2);
       if ( ( length = AIT_StrLength(s2)) > 10)
           break;
    endif;
    break;
default:              //状態がfalseを返してきた場合
    break;            //実行されます
endswitch;

18.7　関数呼び出し

AIT言語は、標準的な操作を実行するための各種APIをサポートしています。APIは、大きく次のように分類されます。

ウィンドウ操作

確認操作

解像度のチェック

日時操作

IME操作

文字列操作

メッセージ操作

レジストリ操作

ディレクトリ操作

リダイレクト操作

ファイル操作

INIファイル操作

レコーダ操作

タスクバー操作

ユティリティ操作

JP1/IT Desktop Management 2とのインターフェース

18.7.1　形式

上記のAPIは、MAINおよびERRORセクションから呼び出せます。

パラメタのデータ型は、API仕様で定義されているものと同一にします。

関数呼び出しの中に式を指定できます。また、式のデータ型または関数呼び出しがAPI仕様と一致していれば、関数呼び出し同士をネストすることもできます。

APIの実行によってランタイムエラーが発生した場合は、ERRORセクションに制御が移ります。

関数の処理が失敗した場合は、関数の戻り値はAIT_GetLastErrorを呼び出すことで取得できます。エラーメッセージに対応するエラーテキストもAIT_GetErrorTextを使用して取得できます。

18.7.2　記述例

integer intvar1;
string Caption;
string Stringvar1, Stringvar2;
...
...
AIT_LogMessage("SAMPLE FUNCTION CALL");  // 関数呼び出し
if(AIT_FocusWindow("Installable-Setup","#32770"))
                               // 式内で関数呼び出しの戻り値を使用している
   AIT_LogMessage("INSIDE Installable Software SETUP");  // 実行される
   AIT_PlayKey("{Enter}");
endif;
                       // 関数呼び出しの異常終了をチェック
Caption = "Installable Software";
intvar1    = AIT_GetSubStr(Stringvar1, Stringvar2, 50);
                                                 // intvar1が0になる
if(!intvar1)
           AIT_LogMessage(AIT_GetErrorText(AIT_GetLastError()));
endif;

18.8　キーワード

キーワードは、特別な意味を持つ定義済みの予約識別子です。キーワードをプログラム内で識別子として使うことはできません。識別子のスペルをキーワードと同じにしてはいけません。キーワードは、大文字小文字を区別しないため、大文字小文字の組み合わせを変えても識別子として使用することはできません。

AIT言語で定義されているキーワードを次に示します。

表18‒3　AIT言語で定義されているキーワード

項番

キーワード

1

bool

2

break

3

case

4

const

5

continue

6

default

7

define

8

do

9

else

10

endif

11

endswitch

12

ERROR

13

float

14

for

15

goto

16

IconGroupName

17

if

18

InstallDirectory

19

InstallDrive

20

InstallerName

21

integer

22

JCompany

23

JUser

24

loop

25

MAIN

26

next

27

PACKAGE_INFO

28

PackageID

29

Product

30

ScriptFileVersion

31

SerialNumber

32

string

33

switch

34

Version

35

while

キーワードには、上記のほかに、API名、AIT言語の定義済みマクロ、および幾つかのWin 32エラーコードがあります。

18.9　マクロ

AITスクリプト言語には、値を代入できない特定の定義済み定数があります。この種の定数は、次に示すマクロ名とそのデータ型で分類されます。

なお、DEFINEセクションでマクロの宣言はできません。

18.9.1　ウィンドウ操作および確認操作に関するマクロ

ウィンドウ操作および確認操作に関するマクロを次に示します。これらのマクロのデータ型は、すべてinteger型です。

表18‒4　ウィンドウ操作および確認操作に関するマクロの一覧

マクロ名

ALT_OFF

ALT_ON

BUTTON_CTRL

CALENDAR_CTRL

CAPSLOCK

CHECKBOX_CTRL

COMBO_CTRL

COMMANDBUTTON_CTRL

CONTROL_CAPTION_SIZE

CONTROL_CLASS_SIZE

CTRL_OFF

CTRL_ON

DTPICKER_CTRL

EDIT_CTRL

HSCROLL

IDABORT

IDCANCEL

IDIGNORE

IDNO

IDOK

IDRETRY

IDYES

INSERTLOCK

IPADDRESS_CTRL

KEYSTATE_OFF

KEYSTATE_ON

LBUTTON

LISTBOX_CTRL

LIST_CTRL

MBUTTON

MB_ABORTRETRYIGNORE

MB_ICONEXCLAMATION

MB_ICONINFORMATION

MB_ICONQUESTION

MB_ICONSTOP

MB_OK

MB_OKCANCEL

MB_RETRYCANCEL

MB_YESNO

MB_YESNOCANCEL

NOTIFICATION_CTRL

NUMLOCK

OPTIONBUTTON_CTRL

PROGRESS_CTRL

RBUTTON

REBAR_CTRL

SB_BOTTOM

SB_LEFT

SB_LINEDOWN

SB_LINELEFT

SB_LINERIGHT

SB_LINEUP

SB_PAGEDOWN

SB_PAGELEFT

SB_PAGERIGHT

SB_PAGEUP

SB_RIGHT

SB_THUMBPOSITION

SB_THUMBTRACK

SB_TOP

SCROLLBAR_CTRL

SCROLLLOCK

SHIFT_OFF

SHIFT_ON

SLIDER_CTRL

SPIN_CTRL

STARTBUTTON_CTRL

STATIC_CTRL

STATUSBAR_CTRL

STYLE_CHECK_BUTTON

STYLE_PUSH_BUTTON

STYLE_RADIO_BUTTON

SW_HIDE

SW_MAXIMIZE

SW_MINIMIZE

SW_NORMAL

SW_SHOW

SW_SHOWMAXIMIZED

SW_SHOWMINIMIZED

SW_SHOWMINNOACTIVE

SW_SHOWNOACTIVATE

SW_SHOWNORMAL

TAB_CTRL

TASKBARCLOCK_CTRL

TASKBARITEMS_CTRL

TASKBAR_CTRL

TOOLBAR_CTRL

TOOLTIPS_CTRL

TREE_CTRL

VSCROLL

18.9.2　メッセージ操作に関するマクロ

メッセージ操作に関するマクロを次に示します。このマクロのデータ型はinteger型です。

HWND_BROADCAST

18.9.3　ファイル操作に関するマクロ

ファイル操作に関するマクロを次に示します。これらのマクロのデータ型は、すべてinteger型です。

表18‒5　ファイル操作に関するマクロの一覧

マクロ名

AIT_ALLFILES

CREATE_ALWAYS

CREATE_NEW

FILE_ALL

FILE_ATTRIBUTE_ARCHIVE

FILE_ATTRIBUTE_DIRECTORY

FILE_ATTRIBUTE_HIDDEN

FILE_ATTRIBUTE_READONLY

FILE_ATTRIBUTE_SYSTEM

FILE_READ

FILE_WRITE

GENERIC_READ

GENERIC_WRITE

OPEN_ALWAYS

OPEN_EXISTING

TRUNCATE_EXISTING

18.9.4　IME操作に関するマクロ

IME操作に関するマクロを次に示します。これらのマクロのデータ型は、すべてinteger型です。

表18‒6　IME操作に関するマクロの一覧

マクロ名

IGP_CONVERSION

IGP_GETIMEVERSION

IGP_PROPERTY

IGP_SELECT

IGP_SENTENCE

IGP_SETCOMPSTR

IGP_UI

IME_CHOTKEY_IME_NONIME_TOGGLE

IME_CHOTKEY_SHAPE_TOGGLE

IME_CHOTKEY_SYMBOL_TOGGLE

IME_CMODE_CHARCODE

IME_CMODE_EUDC

IME_CMODE_FULLSHAPE

IME_CMODE_HANJACONVERT

IME_CMODE_KATAKANA

IME_CMODE_NATIVE

IME_CMODE_NOCONVERSION

IME_CMODE_ROMAN

IME_CMODE_SOFTKBD

IME_CMODE_SYMBOL

IME_JHOTKEY_CLOSE_OPEN

IME_KHOTKEY_ENGLISH

IME_KHOTKEY_HANJACONVERT

IME_KHOTKEY_SHAPE_TOGGLE

IME_PROP_AT_CARET

IME_PROP_CANDLIST_START_FROM_1

IME_PROP_SPECIAL_UI

IME_PROP_UNICODE

IME_SMODE_AUTOMATIC

IME_SMODE_CONVERSATION

IME_SMODE_NONE

IME_SMODE_PHRASEPREDICT

IME_SMODE_PLAURALCLAUSE

IME_SMODE_PLURALCLAUSE

IME_SMODE_SINGLECONVERT

IME_THOTKEY_IME_NONIME_TOGGLE

IME_THOTKEY_SHAPE_TOGGLE

IME_THOTKEY_SYMBOL_TOGGLE

SCS_CAP_COMPSTR

SCS_CAP_MAKEREAD

SELECT_CAP_CONVERSION

SELECT_CAP_SENTENCE

UI_CAP_2700

UI_CAP_ROT90

UI_CAP_ROTANY

−

（凡例）　−：なし

18.9.5　ユティリティ操作に関するマクロ

ユティリティ操作に関するマクロを次に示します。これらのマクロのデータ型は、すべてinteger型です。

表18‒7　ユティリティ操作に関するマクロの一覧

マクロ名

VER_PLATFORM_WIN32_NT

VER_PLATFORM_WIN32_WINDOWS

18.9.6　レジストリ操作に関するマクロ

レジストリ操作に関するマクロを次に示します。これらのマクロのデータ型は、すべてinteger型です。

表18‒8　レジストリ操作に関するマクロの一覧

マクロ名

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

−

（凡例）　−：なし

18.9.7　ディレクトリ操作に関するマクロ

ディレクトリ操作に関するマクロを次に示します。これらのマクロのデータ型は、すべてinteger型です。

表18‒9　ディレクトリ操作に関するマクロの一覧

マクロ名

AIT_CURRENTDIRECTORY

AIT_PARENTDIRECTORY

18.9.8　エラーロギングに関するマクロ

エラーロギングに関するマクロを次に示します。これらのマクロのデータ型は、すべてinteger型です。

表18‒10　エラーロギングに関するマクロの一覧

マクロ名

ERROR_ACCESS_DENIED

ERROR_ALREADY_EXISTS

ERROR_BADDB

ERROR_BADKEY

ERROR_BAD_COMMAND

ERROR_BAD_NETPATH

ERROR_BAD_NET_NAME

ERROR_BAD_PATHNAME

ERROR_BUFFER_OVERFLOW

ERROR_CANNOT_MAKE

ERROR_CANTOPEN

ERROR_CANTREAD

ERROR_CANTWRITE

ERROR_CHILD_MUST_BE_VOLATILE

ERROR_CONTROL_ID_NOT_FOUND

ERROR_CRC

ERROR_CURRENT_DIRECTORY

ERROR_DIRECTORY

ERROR_DISK_CORRUPT

ERROR_DISK_FULL

ERROR_FILENAME_EXCED_RANGE

ERROR_FILE_CORRUPT

ERROR_FILE_EXISTS

ERROR_FILE_NOT_FOUND

ERROR_HANDLE_DISK_FULL

ERROR_HANDLE_EOF

ERROR_INSUFFICIENT_BUFFER

ERROR_INVALID_COMPUTERNAME

ERROR_INVALID_DATA

ERROR_INVALID_DRIVE

ERROR_INVALID_FUNCTION

ERROR_INVALID_HANDLE

ERROR_INVALID_INDEX

ERROR_INVALID_MENU_HANDLE

ERROR_INVALID_NAME

ERROR_INVALID_NETNAME

ERROR_INVALID_PARAMETER

ERROR_INVALID_SCROLLBAR_RANGE

ERROR_INVALID_SHARENAME

ERROR_INVALID_WINDOW_HANDLE

ERROR_KEY_DELETED

ERROR_KEY_HAS_CHILDREN

ERROR_LOCK_VIOLATION

ERROR_MENU_ITEM_NOT_FOUND

ERROR_NETWORK_BUSY

ERROR_NETWORK_UNREACHABLE

ERROR_NOACCESS

ERROR_NOT_ENOUGH_MEMORY

ERROR_NOT_READY

ERROR_NOT_REGISTRY_FILE

ERROR_NO_LOG_SPACE

ERROR_NO_MORE_FILES

ERROR_NO_MORE_ITEMS

ERROR_NO_MORE_SEARCH_HANDLES

ERROR_NO_SCROLLBARS

ERROR_OUTOFMEMORY

ERROR_PATH_BUSY

ERROR_PATH_NOT_FOUND

ERROR_READ_FAULT

ERROR_REGISTRY_CORRUPT

ERROR_REGISTRY_IO_FAILED

ERROR_REGISTRY_RECOVERED

ERROR_SHARING_VIOLATION

ERROR_SUCCESS

ERROR_TIMEOUT

ERROR_TOO_MANY_OPEN_FILES

ERROR_WRITE_FAULT

ERROR_WRITE_PROTECT

19　APIリファレンス

この章では、AIT言語で使用するAPIについて説明します。

19.1　API一覧

AIT言語が提供するAPIは、次のカテゴリで分類されます。

ウィンドウ操作

確認操作

解像度のチェック

日時操作

IME操作

文字列操作

メッセージ操作

レジストリ操作

リダイレクト操作

ディレクトリ操作

ファイル操作

INIファイル操作

レコーダ操作

タスクバー操作

ユティリティ操作

JP1/IT Desktop Management 2とのインターフェース

カテゴリ別のAPIの一覧を次の項以降に示します。

19.1.1　ウィンドウ操作

次のAPIは、ウィンドウの検索、特定のコントロールへのフォーカス設定、チェックボックスまたはラジオボタンのチェック状態の設定など、ウィンドウおよびコントロールに関連する処理をアプリケーションが実行できるようにします。

API関数名

機能

AIT_FocusWindow

ウィンドウを検索し、フォーカスを設定します。

AIT_ExistWindow

ウィンドウが存在するかをチェックします。

AIT_MinWnd

ウィンドウを最小化します。

AIT_SetWndPos

指定したウィンドウの位置を変更します。

AIT_SetWndPosSize

指定したウィンドウの位置とサイズを変更します。

AIT_GetWindowText

指定したウィンドウのタイトルを取得します。

AIT_SetActWnd

アクティブなウィンドウを設定します。

AIT_GetCtrlText

ウィンドウのコントロールからテキストを取得します。

AIT_CtrlSetFocus

コントロールにフォーカスを設定します。

AIT_SetSpinPos

スピンまたはスライダーコントロールの位置を設定します。

AIT_SetScrollPos

スクロールバーの位置を設定します。

AIT_CtrlClick

コントロールに対しマウスクリック処理を実行します。

AIT_SelectMultipleListItem

複数リスト項目を選択します。

AIT_SelectListItem

リスト項目を選択します。

AIT_SelectIPAddressField

IPアドレスフィールドを選択します。

AIT_SelectText

コントロール上のテキストを選択します。

AIT_DefaultButtonCount

デフォルトボタンスタイルの数を取得します。

AIT_SetCheck

ラジオボタンまたはチェックボックスのチェック状態を設定します。

AIT_CtrlItemCount

コントロールの項目数を取得します。

AIT_GetIndexText

インデックスからテキストを取得します。

AIT_CtrlItemIndex

テキストのインデックスを取得します。

AIT_GetIndexTextLen

基準値0のインデックス文字列の、文字の長さを取得します。

AIT_SetKeyState

キーの状態を設定します。

AIT_GetKeyState

キー状態を取得します。

AIT_MouseClick

マウスクリック操作を実行します。

AIT_MouseUp

マウスを離す操作を実行します。

AIT_MouseDown

マウスを押す操作を実行します。

AIT_MouseMoveTo

マウスの移動操作を実行します。

AIT_MouseDragDrop

マウスのドラッグアンドドロップ操作を実行します。

AIT_MouseDblClk

マウスのダブルクリック操作を実行します。

AIT_SetComboEditSelText

コンボボックスのテキストを選択します。

AIT_ComboBoxCloseUp

コンボボックスへのクローズアップ操作を実行します。

AIT_ComboBoxDropDown

コンボボックスへのドロップダウン操作を実行します。

AIT_GetEditFirstLineIndex

エディットボックスでの最初の行のインデックスを取得します。

AIT_GetEditCurrentLineIndex

エディットボックスでの現在の行のインデックスを取得します。

AIT_GetCtrlTextLen

コントロールのテキストの長さを取得します。

AIT_GetEditTextLineLen

エディットボックスにでの行の長さを取得します。

AIT_GetDtPickerTime

日時ピッカーから時間を取得します。

AIT_GetDtPickerDate

日時ピッカーから日付を取得します。

AIT_SetDtPickerTime

日時ピッカーで時間を設定します。

AIT_SetDtPickerDate

日時ピッカーで日付を設定します。

AIT_GetMenu

メニューハンドルを取得します。

AIT_GetSubMenu

サブメニューハンドルを取得します。

AIT_GetMenuText

メニューテキストを取得します。

AIT_GetMenuIndex

メニューのインデックスを取得します。

AIT_MenuItemClick

指定したメニュー項目をクリックします。

19.1.2　確認操作

次のAPIは、コントロールの存在、コントロールの状態、コントロールのフォーカスを確認するなど、確認処理をアプリケーションが実行できるようにします。

API関数名

機能

AIT_VerifyExistence

コントロールの存在を確認します。

AIT_VerifyEnabled

コントロールが使用できるかどうかを確認します。

AIT_VerifyFocus

コントロールがフォーカスされているかどうかを確認します。

AIT_VerifyState

コントロールの状態を確認します。

AIT_VerifyCharPos

コントロールの文字の位置を確認します。

AIT_VerifyLine

行のインデックスを確認します。

AIT_VerifyText

指定したテキストを確認します。

AIT_VerifySelected

エディットボックスで選択されたテキストを確認します。

AIT_VerifyFirstVisible

コントロールの最初の可視項目を確認します。

AIT_VerifyCount

項目カウントを確認します。

AIT_VerifyPos

コントロールの位置を確認します。

AIT_VerifyIndex

コントロールのインデックスを確認します。

AIT_VerifyLocation

コントロールの位置を確認します。

AIT_VerifyDateTime

コントロールの日付または時間の値を確認します。

AIT_VerifyKeyState

キーの状態を確認します。

AIT_VerifyDefaultButton

デフォルトのボタンスタイルを確認します。

AIT_VerifyNoOfCtrls

ウィンドウのコントロール数を確認します。

AIT_VerifyMenuChecked

メニューのチェック状態を確認します。

AIT_VerifyMenuEnabled

メニューが使用できる状態かどうかを確認します。

19.1.3　解像度のチェック

次のAPIは、システムの解像度をチェックします。

API関数名

機能

AIT_CheckResolution

スクリーンの解像度をチェックします。

19.1.4　日時操作

次のAPIは、アプリケーションが日付または時間を処理できるようにします。

API関数名

機能

AIT_GetDate

システムの日付を取得します。

AIT_GetTime

システムの時間を取得します。

19.1.5　IME操作

次のAPIは、IMEのオンまたはオフ、変換モードの切り替えなど、ユーザがよく実行する操作をアプリケーションがシミュレートできるようにします。

API関数名

機能

AIT_IMEGetOpenStatus

IMEがオープンステータスを取得します。

AIT_IMESetOpenStatus

IMEがオープンステータスを設定します。

AIT_IMEGetConversionStatus

IMEが変換ステータスを取得します。

AIT_IMESetConversionStatus

IMEが変換ステータスを設定します

AIT_IMEGetStatusWindowPos

IMEがステータスウィンドウの位置を取得します。

AIT_IMESetStatusWindowPos

IMEがステータスウィンドウの位置を設定します。

AIT_IMEGetProperty

IMEがプロパティを取得します。

AIT_IMESimulateHotKey

IMEがホットキーをシミュレートします。

19.1.6　文字列操作

次のAPIは、部分文字列処理、切り取り処理、ASCIIコードへの変換など、文字列処理をアプリケーションが実行できるようにします。

API関数名

機能

AIT_GetSubStr

文字列から指定した長さの文字列を返します。

AIT_FindSubStr

文字列を検索し、一致する最初の文字列の位置を返します。

AIT_StrLength

文字列の長さを取得します。

AIT_IsEmpty

文字列が空かどうかを確認します。

AIT_StrLTrim

文字列から左端文字を切り取ります。

AIT_StrRTrim

文字列から右端文字を切り取ります。

AIT_StrTrim

文字列から文字を切り取ります。

AIT_StrUpper

文字列を大文字に変換します。

AIT_StrLower

文字列を小文字に変換します。

AIT_StrLeft

文字列の左から指定した文字数を取得します。

AIT_StrRight

文字列の右から指定した文字数を取得します。

AIT_CharToASCII

文字をASCIIコードに変換します。

AIT_ASCIIToChar

ASCIIコードから文字に変換します。

19.1.7　メッセージ操作

次のAPIは、新規のウィンドウメッセージを記録し、ほかのウィンドウにメッセージを記入します。

API関数名

機能

AIT_RegisterWindowMessage

ウィンドウメッセージを記録します。

AIT_PostMessage

メッセージを記入します。

19.1.8　レジストリ操作

次のAPIは、レジストリキーの作成、キー値の照会、キーの削除など、アプリケーションがレジストリを処理できるようにします。

API関数名

機能

AIT_RegCreateKey

レジストリキーを作成します。

AIT_RegDeleteKey

レジストリキーを削除します。

AIT_RegDeleteValue

レジストリ値を削除します。

AIT_RegOpenKey

レジストリキーを開きます。

AIT_RegCloseKey

レジストリキーを閉じます。

AIT_RegGetStringValue

レジストリのstring値を取得します。

AIT_RegGetDWORDValue

レジストリのDWORD値を取得します。

AIT_RegSetStringValue

レジストリのstring値を設定します。

AIT_RegSetDWORDValue

レジストリのDWORD値を設定します。

AIT_RegKeyExists

レジストリキーが存在するかどうかを確認します。

AIT_RegValueExists

レジストリ値が存在するかどうかを確認します。

19.1.9　リダイレクト操作

次のAPIは、アプリケーションがレジストリパスまたはファイルパスにアクセスするモードを切り替えます。

API関数名

機能

AIT_Wow64DisableWow64Redirection

レジストリパス、またはファイルパスに64ビットとしてアクセスするモードに切り替えます。

AIT_Wow64RevertWow64Redirection

レジストリパス、またはファイルパスに32ビットとしてアクセスするモードに切り替えます。

19.1.10　ディレクトリ操作

次のAPIは、アプリケーションがディレクトリを作成、削除、およびコピーできるようにします。

API関数名

機能

AIT_DirCreate

ディレクトリを作成します。

AIT_DirRemove

現在のディレクトリを削除します。

AIT_DirCopy

ディレクトリをコピーします。

AIT_SetCurrentDirectory

現在のディレクトリを設定します。

AIT_GetCurrentDirectory

現在のディレクトリを取得します。

19.1.11　ファイル操作

次のAPIは、アプリケーションがファイルを作成、コピー、削除およびリネームできるようにします。

API関数名

機能

AIT_FileOpen

ファイルを開くか作成します。

AIT_FileClose

ファイルを閉じます。

AIT_FileGetLine

ファイルからデータを取得します。

AIT_FilePutLine

ファイルにデータを書き込みます。

AIT_FileGetPos

ファイルポインタの位置を取得します。

AIT_FileSetPos

ファイルポインタの位置を設定します。

AIT_FileEOF

ファイルの終わりであるかをチェックします。

AIT_FileSize

ファイルのサイズを取得します。

AIT_FileCopy

ファイルをコピーします。

AIT_FileDelete

ファイルを削除します。

AIT_FileExists

ファイルの存在をチェックします。

AIT_FileRename

ファイルをリネームします。

AIT_ChangeFileAttribute

ファイルの属性を変更します。

AIT_FindFirstFile

初めのファイルを検索します。

AIT_FindNextFile

次のファイルを検索します。

AIT_FindCloseFile

検索ハンドルを閉じます。

19.1.12　INIファイル操作

次のAPIは、セクションでのキー値を取得する、セクションのすべての内容を取得するなどの初期化（INI）ファイル処理をアプリケーションが実行できるようにします。

API関数名

機能

AIT_GetProfileString

プロファイルstringを取得します。

AIT_SetProfileString

プロファイルstringを設定します。

AIT_GetProfileFirstSection

最初のセクションを取得します。

AIT_GetProfileNextSection

次のプロファイルセクションを取得します。

AIT_GetProfileFirstSectionNames

最初のセクション名を取得します。

AIT_GetProfileNextSectionNames

次のセクション名を取得します。

19.1.13　レコーダ操作

次のAPIは、自動インストールに使うAITファイルを作成するための各種APIです。

API関数名

機能

AIT_Sleep

指定した期間、AITファイルの実行を中断します。

AIT_SetDefaultWaitTimeout

デフォルトの待機タイムアウト時間を設定します。

AIT_Exec

指定した処理を実行します。

AIT_ExecCommand

指定したMS-DOSコマンドまたはシステムコマンドを実行します。

AIT_PlayKey

アクティブなウィンドウへキーボード入力情報を送信します。

19.1.14　タスクバー操作

次のAPIは、タスクバー中の項目に対するクリックや、タスクバーがフォーカスを持っているかの確認などの、タスクバーに関する操作をするためのAPIです。

API関数名

機能

AIT_TaskbarClk

シングルクリックと同等の働きをするマウスボタンを、タスクバーの空いている場所に設定します。

AIT_TaskbarHasFocus

タスクバーが入力フォーカスを持っているかどうかをチェックします。

AIT_TaskbarSetFocus

タスクバーに入力フォーカスを設定します。

19.1.15　ユティリティ操作

次のAPIは、メッセージボックスやステータスボックスの表示、OSタイプの取得などをアプリケーションが処理できるようにするユティリティAPIです。

API関数名

機能

AIT_MessageBox

メッセージボックスを表示します。

AIT_StatusBox

ステータスボックスを表示します。

AIT_StatusBoxClose

ステータスボックスを閉じます。

AIT_GetEnv

環境変数の内容を取得します。

AIT_GetLastError

最後に発生したエラーを取得します。

AIT_GetErrorText

エラーメッセージを取得します。

AIT_InitLog

ログファイルを初期化します。

AIT_LogMessage

ログファイルにメッセージを記録します。

AIT_Exit

AITファイルの処理を終了します。

AIT_GetOSType

OSタイプを取得します。

19.1.16　JP1/IT Desktop Management 2とのインターフェース

次のAPIは、JP1/IT Desktop Management 2とのインターフェースを使用できるようにするAPIです。

API関数名

機能

AIT_DMPSTRC

JP1/IT Desktop Management 2に固有のグローバル変数を設定します。

JP1/IT Desktop Management 2でAITファイルを使用したリモートインストールを実行する場合は、必ず指定します。

19.2　APIの詳細

ここでは、各APIの詳細を説明します。

APIの説明形式

APIは、基本的には次に示す形式で説明しています。各APIは、API名のアルファベット順に並んでいます。

機能

APIの機能を示しています。

形式

APIの記述形式を示しています。

[ ]で囲まれた引数は省略できます。省略した場合は、デフォルト値が設定されます。これらの引数は常にAPIの最後の引数となります。

（例1）

bool AIT_SelectListItem ( strCaption, nCtrlType, strItemText [, fTimeOut] );

上記のAPIでは、fTimeOutは関数呼び出し時に指定する必要はありません。

（例2）

AIT_SelectListItem ( "Countries" LISTBOX_CTRL, "Japan" );
integer AIT_MessageBox ( strMessage, strTitle [, nIconType] [, nMsgBoxType] );

上記のAPIでは、nIconTypeとnMsgBoxTypeの両方を省略して次のように呼び出せます。

AIT_MessageBox( "Hello World","Error");

nMsgBoxTypeを指定してnIconTypeを指定したくない場合、nIconTypeのデフォルト値が設定されます。

AIT_MessageBox( "Hello World","Error", MB_ICONEXCLAMATION );

引数

APIで指定できる引数を示しています。入力用の引数の場合は（入力用）、出力用の引数の場合は（出力用）、入力用で省略できる場合は（入力用、省略可）と示しています。

戻り値

APIの戻り値を示しています。

APIが実行中に処理を失敗した場合のためにエラーコードが設定されています。このエラーコードはAIT_GetLastErrorというAPIを使用して取得できます。ユーザが特殊なコードのために特殊なエラー処理を必要とする場合は、APIが正常に実行されたか失敗したかをチェックしたあとで、AITファイルによって適切に扱うことになります。

ランタイムエラーが発生した場合、AITファイル内のERRORセクションが自動的に実行されます。

注意事項

API実行時の注意事項がある場合に記載しています。

AIT_ASCIIToChar

機能

指定したASCIIコードを文字に変換します。

形式

string AIT_ASCIIToChar  (
  integer nASCIIValue     // ASCIIコード
);

引数

nASCIIValue（入力用）

ASCIIコードを指定してください。

戻り値

ASCIIコードに対応する文字が返されます。

AIT_ChangeFileAttribute

機能

指定したファイルまたはディレクトリの属性を変更します。

形式

bool AIT_ChangeFileAttribute  (
  string strFileName,     // ファイル名
  integer nFileAttributes // ファイル属性
);

引数

strFileName（入力用）

ファイル名を指定してください。ディレクトリを指定することもできます。

nFileAttributes（入力用）

変更後の属性を指定してください。入力に使用できる値については、「AIT_FileExists」を参照してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得してください。

関数が正常に実行されなかった場合にAIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

18

ERROR_NO_MORE_FILES

21

ERROR_NOT_READY

53

ERROR_BAD_NETPATH

87

ERROR_INVALID_PARAMETER

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

183

ERROR_ALREADY_EXISTS

206

ERROR_FILENAME_EXCED_RANGE

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

AIT_CharToASCII

機能

指定した文字をASCIIコードに変換します。

形式

integer AIT_CharToASCII (
  string strStrName     // 1文字以上の文字列
);

引数

strStrName（入力用）

文字列名を指定してください。

戻り値

最初の文字のASCIIコードが返されます。

AIT_CheckResolution

機能

指定した解像度が現在の画面の解像度と合っているかどうかをチェックします。

形式

integer AIT_CheckResolution  (
  integer nWidth,     // チェックする画面の幅
  integer nHeight     // チェックする画面の高さ
);

引数

nWidth（入力用）

プライマリディスプレイモニタの画面でチェックする幅をピクセル単位で指定してください。

nHeight（入力用）

プライマリディスプレイモニタの画面でチェックする高さをピクセル単位で指定してください。

戻り値

指定した解像度が現在の解像度と一致する場合、戻り値は1です。指定した解像度が現在の解像度と一致しない場合、戻り値は0です。失敗した場合、戻り値は-1です。-1が返された場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

AIT_ComboBoxCloseUp

機能

コンボボックスのクローズアップをシミュレートします。

形式

bool AIT_ComboBoxCloseUp  (
  string strCaption    // コントロールのキャプション
  [,float fTimeOut]    // タイムアウト時間
);
bool AIT_ComboBoxCloseUp  (
  integer nCtrlID     // コントロールID
  [,float fTimeOut]   // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

fTimeOut（入力用、省略可）

コントロールが戻らなかった場合に再試行するためのタイムアウト値を秒単位で指定してください。この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_ComboBoxDropDown

機能

コンボボックスのドロップダウンをシミュレートします。

形式

bool AIT_ComboBoxDropDown  (
  string strCaption       // コントロールのキャプション
  [,float fTimeOut]       // タイムアウト時間
);
bool AIT_ComboBoxDropDown  (
  integer nCtrlID         // コントロールID
  [,float fTimeOut]       // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_CtrlClick

機能

アクティブなウィンドウの特定のコントロールでマウスをクリックします。

形式

bool AIT_CtrlClick  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nMouseButton   // マウスボタン
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_CtrlClick  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  integer nMouseButton   // マウスボタン
  [,float fTimeOut]      // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストコントロールです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

nMouseButton（入力用、省略可）

マウスでクリックするボタンを指定してください。次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTON

中央マウスボタン

RBUTTON

右マウスボタン

省略した場合は、LBUTTONがデフォルト値として使用されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_CtrlItemCount

機能

アクティブなウィンドウの特定のコントロールで、項目数を取得します。

形式

bool AIT_CtrlItemCount  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nItemCount     // 項目数
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_CtrlItemCount  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  integer nItemCount     // 項目のカウント
  [,float fTimeOut]      // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

nItemCount（出力用）

コントロール内の項目数を受け取る変数を指定してください。関数から制御が戻ると、この変数に項目数が格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_CtrlItemIndex

機能

アクティブなウィンドウの特定のコントロールで、項目テキストのインデックスを取得します。

形式

bool AIT_CtrlItemIndex  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  string strItemText,    // 項目テキスト
  integer nIndex         // 項目インデックス
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_CtrlItemIndex  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  string strItemText,    // 項目のテキスト
  integer nIndex         // 項目のインデックス
  [,float fTimeOut]      // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

strItemText（入力用）

インデックスを取得するための項目テキストを指定してください。

nIndex（出力用）

テキストのインデックスを受け取る変数を指定してください。関数から制御が戻ると、この変数に項目テキストのインデックスが格納されます。インデックスの基準値は0です。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1413

ERROR_INVALID_INDEX

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_CtrlSetFocus

機能

特定のコントロールにフォーカスを設定します。

形式

bool AIT_CtrlSetFocus (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType      // コントロールタイプ
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_CtrlSetFocus (
  integer nCtrlID,       // コントロールID
  integer nCtrlType      // コントロールタイプ
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_CtrlSetFocus (
  integer nIndex         // コントロールのインデックス
  [,float fTimeOut]        // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

nIndex（入力可）

コントロールのタブオーダーを指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_DefaultButtonCount

機能

アクティブなウィンドウの、デフォルトボタンを持つコマンドボタンの数を取得します。

形式

integer AIT_DefaultButtonCount ();

引数

なし

戻り値

関数が正常に処理された場合、戻り値はデフォルトボタンを持つコマンドボタンの数です。そのほかの場合、戻り値はfalseです。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

112

ERROR_DISK_FULL

1460

ERROR_TIMEOUT

AIT_DirCopy

機能

ディレクトリをほかの場所にコピーします。コピー先ディレクトリがすでに存在する場合は、そのディレクトリが上書きされます。

形式

bool AIT_DirCopy  (
  string strSourceDirName,     // コピー元ディレクトリ名
  string strTargetDirName      // コピー先ディレクトリ名
);

引数

strSourceDirName（入力用）

コピー元ディレクトリ名を指定してください。

strTargetDirName（入力用）

コピー先ディレクトリ名を指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

266

ERROR_CANNOT_COPY

AIT_DirCreate

機能

新規ディレクトリを作成します。

形式

bool AIT_DirCreate  (
  string strDirName    // ディレクトリ名
);

引数

strDirName（入力用）

作成するディレクトリ名を指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

19

ERROR_WRITE_PROTECT

21

ERROR_NOT_READY

23

ERROR_CRC

53

ERROR_BAD_NETPATH

64

ERROR_NETNAME_DELETED

82

ERROR_CANNOT_MAKE

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

183

ERROR_ALREADY_EXISTS

206

ERROR_FILENAME_EXCED_RANGE

267

ERROR_DIRECTORY

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_DirRemove

機能

既存のディレクトリを削除します。

形式

bool AIT_DirRemove  (
  string strDirName    // ディレクトリ名
);

引数

strDirName（入力用）

ディレクトリ名を指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

16

ERROR_CURRENT_DIRECTORY

87

ERROR_INVALID_PARAMETER

AIT_DMPSTRC

機能

JP1/IT Desktop Management 2に固有のグローバル変数を設定します。JP1/IT Desktop Management 2でAITファイルを使用したリモートインストールを実行する場合は、必ず指定してください。

このAPIは、AITファイルでインストールプログラムを起動する前に呼び出されます。

形式

bool AIT_DMPSTRC ();

引数

なし

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

21

ERROR_NOT_READY

38

ERROR_HANDLE_EOF

53

ERROR_BAD_NETPATH

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

206

ERROR_FILENAME_EXCED_RANGE

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_Exec

機能

指定したアプリケーションファイルを実行します。

形式

bool AIT_Exec  (
  string strExeName,     // アプリケーションファイルの名前
  integer nShowState     // 表示状態
);

引数

strExeName（入力用）

アプリケーションファイルの名前を指定してください。

nShowState（入力用）

アプリケーションの表示方法を指定してください。次のどれかにする必要があります。

値

意味

SW_HIDE

アプリケーションを非表示にします。

SW_SHOWNORMAL

or

SW_NORMAL

アプリケーションを通常の状態で表示します。

SW_SHOWMINIMIZED

アプリケーションを最小化します。

SW_SHOWMAXIMIZED

or

SW_MAXIMIZE

アプリケーションを最大化します。

SW_SHOWNOACTIVATE

アプリケーションをフォーカスなしで通常の状態で表示します。

SW_SHOWMINNOACTIVE

アプリケーションをフォーカスなしで最小化します。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

21

ERROR_NOT_READY

87

ERROR_INVALID_PARAMETER

123

ERROR_INVALID_NAME

AIT_ExecCommand

機能

MS-DOSコマンドまたはシステムコマンドを実行します。

形式

bool AIT_ExecCommand  (
  string strCommandName     // MS-DOSコマンド
);

引数

strCommandName（入力用）

アプリケーションファイルの名前またはシステムコマンドを指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

21

ERROR_NOT_READY

87

ERROR_INVALID_PARAMETER

123

ERROR_INVALID_NAME

AIT_ExistWindow

機能

指定したウィンドウ名およびクラス名と一致するウィンドウがあるかどうかをチェックします。

形式

integer AIT_ExistWindow  (
  string strWndCaption,     // ウィンドウのキャプション
  string strClassName       // クラス名
  [,float fTimeOut]         // タイムアウト時間
);

引数

strWndCaption（入力用）

ウィンドウのキャプションを指定してください。

strClassName（入力用）

ウィンドウのクラス名を指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

ウィンドウが存在する場合、戻り値は1です。ウィンドウが存在しない場合、戻り値は0です。失敗した場合、戻り値は-1です。-1が返された場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

AIT_Exit

機能

AITファイルの実行を終了します。

形式

AIT_Exit ();

引数

なし

戻り値

なし

AIT_FileClose

機能

ファイルハンドルを閉じます。

形式

bool AIT_FileClose  (
  integer nFileHandle     // ファイルハンドル
);

引数

nFileHandle（入力用）

AIT_FileOpen関数を使って開いたファイルハンドルを指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

4

ERROR_TOO_MANY_OPEN_FILES

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

AIT_FileCopy

機能

コピー元ファイルをコピー先ファイルにコピーします。コピー先に同じファイルがすでに存在する場合は、そのファイルが上書きされます。

形式

bool AIT_FileCopy  (
  string strSourceFileName,     // コピー元のファイル名
  string strTargetFileName      // コピー先のファイル名
);

引数

strSourceFileName（入力用）

コピー元のファイルの名前を指定してください。ワイルドカード（*）も使用できます。

strTargetFileName（入力用）

コピー先ファイルまたはディレクトリの名前を指定してください。ワイルドカードは使用できません。コピー先ディレクトリが存在しない場合は、ディレクトリが作成されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

87

ERROR_INVALID_PARAMETER

117

ERROR_INVALID_CATEGORY

AIT_FileDelete

機能

指定したファイルを削除します。

形式

bool AIT_FileDelete  (
  string strFileName     // ファイル名
);

引数

strFileName（入力用）

削除するファイルの名前を指定してください。ワイルドカード（*）も使用できます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

19

ERROR_WRITE_PROTECT

21

ERROR_NOT_READY

53

ERROR_BAD_NETPATH

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_FileEOF

機能

ファイルポインタがファイルの終わりに到達したかどうかを確認します。

形式

integer AIT_FileEOF (
  integer nFileHandle     // ファイルハンドル
);

引数

nFileHandle（入力用）

ファイルハンドルを指定してください。

戻り値

EOFの場合、戻り値は1です。EOFではない場合、戻り値は0です。失敗した場合、戻り値は-1です。-1が返された場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

AIT_FileExists

機能

指定した属性でファイルが存在するかどうかを確認します。

形式

integer AIT_FileExists  (
  string strFileName            // ファイル名
  [,integer nFileAttributes]    // ファイル属性
);

引数

strFileName（入力用）

検索するファイルの名前を指定してください。

nFileAttributes（入力用、省略可）

ファイルの属性を指定してください。これは、次の値のどれかにする必要があります。

値

意味

FILE_ATTRIBUTE_DIRECTORY

ファイルはディレクトリです。

FILE_ATTRIBUTE_HIDDEN

ファイルは隠しファイルです。

FILE_ATTRIBUTE_SYSTEM

ファイルはOSの一部、またはOS専用です。

FILE_ATTRIBUTE_ARCHIVE

ファイルはアーカイブファイルです。アプリケーションはこの属性を、ファイルのバックアップや削除のためのマークとして使います。

FILE_ATTRIBUTE_READONLY

ファイルは読み取り専用です。アプリケーションはファイルを読み取れますが、書き込みや削除はできません。

省略した場合は、ファイル属性とは無関係にファイルが検出されます。

戻り値

ファイルが存在する場合、戻り値は1です。ファイルが存在しない場合、戻り値は0です。失敗した場合、戻り値は-1です。-1が返された場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

21

ERROR_NOT_READY

53

ERROR_BAD_NETPATH

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

998

ERROR_NOACCESS

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_FileGetLine

機能

指定したファイルから、データを読み取ります。

形式

bool AIT_FileGetLine  (
  integer nFileHandle,    // ファイルハンドル
  string strReadData      // ファイルから読み取るデータ
);

引数

nFileHandle（入力用）

ファイルハンドルを指定してください。

strReadData（出力用）

ファイルから読み取るデータを受け取る変数を指定してください。関数から制御が戻ると、この変数にデータが格納されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

38

ERROR_HANDLE_EOF

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

AIT_FileGetPos

機能

ファイルポインタの現在位置を取得します。

形式

bool AIT_FileGetPos  (
  integer nFileHandle,    // ファイルハンドル
  integer nFilePos        // 現在のファイルポインタ位置
);

引数

nFileHandle（入力用）

ファイルハンドルを指定してください。

nFilePos（出力用）

現在のファイルポインタの位置を受け取る変数を指定してください。関数から制御が戻ると、この変数にポインタ位置が格納されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

38

ERROR_HANDLE_EOF

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

AIT_FileOpen

機能

既存のファイルを開きます。または、指定したアクセスモードで新規ファイルを作成します。

形式

bool AIT_FileOpen  (
  string strFileName,     // ファイル名
  integer nAccessMode,    // アクセスモード
  integer nOperation,     // 作成方法
  integer nFileHandle     // ファイルハンドル
);

引数

strFileName（入力用）

作成するファイルまたは開くファイルの名前を指定してください。

nAccessMode（入力用）

ファイルへのアクセスモードを指定してください。これは、次の値のどれかまたは両方の組み合わせです。

値

意味

GENERIC_READ

ファイルへの読み取りアクセスを指定します。ファイルからのデータの読み取りとファイルポインタの移動ができます。読み取り/書き込みアクセスを指定するには、GENERIC_WRITEと組み合わせてください。

GENERIC_WRITE

ファイルへの書き込みアクセスを指定します。ファイルへのデータの書き込みとファイルポインタの移動ができます。読み取り/書き込みアクセスを指定するには、GENERIC_READと組み合わせてください。

nOperation（入力用）

ファイルが存在する場合、または存在しない場合のファイルの扱い方を指定します。次の値のどれかにする必要があります。

値

意味

CREATE_NEW

新規ファイルを作成します。指定したファイルがすでに存在する場合、関数は失敗します。

CREATE_ALWAYS

新規ファイルを作成します。指定したファイルがすでに存在する場合、関数はそのファイルを上書きします。

OPEN_EXISTING

ファイルを開きます。ファイルが存在しない場合、関数は失敗します。

OPEN_ALWAYS

ファイルが存在する場合は、それを開きます。ファイルが存在しない場合は、そのファイルが作成されます。

TRUNCATE_EXISTING

ファイルを開きます。開かれたファイルは、サイズが0バイトになるように切り捨てられます。呼び出しプロセスで、少なくともGENERIC_WRITEアクセスを指定してファイルを開く必要があります。ファイルが存在しない場合、関数は失敗します。

nFileHandle（出力用）

ファイルハンドルを受け取る変数を指定してください。関数から制御が戻ると、この変数にファイルハンドルが格納されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

4

ERROR_TOO_MANY_OPEN_FILES

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

18

ERROR_NO_MORE_FILES

19

ERROR_WRITE_PROTECT

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

53

ERROR_BAD_NETPATH

80

ERROR_FILE_EXISTS

82

ERROR_CANNOT_MAKE

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

183

ERROR_ALREADY_EXISTS

206

ERROR_FILENAME_EXCED_RANGE

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

注意事項

AIT_OpenFileが返したファイルハンドルを閉じるには、AIT_FileClose関数を使用してください。

AIT_FilePutLine

機能

指定したファイルに、データを書き込みます。

形式

bool AIT_FilePutLine  (
  integer nFileHandle,     // ファイルハンドル
  string strWriteData      // ファイルに書き込むデータ
);

引数

nFileHandle（入力用）

ファイルハンドルを指定してください。

strWriteData（入力用）

ファイルに書き込むデータを指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

19

ERROR_WRITE_PROTECT

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

38

ERROR_HANDLE_EOF

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

注意事項

0バイトの書き込みを指定すると、null書き込み操作の指定として解釈されます。

AIT_FilePutLineは、現在のファイルポインタ位置にデータを書き込みます。ファイルポインタ位置は、書き込み操作後に更新されます。

AIT_FileRename

機能

ファイルまたはディレクトリの名前を変更します。

形式

bool AIT_FileRename (
  string strFileName,       // 現在のファイル名
  string strNewFileName     // 新しいファイル名
);

引数

strFileName（入力用）

名前を変更するファイルまたはディレクトリの名前を指定してください。

strNewFileName（入力用）

ファイルまたはディレクトリの新しい名前を指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

19

ERROR_WRITE_PROTECT

21

ERROR_NOT_READY

38

ERROR_HANDLE_EOF

53

ERROR_BAD_NETPATH

80

ERROR_FILE_EXISTS

82

ERROR_CANNOT_MAKE

87

ERROR_INVALID_PARAMETER

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_FileSetPos

機能

ファイルポインタを指定した位置に設定します。

形式

bool AIT_FileSetPos  (
  integer nFileHandle,     // ファイルハンドル
  integer nSetPos          // 設定後のファイルポインタの位置
);

引数

nFileHandle（入力用）

ファイルハンドルを指定してください。

nSetPos（入力用）

設定後のファイルポインタの位置を指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

19

ERROR_WRITE_PROTECT

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

38

ERROR_HANDLE_EOF

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

注意事項

nFileHandle引数の値で示すファイルポインタは、重複する読み取り操作や書き込み操作に使用しないでください。

設定後のファイルポインタの位置に0を指定してこの関数を実行すると、現在のファイルポインタ位置が保持されます。

AIT_FileSize

機能

ファイルのサイズを取得します。

形式

bool AIT_FileSize  (
  integer nFileHandle,     // ファイルハンドル
  integer nFileSize        // ファイルサイズ
);

引数

nFileHandle（入力用）

ファイルハンドルを指定してください。

nFileSize（出力用）

ファイルサイズを受け取る変数を指定してください。関数から制御が戻ると、この変数にファイルサイズが格納されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

21

ERROR_NOT_READY

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

38

ERROR_HANDLE_EOF

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

注意事項

AIT_FileSize関数は、圧縮されていないファイルサイズを取得します。

AIT_FindCloseFile

機能

AIT_FindFirstFile関数によって返されたファイル検索ハンドルを閉じます。

形式

bool AIT_FindCloseFile  (
  integer nSearchHandle     // ファイル検索ハンドル
);

引数

nSearchHandle（入力用）

AIT_FindFirstFile関数によって返されたファイルの検索ハンドルを指定してください。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

112

ERROR_DISK_FULL

注意事項

AIT_FindClose関数の呼び出し後、nSearchHandle引数で指定したハンドルを、AIT_FindNextFile関数またはAIT_FindCloseFile関数への後続の呼び出しに使用することはできません。

AIT_FindFirstFile

機能

ファイル検索ハンドルを開いて、指定したファイル名と名前が一致する最初のファイル名を返します。

形式

bool AIT_FindFirstFile  (
  string strFileNamePattern,    // ファイル名
  string strFileName,           // 検索されたファイル名
  integer nSearchHandle         // ファイル検索ハンドル
);

引数

strFileNamePattern（入力用）

有効なディレクトリの名前、パスまたはファイル名を指定してください。ワイルドカード（*）も使用できます。文字列がワイルドカード、ピリオド、またはディレクトリ名で終わる場合、ユーザはルートまたはパス上のすべてのサブディレクトリへのアクセス権を持っている必要があります。

strFileName（出力用）

指定したファイル名と一致する、検索されたファイルの名前を受け取る変数を指定してください。関数から制御が戻ると、この変数に検索されたファイルの名前が格納されます。

nSearchHandle（出力用）

AIT_FindNextFileおよびAIT_FindCloseFileへの後続の検索で使用するファイル検索ハンドルを受け取る変数を指定してください。関数から制御が戻ると、この変数にファイル検索ハンドルが格納されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

18

ERROR_NO_MORE_FILES

21

ERROR_NOT_READY

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

注意事項

この関数は、ファイルを名前だけで検索します。属性での検索には使用できません。後続の「¥」の有無に関係なく、ルートディレクトリをAIT_FindFirstFileのstrFileName入力文字列として指定することはできません。

AIT_FindFirstFileによって返されたファイル検索ハンドルを閉じるには、AIT_FindCloseFileを使用してください。

AIT_FindNextFile

機能

AIT_FindFirstFile関数によって返された検索ハンドルで、次のファイルを検索します。

形式

bool AIT_FindNextFile  (
  integer nSearchHandle,     // ファイル検索ハンドル
  string strFileName         // 検索されたファイル名
);

引数

nSearchHandle（入力用）

AIT_FindFirstFileへの前の呼び出しによって返されたファイル検索ハンドルを指定してください。

strFileName（出力用）

検索されたファイルの名前を受け取る変数を指定してください。関数から制御が戻ると、この変数に検索されたファイルの名前が格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

18

ERROR_NO_MORE_FILES

21

ERROR_NOT_READY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

148

ERROR_PATH_BUSY

1231

ERROR_NETWORK_UNREACHABLE

注意事項

この関数は、ファイルを名前だけで検索します。属性ベースの検索には使用できません。

AIT_FindSubStr

機能

指定した検索文字列を、文字列内のnStartPosで指定した位置から検索し、一致する最初の文字列の位置を返します。

形式

integer AIT_FindSubStr  (
  string strStrName,      // 文字列
  string strSearchStr     // 検索文字列
  [,integer nStartPos]    // 検索を始める文字の位置
);

引数

strStrName（入力用）

文字列を指定してください。

strSearchStr（入力用）

検索対象文字列を指定してください。

nStartPos（入力用、省略可）

文字列の検索を始める位置を指定してください。nStartPosの基準値は0で、0の位置は文字列の最初の文字に対応します。省略した場合は、最初の文字から検索します。

戻り値

検索対象文字列の最初の文字につき基準値0のインデックスを返します。文字列が含まれない場合とヌル文字列が指定されている場合は-1を返します。

AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

AIT_FocusWindow

機能

指定したウィンドウ名とクラス名を持つウィンドウハンドルを取得して、フォーカスを設定します。

形式

integer AIT_FocusWindow  (
  string strWndCaption,     // ウィンドウのキャプション
  string strClassName       // クラス名
  [,float fTimeOut]         // タイムアウト時間
);

引数

strWndCaption（入力用）

ウィンドウのキャプションを指定してください。

strClassName（入力用）

ウィンドウのクラス名を指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合のウィンドウハンドルが戻り値となり、処理が失敗した場合の戻り値は0となります。関数が0を返した場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

strWndCaptionに空の文字列を指定すると、空白のキャプションが付いたウィンドウを検索します。空白のキャプションが付いたウィンドウが複数ある場合は、最初に発見されたウィンドウにフォーカスを設定します。

AIT_GetCtrlText

機能

アクティブなウィンドウの特定のコントロールからテキストを取得します。

形式

bool AIT_GetCtrlText  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  string strCtrlText     // コントロールのテキスト
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_GetCtrlText  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  string strCtrlText    // コントロールのテキスト
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストコントロールです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

strCtrlText（出力用）

コントロールのテキストを受け取る変数を指定してください。関数から制御が戻ると、この変数にテキストが格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

エディットボックスについては、エディットボックスの内容のテキストを取得します。スタティックテキストとボタンについては、コントロールのキャプションを取得します。そのほかのコントロールについては、その時点で選択されている項目をテキストとして取得します。

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetCtrlTextLen

機能

アクティブなウィンドウの特定のコントロールからテキストの長さを取得します。

形式

bool AIT_GetCtrlTextLen  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nTextLen       // コントロールテキストの長さ
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_GetCtrlTextLen  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  integer nTextLen      // コントロールテキストの長さ
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

nTextLen（出力用）

コントロールテキストの長さを受け取る変数を指定してください。関数から制御が戻ると、この変数にテキストの長さが格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetCurrentDirectory

機能

カレントディレクトリを取得します。

形式

bool AIT_GetCurrentDirectory  (
  string strDirName      // ディレクトリ名
);

引数

strDirName（出力用）

ディレクトリ名を受け取る変数を指定してください。関数から制御が戻ると、この変数にディレクトリ名が格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

AIT_GetDate

機能

システムの日付を短い形式で取得します。

形式

string AIT_GetDate ();

引数

なし

戻り値

システムの日付を短い形式で文字列として返します。

AIT_GetDtPickerDate

機能

日時ピッカーから日付を取得します。

形式

bool AIT_GetDtPickerDate  (
  string strCaption,     // コントロールのキャプション
  string strOutDate      // コントロールの日付
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_GetDtPickerDate  (
  string strCaption,    // コントロールのキャプション
  integer nYear,        // 年
  integer nMonth,       // 月
  integer nDay          // 日
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_GetDtPickerDate  (
  integer nCtrlID,      // コントロールID
  string strOutDate     // コントロールの日付
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_GetDtPickerDate  (
  integer nCtrlID,     // コントロールID
  integer nYear,       // 年
  integer nMonth,      // 月
  integer nDay         // 日
  [,float fTimeOut]    // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

strOutDate（出力用）

コントロールの日付の値を受け取る変数を設定してください。関数から制御が戻ると、この変数に日付が格納されます。日付の値はYYYY/MM/DDという形式になり、YYYYが年、MMが月、DDが日を表します。

nYear（出力用）

コントロールの年の値を受け取る変数を指定してください。関数から制御が戻ると、この変数に年が格納されます。

nMonth（出力用）

コントロールの月の値を受け取る変数を指定してください。関数から制御が戻ると、この変数に月が格納されます。

nDay（出力用）

コントロールの日の値を受け取る変数を指定してください。関数から制御が戻ると、この変数に日が格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetDtPickerTime

機能

日時ピッカーの時間を取得します。

形式

bool AIT_GetDtPickerTime  (
  string strCaption,    // コントロールのキャプション
  string strOutTime     // コントロールの時間
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_GetDtPickerTime  (
  string strCaption,    // コントロールID
  integer nHour,        // 時間
  integer nMinute,      // 分
  integer nSecond       // 秒
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_GetDtPickerTime  (
  integer nCtrlID,      // コントロールID
  string strOutTime     // コントロールの時間
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_SetDtPickerTime  (
  integer nCtrlID,      // コントロールID
  integer nHour,        // 時間
  integer nMinute,      // 分
  integer nSecond       // 秒
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

strOutTime（出力用）

コントロールの時刻の値を受け取る変数を設定してください。関数から制御が戻ると、この変数に時間が格納されます。時間の値はhh:mm:ssという形式になり、hhが時間、mmが分、ssが秒を表します。

nHour（出力用）

コントロールの時間の値を受け取る変数を指定してください。関数から制御が戻ると、この変数に時間が格納されます。

nMinute（出力用）

コントロールの分の値を受け取る変数を指定してください。関数から制御が戻ると、この変数に分が格納されます。

nSecond（出力用）

コントロールの秒の値を受け取る変数を指定してください。関数から制御が戻ると、この変数に秒が格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetEditCurrentLineIndex

機能

複数行のエディットボックスの、カレント行のインデックスを取得します。カレント行とは、入力位置が設定されている行を指します。

形式

bool AIT_GetEditCurrentLineIndex  (
  string strCaption,   // コントロールのキャプション
  integer nIndex       // カレント行のインデックス
  [,float fTimeOut]    // タイムアウト時間
);
bool AIT_GetEditCurrentLineIndex  (
  integer nCtrlID,     // コントロールID
  integer nIndex       // カレント行のインデックス
  [,float fTimeOut]    // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nIndex（出力用）

カレント行のインデックスを受け取る変数を指定してください。関数から制御が戻ると、この変数にカレント行のインデックスが格納されます。インデックスの基準値は0です。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetEditFirstLineIndex

機能

複数行のエディットボックスに表示される最初の行、または単一行のエディットボックスに表示される最初の文字のインデックスを取得します。

形式

bool AIT_GetEditFirstLineIndex  (
  string strCaption,      // コントロールのキャプション
  integer nFirstVisible   // 最初の行または文字のインデックス
  [,float fTimeOut]       // タイムアウト時間
);
bool AIT_GetEditFirstLineIndex  (
  integer nCtrlID,        // コントロールID
  integer nFirstVisible   // 最初の行または文字のインデックス
  [,float fTimeOut]       // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nFirstVisible（出力用）

最初の行または最初の文字の、インデックスの値を受け取る変数を指定してください。関数から制御が戻ると、この変数にインデックスが格納されます。インデックスの基準値は0です。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetEditTextLineLen

機能

アクティブなウィンドウの複数行のエディットボックスにある任意の行の長さを取得します。

形式

bool AIT_GetEditTextLineLen  (
  string strCaption,    // コントロールのキャプション
  integer nLineIndex,   // 行のインデックス
  integer nLineLength   // 行の長さ
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_GetEditTextLineLen  (
  integer nCtrlID,      // コントロールID
  integer nLineIndex,   // 行のインデックス
  integer nLineLength   // 行の長さ
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nLineIndex（入力用）

複数行のエディットボックスのインデックスを指定してください。インデックスの基準値は0です。

nLineLength（出力用）

nLineIndexで指定した行のインデックスの長さを受け取る変数を指定してください。関数から制御が戻ると、この変数に長さが格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetEnv

機能

指定した環境変数の内容を取得します。

形式

string AIT_GetEnv  (
  string strEnvVar     // 環境変数名
);

引数

strEnvVar（入力用）

環境変数名を指定してください。

戻り値

環境変数の内容を返します。

AIT_GetErrorText

機能

指定したエラーコードに対応するシステムエラーテキストを取得します。

形式

string AIT_GetErrorText  (
  integer nErrorCode     // エラーコード
);

引数

nErrorCode（入力用）

AIT_GetLastError関数が返したエラーコードを指定してください。

戻り値

指定したエラーコードに対応するエラーメッセージを返します。

AIT_GetIndexText

機能

アクティブなウィンドウの特定のコントロールから、インデックスで指定した項目テキストを取得します。

形式

bool AIT_GetIndexText  (
  string strCaption,    // コントロールのキャプション
  integer nCtrlType,    // コントロールタイプ
  integer nIndex,       // インデックス
  string strItemText    // 項目テキスト
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_GetIndexText  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  integer nIndex,       // インデックス
  string strItemText    // 項目テキスト
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

nIndex（入力用）

取得する項目テキストのインデックスを指定してください。インデックスの基準値は0です。

strItemText（出力用）

コントロール上で指定したインデックスの項目テキストを受け取る変数を指定してください。関数から制御が戻ると、この変数に項目テキストが格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1413

ERROR_INVALID_INDEX

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetIndexTextLen

機能

アクティブなウィンドウの特定のコントロールから、インデックスで指定した項目テキストの長さを取得します。

形式

bool AIT_GetIndexTextLen  (
  string strCaption,    // コントロールのキャプション
  integer nCtrlType,    // コントロールタイプ
  integer nIndex,       // インデックス
  integer nTextLen      // テキストの長さ
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_GetIndexTextLen  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  integer nIndex,       // インデックス
  integer nTextLen      // テキストの長さ
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

nIndex（入力用）

取得する項目テキストのインデックスを指定してください。インデックスの基準値は0です。

nTextLen（出力用）

コントロール上で指定したインデックスの、項目テキストの長さを受け取る変数を指定してください。関数から制御が戻ると、この変数に項目テキストの長さが格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_GetKeyState

機能

キー状態を取得します。

形式

int AIT_GetKeyState  (
  integer nVirtualKey    // 仮想キー
);

引数

nVirtualKey（入力用）

キー状態を取得する仮想キーコードを指定してください。

これは、次の値のどれかにする必要があります。

値

意味

NUMLOCK

［Num Lock］キー

SCROLLLOCK

［Scroll Lock］キー

CAPSLOCK

［Caps Lock］キー

戻り値

キー状態がオンの場合の戻り値は1、オフの場合は0となります。処理が失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

AIT_GetLastError

機能

直前に実行した関数の詳細コードを取得します。

形式

integer AIT_GetLastError ();

引数

なし

戻り値

詳細コードを返します。この詳細コードはランタイムエラーのコードと同じです。

AIT_GetMenu

機能

ウィンドウのメニューハンドルを取得するために使用します。

形式

bool AIT_GetMenu  (
  integer nWndHandle,    // ウィンドウハンドル
  integer nMenu          // メニューハンドル
  [,float fTimeOut]      // タイムアウト時間
);

引数

nWndHandle（入力用）

ウィンドウハンドルを指定してください。

nMenu（出力用）

メニューハンドルを受け取る変数を指定してください。関数から制御が戻ると、この変数にハンドルが格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

AIT_GetMenuIndex

機能

指定したメニュー項目のインデックスを取得します。

形式

bool AIT_GetMenuIndex  (
  integer nMenu,         // メニューハンドル
  string strMenuText,    // メニュー項目
  integer nIndex         // メニュー項目のインデックス
  [,float fTimeOut]      // タイムアウト時間
);

引数

nMenu（入力用）

メニューハンドルを指定してください。

strMenuText（入力用）

メニュー項目を指定してください。

nIndex（出力用）

メニュー項目のインデックスを受け取る変数を指定してください。関数から制御が戻ると、この変数にインデックスが格納されます。インデックスの基準値は0です。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、 AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

112

ERROR_DISK_FULL

1401

ERROR_INVALID_MENU_HANDLE

1460

ERROR_TIMEOUT

AIT_GetMenuText

機能

指定したメニュー項目を取得します。

形式

bool AIT_GetMenuText  (
  integer nMenu,        // メニューハンドル
  integer nIndex,       // メニュー項目のインデックス
  string strMenuText    // メニュー項目
  [,float fTimeOut]     // タイムアウト時間
);

引数

nMenu（入力用）

メニューハンドルを指定してください。

nIndex（入力用）

メニュー項目のインデックスを指定してください。インデックスの基準値は0です。

strMenuText（出力用）

メニュー項目を受け取る変数を指定してください。関数から制御が戻ると、この変数にメニュー項目が格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1401

ERROR_INVALID_MENU_HANDLE

1460

ERROR_TIMEOUT

AIT_GetOSType

機能

OSのメジャーバージョン、マイナーバージョンおよびプラットフォームIDを取得します。

形式

bool AIT_GetOSType  (
  integer nMajorVersion,    // OSのメジャーバージョン
  integer nMinorVersion,    // OSのマイナーバージョン
  integer nPlatformID       // プラットフォームID
);

引数

nMajorVersion（出力用）

OSのメジャーバージョンを受け取る変数を指定してください。関数から制御が戻ると、この変数に次のどれかの値が格納されます。

値

意味

5

Windows XP

5

Windows Server 2003

6

Windows Vista

6

Windows Server 2008

6

Windows 7

6

Windows Server 2012

6

Windows Server 2012 R2

6

Windows 8

6

Windows 8.1

10

Windows 10

10

Windows Server 2016

10

Windows Server 2019

nMinorVersion（出力用）

OSのマイナーバージョンを受け取る変数を指定してください。関数から制御が戻ると、この変数に次のどれかの値が格納されます。

値

意味

1

Windows XP

2

Windows Server 2003

0

Windows Vista

0

Windows Server 2008

1

Windows Server 2008 R2

1

Windows 7

2

Windows Server 2012

3

Windows Server 2012 R2

2

Windows 8

3

Windows 8.1

0

Windows 10

0

Windows Server 2016

0

Windows Server 2019

nPlatformID（出力用）

OSのプラットフォームIDを受け取る変数を指定してください。関数から制御が戻ると、この変数に次のどれかの値が格納されます。

値

意味

VER_PLATFORM_WIN32_NT

Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012 R2、Windows Server 2012、Windows 7、Windows Server 2008、Windows Vista、Windows Server 2003、またはWindows XP

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

122

ERROR_INSUFFICIENT_BUFFER

注意事項

アプリケーションがOSのどのバージョン上で稼働しているのかを確認する場合は、望ましいバージョン番号よりも大きい番号か同じ番号を使用してください。そうすると、より新しいバージョンのOSでも同じテストが実施できることがわかります。

AIT_GetProfileFirstSection

機能

指定したINIファイルのセクションから、最初のキーとキーの値を取得します。

形式

bool AIT_GetProfileFirstSection  (
  string strIniFileName,     // INIファイル名
  string strSectionName,     // INIファイルのセクション名
  string strValues           // セクションのデータ
);

引数

strIniFileName（入力用）

INIファイル名を指定してください。

strSectionName（入力用）

INIファイルのセクション名を指定してください。

strValues（出力用）

指定したセクションからキーとキーの値を受け取る変数を指定してください。関数から制御が戻ると、この変数にキーとキーの値が格納されます。キーとキーの値の組み合わせは＜key = value＞の形式です。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

21

ERROR_NOT_READY

38

ERROR_HANDLE_EOF

53

ERROR_BAD_NETPATH

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

998

ERROR_NOACCESS

1005

ERROR_UNRECOGNIZED_VOLUME

1169

ERROR_NO_MATCH

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_GetProfileFirstSectionNames

機能

指定したINIファイルの最初のセクション名を取得します。

形式

bool AIT_GetProfileFirstSectionNames  (
  string strIniFileName,     // INIファイル名
  string strSectionName      // セクション名
);

引数

strIniFileName（入力用）

INIファイル名を指定してください。

strSectionName（出力用）

指定したINIファイルから最初のセクション名を受け取る変数名を指定してください。関数から制御が戻ると、この変数にセクション名が格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

21

ERROR_NOT_READY

53

ERROR_BAD_NETPATH

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

998

ERROR_NOACCESS

1005

ERROR_UNRECOGNIZED_VOLUME

1169

ERROR_NO_MATCH

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_GetProfileNextSection

機能

AIT_GetProfileFirstSection関数で指定したINIファイルのセクションから次のキーとキーの値を取得します。

形式

bool AIT_GetProfileNextSection  (
  string strValues       // セクションのデータ
);

引数

strValues（出力用）

AIT_GetProfileFirstSectionで指定した、セクションの次のキーとキーの値を受け取る変数を指定してください。関数から制御が戻ると、この変数にキーとキーの値が格納されます。キーとキーの値の組み合わせは＜key = value＞の形式です。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。キーが存在しない、セクションが存在しない、または指定したINIファイルが存在しない場合、関数はfalseを返します。

AIT_GetProfileNextSectionNames

機能

AIT_GetProfileFirstSectionNames関数で指定したINIファイルから次のセクション名を取得します。

形式

bool AIT_GetProfileNextSectionNames  (
  string strSectionName       // セクション名
);

引数

strSectionName（出力用）

AIT_GetProfileFirstSectionNamesで指定したINIファイルの次のセクション名を受け取る変数を指定してください。関数から制御が戻ると、この変数にセクション名が格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。キーが存在しない、セクションが存在しない、または指定したINIファイルが存在しない場合、関数はfalseを返します。

AIT_GetProfileString

機能

指定したINIファイルのセクションから、指定したキーの値を取得します。

形式

bool AIT_GetProfileString  (
  string strIniFileName,     // INIファイル名
  string strSectionName,     // セクション名
  string strKeyName,         // キー名
  string strValue            // キーの値
);

引数

strIniFileName（入力用）

INIファイル名を指定してください。

strSectionName（入力用）

INIファイルのセクション名を指定してください。

strKeyName（入力用）

セクション名に属するキー名を指定してください。

strValue（出力用）

キーの値を受け取る変数を指定してください。関数から制御が戻ると、この変数にキーの値が格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

21

ERROR_NOT_READY

38

ERROR_HANDLE_EOF

53

ERROR_BAD_NETPATH

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

998

ERROR_NOACCESS

1005

ERROR_UNRECOGNIZED_VOLUME

1169

ERROR_NO_MATCH

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

AIT_GetSubMenu

機能

メニューのサブメニューハンドルを取得します。

形式

bool AIT_GetSubMenu  (
  integer nMenu,      // メニューハンドル
  integer nIndex,     // メニュー項目のインデックス
  integer nSubMenu    // サブメニューハンドル
  [,float fTimeOut]   // タイムアウト時間
);

引数

nMenu（入力用）

AIT_GetMenu関数を呼び出して取得したメニューハンドルを指定してください。

nIndex（入力用）

メニュー項目のインデックスを指定してください。インデックスの基準値は0です。

nSubMenu（出力用）

サブメニューハンドルを受け取る変数を指定してください。関数から制御が戻ると、この変数にハンドルが格納されます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1401

ERROR_INVALID_MENU_HANDLE

1460

ERROR_TIMEOUT

AIT_GetSubStr

機能

文字列から指定した長さの文字列を返します。

形式

bool AIT_GetSubStr (
  string  strSubString,    // 抽出した文字列
  string  strStrName,      // 文字列
  integer nStartPos        // 抽出を始める文字の位置
  [,integer nLength]       // 文字数
);

引数

strSubString（出力用）

抽出した文字列を受け取る変数を指定してください。関数から制御が戻ると、この変数に文字列が格納されます。

strStrName（入力用）

文字列名を指定してください。

nStartPos（入力用）

抽出を始める文字の位置を指定してください。基準値は0で、0の位置は文字列の最初の文字に対応します。

nLength（入力用、省略可）

抽出する文字数を指定してください。この引数が文字列の文字数を超えないかぎり、nStartPosから指定した文字数の文字列が抽出されます。省略した場合は、文字列の末尾の文字までの長さとなります。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

AIT_GetTime

機能

システムの時間を取得します。

形式

string AIT_GetTime ();

引数

なし

戻り値

システムの時間を取得します。

AIT_GetWindowText

機能

指定したウィンドウのタイトルを取得します。

形式

bool AIT_GetWindowText  (
  integer nWndHandle,     // ウィンドウハンドル
  string strCaption       // コントロールのキャプション
);

引数

nWndHandle（入力用）

ウィンドウハンドルを指定してください。0が指定されている場合は、アクティブなウィンドウのタイトルを取得します。

strCaption（出力用）

コントロールのキャプションを受け取る変数を指定してください。関数から制御が戻ると、この変数にキャプションが格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_IMEGetConversionStatus

機能

現在のIME変換ステータスを取得します。

形式

bool AIT_IMEGetConversionStatus  (
  integer nWndHandle,     // ウィンドウハンドル
  integer nConvMode,      // 変換モード
  integer nSentenceMode   // 文モード
);

引数

nWndHandle（入力用）

ステータスを取得するウィンドウハンドルを指定してください。

0が指定されている場合は、入力フォーカスを持つウィンドウが使用されます。

nConvMode（出力用）

変換ステータスを受け取る変数を指定してください。関数から制御が戻ると、この変数に次の値の組み合わせが格納されます。

値

意味

IME_CMODE_CHARCODE

オンの場合、IMEのモードは文字コード入力モードです。

IME_CMODE_EUDC

オンの場合、IMEのモードはEUDC変換モードです。

IME_CMODE_FULLSHAPE

オンの場合、IMEのモードは全角モードです。オフの場合、半角モードです。

IME_CMODE_HANJACONVERT

オンの場合、IMEのモードはHANJA変換モードです。

IME_CMODE_KATAKANA

オンの場合、カタカナモードです。オフの場合、ひらがなモードです。

IME_CMODE_NATIVE

オンの場合、NATIVEモードです。オフの場合、ALPHANUMERICモードです。

IME_CMODE_NOCONVERSION

オンの場合、IMEは変換を実行しません。IMEを閉じている状態と同じです。

IME_CMODE_ROMAN

オンの場合、IMEのモードはローマ字入力モードです。

IME_CMODE_SOFTKBD

オンの場合、IMEのモードはソフトキーボードモードです。

IME_CMODE_SYMBOL

オンの場合、IMEのモードはSYMBOL変換モードです。

nSentenceMode（出力用）

文字モードを受け取る変数を指定してください。関数から制御が戻ると、この変数に次の値の組み合わせが格納されます。

値

意味

IME_SMODE_AUTOMATIC

IMEは自動モードで変換します。

IME_SMODE_NONE

センテンスについての情報はありません。

IME_SMODE_PHRASEPREDICT

IMEはフレーズ情報を利用して次の文字を予測します（連文節）。

IME_SMODE_PLURALCLAUSE

IMEは変換処理する際に複数の文節情報を使用します（複合語優先）。

IME_SMODE_SINGLECONVERT

IMEはシングルモードで変換します。

IME_SMODE_CONVERSATION

IMEは変換モードを使用します。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_IMEGetOpenStatus

機能

IMEが開いているか閉じているかをチェックします。

形式

integer AIT_IMEGetOpenStatus  (
  [integer nWndHandle]     // ウィンドウハンドル
);

引数

nWndHandle（入力用、省略可）

ステータスを取得するウィンドウハンドルを指定してください。

省略した場合は、入力フォーカスを持つウィンドウが使用されます。

戻り値

IMEが開いている場合の戻り値は1、IMEが閉じている場合の戻り値は0となり、処理が失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_IMEGetProperty

機能

入力フォーカスウィンドウと結び付けられたIMEのプロパティまたは機能を取得します。

形式

integer AIT_IMEGetProperty  (
  integer nPropertyInfo     // プロパティ情報
);

引数

nPropertyInfo（入力用）

取得するプロパティ情報を指定してください。

次の値のどれかに該当する必要があります。

値

意味

IGP_PROPERTY

プロパティ情報

IGP_CONVERSION

変換機能

IGP_SENTENCE

センテンスモード機能

IGP_UI

ユーザーインターフェース機能

IGP_SETCOMPSTR

コンポジション文字列機能

IGP_SELECT

選択継承の機能

戻り値

関数が正常に処理された場合の戻り値はnPropertyInfoの値に応じたプロパティまたは機能の値となり、そのほかの場合の戻り値は-1となります。

nPropertyInfoがIGP_PROPERTYの場合戻り値は次の値の組み合わせになります。

値

意味

IME_PROP_AT_CARET

オンの場合、変換ウィンドウはカレットの位置にあります。オフの場合、変換ウィンドウはカレットの近くにあります。

IME_PROP_SPECIAL_UI

オンの場合、IMEは標準的なユーザーインターフェースを持っていません。この場合は、アプリケーションでIMEウィンドウ内を描画しないでください。

IME_PROP_CANDLIST_START_FROM_1

オンの場合、候補リスト内の文字列は1から順に番号が付いています。オフの場合、文字列は0から順に番号が付いています。

IME_PROP_UNICODE

オンの場合、入力コンテキスト文字列にはUnicode文字が含まれます。オフの場合、文字列には1バイト文字と2バイト文字が含まれます。

nPropertyInfoがIGP_UIの場合、戻り値は次の値の組み合わせになります。

値

意味

UI_CAP_2700

テキストの印字方向として、0または2700の値をサポートします。

UI_CAP_ROT90

テキストの印字方向として、0、900、1800、または2700の値をサポートします。

UI_CAP_ROTANY

任意の印字方向をサポートします。

nPropertyInfoがIGP_SETCOMPSTRの場合、戻り値は次の値の組み合わせになります。

値

意味

SCS_CAP_COMPSTR

IMESetCompositionStringのSCS_SETSTR値を使用してコンポジション文字列を作成できます。

SCS_CAP_MAKEREAD

IMESetCompositionStringのSCS_SETSTR値を使用すると、対応するコンポジション文字列から読み取り文字列を作成できます。

nPropertyInfoがIGP_SELECTの場合、戻り値は次の値の組み合わせになります。

値

意味

SELECT_CAP_CONVERSION

IMEが新たに選択された場合、変換モードを継承します。

SELECT_CAP_SENTENCE

IMEが新たに選択された場合、センテンスモードを継承します。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。

AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

AIT_IMEGetStatusWindowPos

機能

ステータスウィンドウの位置を取得します。

形式

bool AIT_IMEGetStatusWindowPos  (
  integer nWndHandle,     // ウィンドウハンドル
  integer nX,             // X座標
  integer nY              // Y座標
);

引数

nWndHandle（入力用）

ステータスウィンドウの位置を取得するウィンドウハンドルを指定してください。

0が指定されている場合は、入力フォーカスを持つウィンドウハンドルが使用されます。

nX（出力用）

ステータスウィンドウのX座標を受け取る変数を指定してください。関数から制御が戻ると、この変数にX座標が格納されます。

nY（出力用）

ステータスウィンドウのY座標を受け取る変数指定してください。関数から制御が戻ると、この変数にY座標が格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_IMESetConversionStatus

機能

現在の変換ステータスを設定します。

形式

bool AIT_IMESetConversionStatus  (
  integer nWndHandle,     // ウィンドウハンドル
  integer nConvMode,      // 変換モード
  integer nSentenceMode   // 文モード
);

引数

nWndHandle（入力用）

ステータスを設定するウィンドウハンドルを指定してください。

0が指定されている場合は、入力フォーカスを持つウィンドウハンドルが使用されます。

nConvMode（入力用）

変換モードの組み合わせを指定してください。

ビット値については、「AIT_IMEGetConversionStatus」を参照してください。

nSentenceMode（入力用）

文モードを指定してください。

ビット値については、「AIT_IMEGetConversionStatus」を参照してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_IMESetOpenStatus

機能

IMEを開いたり、閉じたりします。

形式

bool AIT_IMESetOpenStatus  (
  integer nWndHandle,     // ウィンドウハンドル
  bool bCondition         // 条件
);

引数

nWndHandle（入力用）

ステータスを設定するウィンドウハンドルを指定してください。

0が指定されている場合は、入力フォーカスを持つウィンドウハンドルが使用されます。

bCondition（入力用）

IMEを開くか閉じるかを指定してください。trueの場合IMEを開き、falseの場合IMEを閉じます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_IMESetStatusWindowPos

機能

ステータスウィンドウの位置を設定します。

形式

bool AIT_IMESetStatusWindowPos  (
  integer nWndHandle,     // ウィンドウハンドル
  integer nX,             // X座標
  integer nY              // Y座標
);

引数

nWndHandle（入力用）

位置を設定するウィンドウハンドルを指定してください。

0が指定されている場合は、入力フォーカスされているウィンドウハンドルが使用されます。

nX（入力用）

ステータスウィンドウのX座標を指定してください。

nY（入力用）

ステータスウィンドウのY座標を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_IMESimulateHotKey

機能

指定したIMEホットキーをシミュレートします。

形式

bool AIT_IMESimulateHotKey  (
  integer nWndHandle,     // ウィンドウハンドル
  integer nHotKeyId       // ホットキー識別子
);

引数

nWndHandle（入力用）

ウィンドウハンドルを指定してください。

nHotKeyId（入力用）

IMEホットキーの識別子を指定してください。

次の値のどれかに該当する必要があります。

値

意味

IME_CHOTKEY_IME_NONIME_TOGGLE

このホットキーは中国語（簡体字）版で使用します。IMEオペレーションと非IMEオペレーションとを切り替えます。

IME_CHOTKEY_SHAPE_TOGGLE

このホットキーは中国語（簡体字）版で使用します。IMEのシェイプ変換モードを切り替えます。

IME_CHOTKEY_SYMBOL_TOGGLE

このホットキーは中国語（簡体字）版で使用します。IMEのシェイプ変換モードを切り替えます。シンボルモードで中国語の句読法とシンボル（完全な全角文字）を入力できるようにするには、それらをキーボードに割り当てます。

IME_JHOTKEY_CLOSE_OPEN

このホットキーは日本語で使用し、IMEを開いたり閉じたりします。

IME_KHOTKEY_ENGLISH

このホットキーは韓国語で使用し、英語へ切り替えます。

IME_KHOTKEY_SHAPE_TOGGLE

このホットキーは韓国語で使用し、IMEのシェイプ変換モードを切り替えます。

IME_KHOTKEY_HANJACONVERT

このホットキーは韓国語で使用し、漢字（Hanja）変換へ切り替えます。

IME_THOTKEY_IME_NONIME_TOGGLE

このホットキーは中国語（繁体字）版で使用し、IMEオペレーションと非IME オペレーションを切り替えます。

IME_THOTKEY_SHAPE_TOGGLE

このホットキーは中国語（繁体字）版で使用し、IMEのシェイプ変換モードを切り替えます。

IME_THOTKEY_SYMBOL_TOGGLE

このホットキーは中国語（繁体字）版で使用し、IMEのシンボル変換モードを切り替えます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_InitLog

機能

AIT_LogMessage関数が使用するRecDFile.logファイルを初期化します。AIT_LogMessage関数を実行する前には必ずこの関数を実行してください。RecDFile.logファイルは、次のレジストリキー値で指定したLOGディレクトリのパスに存在します。

OSが32ビット版の場合

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥IT DESKTOP MANAGEMENT 2/P¥PathName

OSが64ビット版の場合

HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥Hitachi¥IT DESKTOP MANAGEMENT 2/P¥PathName

形式

bool AIT_InitLog  (
  string strMessage     // メッセージ文字列
);

引数

strMessage（入力用）

ログファイルに書き込む文字列メッセージを指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

3

ERROR_PATH_NOT_FOUND

4

ERROR_TOO_MANY_OPEN_FILES

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

19

ERROR_WRITE_PROTECT

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

53

ERROR_BAD_NETPATH

82

ERROR_CANNOT_MAKE

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

183

ERROR_ALREADY_EXISTS

206

ERROR_FILENAME_EXCED_RANGE

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

注意事項

この関数を実行すると、以前のRecDFile.logはRec1File.logに変更され、5つまで履歴として保存されます。

この関数はメッセージとともに現在の日付と時間を記録します。

AIT_IsEmpty

機能

入力した文字列が空か、空でないかを確認します。

形式

bool AIT_IsEmpty (
  string strStrName     // 文字列名
);

引数

strStrName（入力用）

文字列名を指定してください。

戻り値

文字列が空の場合trueを返し、そのほかの場合はfalseを返します。

AIT_LogMessage

機能

AIT_InitLog関数によって開かれたRecDFile.logファイルにメッセージを記録します。

形式

bool AIT_LogMessage  (
  string strMessage     // メッセージ文字列
);

引数

strMessage（入力用）

ログファイルに書き込む文字列メッセージを指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

3

ERROR_PATH_NOT_FOUND

4

ERROR_TOO_MANY_OPEN_FILES

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

19

ERROR_WRITE_PROTECT

32

ERROR_SHARING_VIOLATION

33

ERROR_LOCK_VIOLATION

53

ERROR_BAD_NETPATH

82

ERROR_CANNOT_MAKE

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

161

ERROR_BAD_PATHNAME

183

ERROR_ALREADY_EXISTS

206

ERROR_FILENAME_EXCED_RANGE

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

1231

ERROR_NETWORK_UNREACHABLE

1392

ERROR_FILE_CORRUPT

注意事項

この関数はメッセージとともに現在の日付と時間を記録します。

AIT_MenuItemClick

機能

指定したメニュー項目をクリックします。

形式

bool AIT_MenuItemClick  (
  integer nWndHandle,    // ウィンドウハンドル
  integer nMenu,         // メニューハンドル
  integer nIndex         // メニュー項目のインデックス
  [,float fTimeOut]      // タイムアウト時間
);

引数

nWndHandle（入力用）

ウィンドウハンドルを指定してください。

nMenu（入力用）

メニューハンドルを指定してください。

nIndex（入力用）

メニュー項目のインデックスを指定してください。インデックスの基準値は0です。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の設定値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1401

ERROR_INVALID_MENU_HANDLE

1460

ERROR_TIMEOUT

AIT_MessageBox

機能

指定したメッセージをダイアログボックスに表示し、ユーザがどれかのボタンをクリックするまで待機し、ユーザが選択したボタンを示す値を返します。

形式

integer AIT_MessageBox  (
  string strMessage,       // メッセージ
  string strTitle          // タイトル
  [,integer nIconType]     // アイコンタイプ
  [,integer nMsgBoxType]   // メッセージボックスタイプ
);

引数

strMessage（入力用）

メッセージボックスに表示するメッセージを指定してください。

strTitle（入力用）

メッセージボックスのタイトルを指定してください。

nIconType（入力用、省略可）

表示するアイコンタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

MB_ICONEXCLAMATION

メッセージボックスに「!」（感嘆符）のアイコンが表示されます。

MB_ICONINFORMATION

メッセージボックスに、丸の中に「i」があるアイコンが表示されます。

MB_ICONQUESTION

メッセージボックスに「?」（疑問符）のアイコンが表示されます。

MB_ICONSTOP

メッセージボックスに停止標識のアイコンが表示されます。

省略した場合は、MB_ICONEXCLAMATIONがアイコンタイプになります。

nMsgBoxType（入力用、省略可）

メッセージボックスタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

MB_ABORTRETRYIGNORE

［中止］、［再試行］、および［無視］ボタンがあるメッセージボックス

MB_OK

［OK］ボタンだけがあるメッセージボックス

MB_OKCANCEL

［OK］および［キャンセル］ボタンがあるメッセージボックス

MB_RETRYCANCEL

［再試行］および［キャンセル］ボタンがあるメッセージボックス

MB_YESNO

［はい］および［いいえ］ボタンがあるメッセージボックス

MB_YESNOCANCEL

［はい］、［いいえ］、および［キャンセル］ボタンがあるメッセージボックス

省略した場合は、MB_OKがメッセージボックスタイプに指定されます。

戻り値

ユーザが選択したボタンを表す値を返します。次のどれかの値になります。

値

意味

IDABORT

［中止］ボタンが選択されました。

IDCANCEL

［キャンセル］ボタンが選択されました。

IDIGNORE

［無視］ボタンが選択されました。

IDNO

［いいえ］ボタンが選択されました。

IDOK

［OK］ボタンが選択されました。

IDRETRY

［再試行］ボタンが選択されました。

IDYES

［はい］ボタンが選択されました。

上記以外の値が返った場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

AIT_MinWnd

機能

指定したウィンドウを最小化し、次の最上位のウィンドウがアクティブになります。

形式

bool AIT_MinWnd  (
  integer nWndHandle     // ウィンドウハンドル
);
bool AIT_MinWnd  (
  string strCaption,     // コントロールのキャプション
  string strClassName    // クラス名
);

引数

nWndHandle（入力用）

ウィンドウハンドルを指定してください。

strCaption（入力用）

コントロールのキャプションを指定してください。

strClassName（入力用）

ウィンドウのクラス名を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_MouseClick

機能

指定した座標でマウスをクリックします。

形式

bool AIT_MouseClick  (
  integer nMouseButton,     // マウスボタン
  integer nX,               // X座標
  integer nY                // Y座標
);

引数

nMouseButton（入力用）

クリックするマウスボタンを指定してください。これは、次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTOM

中央マウスボタン

RBUTTON

右マウスボタン

nX（入力用）

クリックする位置のX座標を指定してください。

nY（入力用）

クリックする位置のY座標を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

AIT_MouseDblClk

機能

指定した座標でマウスをダブルクリックします。

形式

bool AIT_MouseDblClk  (
  integer nX,             // X座標
  integer nY,             // Y座標
  integer nButton,        // マウスボタン
  integer nKeyState       // キー状態
);

引数

nX（入力用）

ダブルクリックする位置のX座標を指定してください。

nY（入力用）

ダブルクリックする位置のY座標を指定してください。

nButton（入力用）

ダブルクリックするマウスボタンを指定してください。これは、次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTON

中央マウスボタン

RBUTTON

右マウスボタン

nKeyState（入力用）

キー状態を指定してください。これは、次の値のどれかにする必要があります。

値

意味

SHIFT_ON

［Shift］キーはオン状態

ALT_ON

［Alt］キーはオン状態

CTRL_ON

［Ctrl］キーはオン状態

SHIFT_OFF

［Shift］キーはオフ状態

ALT_OFF

［Alt］キーはオフ状態

CTRL_OFF

［Ctrl］キーはオフ状態

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

AIT_MouseDown

機能

指定した座標でマウスのボタンを押します。

形式

bool AIT_MouseDown  (
  integer nX,              // X座標
  integer nY,              // Y座標
  integer nButton,         // マウスボタン
  integer nKeyState        // キー状態
);

引数

nX（入力用）

マウスボタンを押す位置のX座標を指定してください。

nY（入力用）

マウスボタンを押す位置のY座標を指定してください。

nButton（入力用）

マウスで押すボタンを指定してください。これは、次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTON

中央マウスボタン

RBUTTON

右マウスボタン

nKeyState（入力用）

キー状態を指定してください。これは、次の値のどれかにする必要があります。

値

意味

SHIFT_ON

［Shift］キーはオン状態

ALT_ON

［Alt］キーはオン状態

CTRL_ON

［Ctrl］キーはオン状態

SHIFT_OFF

［Shift］キーはオフ状態

ALT_OFF

［Alt］キーはオフ状態

CTRL_OFF

［Ctrl］キーはオフ状態

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

AIT_MouseDragDrop

機能

指定した開始位置から終了位置までをドラッグアンドドロップします。

形式

bool AIT_MouseDragDrop  (
  integer nXStartPos,       // 開始X座標
  integer nYStartPos,       // 開始Y座標
  integer nXEndPos,         // 終了X座標
  integer nYEndPos,         // 終了Y座標
  integer nButton,          // マウスボタン
  integer nKeyState         // キー状態
);

引数

nXStartPos（入力用）

ドラッグを開始する位置のX座標を指定してください。

nYStartPos（入力用）

ドラッグを開始する位置のY座標を指定してください。

nXEndPos（入力用）

ドロップする位置のX座標を指定してください。

nYEndPos（入力用）

ドロップする位置のY座標を指定してください。

nButton（入力用）

ドラッグアンドドロップするマウスボタンを指定してください。これは、次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTON

中央マウスボタン

RBUTTON

右マウスボタン

nKeyState（入力用）

キー状態を指定してください。これは、次の値のどれかにする必要があります。

値

意味

SHIFT_ON

［Shift］キーはオン状態

ALT_ON

［Alt］キーはオン状態

CTRL_ON

［Ctrl］キーはオン状態

SHIFT_OFF

［Shift］キーはオフ状態

ALT_OFF

［Alt］キーはオフ状態

CTRL_OFF

［Ctrl］キーはオフ状態

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

AIT_MouseMoveTo

機能

指定した座標へマウスを移動します。

形式

bool AIT_MouseMoveTo  (
  integer nX,             // X座標
  integer nY,             // Y座標
  integer nButton,        // マウスボタン
  integer nKeyState       // キー状態
);

引数

nX（入力用）

マウスを移動する位置のX座標を指定してください。

nY（入力用）

マウスを移動する位置のY座標を指定してください。

nButton（入力用）

移動中にクリックするマウスボタンを指定してください。これは、次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTON

中央マウスボタン

RBUTTON

右マウスボタン

nKeyState（入力用）

キー状態を指定してください。これは、次の値のどれかにする必要があります。

値

意味

SHIFT_ON

［Shift］キーはオン状態

ALT_ON

［Alt］キーはオン状態

CTRL_ON

［Ctrl］キーはオン状態

SHIFT_OFF

［Shift］キーはオフ状態

ALT_OFF

［Alt］キーはオフ状態

CTRL_OFF

［Ctrl］キーはオフ状態

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

AIT_MouseUp

機能

指定した座標でマウスのボタンを離します。

形式

bool AIT_MouseUp  (
  integer nX,          // X座標
  integer nY,          // Y座標
  integer nButton,     // マウスボタン
  integer nKeyState    // キー状態
);

引数

nX（入力用）

マウスボタンを離す位置のX座標を指定してください。

nY（入力用）

マウスボタンを離す位置のY座標を指定してください。

nButton（入力用）

マウスで離すボタンを指定してください。これは、次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTON

中央マウスボタン

RBUTTON

右マウスボタン

nKeyState（入力用）

キー状態を指定してください。これは、次の値のどれかにする必要があります。

値

意味

SHIFT_ON

［Shift］キーはオン状態

ALT_ON

［Alt］キーはオン状態

CTRL_ON

［Ctrl］キーはオン状態

SHIFT_OFF

［Shift］キーはオフ状態

ALT_OFF

［Alt］キーはオフ状態

CTRL_OFF

［Ctrl］キーはオフ状態

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

AIT_PlayKey

機能

ユーザがキー入力した場合と同じように、アクティブなウィンドウへキーボード入力情報を送信します。

形式

bool AIT_PlayKey  (
  string strKeys     // 文字列
);

引数

strKeys（入力用）

キーやキーの組み合わせ文字列、または文字列を指定してください。次のどれかを組み合わせて指定できます。

aからzまでのすべての大文字と小文字

0から9までのすべての数字

次の半角記号

「~」「!」「@」「#」「$」「%」「^」「&」「*」「(」「)」「_」「+」「|」「?」「>」「<」「"」「}」「{」「[」「]」「'」「;」「/」「.」「,」「`」「-」「=」「¥」

例

AIT_PlayKey("ABC")は、ABCという文字列を打つ処理をシミュレートします。

次に示すのは指定できる特殊キーです。

指定できる特殊キー

{ALT}

{ALT_LOCK}

{ALT_UNLOCK}

{ALT+SHIFT}

{APPS}

{BACKSPACE}

{CTRL}

{CTRL+ALT}

{CTRL+SHIFT}

{CTRL+ALT+SHIFT}

{CTRL_LOCK}

{CAPSLOCK}

{CAPSLOCK_ON}

{CAPSLOCK_OFF}

{CTRL_UNLOCK}

{DELETE}

{DOWN}

{END}

{ENTER}

{ESC}

{F1}

{F2}

{F3}

{F4}

{F5}

{F6}

{F7}

{F8}

{F9}

{F10}

{F11}

{F12}

{HOME}

{INS}

{KANA_ON}

{KANA_OFF}

{KANJI_ON}

{KANJI_OFF}

{LEFT}

{LWIN}

{LWIN_LOCK}

{LWIN_UNLOCK}

{NUMLOCK_ON}

{NUMLOCK_OFF}

{NUMLOCK}

{NUMPAD0}

{NUMPAD1}

{NUMPAD2}

{NUMPAD3}

{NUMPAD4}

{NUMPAD5}

{NUMPAD6}

{NUMPAD7}

{NUMPAD8}

{NUMPAD9}

{PAUSE}

{PGDOWN}

{PGUP}

{PRNSCR}

{PROCESS}

{RIGHT}

{RWIN}

{RWIN_LOCK}

{RWIN_UNLOCK}

{SCROLLLOCK}

{SCROLLLOCK_ON}

{SCROLLLOCK_OFF}

{SHIFT}

{SHIFT_LOCK}

{SHIFT_UNLOCK}

{SPACE}

{TAB}

{UP}

−

−

−

−

（凡例）−：値なし

例

AIT_PlayKey("{TAB}")は［Tab］キーを押す処理をシミュレートします。

［Shift］、［Ctrl］、または［Alt］キーと組み合わせたキーを指定する場合は、通常のキーテキストの前に次のキー操作コードを付け加えてください。

キー

キー操作コード

Shift

+

Ctrl

^

Alt

%

例

AIT_PlayKey("%(N)")は［Alt］+［N］キーを押すことを表します。

同じ順番でキーを繰り返す場合は、次のように表記してください。

{REPEAT n}<char to repeat>{END_REPEAT}

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

AIT_PostMessage

機能

指定したウィンドウを作成したスレッドに関連づけられているメッセージキューにメッセージをポストします。対応するスレッドがメッセージを処理するのを待つことなく制御を返します。

形式

bool AIT_PostMessage  (
  integer nWndHandle,     // ウィンドウハンドル
  integer nMessage,       // メッセージ
  integer nWParam,        // メッセージの最初の引数
  integer nLParam         // メッセージの2番目の引数
);

引数

nWndHandle（入力用）

ポスト先のウィンドウハンドルを指定してください。

次の値は特別な意味を持ちます。

値

意味

HWND_BROADCAST

システム内のすべてのトップレベルウィンドウへメッセージをポストします。無効になっている所有されていないウィンドウ、不可視の所有されていないウィンドウ、オーバーラップされた（手前にほかのウィンドウがあって覆い隠されている）ウィンドウ、ポップアップウィンドウもポスト先になります。子ウィンドウへはメッセージをポストしません。

nMessage（入力用）

ポストするメッセージを指定してください。

nWParam（入力用）

メッセージ特有の追加情報を指定してください。

nLParam（入力用）

メッセージ特有の追加情報を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

AIT_RegCloseKey

機能

指定したレジストリキーのハンドルを閉じます。

形式

bool AIT_RegCloseKey(
  integer nHKeyHandle     // キーハンドル
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーを指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

1009

ERROR_BADDB

1010

ERROR_BADKEY

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1019

ERROR_NO_LOG_SPACE

AIT_RegCreateKey

機能

指定したレジストリキーを作成します。すでに存在している場合はそのキーを開きます。

形式

bool AIT_RegCreateKey(
  integer nHKeyHandle,       // キーハンドル
  string strRegKeyName,      // 作成するキー名
  integer nOutputHkeyHandle  // 出力用のキーハンドル
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルまたは次のどれかを指定してください。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

strRegKeyName（入力用）

作成または開くレジストリキー名を指定してください。

nOutputHkeyHandle（出力用）

レジストリキーのハンドルを受け取る変数を指定してください。関数から制御が戻ると、この変数にハンドルが格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

1009

ERROR_BADDB

1010

ERROR_BADKEY

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1019

ERROR_NO_LOG_SPACE

注意事項

終了時にAIT_RegCloseKeyを呼び出してnOutputHkeyHandleを閉じてください。

レジストリキーを作成するには、作成位置へ書き込みできる権限が必要です。

すでに存在しているレジストリキーを開く場合、そのレジストリキーに書き込みできる権限がないときは、読み込み権限で開きます。

AIT_RegDeleteKey

機能

指定したレジストリのサブキーを削除します。

形式

bool AIT_RegDeleteKey(
  integer nHKeyHandle,     // キーハンドル
  string strRegKeyName     // 削除するキー名
);

引数

nHKeyHandle（入力用）

すでに開かれたレジストリキーのハンドルを指定してください。

strRegKeyName（入力用）

削除するレジストリのサブキー名を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

5

ERROR_ACCESS_DENIED

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

1009

ERROR_BADDB

1010

ERROR_BADKEY

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1019

ERROR_NO_LOG_SPACE

注意事項

コンピュータのOSがWindowsの場合、指定したキーにサブキーがあるときは、指定したキーを削除できません。あらかじめサブキーを削除しておいてください。

AIT_RegDeleteValue

機能

指定したレジストリ値を削除します。

形式

bool AIT_RegDeleteValue(
  integer nHKeyHandle,     // キーハンドル
  string strRegValueName   // レジストリ値名
);

引数

nHKeyHandle（入力用）

すでに開かれたレジストリキーのハンドルを指定してください。

strRegValueName（入力用）

削除するレジストリ値名を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

1009

ERROR_BADDB

1010

ERROR_BADKEY

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1019

ERROR_NO_LOG_SPACE

AIT_RegGetDWORDValue

機能

DWORDのデータ型のレジストリ値を取得します。

形式

bool AIT_RegGetDWORDValue(
  integer nHKeyHandle,      // キーハンドル
  string strRegKeyName,     // レジストリサブキー名
  string strRegValueName,   // レジストリ値名
  integer nRegValueData     // レジストリ値データ
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルまたは次のどれかを指定してください。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

strRegKeyName（入力用）

レジストリのサブキー名を指定してください。

strRegValueName（入力用）

取得するレジストリ値名を指定してください。

nRegValueData（出力用）

DWORDのデータ型のレジストリ値データを受け取る変数を指定してください。関数から制御が戻ると、この変数にレジストリ値データが格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

234

ERROR_MORE_DATA

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1012

ERROR_CANTREAD

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1018

ERROR_KEY_DELETED

1019

ERROR_NO_LOG_SPACE

1069

ERROR_NO_MATCH

AIT_RegGetStringValue

機能

文字列のデータ型（REG_SZ、REG_EXPAND_SZ、REG_MULTI_SZ）のレジストリ値を取得します。

形式

bool AIT_RegGetStringValue(
  integer nHKeyHandle,      // キーハンドル
  string strRegKeyName,     // レジストリサブキー名
  string strRegValueName,   // レジストリ値名
  string strRegValueData    // レジストリ値データ
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルまたは次のどれかを指定してください。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

strRegKeyName（入力用）

レジストリのサブキー名を指定してください。

strRegValueName（入力用）

取得するレジストリ値名を指定してください。

strRegValueData（出力用）

文字列のデータ型のレジストリ値データを受け取る変数を指定してください。関数から制御が戻ると、この変数のレジストリ値データが格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

234

ERROR_MORE_DATA

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1012

ERROR_CANTREAD

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1018

ERROR_KEY_DELETED

1019

ERROR_NO_LOG_SPACE

1169

ERROR_NO_MATCH

AIT_RegisterWindowMessage

機能

システム上で固有となる新たなウィンドウメッセージを定義します。メッセージの送信またはポストをする際に、このメッセージ値を利用できます。

通常この関数は2つの協調アプリケーション間の通信に使うメッセージを登録する目的で使います。

形式

integer AIT_RegisterWindowMessage  (
  string strMessageString     // メッセージ文字列
);

引数

strMessageString（入力用）

登録するメッセージを指定してください。

戻り値

メッセージが正常に登録された場合、戻り値は49152〜65535のメッセージ値（メッセージ識別子）になります。

関数の処理が失敗した場合の戻り値は0となります。AIT_GetLastErrorを使用して拡張エラーコードを取得できます。

AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

AIT_RegKeyExists

機能

指定したレジストリキーが存在するかを確認します。

形式

integer AIT_RegKeyExists(
  integer nHKeyHandle,       // キーハンドル
  string strRegKeyName       // レジストリサブキー名
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルを指定してください。

strRegKeyName（入力用）

存在を確認するレジストリのサブキー名を指定してください。

戻り値

このキーが存在する場合の戻り値は1、このキーが存在しない場合は0となり、処理が失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1019

ERROR_NO_LOG_SPACE

AIT_RegOpenKey

機能

指定したレジストリキーを開きます。

形式

bool AIT_RegOpenKey(
  integer nHKeyHandle,       // キーハンドル
  string strRegKeyName,      // 開かれるキー名
  integer nOutputHkeyHandle  // 出力用のキーハンドル
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルまたは次のどれかを指定してください。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

strRegKeyName（入力用）

開くレジストリのサブキー名を指定してください。

nOutputHkeyHandle（出力用）

レジストリキーのハンドルを受け取る変数を指定してください。関数から制御が戻ると、この変数にハンドルが格納されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1018

ERROR_KEY_DELETED

1019

ERROR_NO_LOG_SPACE

注意事項

終了時にAIT_RegCloseKeyを呼び出してnOutputHkeyHandleを閉じてください。

レジストリキーを開く場合、そのレジストリキーに書き込みできる権限がないときは、読み込み権限で開きます。

AIT_RegSetDWORDValue

機能

DWORDのデータ型のレジストリ値にデータを設定します。

形式

bool AIT_RegSetDWORDValue(
  integer nHKeyHandle,      // キーハンドル
  string strRegKeyName,     // レジストリサブキー名
  string strRegValueName,   // レジストリ値名
  integer nRegValueData     // レジストリ値データ
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルまたは次のどれかを指定してください。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

strRegKeyName（入力用）

レジストリのサブキー名を指定してください。

strRegValueName（入力用）

設定するレジストリ値名を指定してください。

nRegValueData（入力用）

DWORDのデータ型のレジストリ値に設定するデータを指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

234

ERROR_MORE_DATA

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1013

ERROR_CANTWRITE

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1018

ERROR_KEY_DELETED

1019

ERROR_NO_LOG_SPACE

1169

ERROR_NO_MATCH

AIT_RegSetStringValue

機能

文字列のデータ型（REG_SZ、REG_EXPAND_SZ、REG_MULTI_SZ）のレジストリ値にデータを設定します。

形式

bool AIT_RegSetStringValue(
  integer nHKeyHandle,      // キーハンドル
  string strRegKeyName,     // レジストリサブキー名
  string strRegValueName,   // レジストリ値名
  string strRegValueData    // レジストリ値データ
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルまたは次のどれかを指定してください。

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

strRegKeyName（入力用）

レジストリのサブキー名を指定してください。

strRegValueName（入力用）

設定するレジストリ値名を指定してください。

strRegValueData（入力用）

文字列のデータ型のレジストリ値に設定するデータを指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

234

ERROR_MORE_DATA

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1013

ERROR_CANTWRITE

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1018

ERROR_KEY_DELETED

1019

ERROR_NO_LOG_SPACE

1169

ERROR_NO_MATCH

注意事項

新規にレジストリを作成する場合、文字列のデータ型はREG_SZになります。データ型は変更できません。

既存のレジストリ値を更新する場合、APIを実行してもデータ型は変更されません。

AIT_RegValueExists

機能

指定したレジストリ値が存在するかを確認します。

形式

integer AIT_RegValueExists(
  integer nHKeyHandle,     // キーハンドル
  string strRegValueName   // レジストリ値名
);

引数

nHKeyHandle（入力用）

すでに開かれているレジストリキーのハンドルを指定してください。

strRegValueName（入力用）

存在を確認するレジストリ値名を指定してください。

戻り値

この値が存在する場合の戻り値は1、この値が存在しない場合の戻り値は0となり、処理が失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

6

ERROR_INVALID_HANDLE

87

ERROR_INVALID_PARAMETER

236

ERROR_MORE_DATA

1009

ERROR_BADDB

1010

ERROR_BADKEY

1011

ERROR_CANTOPEN

1015

ERROR_REGISTRY_CORRUPT

1016

ERROR_REGISTRY_IO_FAILED

1019

ERROR_NO_LOG_SPACE

AIT_SelectIPAddressField

機能

アクティブなウィンドウのIPアドレスコントロール内のテキストを選択します。

形式

bool AIT_SelectIPAddressField  (
  string strCaption,       // コントロールのキャプション
  integer nFieldIndex,     //フィールドのインデックス
  integer nStartSel,       // テキストの開始位置
  integer nEndSel          // テキストの数
  [,float fTimeOut]        // タイムアウト時間
);
bool AIT_SelectIPAddressField  (
  integer nCtrlID,         // コントロールID
  integer nFieldIndex,     // フィールドのインデックス
  integer nStartSel,       // テキストの開始位置
  integer nEndSel          // テキストの数
  [,float fTimeOut]        // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nFieldIndex（入力用）

IPアドレスコントロール内のフィールドのインデックスを指定してください。インデックスの基準値は0です。

nStartSel（入力用）

テキストを選択する開始文字位置を指定してください。nStartSelの基準値は0で0の位置はテキストの最初の文字に対応します。

nEndSel（入力用）

選択するテキストの数を指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

開始値が終了値より大きくてもかまいません。2つの値の小さい方が選択テキストの最初の文字位置を指定します。大きい方の値は選択テキストを超えた最初の文字位置を指定します。

開始値は選択テキストの固定点となり、終了値は変動する終点になります。

開始が0で終点が-1の場合、エディットコントロール内のすべてのテキストが選択されます。開始が-1の場合、アクティブな選択は解除されます。

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SelectListItem

機能

アクティブなウィンドウの特定のコントロールで指定した項目を選択します。

形式

bool AIT_SelectListItem  (
  string strCaption,    // コントロールのキャプション
  integer nCtrlType,    // コントロールタイプ
  string strItemText    // 選択される項目テキスト
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_SelectListItem  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  string strItemText    // 選択される項目テキスト
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

LIST_CTRL

コントロールタイプはリストコントロールです。

strItemText（入力用）

特定のコントロール上で選択するテキストを指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の設定値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

AIT_SelectListItem関数は複数選択できるコントロールでは使用しないでください。

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SelectMultipleListItem

機能

アクティブなウィンドウの特定の複数選択コントロールで指定した項目を選択します。

形式

bool AIT_SelectMultipleListItem  (
  string strCaption,    // コントロールのキャプション
  integer nCtrlType,    // コントロールタイプ
  string strItemText    // 選択される項目テキスト
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_SelectMultipleListItem  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  string strItemText    // 選択される項目テキスト
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

LISTBOX_CTRL

コントロールタイプはリストボックスです。

LIST_CTRL

コントロールタイプはリストコントロールです。

strItemText（入力用）

特定の複数選択コントロールで選択するテキストを指定してください。複数指定する場合はコンマで区切った値で指定できます。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、AIT_SetDefaultWaitTimeout関数の設定値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

AIT_SelectMultipleListItem関数は複数選択できるコントロールだけで使用してください。

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SelectText

機能

アクティブなウィンドウのエディットコントロールでテキストを選択します。

形式

bool AIT_SelectText  (
  string strCaption,   // コントロールのキャプション
  integer nStartPos,   // コントロールの開始位置
  integer nEndPos      // コントロールの終了位置
  [,float fTimeOut]    // タイムアウト時間
);
bool AIT_SelectText  (
  integer nCtrlID,     // コントロールID
  integer nStartPos,   // コントロールの開始位置
  integer nEndPos      // コントロールの終了位置
  [,float fTimeOut]    // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nStartPos（入力用）

テキストを選択する開始文字位置を指定してください。nStartPosの基準値は0で、0の位置はテキストの最初の文字に対応します。

nEndPos（入力用）

テキストを選択する終了文字位置を指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

開始値が終了値より大きくてもかまいません。2つの値の小さい方が選択テキストの最初の文字位置を指定します。大きい方の値は選択テキストを超えた最初の文字位置を指定します。

開始値は選択テキストの固定点となり、終了値は変動する終点になります。

開始が0で終点が-1の場合、エディットコントロール内のすべてのテキストが選択されます。開始が-1の場合、アクティブな選択は解除されます。

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SetActWnd

機能

指定したウィンドウをアクティブにします。

形式

bool AIT_SetActWnd  (
  integer nWndHandle     // ウィンドウハンドル
);

引数

nWndHandle（入力用）

ウィンドウのハンドルを指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_SetCheck

機能

アクティブなウィンドウの特定のコントロールをオン、オフおよび、不確定状態にします。

形式

bool AIT_SetCheck  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType      // コントロールタイプ
  [,integer nCondition]  // チェックタイプ
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetCheck  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType      // コントロールタイプ
  [,integer nCondition]  // チェック状態のタイプ
  [,float fTimeOut]      // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールのIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

CHECKBOX_CTRL

コントロールタイプがチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプがオプションボタンです。

nCondition（入力用、省略可）

チェック状態のタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

0

オフにした状態

1

オンにした状態

2

不確定またはグレー表示された状態

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SetComboEditSelText

機能

アクティブなウィンドウのコンボボックスでテキスト選択を設定します。

形式

bool AIT_SetComboEditSelText  (
  string strCaption,    // コントロールのキャプション
  integer nStartSel,    // コントロールの開始位置
  integer nEndSel       // コントロールの終了位置
  [,float fTimeOut]     // タイムアウト時間
);
bool AIT_SetComboEditSelText  (
  integer nCtrlID,      // コントロールのキャプション
  integer nStartSel,    // コントロールの開始位置
  integer nEndSel       // コントロールの終了位置
  [,float fTimeOut]     // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nStartSel（入力用）

エディットコントロール内のテキストを選択する開始位置を指定してください。nStartSelの基準値は0です。

nEndSel（入力用）

エディットコントロール内のテキストを選択する終了位置を指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

この関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseとなります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

開始値が終了値より大きくてもかまいません。2つの値の小さい方が選択テキストの最初の文字位置を指定します。大きい方の値は、選択テキストを超えた最初の文字位置を指定します。

開始値は選択テキストの固定点となり、終了値は変動する終点になります。ユーザが［Shift］キーを使用して選択テキストのサイズを調整すると、開始が0で終点が-1の場合、エディットコントロール内のすべてのテキストが選択されます。開始が-1の場合、アクティブな選択は解除されます。

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SetCurrentDirectory

機能

現在のディレクトリを、カレントディレクトリに変更します。

形式

bool AIT_SetCurrentDirectory  (
  string strDirName    // ディレクトリ名
);

引数

strDirName（入力用）

ディレクトリ名を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

21

ERROR_NOT_READY

53

ERROR_BAD_NETPATH

123

ERROR_INVALID_NAME

161

ERROR_BAD_PATHNAME

1005

ERROR_UNRECOGNIZED_VOLUME

1210

ERROR_INVALID_COMPUTERNAME

1214

ERROR_INVALID_NETNAME

AIT_SetDefaultWaitTimeout

機能

コントロール関連のAPIで使うデフォルトのタイムアウト時間を設定します。

形式

AIT_SetDefaultWaitTimeout  (
  float fTimeOut      // タイムアウト値（秒）
);

引数

fTimeOut（入力用）

デフォルトのタイムアウト値を秒単位で指定してください。この関数を省略した場合はタイムアウト時間が5秒となります。

戻り値

なし

AIT_SetDtPickerDate

機能

日時ピッカーに日付を設定します。

形式

bool AIT_SetDtPickerDate  (
  string strCaption,     // コントロールのキャプション
  integer nYear,         // 年
  integer nMonth,        // 月
  integer nDay           // 日
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetDtPickerDate  (
  string strCaption,     // コントロールのキャプション
  string strInputDate    // 日付
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetDtPickerDate  (
  integer nCtrlID,       // コントロールID
  integer nYear,         // 年
  integer nMonth,        // 月
  integer nDay           // 日
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetDtPickerDate  (
  integer nCtrlID,        // コントロールID
  string  strInputDate    // 日付
  [,float fTimeOut]       // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nYear（入力用）

コントロールに設定する年を指定してください。

nMonth（入力用）

コントロールに設定する月を指定してください。

nDay（入力用）

コントロールに設定する日を指定してください。

strInputDate

[in] コントロールに設定する日付を指定してください。日付はYYYY/MM/DD形式で、YYYYが年、MMが月、そしてDDが日を示すように指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SetDtPickerTime

機能

日時ピッカーに時刻を設定します。

形式

bool AIT_SetDtPickerTime  (
  string strCaption,     // コントロールのキャプション
  integer nHour,         // 時間
  integer nMinute,       // 分
  integer nSecond        // 秒
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetDtPickerTime  (
  string strCaption,     // コントロールのキャプション
  string strInputTime    // 時刻
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetDtPickerTime  (
  integer nCtrlID,       // コントロールID
  integer nHour,         // 時間
  integer nMinute,       // 分
  integer nSecond        // 秒
  integer [nTimeOut]     // タイムアウト時間
);
bool AIT_SetDtPickerTime  (
  integer nCtrlID,       // コントロールID
  string strInputTime    // 時刻
  [,float fTimeOut]      // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nHour（入力用）

コントロールに設定する時間を指定してください。

nMinute（入力用）

コントロールに設定する分を指定してください。

nSecond（入力用）

コントロールに設定する秒を指定してください。

strInputTime（入力用）

コントロールに設定する時刻を指定してください。時刻はhh:mm:ss形式で、hhが時間、mmが分、そしてssが秒を示すように指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで指定されている値が使われます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SetKeyState

機能

指定したキー状態に設定します。

形式

bool AIT_SetKeyState  (
  integer nVirtualKey,     // 仮想キー
  integer nKeyState        // キー状態
);

引数

nVirtualKey（入力用）

設定する仮想キーを指定してください。これは、次の値のどれかにする必要があります。

値

意味

NUMLOCK

［Num Lock］キー

SCROLLLOCK

［Scroll Lock］キー

CAPSLOCK

［Caps Lock］キー

nKeyState（入力用）

設定するキー状態を指定してください。これは、次の値のどれかにする必要があります。

値

意味

KEYSTATE_OFF

キーのオフ状態

KEYSTATE_ON

キーのオン状態

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

AIT_SetProfileString

機能

INIファイルのセクションにあるキーの値を作成または変更します。

形式

bool AIT_SetProfileString  (
  string strIniFileName,     // INIファイル名
  string strSectionName,     // セクション名
  string strKeyName,         // キー名
  string strValue            // 値
);

引数

strIniFileName（入力用）

INIファイル名を指定してください。

strSectionName（入力用）

INIファイルのセクション名を指定してください。

strKeyName（入力用）

セクション名に属するキー名を指定してください。

strValue（入力用）

設定するキーの値を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。

関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

2

ERROR_FILE_NOT_FOUND

3

ERROR_PATH_NOT_FOUND

5

ERROR_ACCESS_DENIED

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

15

ERROR_INVALID_DRIVE

21

ERROR_NOT_READY

23

ERROR_CRC

53

ERROR_BAD_NETPATH

67

ERROR_BAD_NET_NAME

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

123

ERROR_INVALID_NAME

148

ERROR_PATH_BUSY

1005

ERROR_UNRECOGNIZED_VOLUME

AIT_SetScrollPos

機能

スクロールバーを移動します。

形式

bool AIT_SetScrollPos (
  integer nCtrlID,         // コントロールID
  integer nPosition        // 位置
  [,float fTimeOut]        // タイムアウト時間
);
bool AIT_SetScrollPos (
  string strCaption,       // コントロールのキャプション
  integer nCtrlType,       // コントロールタイプ
  integer nScrollType,     // スクロールタイプ
  integer nPosition,       // 設定位置
  integer nScrollMovement  // 移動タイプ
  [,float fTimeOut]        // タイムアウト時間
);
bool AIT_SetScrollPos (
  integer nCtrlID,         // コントロールID
  integer nCtrlType,       // コントロールタイプ
  integer nScrollType,     // スクロールタイプ
  integer nPosition,       // 設定位置
  integer nScrollMovement  // 移動タイプ
  [,float fTimeOut]        // タイムアウト時間
);

引数

nCtrlID（入力用）

コントロールIDを指定してください。

nPosition（入力用）

設定する位置を指定してください。

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlType（入力用）

スクロールバーを持つコントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

EDIT_CTRL

コントロールタイプはエディットコントロールです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

LIST_CTRL

コントロールタイプはリストコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

nScrollType（入力用）

スクロールバーのタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

VSCROLL

縦スクロールバー

HSCROLL

横スクロールバー

nScrollMovement（入力用）

スクロールバーコントロールの移動タイプを指定してください。nScrollTypeがVSCROLLの場合、これは次の値のどれかにする必要があります。

値

意味

SB_BOTTOM

右下にスクロールします。

SB_LINEDOWN

1行下にスクロールします。

SB_LINEUP

1行上にスクロールします。

SB_PAGEDOWN

1ページ下にスクロールします。

SB_PAGEUP

1ページ上にスクロールします。

SB_THUMBPOSITION

ユーザはスクロールボックス（サム）をドラッグしてマウスボタンを放しました。

SB_THUMBTRACK

ユーザはスクロールボックスをドラッグしています。

SB_TOP

左上にスクロールします。

nScrollTypeがHSCROLLの場合、これは次の値のどれかにする必要があります。

値

意味

SB_LEFT

左上にスクロールします。

SB_RIGHT

右下にスクロールします。

SB_LINELEFT

1単位左にスクロールします。

SB_LINERIGHT

1単位右にスクロールします。

SB_PAGELEFT

ウィンドウ幅分左にスクロールします。

SB_PAGERIGHT

ウィンドウ幅分右にスクロールします。

SB_THUMBPOSITION

ユーザはスクロールボックス（サム）をドラッグしてマウスボタンを放しました。

SB_THUMBTRACK

ユーザはスクロールボックスをドラッグしています。

nTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SetSpinPos

機能

アクティブなウィンドウの特定のコントロールでの位置を設定します。

形式

bool AIT_SetSpinPos (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nPosition      // 設定位置
  [,float fTimeOut]      // タイムアウト時間
);
bool AIT_SetSpinPos (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  integer nPosition      // 設定位置
  [,float fTimeOut]      // タイムアウト時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

SPIN_CTRL

コントロールタイプがスピンコントロール

SLIDER_CTRL

コントロールタイプがスライダーコントロール

nPosition（入力用）

設定する位置を指定してください。

fTimeOut（入力用、省略可）

この関数がコントロールを見つけるために使用できる最大時間を秒単位で指定してください。省略した場合は、関数AIT_SetDefaultWaitTimeoutで設定した値が使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_SetWndPos

機能

指定したウィンドウの位置を変更します。

形式

bool AIT_SetWndPos  (
  integer nWndHandle,     // ウィンドウハンドル
  integer nLeft,          // 水平位置
  integer nTop            // 垂直位置
);

引数

nWndHandle（入力用）

ウィンドウのハンドルを指定してください。0を指定した場合、アクティブなウィンドウの位置が設定されます。

nLeft（入力用）

変更後のウィンドウの左上隅のX座標（水平位置）を指定してください。

nTop（入力用）

変更後のウィンドウの左上隅のY座標（垂直位置）を指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_SetWndPosSize

機能

指定したウィンドウの位置とサイズを変更します。

形式

bool AIT_SetWndPosSize  (
  integer nHandle,      // ウィンドウハンドル
  integer nLeft,        // 水平位置
  integer nTop,         // 垂直位置
  integer nWidth,       // ウィンドウの幅
  integer nHeight       // ウィンドウの高さ
);

引数

nHandle（入力用）

ウィンドウのハンドルを指定してください。0を指定した場合、アクティブなウィンドウの位置が設定されます。

nLeft（入力用）

変更後のウィンドウの左上隅のX座標（水平位置）を指定してください。

nTop（入力用）

変更後のウィンドウの左上隅のY座標（垂直位置）を指定してください。

nWidth（入力用）

変更後のウィンドウの幅を指定してください。

nHeight（入力用）

変更後のウィンドウの高さを指定してください。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_Sleep

機能

AITファイルの実行を一定時間停止します。

形式

AIT_Sleep  (
  float fSeconds        // 秒数
);

引数

fSeconds（入力用）

実行を停止する時間を秒単位で指定してください。

戻り値

なし

AIT_StatusBox

機能

入力したメッセージを含むダイアログボックスを表示します。

形式

bool AIT_StatusBox(
  string       strMessage,   // メッセージ文字列
  [[[[,integer nXCord]       // X座標
  [,integer    nYCord]       // Y座標
  [,integer    nWidth]       // メッセージボックスの幅
  [,integer    nHeight]]     // メッセージボックスの高さ
  [,bool       bIsTop]       // 最前面のメッセージボックス
  [,bool       bIsMovable]]  // 移動可能なメッセージボックス
  [,string     strFontName]] // メッセージのフォント名
  [,integer    nFontSize]    // メッセージのフォントサイズ
  [,integer    nFontWeight]  // メッセージのフォント幅
);

引数

strMessage（入力用）

ダイアログボックスに表示するメッセージ文字列を指定してください。

nXCord（入力用、省略可）

ダイアログボックスの左上隅のX座標を指定してください。-1を指定した場合、X座標の中央にダイアログボックスが表示されます。

nYCord（入力用、省略可）

ダイアログボックスの左上隅のY座標を指定してください。-1を指定した場合、Y座標の中央にダイアログボックスが表示されます。

nXCordおよびnYCordを省略した場合は、ダイアログボックスが中央に配置されます。

nWidth（入力用、省略可）

ダイアログボックスの幅を指定してください。

nHeight（入力用、省略可）

ダイアログボックスの高さを指定してください。

nWidthおよびnHeightを省略した場合は、ダイアログボックスのサイズがstrMessageのサイズと同じになります。

bIsTop（入力用、省略可）

trueを指定すると、ダイアログボックスは常に最前面に配置されます。falseを指定すると、最初は前面に表示されますが、ほかのウィンドウを移動したり作成したりすると、背面に移動します。任意の動作にはfalseを指定してください。

なお、trueを指定しても、ほかのウィンドウの動作によってダイアログボックスが背面に移動する場合があります。この場合、再度APIを実行することでダイアログボックスを最前面に表示できます。

この引数を使用する場合は、nXCord、nYCord、nWidth、およびnHeightを指定する必要があります。

bIsMovable（入力用、省略可）

trueを指定すると、ダイアログボックスは移動可能になります。falseを指定すると、ダイアログボックスは移動できません。

この引数を使用する場合は、nXCord、nYCord、nWidth、およびnHeightを指定する必要があります。

strFontName（入力用、省略可）

メッセージの表示フォントを指定する文字列を指定してください。使用可能なフォントは、システムによって異なることがあります。

任意の動作には""を指定してください。この場合、デフォルトフォントはシステムが決定します。

この引数を使用する場合は、nXCord、nYCord、nWidth、nHeight、bIsTop、およびbIsMovableを指定する必要があります。

nFontSize（入力用、省略可）

メッセージのフォントサイズを整数で指定してください。単位はポイントです。

任意の動作には0を指定してください。この場合、デフォルトフォントサイズはシステムが決定します。

nFontWeight（入力用、省略可）

メッセージのフォント幅を整数で指定してください。有効な値は0〜900です。最低の値を指定すると最も細いフォントに、最高の値を指定すると最も太いフォントになります。

任意の動作には0を指定してください。この場合、デフォルトのフォントの太さはシステムが決定します。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

87

ERROR_INVALID_PARAMETER

注意事項

省略可と示されている引数は独立した引数ではありません。その前の省略可能な引数をデフォルト値で指定する必要があります。例えばnXCordとnYCordだけを指定する場合は、あとに続くほかの省略可能な引数を省けます。しかし、nFontSizeとnFontWeightだけを指定する場合は、あとに続く省略可能な引数を省くことはできません。その前の省略可能な引数にはデフォルト値を指定する必要があります。

AIT_StatusBoxClose

機能

表示されているステータスボックスを閉じます。

形式

AIT_StatusBoxClose ();

引数

なし

戻り値

なし

AIT_StrLeft

機能

文字列の左から指定した文字数分だけ返します。

strStrNameの先頭（左端）から、nNumCharsで指定した文字数分を抽出します。nNumCharsが文字列の長さを超える場合は、文字列全体を抽出します。

形式

string AIT_StrLeft (
  string strStrName,    // 文字列
  integer nNumChars     // 文字数
);

引数

strStrName（入力用）

文字列を指定してください。

nNumChars（入力用）

抽出する文字数を指定してください。

戻り値

抽出した文字列を返します。

注意事項

マルチバイト文字セット（MBCS）の場合は、8ビットごとに1文字としてカウントします。つまり、1マルチバイト文字の先頭および末尾のバイトを2文字としてカウントします。

AIT_StrLength

機能

文字列の長さを返します。

形式

integer AIT_StrLength (
  string strStrName    // 文字列
);

引数

strStrName（入力用）

文字列を指定してください。

戻り値

文字列の長さを返します。

AIT_StrLower

機能

文字列を小文字に変換します。

形式

string AIT_StrLower (
  string strStrName    // 文字列
);

引数

strStrName（入力用）

文字列を指定してください。

戻り値

小文字に変換した文字列を返します。

AIT_StrLTrim

機能

文字列の先頭（左端）から、空白または指定した文字をすべて削除した文字列を返します。

形式

string AIT_StrLTrim (
  string strStrName        // 文字列
  [,string strCharValue]   // 文字の値
);

引数

strStrName（入力用）

文字列を指定してください。

strCharValue（入力用、省略可）

削除する文字を指定してください。省略した場合、文字列の先頭から空白（改行、スペース、タブ文字など）を削除します。

戻り値

文字列の先頭からすべての空白または指定した文字を削除した文字列を返します。

AIT_StrRight

機能

文字列の右から、指定した文字数分だけ返します。

strStrNameの末尾（右端）から、nNumCharsで指定した文字数分を抽出します。nNumCharsが文字列の長さを超える場合は、文字列全体を返します。

形式

string AIT_StrRight (
  string strStrName,    // 文字列
  integer nNumChars     // 文字数
);

引数

strStrName（入力用）

文字列を指定してください。

nNumChars（入力用）

抽出する文字数を指定してください。

戻り値

抽出した文字列を返します。

注意事項

マルチバイト文字セット（MBCS）の場合は、8ビットごとに1文字としてカウントします。つまり、1マルチバイト文字の先頭および末尾のバイトを2文字としてカウントします。

AIT_StrRTrim

機能

文字列の末尾（右端）から空白または指定した文字をすべて削除した文字列を返します。

形式

string AIT_StrRTrim (
  string strStrName        // 文字列
  [,string strCharValue]   // 文字の値
);

引数

strStrName（入力用）

文字列を指定してください。

strCharValue（入力用、省略可）

削除する文字を指定してください。省略した場合は、文字列の末尾から空白（改行、スペース、タブ文字など）を削除します。

戻り値

文字列の末尾からすべての空白または指定した文字を削除した文字列を返します。

AIT_StrTrim

機能

文字列の先頭（左端）および、末尾（右端）から空白または指定した文字をすべて削除した文字列を返します。

形式

string AIT_StrTrim (
  string strStrName        // 文字列
  [,string strCharValue]   // 文字の値
);

引数

strStrName（入力用）

文字列を指定してください。

strCharValue（入力用、省略可）

削除する文字を指定してください。省略した場合は、先頭、および末尾から空白（改行、スペース、タブ文字など）を削除します。

戻り値

文字列の先頭、および末尾から空白または指定した文字を削除した文字列を返します。

AIT_StrUpper

機能

文字列を大文字に変換します。

形式

string AIT_StrUpper (
  string strStrName    // 文字列
);

引数

strStrName（入力用）

文字列を指定してください。

戻り値

大文字に変換した文字列を返します。

AIT_TaskbarClk

機能

タスクバーの空いている場所をクリックします。

形式

bool AIT_TaskbarClk  (
  [integer nMouseButton]     // マウスボタン
);

引数

nMouseButton（入力用、省略可）

マウスでクリックするボタンを指定してください。これは、次の値のどれかにする必要があります。

値

意味

LBUTTON

左マウスボタン

MBUTTON

中央マウスボタン

RBUTTON

右マウスボタン

省略した場合は、RBUTTONがデフォルト値として使用されます。

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_TaskbarHasFocus

機能

タスクバーが入力フォーカスを持っているかどうかを確認します。

形式

integer AIT_TaskbarHasFocus ();

引数

なし

戻り値

タスクバーがフォーカスを持っている場合は戻り値が1、タスクバーがフォーカスを持っていない場合は戻り値が0、失敗した場合は戻り値が-1になります。-1が返された場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_TaskbarSetFocus

機能

タスクバーに入力フォーカスを設定します。

形式

bool AIT_TaskbarSetFocus ();

引数

なし

戻り値

関数が正常に処理された場合の戻り値はtrue、そのほかの場合はfalseになります。関数がfalseを返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

1400

ERROR_INVALID_WINDOW_HANDLE

AIT_VerifyCharPos

機能

アクティブなウィンドウの特定のコントロールで文字位置を確認します。

形式

integer AIT_VerifyCharPos  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nVerifyPos     // 文字位置
);
integer AIT_VerifyCharPos  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  integer nVerifyPos     // 文字位置
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。コントロールタイプはEDIT_CTRLだけが有効です。

nVerifyPos（入力用）

確認する文字の位置の値を指定してください。位置は0を基準にしているため、エディットボックスの最初の文字は、位置が0になります。

戻り値

検索した位置が指定した位置と同じ場合の戻り値は1、異なる場合の戻り値は0、失敗した場合の戻り値は-1になります。

-1が返された場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyCount

機能

アクティブなウィンドウの特定のコントロールで項目数を確認します。

形式

integer AIT_VerifyCount  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nItemCount     // 項目数
);
integer AIT_VerifyCount  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  integer nItemCount     // 項目数
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。これは、次の値のどれかにする必要があります。

値

意味

COMBO_CTRL

コントロールタイプがコンボボックスです。

LISTBOX_CTRL

コントロールタイプがリストボックスです。

TREE_CTRL

コントロールタイプがツリーコントロールです。

LIST_CTRL

コントロールタイプがリストコントロールです。

nItemCount（入力用）

確認する項目数の値を指定してください。

戻り値

指定した項目数と一致する場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1になります。

-1が返された場合は、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyDateTime

機能

アクティブなウィンドウの特定のコントロールで日付または時間を確認します。

形式

integer AIT_VerifyDateTime  (
  string strCaption,     // コントロールのキャプション
  string strDateTime     // 日付または時間
);
integer AIT_VerifyDateTime  (
  integer nCtrlID,       // コントロールID
  string strDateTime     // 日付または時間
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

strDateTime（入力用）

コントロールの日付または時間を指定してください。

戻り値

指定した日付または時間と一致した場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyDefaultButton

機能

アクティブなウィンドウで特定のコマンドボタンがデフォルトボタンかどうかを確認します。

形式

integer AIT_VerifyDefaultButton  (
  string strCaption    // コントロールのキャプション
);
integer AIT_VerifyDefaultButton  (
  integer nCtrlID      // コントロールID
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

戻り値

ボタンがデフォルトボタンの場合の戻り値は1、デフォルトボタンではない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyEnabled

機能

アクティブなウィンドウの特定のコントロールが使用可能かを確認します。

形式

integer AIT_VerifyEnabled  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType      // コントロールタイプ
  [,integer nCtrlPos]    // タブオーダー
);
integer AIT_VerifyEnabled  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType      // コントロールタイプ
  [,integer nCtrlPos]    // タブオーダー
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

nCtrlPos（入力用、省略可）

コントロールのタブオーダーを指定してください。

戻り値

コントロールが使用できる場合の戻り値は1、使用できない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyExistence

機能

アクティブなウィンドウで特定のコントロールが存在するかを確認します。

形式

integer AIT_VerifyExistence  (
  string strCaption,    // コントロールのキャプション
  integer nCtrlType     // コントロールタイプ
);
integer AIT_VerifyExistence  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType     // コントロールタイプ
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

IPADDRESS_CTRL

コントロールタイプはIPアドレスコントロールです。

SLIDER_CTRL

コントロールタイプはスライダーコントロールです。

SCROLLBAR_CTRL

コントロールタイプはスクロールバーコントロールです。

戻り値

コントロールが存在する場合の戻り値は1、存在しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyFirstVisible

機能

リストボックスの最初の、可視項目のインデックスを確認します。

形式

integer AIT_VerifyFirstVisible  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nIndex         // インデックス
);
integer AIT_VerifyFirstVisible  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  integer nIndex         // インデックス
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。コントロールタイプはLISTBOX_CTRLだけ有効です。

nIndex（入力用）

コントロールのインデックスを指定してください。インデックスの基準値は0で、コントロールの最初の項目でのインデックスは0になります。

戻り値

指定したインデックスが最初の可視項目のインデックスと一致する場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyFocus

機能

アクティブなウィンドウの特定のコントロールがフォーカスを持っているかどうかを確認します。

形式

integer AIT_VerifyFocus  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType      // コントロールタイプ
);
integer AIT_VerifyFocus  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType      // コントロールタイプ
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかを指定します。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

戻り値

コントロールがフォーカスを持っている場合の戻り値は1、フォーカスを持っていない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyIndex

機能

アクティブなウィンドウの特定のコントロールでテキストとインデックスが一致しているかどうかを確認します。

形式

integer AIT_VerifyIndex  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  string strCtrlText,    // コントロールテキスト
  integer nIndex         // インデックス
);
integer AIT_VerifyIndex  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  string strCtrlText,    // コントロールテキスト
  integer nIndex         // インデックス
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

strCtrlText（入力用）

コントロールのテキストを指定してください。

nIndex（入力用）

コントロールのインデックスを指定してください。インデックスの基準値は0です。

戻り値

指定したコントロールのインデックスとテキストが一致する場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyKeyState

機能

キーの状態がキーボード上のキーの状態と同じ状態であるかを確認します。

形式

integer AIT_VerifyKeyState  (
  integer nVirtualKey,     // 仮想キー
  integer nKeyState        // キーの状態
);

引数

nVirtualKey（入力用）

確認するキー状態の仮想キーを指定してください。

次の値のどれかに該当する必要があります。

値

意味

NUMLOCK

［Num Lock］キー

SCROLLLOCK

［Scroll Lock］キー

CAPSLOCK

［Caps Lock］キー

nKeyState（入力用）

確認するキーのオンまたはオフの状態を指定してください。次の値のどれかに該当する必要があります。

値

意味

KEYSTATE_OFF

キーはオフ状態

KEYSTATE_ON

キーはオン状態

戻り値

キーの状態が指定した状態と一致している場合の戻り値は1、一致していない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

AIT_VerifyLine

機能

アクティブなウィンドウでインデックスと複数行のエディットボックス上のカレント行が一致しているかどうかを確認します。

形式

integer AIT_VerifyLine  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nIndex         // インデックス
);
integer AIT_VerifyLine  (
  integer nCtrlID,       // コントロールID
  integer nCtrlType,     // コントロールタイプ
  integer nIndex         // インデックス
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。コントロールタイプはEDIT_CTRLだけ有効です。

nIndex（入力用）

確認するカレント行のインデックスを指定してください。インデックスの基準値は0で、エディットボックスの最初の行でのインデックスは0になります。

戻り値

エディットボックスでのカレント行が指定したインデックスと一致する場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyLocation

機能

アクティブなウィンドウの特定のコントロールが指定した座標と一致するかどうかを確認します。

形式

integer AIT_VerifyLocation  (
  string  strCaption,   // コントロールのキャプション
  integer nCtrlType,    // コントロールタイプ
  integer nLeft,        // コントロールの左座標
  integer nTop,         // コントロールの上座標
  integer nRight,       // コントロールの右座標
  integer nBottom       // コントロールの下座標
);
integer AIT_VerifyLocation  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  integer nLeft,        // コントロールの左座標
  integer nTop,         // コントロールの上座標
  integer nRight,       // コントロールの右座標
  integer nBottom       // コントロールの下座標
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

nLeft（入力用）

コントロールの左上隅のX座標を指定してください。

nTop（入力用）

コントロールの左上隅のY座標を指定してください。

nRight（入力用）

コントロールの右下隅のX座標を指定してください。

nBottom（入力用）

コントロールの右下隅のY座標を指定してください。

戻り値

コントロールの座標が指定した座標と一致した場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyMenuChecked

機能

メニュー項目がチェックされているかどうかを確認します。

形式

integer AIT_VerifyMenuChecked  (
  integer nMenu,      // メニューハンドル
  integer nIndex      // メニュー項目のインデックス
);

引数

nMenu（入力用）

AIT_GetMenuまたはAIT_GetSubMenuのAPIが返したメニューハンドルを指定してください。

nIndex（入力用）

メニュー項目のインデックスを指定してください。メニューのインデックス基準値は0で、最初のメニュー項目のインデックスは0になります。

インデックスにはメニューセパレータのインデックスも含まれます。メニューセパレータのインデックスが入力値として与えられた場合、この関数の処理は失敗し拡張エラーコードでERROR_INVALID_INDEXを返します。

戻り値

メニュー項目がチェックされている場合の戻り値は1、チェックされていない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1401

ERROR_INVALID_MENU_HANDLE

1413

ERROR_INVALID_INDEX

1460

ERROR_TIMEOUT

AIT_VerifyMenuEnabled

機能

メニュー項目が使用可能かどうかを確認します。

形式

integer AIT_VerifyMenuEnabled  (
  integer nMenu,      // メニューハンドル
  integer nIndex      // メニュー項目のインデックス
);

引数

nMenu（入力用）

AIT_GetMenuまたはAIT_GetSubMenuのAPIが返したメニューハンドルを指定してください。

nIndex（入力用）

メニュー項目のインデックスを指定してください。メニュー項目のインデックスは0から始まります。したがって、最初のメニュー項目のインデックスは0になります。

インデックスには、メニューセパレータのインデックスも含まれます。メニューセパレータのインデックスが入力値として与えられた場合、この関数の処理は失敗し拡張エラーコードERROR_INVALID_INDEXを返します。

戻り値

メニュー項目が使用できる場合の戻り値は1、使用できない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1401

ERROR_INVALID_MENU_HANDLE

1413

ERROR_INVALID_INDEX

1460

ERROR_TIMEOUT

AIT_VerifyNoOfCtrls

機能

アクティブなウィンドウ内に存在するコントロールの個数が、指定した個数と一致するかどうかを確認します。

形式

integer AIT_VerifyNoOfCtrls  (
  integer nNumControls      // コントロール個数
);

引数

nNumControls（入力用）

確認するコントロールの個数を指定してください。

戻り値

コントロールの個数が一致した場合の戻り値は1、一致しなかった場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

AIT_VerifyPos

機能

アクティブなウィンドウの特定のコントロールが、指定したタブオーダーと一致するかどうかを確認します。

形式

integer AIT_VerifyPos  (
  string strCaption,     // コントロールのキャプション
  integer nCtrlType,     // コントロールタイプ
  integer nCtrlPos       // タブオーダー
);
integer AIT_VerifyPos  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  integer nCtrlPos      // タブオーダー
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

BUTTON_CTRL

コントロールタイプはコマンドボタンです。

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

EDIT_CTRL

コントロールタイプはエディットボックスです。

STATIC_CTRL

コントロールタイプはスタティックテキストです。

COMBO_CTRL

コントロールタイプはコンボボックスです。

LISTBOX_CTRL

コントロールタイプはリストボックスです。

SPIN_CTRL

コントロールタイプはスピンコントロールです。

TREE_CTRL

コントロールタイプはツリーコントロールです。

LIST_CTRL

コントロールタイプはリストコントロールです。

DTPICKER_CTRL

コントロールタイプは日時ピッカーです。

nCtrlPos（入力用）

コントロールのタブオーダーを指定してください。

戻り値

コントロールのタブオーダーが指定したタブオーダーと一致する場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifySelected

機能

アクティブなウィンドウの特定のコントロールで、指定したテキストがコントロール内で選択されているかどうかを確認します。

形式

integer AIT_VerifySelected  (
  string strCaption,      // コントロールのキャプション
  integer nCtrlType,      // コントロールタイプ
  string strSelectedText  // 選択テキスト
);
integer AIT_VerifySelected  (
  integer nCtrlID,        // コントロールID
  integer nCtrlType,      // コントロールタイプ
  string strSelectedText  // 選択テキスト
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。コントロールタイプはEDIT_CTRLだけ有効です。

strSelectedText（入力用）

確認するテキストを指定してください。

戻り値

コントロール内で選択されたテキストが指定したテキストと一致した場合の戻り値は1、一致しない場合の戻り値は0、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

6

ERROR_INVALID_HANDLE

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyState

機能

アクティブなウィンドウで特定のコントロールがチェックされているかどうかを確認します。

形式

integer AIT_VerifyState  (
  string strCaption,    // コントロールのキャプション
  integer nCtrlType     // コントロールタイプ
);
integer AIT_VerifyState  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType     // コントロールタイプ
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。次の値のどれかに該当する必要があります。

値

意味

CHECKBOX_CTRL

コントロールタイプはチェックボックスです。

OPTIONBUTTON_CTRL

コントロールタイプはオプションボタンです。

戻り値

コントロールがチェックされた状態の戻り値は1、チェックされていない状態の戻り値は0、不確定状態の戻り値は2になり、失敗した場合の戻り値は-1になります。不確定状態はCHECKBOX_CTRLだけに適用されます。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

注意事項

コントロールは、完全なキャプションまたは関連するラベル名を使用するか、キャプションまたは関連するラベルの最初の部分を指定することで認識できます。キャプションまたは関連するラベルの最初の部分を指定する場合は、文字列の最初に「~」（波記号）を付けます。

AIT_VerifyText

機能

アクティブなウィンドウで、特定のコントロールが指定したテキストと一致するかどうかを確認します。

形式

integer AIT_VerifyText  (
  string strCaption,    // コントロールのキャプション
  integer nCtrlType,    // コントロールタイプ
  string strText        // テキスト
);
integer AIT_VerifyText  (
  integer nCtrlID,      // コントロールID
  integer nCtrlType,    // コントロールタイプ
  string strText        // テキスト
);

引数

strCaption（入力用）

コントロールのキャプションを指定してください。

nCtrlID（入力用）

コントロールIDを指定してください。

nCtrlType（入力用）

コントロールタイプを指定してください。コントロールタイプはEDIT_CTRLだけ有効です。

strText（入力用）

確認するテキストを指定してください。

戻り値

コントロールのテキストが指定したテキストと一致する場合の戻り値は1、一致しない場合の戻り値は0となり、失敗した場合の戻り値は-1となります。

関数が-1を返した場合には、AIT_GetLastErrorを使用して拡張エラーコードを取得できます。AIT_GetLastErrorが返すおそれのあるエラーコードを次に示します。

拡張エラー番号

エラーコード

8

ERROR_NOT_ENOUGH_MEMORY

14

ERROR_OUTOFMEMORY

87

ERROR_INVALID_PARAMETER

112

ERROR_DISK_FULL

1400

ERROR_INVALID_WINDOW_HANDLE

1460

ERROR_TIMEOUT

AIT_Wow64DisableWow64Redirection

機能

レジストリパス、またはファイルパスに64ビットとしてアクセスするモードに切り替えます。

形式

integer AIT_Wow64DisableWow64Redirection ();

引数

なし

戻り値

レジストリパス、またはファイルパスに64ビットとしてアクセスするモードの場合の戻り値は1、32ビットとしてアクセスするモードの場合の戻り値は0となります。

AIT_Wow64RevertWow64Redirection

機能

レジストリパス、またはファイルパスに32ビットとしてアクセスするモードに切り替えます。

形式

integer AIT_Wow64RevertWow64Redirection ();

引数

なし

戻り値

レジストリパス、またはファイルパスに64ビットとしてアクセスするモードの場合の戻り値は1、32ビットとしてアクセスするモードの場合の戻り値は0となります。

19.3　APIの使用例

AIT言語が提供するAPIの使用例を次に示します。

19.3.1　復帰と改行を削除する

ファイルから読み出した文章には、復帰と改行（¥r¥n）が含まれている場合があります。ファイルから読み出した文章「復帰と改行を削除しました。¥r¥n」から復帰と改行を削除して、RecDFile.logに実行結果を出力する例を次に示します。

(1)　記述例

strFileName = "C:'¥Sample.txt";
strCharValue = "¥r¥n";                    // 復帰と改行の文字列
if (AIT_FileOpen(strFileName, GENERIC_READ, OPEN_EXISTING, nFileHandle))
  // ファイルからデータを読み込みます。
  if (!AIT_FileGetLine(nFileHandle, strReadData))
    AIT_LogMessage("AIT_FileGetLine failed");
  else
    // 読み込んだデータから、復帰と改行を削除します。
    strStrName = AIT_StrRTrim(strReadData, strCharValue);
    AIT_LogMessage("strStrName = " + strStrName);
  endif;
  AIT_FileClose(nFileHandle);
else
  AIT_LogMessage("AIT_FileOpen failed");
endif;

(2)　実行結果

RecDFile.logへの出力結果を次に示します。

strStrName = 復帰と改行を削除しました。

19.3.2　文字列を抽出する

文字列「0123-4567-89AB-CDEF」から英数字だけを抽出して、RecDFile.logへ実行結果を出力する例を次に示します。

(1)　記述例

strStrName = "0123-4567-89AB-CDEF";    // 文字列
strSearchStr = "-";                    // 検索文字列
nStartPos = 0;
while(TRUE)
  // 抽出する文字列の長さを取得します。
  nLength = AIT_FindSubStr(strStrName, strSearchStr, nStartPos);
  if (nLength == -1)
    // 最後に抽出する文字列を設定します。
    strSubString = strStrName;
    AIT_LogMessage("strSubString = " + strSubString);
    // 文字列の抽出を終了します。
    break;
  else
    // 文字列を抽出します。
    if (!AIT_GetSubStr(strSubString, strStrName, nStartPos, nLength))
      AIT_LogMessage("AIT_GetSubStr failed");
      break;
    else
      AIT_LogMessage("strSubString = " + strSubString);
    endif;
    // 抽出する文字列から抽出した文字列を削除します。
    strStrName = AIT_StrLTrim(strStrName, strSubString);
    strStrName = AIT_StrLTrim(strStrName, strSearchStr);
    strSubString = "";
  endif;
loop;
// strStrNameは処理開始前の値と異なります。
AIT_LogMessage("strStrName = " + strStrName);

(2)　実行結果

RecDFile.logへの出力結果を次に示します。

strSubString = 0123
strSubString = 4567
strSubString = 89AB
strSubString = CDEF
strStrName = CDEF

19.3.3　リモートインストール時にレジストリのHKEY_CURRENT_USERを操作する

AITファイルでレジストリのHKEY_CURRENT_USERを操作するAPIを使用する場合、リモートインストール先のコンピュータにAdministrator権限を持たないユーザがログオンしているときは、操作するレジストリがHKEY_USERS¥.DEFAULTへ変更されます。このとき、レジストリのHKEY_CURRENT_USERを操作するには、［スタート］メニューから［ファイル名を指定して実行］を実行して、レジストリファイルをインポートする必要があります。

AITファイルを使用して、リモートインストール時にレジストリのHKEY_CURRENT_USERを操作する手順を説明します。

レジストリファイルを作成する。

追加、変更などを実行したいレジストリのレジストリファイルを作成します。

重要

レジストリを操作する場合は、レジストリをバックアップしておくことと、システムの復元方法を理解しておくことをお勧めします。

AITファイルを作成する。

［スタート］メニューから［ファイル名を指定して実行］を実行し、regedit.exeを利用してレジストリファイルをインポートする例を次に示します。この例では、インポートするレジストリファイルを「Sample.reg」としています。

while(iLoopCount < iLoopMax)
  if((AITEVENTFLAG1==0) && (AITIGNORE == 0))
    // ［スタート］メニューを表示します。
    AIT_PlayKey("{LWIN}");
    AIT_Sleep(SLEEP_TIME_EVENTS);
    // ［ファイル名を指定して実行］を選択します。
    AIT_PlayKey("r");
    AIT_Sleep(SLEEP_TIME_EVENTS);
    AITEVENTFLAG1 = 1;
    AITIGNORE = 1;
    iLoopCount = 0;
  endif;
  if((AITEVENTFLAG1==1) && (AITIGNORE == 0) && (AIT_FocusWindow("ファイル名を指定して実行", "#32770") != 0))
    // レジストリファイルのパスを入力します。
    AIT_GetCurrentDirectory(strPath);
    AIT_PlayKey("regedit.exe /s '"" + strPath + "'¥Sample.reg'"");
    AIT_Sleep(SLEEP_TIME_EVENTS);
    // レジストリファイルをインポートします。
    AIT_PlayKey("{ENTER}");
    AIT_Sleep(SLEEP_TIME_EVENTS);
    iLoopCount = iLoopMax;
    DM_RTN = OK_END;
    continue;
  endif;
  AITIGNORE = 0;
  iLoopCount = iLoopCount + 1;
  AIT_Sleep(SLEEP_TIME);
loop;

配布するソフトウェアと同じディレクトリに、作成したレジストリファイルを格納する。

作成したAITファイルを指定してパッケージングを実行する。

リモートインストールを実行する。

リモートインストール先のコンピュータで、setup.exeなどと同じディレクトリにレジストリファイルが展開され、AITファイルが実行されます。

20　AITのトラブルシューティング

この章では、Automatic Installation Toolでトラブルが発生した場合の対処方法、およびメッセージについて説明します。

20.1　メッセージの確認

AITファイルの実行時やコード解析時に、GUIの操作誤り、ディスク使用超過、メモリ破損などのトラブルが発生した場合は、まず、標準出力またはログファイルにエラーメッセージが出力されているかどうかを確認してください。エラーメッセージが出力されている場合、エラーメッセージのメッセージIDから、エラーが発生しているプログラムやトラブルの要因が特定できます。

20.1.1　メッセージの出力先

メッセージは、ダイアログボックスまたはアウトプットウィンドウに表示されます。なお、一部のメッセージはログファイルに出力されます。ログファイルの格納先を次に示します。

JP1/IT Desktop Management 2のインストール先ディレクトリ¥LOG

メッセージが出力されるログファイルと、その内容は次のとおりです。

ファイル名

最大行数

内容

ait.log

2000

GUI関連のエラーがこのファイルに出力されます。

aitapi.log

2000

API関連のエラーがこのファイルに出力されます。

aitexec.log

2000

実行、解析関連のエラーがこのファイルに出力されます。

20.1.2　メッセージの形式

このマニュアルでは、メッセージを次の形式で説明します。

メッセージID

メッセージテキスト

要因

aa・・・aa

対処

bb・・・bb

例

cc・・・cc

(1)　メッセージID

メッセージの形式：AITXnnnn-Z メッセージテキスト

AIT

メッセージを表示したプログラムがAutomatic Installation Toolであることを表します。

X

メッセージを出力したコンポーネントを表します。

G：GUI

CEまたはCW：AITファイルの実行および解析時（EはERRORを、WはWARNINGを示します）

nnnまたはnnnn

各コンポーネントで任意に割り当てられるメッセージ番号を表します。

Z

メッセージの種別を表します。各種別を説明します。ただし、AITCE、AITCWのメッセージの場合、AITCE、AITCWの「E」および「W」に該当します。

E（ERROR）

致命的なエラーが発生したことを示し、通常は処理が停止するエラーメッセージです。

W（WARNING）

期待された情報が検出されなかったことを示す警告メッセージです。デフォルト値があります。

Q（QUESTION）

ユーザが応答する必要のあるメッセージです。

I（INFORMATION）

重要な活動が実行されていることを示す情報メッセージです。

(2)　メッセージテキスト

メッセージの内容を示したテキストです。メッセージ中の<XXX>の部分は、該当する文字列が実際には表示されます。

(3)　要因

メッセージが表示された要因の説明です。

(4)　対処

メッセージが表示された場合の対処方法の説明です。

(5)　例

APIの誤った使用方法および正しい使用方法の説明です。

20.2　編集ウィンドウ使用時のメッセージ

ここでは、編集ウィンドウ使用時に表示されるメッセージを示します。これらのメッセージは、ダイアログボックスまたはアウトプットウィンドウに表示されます。

AITG100-E

レジストリが無効または壊れている可能性があります。

要因

次の要因が考えられます。

構成レジストリデータベースが壊れています。

構成レジストリキーが無効です。

レジストリが壊れています。レジストリデータを含む一部のファイル構造体が壊れている、システム上のファイルのメモリイメージが壊れている、または代替のコピーかログが存在しないか壊れているためファイルを修復できません。

システムはレジストリ内にファイルをロードするか復元することを試みましたが、指定されたファイルの形式はレジストリファイル形式ではありませんでした。

対処

該当する追加情報に基づいて、必要な処理を実行してください。レジストリが壊れている場合は、修複ディスクを使用して設定情報を復元してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG101-E

レジストリの操作が失敗しました。

要因

次の要因が考えられます。

構成レジストリキーを開けません。

構成レジストリキーを読み込めません。

構成レジストリキーに書き込めません。

レジストリで修復できない失敗を持つI/O操作を開始したため、システムのレジストリイメージを含むファイルの一つに対して、読み取り、書き込み、またはフラッシュを実行できませんでした。

「削除」としてすでに指示されているレジストリキーに対し、誤った操作が実行されました。

レジストリログ内に必要な領域を割り当てられませんでした。

すでにサブキーまたは値のあるレジストリキーにシンボリックリンクを作成できません。

揮発性親キーの下に安定したサブキーを作成しようとしました。

対象となるマルチバイトコードページにUnicode文字のマッピングが存在しません。

インデックス内に指定されたキーと一致するものがありませんでした。

対処

該当する追加情報に基づいて、必要な処理を実行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG102-E

内部でエラーが発生しました。

要因

アプリケーションが次に示す誤ったハンドルで、リソースにアクセスしました。

無効なハンドル

無効なウィンドウハンドル

無効なフックハンドル

対処

アプリケーションを再実行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG103-E

メモリまたはディスクの残容量がありません。

要因

次の要因が考えられます。

このコマンドを処理するための十分な記憶容量がありません。

この処理を完了するための十分な記憶容量がありません。

ディスクがいっぱいです。

ディスク上に十分なスペースがありません。

要求されたサービスを完了するためにはシステムリソースが不足しています。

対処

使用していないアプリケーションをすべて終了して再度処理を試みてください。

ディスク上の不要なファイルを削除してアプリケーションを再実行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG104-E

ファイルまたはディレクトリの操作が失敗しました。

要因

次の要因が考えられます。

システムが指定されたファイルを検索できません。

システムが指定されたパスを検索できません。

システムがファイルを開けません。

システムが指定されたドライブを検索できません。

ディレクトリを削除できません。

システムがファイルをほかのディスクドライブに移動できません。

ファイルが存在しません。

ディレクトリまたはファイルを作成できません。

ファイル名が長過ぎます。

ディレクトリがルートディレクトリのサブディレクトリではありません。

ディレクトリが空ではありません。

ハードディスクへのアクセス中に、ディスク操作に失敗し、さらに再試行も失敗しました。

対処

該当する追加情報に基づいて、必要な処理を実行してください。

例えば、正しいファイル名かパス名または正しいドライブ名を使用して再試行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG105-E

レコーダの起動に失敗しました。

要因

編集ウィンドウから次のどれかが初期化されています。

文法チェック

実行

レコーダ

ウィンドウプロパティ

対処

アプリケーションを再実行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG106-E

デバッグ操作は失敗しました。

要因

デバッグ時にアプリケーションが実行エンジンと交信できません。

対処

アプリケーションを再実行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG107-W

シンタクスファイルは見つかりませんでした。シンタクスハイライトは活性化されませんでした。

要因

編集ウィンドウから文法ファイル（AIT.syn）を検索できません。

対処

次のレジストリキーに指定された文法ファイルのパスが、正しいロケーションを指していません。

OSが32ビット版の場合

HKEY_LOCAL_MACHINE¥SOFTWARE¥HITACHI¥JP1/IT Desktop Management - AIT¥ConfPath

OSが64ビット版の場合

HKEY_LOCAL_MACHINE¥SOFTWARE¥Wow6432Node¥Hitachi¥JP1/IT Desktop Management - AIT¥ConfPath

レジストリ内のパスを検証して、アプリケーションを再実行してください。

AITG108-E

無効な行数です。

要因

［ジャンプ］ダイアログボックスまたは［ブレークポイントの設定］ダイアログボックスの操作時、行番号エディットボックスに無効な行番号が指定されています。

対処

有効な番号を指定して再試行してください。

AITG109-E

文字列'<文字列>'は見つかりません。

要因

［検索］ダイアログボックスまたは［置換］ダイアログボックスの操作時に、アプリケーションが編集ウィンドウのテキストから文字列を検索できません。

対処

必要ありません。

AITG110-E

PACKAGE_INFOセクションの形式は無効です。

要因

［パッケージ情報］ダイアログボックスを呼び出す際の、AITファイル内のPACKAGE_INFOセクションの形式に誤りがあります。

対処

AITファイルの文法をチェックしてから［パッケージ情報］ダイアログボックスを呼び出してください。

AITG111-E

必須項目'<項目名>'を入力してください。

要因

［パッケージ情報］ダイアログボックスで必ず指定する、次のパッケージ項目が指定されていません。

パッケージ識別ID

パッケージ名

バージョン

インストールプログラム名

インストール先ドライブ

インストール先ディレクトリ

対処

必ず指定する項目を指定してからパッケージ情報を生成してください。

AITG112-Q

パッケージ情報を更新しますか？

要因

［レコーダ］ダイアログボックスの［停止］ボタンをクリックすると表示されます。AITファイル内にPACKAGE_INFOセクションを生成するかどうかを選択します。

対処

PACKAGE_INFOセクションを生成するために［パッケージ情報］ダイアログボックスを表示する場合は、［はい］ボタンをクリックしてください。

PACKAGE_INFOセクションのないAITファイルを作成する場合は、［いいえ］ボタンをクリックしてください。

AITG113-E

1から64までの範囲で指定してください。

要因

［オプション］ダイアログボックスの［タブ］パネルの「タブサイズ」に、1〜64以外の整数値が指定されています。

対処

1〜64の整数値を指定して再試行してください。

AITG114-E

無効な文字が入力されました。<指定できる文字列>を指定してください。

要因

［パッケージ情報］ダイアログボックスの、次のパッケージ項目のどれかに無効な文字が指定されています。

パッケージ識別ID

パッケージ名

バージョン

インストールプログラム名

インストール先ディレクトリ

対処

<指定できる文字列>に表示された内容に従って、指定できる文字列を入力してからパッケージ情報を生成してください。

AITG115-W

レジストリキーを更新できません。

要因

次の要因が考えられます。

構成レジストリデータベースが壊れています。

構成レジストリキーが開けません。

構成レジストリキーが読めません。

構成レジストリキーを更新できません。

構成レジストリキーが無効です。

レジストリが壊れています。レジストリデータを含む一部のファイル構造体が壊れている、システム上のファイルのメモリイメージが壊れている、または代替のコピーかログが存在しないか壊れているため、ファイルを修復できません。

システムはレジストリ内のファイルの更新を試みましたが、指定されたファイルの形式はレジストリファイル形式ではありません。

対処

該当する追加情報に基づいて、必要な処理を実行してください。

AITG116-W

レジストリキーを読み込めません。

要因

次の要因が考えられます。

構成レジストリデータベースが壊れています。

構成レジストリキーが開けません。

構成レジストリキーが読めません。

構成レジストリキーが無効です。

レジストリが壊れています。レジストリデータを含む一部のファイル構造体が壊れている、システム上のファイルのメモリイメージが壊れている、または代替のコピーかログが存在しないか壊れているため、ファイルを修復できません。

システムはレジストリからのファイルの読み出しを試みましたが、指定されたファイルの形式はレジストリファイル形式ではありません。

対処

該当する追加情報に基づいて、必要な処理を実行してください。

AITG117-W

レジストリキーを削除できません。

要因

次の要因が考えられます。

構成レジストリデータベースが壊れています。

構成レジストリキーを削除できません。

構成レジストリキーが無効です。

レジストリが壊れています。レジストリデータを含む一部のファイル構造体が壊れている、システム上のファイルのメモリイメージが壊れている、または代替のコピーかログが存在しないか壊れているため、ファイルを修復できません。

システムはレジストリからのファイルの削除を試みましたが、指定されたファイルの形式はレジストリファイル形式ではありません。

対処

該当する追加情報に基づいて、必要な処理を実行してください。

AITG118-W

AITエンジンの処理が実行されています。ファイルを閉じることはできません。

要因

文法チェック中に、処理中のAITファイルを閉じる操作が実行されています。

対処

必要ありません。

AITG119-W

AITエンジンの処理が実行されています。アプリケーションを閉じることはできません。

要因

次の要因が考えられます。

AITファイルが文法チェック中に、アプリケーションを閉じようとした場合

実行エンジンによってAITファイルが実行されている際に、アプリケーションを閉じようとした場合

対処

必要ありません。

AITG120-E

シンボルが見つかりませんでした。

要因

次の要因が考えられます。

デバッグモード時にAITファイルで定義されていない変数を監視ウィンドウに入力した場合

デバッグモード時にAITファイルで定義されていない記号を入力した場合

対処

監視ウィンドウに入力する記号が、デバッグ中のAITファイルで有効な変数であることを確認してください。

AITG121-W

オプションを更新する権限がありません。保存されたオプションは現在のセッションだけに反映されます。

要因

ゲストとしてログオンしているときに、レジストリの値が保存されました。

対処

必要ありません。

AITG122-E

<各パッケージ項目に入力できる最大文字数>文字を超えています。

要因

PACKAGE_INFOセクションの各パッケージ項目に入力できる最大文字数を超えた状態で、PACKAGE_INFOセクションが生成されています。

対処

各パッケージ項目は、最大文字数以下の文字数で入力してください。

AITG123-E

<各パッケージ項目に入力できる最大文字数>文字を超えています。

要因

PP識別情報ファイルの各パッケージ項目に入力できる最大文字数を超えた状態で、PP識別情報ファイルが生成されています。

対処

各パッケージ項目で指定できる文字数を確認して、指定できる範囲内の文字数で入力してください。

AITG124-E

PP識別情報ファイルの操作に失敗しました。

要因

ほかのアプリケーションで操作されているおそれがあります。

対処

ほかのアプリケーションで操作されているPP識別情報ファイルを閉じてください。

AITG125-E

項目'<項目名>'を入力してください。

要因

［パッケージ情報］ダイアログボックスで、次の項目のどちらかが指定されていません。

「AITファイルの格納パス」

「識別用ファイル名」

対処

項目を指定してからパッケージ情報を生成してください。

AITG200-E

レコーディングの操作が失敗しました。

要因

アプリケーションが次に示す誤ったハンドルでリソースにアクセスしました。

無効なハンドル

無効なウィンドウハンドル

無効なフックハンドル

対処

アプリケーションを再実行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG201-E

ウィンドウ詳細の取得に失敗しました。

要因

レコーディング時に、ウィンドウの情報を取得できませんでした。

対処

問題が解決しない場合は、システム管理者に連絡してください。

AITG202-E

コントロール詳細の取得に失敗しました。

要因

レコーディング時に、ウィンドウのコントロール情報を取得できませんでした。

対処

問題が解決しない場合は、システム管理者に連絡してください。

AITG203-E

イベント詳細の取得に失敗しました。

要因

レコーディング時に、イベント情報を取得できませんでした。

対処

問題が解決しない場合は、システム管理者に連絡してください。

AITG204-E

AITファイルでPACKAGE_INFOセクションの生成に失敗しました。

要因

レコーディング終了後にPACKAGE_INFOセクションを生成できませんでした。

対処

一時フォルダを削除して再試行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG205-E

AITファイルでDEFINEセクションの生成に失敗しました。

要因

レコーディング終了後にDEFINEセクションを生成できませんでした。

対処

一時フォルダを削除して再試行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG206-E

AITファイルでMAINセクションの生成に失敗しました。

要因

レコーディング終了後にMAINセクションが生成できませんでした。

対処

一時フォルダを削除して再試行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG208-E

AITファイルの生成に失敗しました。

要因

レコーディング終了後にAITファイルを生成できませんでした。

次の要因が考えられます。

ハードディスクへのアクセス中に、ディスク操作に失敗し、さらに再試行も失敗しました。

このコマンドを処理するための十分な記憶容量がありません。

この処理を完了するための十分な記憶容量がありません。

無効なハンドルです。

対処

該当する追加情報に基づいて、必要な処理を実行してください。

問題が解決しない場合は、システム管理者に連絡してください。

AITG209-I

インストールプログラム<インストールプログラム名>の実行は成功しました。

要因

AITファイルが正常に実行されました。

対処

必要ありません。

AITG211-W

AITファイルのためのログオプションは，レジストリに設定されませんでした。

要因

レジストリ内にログオプションが設定されていません。

対処

レジストリ内のログオプションを設定してください。

AITG212-I

レコーディングの処理が完了しました。

要因

レコーディングが正常に完了しました。

対処

必要ありません。

AITG213-I

AITファイルの作成が成功しました。

要因

レコーディング終了後にAITファイルが正常に生成されました。

対処

必要ありません。

AITG214-W

ユーザ情報ファイルの更新は，存在しないイベントのためにスキップしました。

要因

一時停止後にレコーダがレコーディングを続行できません。

対処

必要ありません。

AITG215-E

レコーディングを継続できませんでした。

要因

一時停止後にレコーダがレコーディングを続行できません。

対処

該当する追加情報に基づいて、必要な処理を実行してください。

AITG216-Q

インストールプログラムの起動に失敗しました。: <インストールプログラム名> <追加情報> レコーディングを続けますか。

要因

［レコーダ］ダイアログボックスで、誤ったインストールプログラム名が指定されています。

次の要因が<追加情報>として表示されます。

指定されたファイルを見つけることができません

指定されたパスを見つけることができません

アクセスが拒否されました

メモリが不足しているため処理を行えません

対処

レコーディングを開始する場合は［はい］ボタンを、追加情報に従って必要な処置を実行する場合は［いいえ］ボタンをクリックしてください。

20.3　実行および解析時のメッセージ

ここでは、AITファイル解析時および実行時に表示されるメッセージを示します。これらのメッセージは、アウトプットウィンドウに表示されます。

AITCE-0001

<トークン1>は予期しないものです。<トークン2>は見つかりません。

要因

無効なキーワードまたはシンボル<トークン1>が検出されました。スクリプト解析では、キーワードまたはシンボル<トークン2>を予期しています。

対処

必要に応じて<トークン2>を追加してください。

例

誤った指定例

DEFINE
{
   const integer OK_END = 0;
   const integer NG_END = -1      // 「;」が指定されていません
   const integer sloop_max = 30;
}

正しい指定例

DEFINE
{
   const integer OK_END = 0;
   const integer NG_END = -1;      // 「;」を追加しました
   const integer sloop_max = 30;
}

AITCE-0002

<トークン>は予期しないものです。

要因

無効なキーワードまたはシンボル<トークン>が検出されました。

対処

予期されないキーワードまたはシンボルを削除してください。

例

誤った指定例

DEFINE
{
   integer OK_END = 0;
   integer sloop_max = 0;;      // 「;」が2つ指定されています
}

変数「sloop_max」に「;」が2つ指定されています。

正しい指定例

DEFINE
{
   integer OK_END = 0;
   integer sloop_max = 0;      // 「;」を削除しました
}

変数「sloop_max」の「;」を1つ削除しました。

AITCE-0003

関数名を識別子名として使用しています。

要因

関数名は識別子として使用できません。

対処

識別子名を変更してください。

例

誤った指定例

DEFINE
{
   integer AIT_LogMessage = 10;
}

変数名に関数名が使用されています。

正しい指定例

DEFINE
{
   integer AIT_LogMessageNumber = 10;
}

変数名を「AIT_LogMessageNumber」に変更しました。

AITCE-0005

階層数が255を超えています。

要因

AITファイル内で構造体の階層レベルが最大値の255を超えています。

対処

if、if-else、do-while、whileまたはswitch構造体の階層レベルが最大値の255を超えると、AITファイルの解析ができなくなります。AITファイルを再編集し、構造体の階層レベルのネストを浅くしてください。

AITCE-0006

識別子名が64文字を超えています。

要因

各識別子名に使用できる最大文字数は64です。この最大文字数を超える識別子名がAITファイルに存在します。

対処

識別子名は1〜64文字で指定してください。

例

誤った指定例

DEFINE
{
   integer sloop_max = 0;
   integer sample123456sample123456sample123456sample123456sample123456sample = 0;      // 66文字で変数名が指定されています
}

2番目に定義した変数名が最大文字数を超えています。

正しい指定例

DEFINE
{
   integer sloop_max = 0;
   integer sample123456 = 0;   // 64文字以内で変数名を指定しました
}

2番目に定義した変数名を最大文字数内で指定しました。

AITCE-0007

文字列定数が複数列にわたっています。

要因

最初の行が¥nで終わっているため、文字列定数が2行目に続いています。

対処

文字列定数は1行で指定してください。

例

誤った指定例

DEFINE
{
   integer sloop_max = 0;
   string SoftwareName = " My
                               Setup";      // 文字列定数が2行目に続いています
}

変数「SoftwareName」の文字列定数が2行目に続いています。

正しい指定例

DEFINE
{
   integer sloop_max = 0;
   string SoftwareName = " My Setup";   // 文字列定数を1行で指定しました
}

変数「SoftwareName」の文字列定数を1行で指定しました。

AITCE-0008

エスケープシーケンスの使用方法が誤っています。

要因

実行時に指定されたAITファイルの文字列定数に、誤ったエスケープシーケンスが含まれています。

対処

文字列定数には、正しいエスケープシーケンスを使用してください。

例

誤った指定例

DEFINE
{
   integer sloop_max = 0;
   string str1 = "sample'
                  testing";
}

文字列変数「strl」は「'」付きの文字列が代入されていますが、その文字列が複数行にわたって記述されています。

文字列が連続していることを示す文字「_」を「'」の代わりに使用する必要があります。

正しい指定例

DEFINE
{
   integer sloop_max=10;
   string str1 = "sample_
                  testing";
}

「'」を削除してエスケープシーケンスの誤りを修正しました。

AITCE-0009

case内で識別子は使用できません。

要因

case内で識別子を指定しています。

対処

case内では、定数またはマクロだけを使用してください。

例

誤った指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch (FileVersion)
      case stMsgText:      // caseに識別子が指定されています
         ...
         break;
      default:
         ...
         break;
   endswitch;
}

case内に、識別子「stMsgText」が指定されています。

正しい指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch (FileVersion)
      case "7.1":      // 識別子の代わりに文字列定数を指定しました
         ...
         break;
      default:
         ...
         break;
   endswitch;
}

case内に、識別子「stMsgText」の代わりに文字列定数を指定しました。

AITCE-0010

"+" または "-"の使用方法が誤っています。

要因

AITファイルで、「++」、「--」、「+-」、または「-+」演算子が指定されています。AITファイルの解析では、これらの演算子を解析できません。

対処

「++」、「--」、「+-」、または「-+」演算子をAITファイルから削除してください。

例

誤った指定例

DEFINE
{
   integer sloop_count = 0;
}
MAIN
{
   if (AIT_FileExists("#setup.exe") == 0)
      ...
      ...
      sloop_count++;      // 誤った演算子「++」が変数の増分に使用されています
   endif;
}

インクリメント演算子とディクリメント演算子は使用できません。

変数「sloop_count」が「++」で増分されているため、エラーメッセージが表示されます。

正しい指定例

DEFINE
{
   integer sloop_count = 0;
}
MAIN
{
   if (AIT_FileExists("#setup.exe") == 0)
      ...
      ...
      sloop_count = sloop_count + 1;      // 「++」を削除しました
   endif;
}

「++」を変数「sloop_count」から削除しました。

AITCE-0011

AITファイルが65535行を超えています。

要因

AITファイル内の最大行数は65,535です。AITファイルがこの最大値を超えると、AITファイルの解析を停止します。

対処

AITファイル内の行数を減らしてください。

AITCE-0012

<識別子> : 定義されていない識別子です。

要因

変数の型を定義しないで変数が指定されています。

対処

DEFINEセクションで変数を定義してください。

例

誤った指定例

DEFINE
{
   string stMsgText;
}
MAIN
{
   if (AIT_FileExists("#setup.exe") == 0)
      stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
      AIT_LogMessage(stMsgText);
      sloop_max = 0;      // この変数はDEFINEセクションで定義されていません
   endif;
}

DEFINEセクションで変数「sloop_max」が定義されていないまま、MAINセクションでこの変数が指定されています。

正しい指定例

DEFINE
{
   string  stMsgText;
   integer sloop_max;      // 変数「sloop_max」を定義しました

}
MAIN
{
   if (AIT_FileExists("#setup.exe") == 0)
      stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
      AIT_LogMessage(stMsgText);
      sloop_max = 0;      // 定義した変数を利用しました
   endif;
}

変数「sloop_max」がDEFINEセクションで定義され、その変数がMAINセクションで指定されました。

AITCE-0013

<識別子> : 再定義されました。

要因

すでに識別子が定義されている場合に、それと同じ識別子が再定義されています。

対処

再定義されている変数を削除してください。

例

誤った指定例

DEFINE
{
   integer sloop_max = 10;
   string sloop_max = "sample";      // 変数「sloop_max」がstring型として再定義されています。
}

すでにinteger型として定義されている変数「sloop_max」が、string型変数として再定義されています。

正しい指定例

DEFINE
{
   integer sloop_max = 10;
   string stMsgText = "sample";      // 変数名を変更しました
}

変数「sloop_max」の再定義を削除し、異なる変数名を定義しました。

AITCE-0014

パッケージ情報のフィールド <パッケージ項目>のデータ<値>が誤っています。

要因

PACKAGE_INFOセクション内のパッケージ項目のどれかに無効な値が含まれています。

対処

パッケージ情報のフィールドに適した値を指定してください。

例

誤った指定例

PACKAGE_INFO
{
   PackageID = "#$@#ADOBEACROBATREADER";      // PackageIDに無効な文字#$@#が含まれています
   Product = "Adobe Acrobat Reader 5.05";
   Version = "505";
   InstallerName = "Ar505jpn.exe";
   InstallDrive = "C:";
   InstallDirectory = "'¥Program Files'¥Adobe";
}

PACKAGE_INFOセクションのPackageIDに、使用できない文字列「#$@」が含まれています。

正しい指定例

PACKAGE_INFO
{
   PackageID = "ACROBAT-READER";   // 使用できない文字 #$@#を削除しました
   Product = "Adobe Acrobat Reader 5.05";
   Version = "505";
   InstallerName = "Ar505jpn.exe";
   InstallDrive = "C:";
   InstallDirectory = "'¥Program Files'¥Adobe";
}

PACKAGE_INFOセクションのPackageIDから、使用できない文字列「#$@」を削除しました。

AITCE-0015

左辺値はconstオブジェクトに指定されています。

要因

constant型として定義された変数にMAINセクションで値が割り当てられています。

対処

constant定義を変更するか、割り当てた左辺を削除してください。

例

誤った指定例

DEFINE
{
   const float SLEEP_TIME = 2.0;
   integer sloop_count;
}
MAIN
{
   if (AIT_FocusWindow("Setup", "#32770",0.0) > 0)
      AIT_PlayKey("{Enter}");
      AIT_LogMessage("Setup: Enter");
      sloop_count = 0;
      SLEEP_TIME = 3.0;      // 変数「SLEEP_TIME」のconstant値を変更しようとしています
      AIT_Sleep(SLEEP_TIME);
   endif;
}

変数「SLEEP_TIME」は、constant float型として定義されていますが、MAINセクション内で別の値が割り当てられました。

正しい指定例

DEFINE
{
   const float SLEEP_TIME = 3.0;
   integer sloop_cnt;
}

MAIN
{
   if (AIT_FocusWindow("Setup", "#32770",0.0) > 0)
      AIT_PlayKey("{Enter}");
      AIT_LogMessage("Setup : Enter");
      sloop_cnt = 0;
      AIT_Sleep(SLEEP_TIME);
   endif;
}

MAINセクション内で、変数「SLEEP_TIME」のconstant float値への割り当てを削除しました。

AITCE-0018

AITファイルの構文誤りによって，AITファイルの解析が異常終了しました。

要因

文法チェック中に致命的なエラー（文字列の終了処理が正しくない、変数名内の文字数が正しく指定されていない）が発生しています。

対処

エラー個所を修正したあと、AITファイルを再度確認してください。

例

誤った指定例

DEFINE
{
   string ErrorTxt = "ABC
def";
}

文字列定数は、複数の行にわたって指定できませんが、文字列が複数の行にわたって指定されています。

正しい指定例

DEFINE
{
   string ErrorTxt = "ABC_
def";      // 「_」で文字列が連続していることを示しています。
}

文字列の連続を示す「_」を付けて指定しました。

AITCE-0019

除算の2番目のオペランドは0です。

要因

AITファイルの解析時に除算の2番目のオペランドが0のため、未定義として扱われています。

対処

0以外の値を除数として指定してください。

例

誤った指定例

DEFINE
{
   integer sloop_count = 0;
   const integer  sloop_max = 30;
}
MAIN
{
   sloop_count = sloop_max / 0;      // 除数が0であるため、エラーになります
}

0による除算はできませんが、変数「sloop_max」を0で除算しています。

正しい指定例

DEFINE
{
   integer sloop_count = 0;
   const integer sloop_max = 30;
}
MAIN
{
   sloop_count = sloop_max / 1;      // 除数が0以外の値に変更しました
}

0による変数「sloop_max」の除算を削除しました。

AITCE-0020

<データ型1>と<データ型2>は<処理名>と互換性がありません。

要因

演算子の左辺値と右辺値で互換性のないデータ型が指定されています。例えば、string型とinteger型が比較に使用された場合、このメッセージが表示されます。

対処

演算子の左辺値と右辺値の両方で互換性のあるデータ型を指定してください。

例

誤った指定例

DEFINE
{
   const integer ExeVersion = 7;
   const string FileVersion = "7";
}
MAIN
{
   if (ExeVersion == FileVersion)   // string型とinteger型が比較に使用されています
      ...
      ...
   endif;
}

integer型変数「ExeVersion」とstring型変数「FileVersion」が比較に使用されています。

string型とinteger型には、比較演算のための互換性がありません。

正しい指定例

DEFINE
{
   const integer ExeVersion = 7;
   const integer FileVersion = 7;
}
MAIN
{
   if (ExeVersion == FileVersion)      // 同じ型を比較に使用しました
      ...
      ...
   endif;
}

string型変数「FileVersion」をinteger型変数に変更し、integer型変数との比較に変更しました。

AITCE-0021

オペレーション<演算子名>で<データ型1>の使用方法が誤っています。

要因

演算で不適切なデータ型が指定されています。例えば、float型が剰余（%）演算に使用された場合や、string型が!演算に使用された場合、このメッセージが表示されます。

対処

各演算で使用できるデータ型を指定してください。

例

誤った指定例

DEFINE
{
   float SLEEP_TIME = 7.1;
}
MAIN
{
   SLEEP_TIME = SLEEP_TIME % 2;      // floatは剰余演算で使用できないため、エラーになります
}

float型は剰余演算に使用できませんが、float型変数「SLEEP_TIME」が剰余演算に使用されています。

正しい指定例

DEFINE
{
   integer SLEEP_TIME = 7;
}
MAIN
{
   SLEEP_TIME = SLEEP_TIME % 2;      // integer型変数を剰余演算に使用しました
}

integer値を剰余演算に使用しました。

AITCE-0022

integer値は'-2147483648'〜'2147483647'の範囲で指定してください。

要因

許容範囲外のinteger値が指定されています。

対処

'-2,147,483,648'〜'2,147,483,647'でinteger値を指定してください。

例

誤った指定例

DEFINE
{
   const integer OK_END = 21474836476;      // integer値が最大値を超えています
}

変数「OK_END」に最大値よりも大きいinteger値が指定されています。

正しい指定例

DEFINE
{
   const integer OK_END =214748364;      // integer値の範囲内で指定しました
}

変数「OK_END」にinteger値の範囲内の値を指定しました。

AITCE-0023

float値は'3.402823466e+38'〜'1.175494351e-38'の範囲で指定してください。

要因

許容範囲外のfloat値が指定されています。

対処

'3.402823466e+38'〜'1.175494351e-38'でfloat値を指定してください。

例

誤った指定例

DEFINE
{
   const float NG_END = 3.402823466e+40;      // float値が最大値を超えています
}

変数「NG_END」に最大値よりも大きいfloat値が指定されています。

正しい指定例

DEFINE
{
   const float NG_END = 3.402823466e+10;      // float値の範囲内で指定しました
}

変数「NG_END」にfloat値の範囲内の値を指定しました。

AITCE-0024

switch式の求める数値のデータ型が誤っています。

要因

caseラベル値のデータ型がswitchステートメントのcaseのデータ型と一致していません。例えば、switchステートメントがinteger型の場合にcase値にfloat値が含まれていると、このメッセージが表示されます。

対処

switchステートメントとcaseラベル値で一致するデータ型を指定してください。

例

誤った指定例

DEFINE
{
   const string FileVersion = "7.1";
   integer sloop_max = 0;
}
MAIN
{
   switch (FileVersion)   // switchステートメントはstring型です
       case 7.1:      // caseにinteger値が指定されています
         ...
         ...
         break;
      default:
         ...
         ...
         break;
   endswitch;
}

switchステートメントのデータ型はstring型ですが、case値はinteger型になっています。

正しい指定例

DEFINE
{
   const string FileVersion = "7.1";
   integer sloop_max = 0;
}
MAIN
{
   switch (FileVersion)
      case "7.1":    // caseラベルにstring値を指定しました
         ...
         ...
         break;
      default:
         ...
         ...
         break;
   endswitch;
}

case値にstring型を指定し、switch文のデータ型と一致するよう変更しました。

AITCE-0025

コメントで予期しないEOFが検出されました。

要因

「/*」で開始されたコメントがファイルの終わりまでに「*/」で終了されていません。

対処

ファイルの終わりまでに、コメントを閉じる「*/」を指定してください。

例

誤った指定例

DEFINE
{
   /* AITファイルで使用するデータ型   // コメントが閉じられていません
   const integer NG_END = -1
   const integer sloop_max = 30;
}

コメントはすべて閉じる必要があります。この例では、「/*」でコメントが開始されていますが、「*/」で終了されていません。

正しい指定例

DEFINE
{
   /* AITファイルで使用するデータ型 */   // コメントが終了されています
   const integer NG_END = -1;
   const integer sloop_max = 30;
}

コメントが「*/」で終了されました。

AITCE-0026

<文字コード（16進数）>は不正な文字です。

要因

AIT言語仕様で規定されていない文字が存在します。文字コードが16進数で表示されます。

対処

AIT言語仕様に記載されている有効な文字だけを指定してください。

例

誤った指定例

DEFINE
{
   const integer OK_END = 0;
   const integer NG_END = -1;
   const integer sloop_max = #30;      // 無効な文字「#」があります
}

「#$@」といった無効な文字は、文字列定数内で使用できませんが、「#」が変数「sloop_max」に含まれています。

正しい指定例

DEFINE
{
   const integer OK_END =0;
   const integer NG_END = -1;
   const integer sloop_max = 30;    // 無効な文字「#」を削除しました
}

「#」を変数「sloop_max」から削除しました。

AITCE-0027

式の中ではvoid型を使用できません。有効な型を使用してください。

要因

voidを返す関数が式で使用されています。

対処

voidを返す関数は式で使用しないでください。

AITCE-0029

caseの値<caseラベル値>はすでに使われています。

要因

switchステートメントで同じcase値が複数回使用されています。

対処

固有のcaseラベル値を指定してください。

例

誤った指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch(FileVersion )
      case "7.1":
         ...
         ...
         break;
      case "7.1":      // case値"7.1"はすでに使用されています
         ...
         ...
         break;
      default:
         ...
         ...
         break;
   endswitch;
}

switchステートメント内で固有のcaseラベル値を指定する必要があります。

ここで、2番目のcaseラベル値"7.1"は最初のcaseラベル値と同じです。

正しい指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch(FileVersion )
      case "7.1":      // 重複するcase値"7.1"を削除しました
         ...
         ...
         break;
      default:
         ...
         ...
         break;
   endswitch;
}

2番目のcaseラベル値を削除しました。

AITCE-0030

<関数名> : 関数名が誤っています。

要因

無効な関数名（使用できるAPI一覧にない関数名）が指定されています。

対処

AITファイルで有効な関数名を指定してください。有効な関数（API名）の一覧は、「19.1　API一覧」を参照してください。

例

誤った指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      if (AIT_FileExists1("#setup.exe") == 0)      // 「AIT_FileExists1」は使用できるAPIではありません
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
      endif;
   endif;
}

「AIT_FileExists1()」は使用できるAPIではありません。

正しい指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      if (AIT_FileExists("setup.exe") == 0)      // 使用できるAPIを指定しました
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
      endif;
   endif;
}

使用できるAPIとして「AIT_FileExists()」を指定しました。

AITCE-0031

<関数名> : 引数<指定されている引数の数>を取得できません。

要因

引数の数に誤りのある関数が含まれています。

関数にはそれぞれ独自の引数のセットがあります。関数に対して指定された引数の数が、実際に呼び出させる関数の引数の数と一致しないと、このメッセージが呼び出されます。

対処

関数に対して正しい数の引数を指定してください。実際の引数のリストについては、「19.2　APIの詳細」を参照してください。

例

誤った指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      if (AIT_FileExists() == 0)      // 「AIT_FileExists」に引数が指定されていません
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
      endif;
   endif;
}

「AIT_FileExists()」に対しては、1つ以上の引数を指定してください。この例では「AIT_FileExists()」に対して引数が指定されていません。

正しい指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      if (AIT_FileExists("#setup.exe") == 0)
      // 「AIT_FileExists」に対して引数を指定しました
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
      endif;
   endif;
}

「AIT_FileExists()」に対して引数を指定しました。

AITCE-0032

関数に指定された一つまたは複数の変数のデータ型が誤っています。

要因

引数のデータ型と一致しないデータ型が関数に含まれています。

関数にはそれぞれ独自の引数のセットがあります。関数に対して指定された引数のデータ型が、実際に呼び出させる関数の引数のデータ型と一致しないと、このメッセージが呼び出されます。

対処

関数の引数で正しいデータ型を指定してください。実際の引数のリストについては、「19.2　APIの詳細」を参照してください。

例

誤った指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion )
      if (AIT_FileExists("#setup.exe") == 0)
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
         AIT_Sleep(3);      // integer値が「AIT_Sleep」に指定されています
      endif;
   endif;
}

「AIT_Sleep()」には、float型の引数だけが指定できますが、integer値が引数として指定されています。

正しい指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string  FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == Version)
      if (AIT_FileExists("#setup.exe") == 0)
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
         AIT_Sleep(3.1);      // integer値をfloat値に変更しました
      endif;
   endif;
}

「AIT_Sleep()」の引数をintegerからfloatに変更しました。

AITCE-0034

<ラベル名> : 定義されていないラベルです。

要因

ラベルを定義しないでgotoステートメントが使用されています。

AITファイルでは、各gotoステートメントに対して関連するラベルを定義する必要があります。

対処

すべてのgotoステートメントに対して関連ラベル名を指定してください。

例

誤った指定例

DEFINE
{
   integer sloop_max = 0;
}
MAIN
{
   goto ErrorLabel; // ラベル「ErrorLabel」が定義されていません
   sloop_max = 0;
}

gotoステートメントに対して、関連するラベルステートメントを指定する必要があります。

ここでは、goto ErrorLabelしか指定されていません。ラベル「ErrorLabel」はMAINセクションのどこにも定義されていません。

正しい指定例

DEFINE
{
   integer sloop_max = 0;
}
MAIN
{
   goto ErrorLabel;
   sloop_max = 0;
ErrorLabel:      // ラベルを定義しました
}

gotoステートメントに対してラベル「ErrorLabel」を指定しました。

AITCE-0037

gotoのラベル<ラベル名>は別のセクションにあります。

要因

指定されたラベル名とそれに対応するgotoステートメントが別のセクションに存在します。

gotoステートメントとそれに関連するラベルは、同じセクション内にある必要があります。

対処

ラベル名とgotoステートメントは同じセクション内で指定してください。

例

誤った指定例

DEFINE
{
   string stMsgText;
}
MAIN
{
   goto ErrorLabel;      // gotoステートメントがMAINセクションで定義されています
}
ERROR
{
ErrorLabel:      // ラベルがERRORセクションで定義されています
      stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
}

ラベルとそのgotoステートメントは、同じセクション内で定義する必要があります。この例では、gotoステートメントがMAINセクション内にあり、ラベル「ErrorLabel」がERRORセクション内にあります。

正しい指定例

DEFINE
{
   string stMsgText;
}
MAIN
{
      goto ErrorLabel;
ErrorLabel:      // ラベルがMAINセクション内で定義されています
      stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
}

ラベル「ErrorLabel」とそのgotoステートメントをMAINセクション内で定義しました。

AITCE-0038

変数の設定値の型が誤っています。

要因

変数に対して指定された値が変数のデータ型と異なります。例えば、string値がinteger型変数に割り当てられると、このメッセージが呼び出されます。

対処

変数と同じ型の値を指定してください。

例

誤った指定例

DEFINE
{
   const integer OK_END =0;
   const integer NG_END = -1;
   const integer sloop_max = "30";      // string値がinteger型変数に割り当てられています
}

この例では、文字列定数が整数定数「sloop_max」に割り当てられています。

正しい指定例

DEFINE
{
   const integer OK_END =0;
   const integer NG_END = -1;
   const integer sloop_max = 30;      // string値でなくinteger値を割り当てました
}

文字列定数を削除し、integer値の変数「sloop_max」を割り当てました。

AITCE-0039

breakの使用方法が誤っています。

要因

do-while、while-loop、for-next、またはswitchステートメント以外でbreakステートメントが使用されています。breakステートメントはループ構造体内だけで有効です。

対処

breakステートメントは、do-while、while-loop、for-next、またはswitchステートメント内で使用してください。

例

誤った指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion )
      if (AIT_FileExists("#setup.exe") == 0)
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
         break;      // breakステートメントがifステートメント内にあります
      endif;
   endif;
}

この例では、breakステートメントがif構造体内にあります。

正しい指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string  FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      if (AIT_FileExists("#setup.exe") == 0)
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
      endif;
   endif;
}

breakステートメントをif構造体から削除しました。

AITCE-0040

continueの使用方法が誤っています。

要因

do-while、while-loop、またはfor-next以外でcontinueステートメントが使用されています。continueステートメントは、ループ構造体内だけで有効です。

対処

continueステートメントは、do-while、while-loop、またはfor-nextステートメント内だけで使用してください。

例

誤った指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      if (AIT_FileExists("#setup.exe") == 0)
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
         continue;      // continueステートメントがifステートメント内にあります
      endif;
   endif;
}

この例では、continueがif構造体内にあります。

正しい指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string  FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      if (AIT_FileExists("#setup.exe") == 0)
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
      endif;
   endif;
}

continueステートメントをif構造体から削除しました。

AITCE-0041

'<ループ構造体>'が255 breakステートメントを超えました。

要因

255より多くのbreakステートメントがループ構造体内にあります。ループ構造体（do-while、while、for-nextまたはswitch構造体）内で使用できるbreakステートメントの最大数は255です。

対処

ループ構造体内で指定するbreakステートメントの数を、最大数以下にしてください。

AITCE-0042

'<ループ構造体>'が255 continueステートメントを超えました。

要因

255より多くのcontinueステートメントがループ構造体内にあります。ループ構造体（do-while、while、for-next）内で使用できるcontinueステートメントの最大数は255です。

対処

ループ構造体内で指定するcontinueステートメントの数を、最大数以下にしてください。

AITCE-0043

switchステートメントのcaseラベル数が255を超えています。

要因

255より多くのcaseラベルがswitchステートメント内にあります。switchステートメント内で使用できるcaseラベルの最大数は255です。

対処

switchステートメント内で指定するcaseラベルの数は、最大数以下にしてください。

AITCE-0044

switchステートメントに一つ以上のdefaultラベルは使用できません。

要因

switchステートメント内で使用できるdefaultステートメントは1つだけです。

対処

switchステートメント内で指定するdefaultステートメントは1つだけにしてください。

例

誤った指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch(FileVersion )
      case "7.1":
         ...
         ...
         break;
      default:      // 最初のdefaultです
         ...
         ...
         break;
      default:      // defaultが2つ指定されています
         ...
         ...
         break;
   endswitch;
}

各switchステートメントで指定できるdefaultステートメントは1つだけです。この例では、switchステートメントにdefaultステートメントが2つ指定されています。

正しい指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch(FileVersion)
      case "7.1":
         ...
         ...
         break;
      default:      // defaultを1つだけ指定しました
         ...
         ...
         break;
   endswitch;
}

switchステートメントからdefaultステートメントを1つ削除しました。

AITCE-0045

パッケージ情報に必要なフィールド'<フィールド名>'が見つかりません。

要因

PACKAGE_INFOセクションで指定する必要のあるフィールドのうち、どれかが指定されていません。

対処

PACKAGE_INFOセクションで必要なすべてのフィールドを指定してください。

例

誤った指定例

PACKAGE_INFO
{
   // 指定する必要のあるPackageIDが欠けています
   Product = "Adobe Acrobat Reader 5.05";
   Version = "505";
   InstallerName = "Ar505jpn.exe";
   InstallDrive = "C:";
   InstallDirectory = "'¥Program Files'¥Adobe";
}

指定する必要のあるPackageIDが指定されていません。

正しい指定例

PACKAGE_INFO
{
   PackageID = "ADOBEACROBATREADER";   // 指定する必要のあるパッケージ項目を指定しました
   Product = "Adobe Acrobat Reader 5.05";
   Version = "505";
   InstallerName = "Ar505jpn.exe";
   InstallDrive = "C:";
   InstallDirectory = "'¥Program Files'¥Adobe";
}

PackageIDをPACKAGE_INFOセクション内に追加しました。

AITCE-0046

演算子'+','-'と'!'は，文字列定数で使用できません。

要因

単項演算子と文字列定数が一緒に指定されています。

対処

単項演算子と文字列定数は一緒に指定しないでください。

例

誤った指定例

DEFINE
{
   const integer OK_END =0;
   const integer NG_END = -1;
   const string szMsgText = !"30";  // 「!」を文字列定数に使用しました
}

DEFINEセクションで文字列定数を初期化する際、単項演算子（「+」、「-」、および「!」）は使用できません。

ここでは、変数「szMsgText」で、「!」が文字列定数と一緒に指定されています。

正しい指定例

DEFINE
{
   const integer OK_END =0;
   const integer NG_END = -1;
   const string szMsgText = "30";      // 「!」を削除しました
}

「!」を変数「szMsgText」から削除しました。

AITCE-0047

式内でラベルの使用方法が誤っています。

要因

ラベルが式内で使用されています。

対処

ラベルは式内で使用しないでください。

例

誤った指定例

DEFINE
{
   integer sloop_max = 0;
}
MAIN
{
ErrorLabel:
   if (ErrorLabel)      // if構造体内でラベル名が使用されています
      AIT_LogMessage("Setup(Japanese)For Windows-Start");
      if (AIT_FileExists("#setup.exe") == 0)
         goto ErrorLabel;
         sloop_max = 0;
      endif;
   endif;
}

ラベルは式内で使用できません。この例では、ラベル「ErrorLabel」がif構造体内で指定されています。

正しい指定例

DEFINE
{
   integer sloop_max = 0;
   string stMsgText;
}
MAIN
{
   if(1)      // ラベルを式から削除しました
      if (AIT_FileExists("#setup.exe") == 0)
         goto ErrorLabel;
         sloop_max = 0;
      endif;
ErrorLabel:
      stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
      AIT_LogMessage(stMsgText);
   endif;
}

ラベル「ErrorLabel」をif構造体から削除し、式内の値を有効にしました。

AITCE-0048

case内で ""!"" 演算子は使用できません。

要因

caseラベル値に式が指定されています。switchステートメント内のcaseラベル値には定数値しか指定できません。

対処

caseラベル値内では式を指定しないでください。

例

誤った指定例

DEFINE
{
   const integer FileVersion = 7;
   string stMsgText;
}
MAIN
{
   switch (FileVersion)
      case 7:
         ...
         ...
         break;
      case 5 + 1:      // caseステートメント内では式を使用できません
         ...
         ...
         break;
      default:
         ...
         ...
         break;
   endswitch;
}

switchステートメント内では定数だけが指定できます。この例では、2番目のcaseラベルに加算演算式が指定されています。

正しい指定例

DEFINE
{
   const integer FileVersion = 7;
   string stMsgText;
}
MAIN
{
   switch (FileVersion)
      case 7:
         ...
         ...
         break;
      case 6:      // 式を削除し、定数を指定しました
         ...
         ...
         break;
      default:
         ...
         ...
         break;
   endswitch;
}

2番目のcaseステートメントから加算演算式を削除し、定数を指定しました。

AITCE-0050

AITファイルのバージョンと実行エンジンのDLLのバージョンが不一致です。

要因

AITファイルのバージョンが実行エンジンのDLLより新しいことが考えられます。

対処

AITファイルの実行時に、スクリプトエンジンのDLLのバージョンがPACKAGE_INFOセクションで示されているScriptFileVersionよりも新しいか確認してください。ScriptFileVersionは、DLLのバージョンよりも前である必要があります。

AITCW-0016

<ランクの高いデータ型>から<ランクの低いデータ型>に変換しました。データが失われている可能性があります。

要因

AITファイルで、ランクの低いデータ型にランクの高いデータ型を割り当てようとすると、値が切り捨てられ、それがランクの低いデータ型に割り当てられます。integer型変数に対して、float値を割り当てた場合が考えられます。

対処

ランクの高いデータ型を使用してください。

例

誤った指定例

DEFINE
{
   const integer OK_END = 0;
   const integer SLEEP_TIME = 3.8;      // float型変数を整数定数に割り当てようとしています。値は切り捨てられ、3だけが変数に保存されます。
}

ここでは、float値がinteger型変数「SLEEP_TIME」に割り当てられています。割り当てられた値は切り捨てられ、integer値だけが変数「SLEEP_TIME」に保存されます。

正しい指定例

DEFINE
{
   const integer OK_END =0;
   const float SLEEP_TIME = 3.8;      // 変数の型をfloat型に変更しました
}

float値を保持するために、変数「SLEEP_TIME」のデータ型をinteger型からfloat型に変更しました。

AITCW-0017

<処理>でbool型変数は指定できません。

要因

bool型変数を予期しない方法で指定すると、この警告が呼び出されます。例えば、bool型変数を除算演算や剰余演算（/、%）に指定すると、0による除算または0/0矛盾につながり、警告メッセージが呼び出されます。

対処

このような場合は、bool型変数を指定しないでください。

例

誤った指定例

DEFINE
{
   const integer sloop_max = 30;
   integer sloop_count;
   bool IsPathSet = false;
}
MAIN
{
   sloop_count = sloop_max / IsPathSet;      // bool型変数が除数として指定されています
}

bool型変数を使用すると、0による除算となり、この警告メッセージが表示されます。ここでは、bool型変数「IsPathSet」が除数として指定されているため、0による除算となります。

正しい指定例

DEFINE
{
   integer NG_END = 1;
   const integer sloop_max = 30;
   integer sloop_count;
}
MAIN
{
   sloop_count = sloop_max / NG_END;      // bool型変数を削除し、integer型変数を除数として指定しました
}

bool型変数「IsPathSet」を削除し、integer型変数「NG_END」を除数として指定しました。

AITCW-0028

演算子<演算子名>で<データ型1>と<データ型2>は混在できません。

要因

ビットの論理積や論理和などの演算の式で、integer型やbool型が混合して指定されています。

対処

式のオペランドでは一貫したデータ型を指定してください。

例

誤った指定例

DEFINE
{
   integer sloop_max = 0;
   bool IsPathSet;
}
MAIN
{
   sloop_max = sloop_max & IsPathSet;      // ビット演算の論理積に対してinteger型とbool型が指定されています
}

この例では、「&」演算に対してinteger型とbool型が指定され、データ型が混在しています。

正しい指定例

DEFINE
{
   integer sloop_max = 0;
   integer sloop_count;
}
MAIN
{
   sloop_max = sloop_max & sloop_count;      // ビット演算の論理積に対してinteger型とinteger型を指定しました
}

「&」演算に対して同じデータ型（integer型とinteger型）を指定しました。

AITCW-0033

switchステートメントにはdefaultラベルしかありません。

要因

switchステートメントでdefaultステートメントのcaseだけが指定されています。switchステートメントのcaseラベルが指定されていません。これは、ステートメントのシーケンスに相当します。

対処

switchステートメントで少なくとも1つのcaseラベルを指定してください。

例

誤った指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch(FileVersion)
      default:      // switchステートメントにdefaultステートメントしか使用していません
         ...
         ...
         break;
   endswitch;
}

すべてのswitchステートメントに、1つ以上のcaseステートメントが必要ですが、この例では、caseステートメントがなくdefaultステートメントしか指定されていません。

正しい指定例

DEFINE
{
   const string FileVersion = "7.1";
   string stMsgText;
}
MAIN
{
   switch(Version )
      case "7.1":      // switchステートメントにcaseステートメントが含まれています
         ...
         ...
         break;
      default:
         ...
         ...
         break;
   endswitch;
}

switchステートメントにcaseステートメントを追加しました。

AITCW-0035

<ラベル名> : 定義されたラベルが使われていません。

要因

ラベルが定義されていますが、参照されていません。このラベルを無視します。

対処

ラベル名を参照するgotoステートメントを指定してください。

例

誤った指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   integer sloop_max = 0;
}
MAIN
{
   if (ExeVersion == FileVersion )
ErrorLabel:   // ラベルに関連するgotoステートメントがありません
      AIT_LogMessage("Setup(Japanese)For Windows-Start");
      if (AIT_FileExists("#setup.exe") == 0)
         sloop_max = 0;
      endif;
   endif;
}

ラベルには、対応するgotoステートメントが必要です。gotoステートメントなしでラベルステートメントを定義すると、そのラベルステートメントは無視されます。この例では、ラベル「ErrorLabel」がgotoステートメントなしで指定されています。

正しい指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   integer sloop_max = 0;
}
MAIN
{
   if (ExeVersion == FileVersion)
      AIT_LogMessage("Setup(Japanese)For Windows-Start");
      if (AIT_FileExists("#setup.exe") == 0)
         goto ErrorLabel;      // gotoステートメントを指定しました
         sloop_max = 0;
      endif;
ErrorLabel:      // ラベルが定義されています
      stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
      AIT_LogMessage(stMsgText);
   endif;
}

ラベル「ErrorLabel」に対応するgotoステートメントを指定しました。

なお、必要のないラベルステートメントを削除する対処方法もあります。

AITCW-0036

<変数名> : 定義された変数が使われていません。

要因

変数がDEFINEセクションで定義されていますが、参照されていません。

対処

不要な場合や使用しない場合は、変数の定義を削除してください。

例

誤った指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   integer sloop_max;      // この変数はプログラム内のどこからも参照されていません
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      AIT_LogMessage("Setup(Japanese)For Windows-Start");
      if (AIT_FileExists("#setup.exe") == 0)
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
      endif;
   endif;
}

上の例で、変数「sloop_max」はDEFINEセクションで定義されていますが、MAINセクション内で使用されていません。

正しい指定例

DEFINE
{
   const string ExeVersion = "7.1";
   const string FileVersion = "7.1";
   integer sloop_max;
   string stMsgText;
}
MAIN
{
   if (ExeVersion == FileVersion)
      AIT_LogMessage("Setup(Japanese)For Windows-Start");
      if (AIT_FileExists("#setup.exe") == 0)
         sloop_max = 0;// ここで変数「sloop_max」が使用されています
         stMsgText = "Setup(Japanese) " + InstallerName + " Not Found";
         AIT_LogMessage(stMsgText);
      endif;
   endif;
}

変数「sloop_max」はMAINセクション内で使用しました。

なお、MAINセクションで必要のない変数はDEFINEセクションから削除する対処方法もあります。

付録

付録A　JP1/IT Desktop Management 2 - Agent を使用するときの注意事項

JP1/IT Desktop Management 2 - AgentがインストールされているPCのOSがWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008、Windows Vistaの場合の注意事項について説明します。

付録A.1　マネージャ側の注意事項

JP1/IT Desktop Management 2 - AgentがインストールされているPCのOSがWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008、Windows Vistaの場合の、マネージャ側の注意事項について説明します。

Windowsのリソースとして保護されているファイルおよびレジストリを変更するジョブはエラーになります。

次に示すディレクトリまたはファイルにシンボリックリンク、ハードリンク、およびジャンクションを設定しないでください。

パッケージング時またはリモートインストール時に指定する、インストール先ディレクトリ

リモートコレクトの対象となるディレクトリおよびファイル

上記のディレクトリおよびファイルにシンボリックリンク、ハードリンク、およびジャンクションが設定されている場合、パッケージング、リモートインストール、およびリモートコレクトの処理の対象になりません。

付録A.2　管理対象のコンピュータ側の注意事項

JP1/IT Desktop Management 2 - AgentがインストールされているPCのOSがWindows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows 7、Windows Server 2008 R2の場合の、管理対象のコンピュータ側の注意事項について説明します。

なお、JP1/IT Desktop Management 2 - Agentを使用する際の全般的な注意事項については、「1.7.2　手動でソフトウェアをインストールする場合の注意事項」を参照してください。

OSがWindows 10、Windows 8.1、Windows 8の場合、タスクマネージャーからスタートアッププログラムを無効にできますが、JP1/IT Desktop Management 2 - Agentが登録しているプログラムを決して無効にしないでください。

次に示す動作を実行する場合は、［ユーザーアカウント制御］ダイアログボックスが表示されます。動作を実行する場合はプログラムの実行を許可してください。動作を実行しない場合は、プログラムの実行をキャンセルしてください。

エージェントのインストール

エージェントのセットアップの起動※

パッケージャの起動※

注※

OSの管理権限を持たないユーザが実行する場合は、OSの管理権限を持つユーザに昇格してから実行してください。

表示言語が日本語の場合、シフトJISに変換できない文字は、「?」または「??」で表示または入力されます。表示言語が中国語の場合、GBKに変換できない文字は、「?」または「??」で表示または入力されます。

ユーザの簡易切り替え機能を使用して、複数のユーザがJP1/IT Desktop Management 2 - Agentのアプリケーションを同時に実行することはできません。

付録B　リモートインストールマネージャを使用した配布に関する監査ログの出力

監査ログの出力情報について説明します。

付録B.1　監査ログに出力される事象の種別

監査ログを出力する対象となる事象の種別、およびJP1/IT Desktop Management 2が監査ログを出力する契機を次の表に示します。事象の種別とは、監査ログに出力される事象を分類するための識別子です。

表B‒1　監査ログに出力される事象の種別

事象の種別

説明

JP1/IT Desktop Management 2が出力する契機

StartStop

ソフトウェアの起動および終了を示す事象。

GUIを持つプログラムの起動および停止

Authentication

管理者が認証に、成功または失敗したことを示す事象。

GUIを持つプログラムでの認証の実行

ContentAccess

JP1/IT Desktop Management 2で管理しているファイル、レジストリ、およびデータベースのデータへのアクセスに、成功または失敗したことを示す事象。

ジョブの実行および実行結果

コマンドの実行および実行結果

付録B.2　監査ログの保存形式

監査ログの保存形式について説明します。

最新の監査ログは、NETMAuditManager.LOGに出力されます。ログファイルが一定の容量に達すると、ファイル名をNETMAuditManagern.LOGに変更して保存したあと、変更前と同じ名称のファイルを作成して新たにログを書き込みます。一定の容量に達してログファイルが切り替わる際、NETMAuditManager.LOGを、NETMAuditManager1.LOGに変更して保存し、新たにNETMAuditManager.LOGを作成して、ログを書き込みます。再びNETMAuditManager.LOGが一定量に達すると、保存済みのNETMAuditManager1.LOGをNETMAuditManager2.LOGに変更したあと、NETMAuditManager.LOGをNETMAuditManager1.LOGに変更して保存します。世代数nは9までです。

このように、保存済みのログファイルは、新たにファイルが作成されるごとにファイル名末尾の数値+1をしたファイル名称に変更されます。つまり、数値が大きいログファイルほど古いログファイルとなります。なお、ファイルの世代数が9を超えると、古いログファイルから削除されます。

付録B.3　監査ログの出力形式

監査ログの出力形式、出力先、出力項目、および出力例について説明します。

(1)　監査ログの出力形式

監査ログの出力形式は、監査ログのフォーマットであることを示す「CALFHM」、監査ログのリビジョン番号、該当する出力項目の順で出力されます。

監査ログの出力形式を次の図に示します。

図B‒1　監査ログの出力形式

(2)　監査ログの出力先

監査ログは、次のディレクトリに出力されます。

監査ログの出力先

JP1/IT Desktop Management 2 - Managerのインストール先ディレクトリ¥mgr¥log

(3)　出力項目

出力項目は、共通出力項目と固有出力項目の2種類あります。それぞれについて説明します。

共通出力項目

監査ログを出力するJP1製品で共通して出力される項目です。

固有出力項目

監査ログを出力するJP1製品ごとに、出力される項目です。

(a)　共通出力項目

共通出力項目に出力される値および内容を次の表に示します。

表B‒2　監査ログの共通出力項目

項番

出力項目

値

内容

項目名

出力される属性名

1

共通仕様識別子

−

「CALFHM」

監査ログのフォーマットであることを示す識別子

2

共通仕様リビジョン番号

−

1.0

監査ログを管理するためのリビジョン番号

3

通番

seqnum

通番

監査ログの通し番号

4

メッセージID

msgid

公開メッセージID

製品ごとのメッセージID

5

日付・時刻

date

YYYY-MM-DDThh:mm:ss.sssTZD※

監査ログの取得日時およびタイムゾーン

6

発生プログラム名

progid

「JP1ITDM2」

事象が発生したプログラム名

7

発生コンポーネント名

compid

「DistributionManager」

出力対象となる機能やコマンドは次のとおりです。

［JP1_IT Desktop Management 2 - Manager］フォルダまたは［JP1_IT Desktop Management 2 - Agent］フォルダのメニュー名

リモートインストールマネージャ

アンアーカイバ

パッケージャ

コマンド名

Dcmcoll

ファイルの収集

Dcmgpmnt

あて先グループへのポリシーの一括反映

Dcminst

ジョブの作成、実行

Dcmjbrm

ジョブの削除

Dcmjexe

ジョブの実行

Dcmpack

パッケージングの実行

Dcmpkget

パッケージのバックアップの取得

Dcmpkput

パッケージのバックアップからの復元

Dcmpkrm

パッケージの削除

Dcmrmgen

ジョブ定義の削除

Dcmrtry

ジョブの再実行

Dcmstat

ジョブの実行状況の取得

Dcmstsw

ジョブの実行状況の監視

Dcmsusp

ファイル転送の中断と再開

事象が発生した機能名

8

発生プロセスID

pid

プロセスのID

事象が発生を検出したプロセスのID

9

発生場所

ocp:host

ホスト名

事象が発生したホストのホスト名

なお、ホスト名を取得できない場合は、「-」（ハイフン）が出力されます。

10

事象の種別

ctgry

StartStop

Authentication

ContentAccess

監査ログに出力される事象を分類するため識別子

11

事象の結果

result

Success（成功）

Failure（失敗）

Occurrence（発生（成功または失敗以外））

発生した事象の結果

12

サブジェクト識別情報

subj:uid

ユーザーアカウントまたはAdministrator

事象を発生させたユーザーの情報

subj:pid

プロセスID

事象を発生させたプロセス情報

（凡例）

−：属性名は出力されない

注※

YYYYは年、MMは月、DDは日、hhは時間、mmは分、ssは秒、sssはミリ秒です。

Tは日付と時刻の区切りです。

TZDはタイムゾーン指定子です。次のどれかが出力されます。

+hh:mm：世界共通の標準時刻からhh:mmだけ進んでいることを示す。

-hh:mm：世界共通の標準時刻からhh:mmだけ遅れていることを示す。

Z：世界共通の標準時刻と同じであることを示す。

(b)　固有出力項目

固有出力項目に出力される値および内容を次の表に示します。

表B‒3　監査ログの固有出力項目

項番

出力項目

値

内容

項目名

出力される属性名

1

動作情報

op

Regist

パッケージの登録

Execute

「パッケージのインストール」または「クライアントユーザによるインストール」ジョブの実行

事象を発生させたユーザの動作の情報

なお、値に該当しない動作の情報は、出力されません。

2

自由記述

msg

任意のメッセージ

事象の内容を示すメッセージ

(4)　監査ログの出力例

JP1/IT Desktop Management 2 - Managerでリモートインストールマネージャを起動して、ホストを作成した場合の監査ログの出力例を示します。

ホストを作成する際に実行した操作は次のとおりです。

リモートインストールマネージャを起動した。

ユーザ認証を実行した。

ジョブを実行した。

リモートインストールマネージャを終了した。

監査ログの内容を次に示します。

図B‒2　監査ログの内容

付録B.4　監査ログを出力するための設定

監査ログを出力するための設定を次に示します。「Manager」とパッケージャを別のPCで運用している場合は、パッケージャでも監査ログの出力を設定する必要があります。

セットアップでの設定

セットアップの［リモートインストールマネージャを使用した配布のセットアップ］画面の［監査ログ］パネルで、ログの出力レベルを設定します。

パッケージャでの設定

［JP1/ITDM2 パッケージャ］ウィンドウの［オプション］−［デフォルト値のカスタマイズ］を選択し、［デフォルト値のカスタマイズ］ダイアログボックスを表示します。ダイアログボックスの［監査ログ］パネルで「監査ログを出力する」チェックボックスをオンにします。

［監査ログ］パネルでの設定方法の詳細については、「7.2.14(4)　［監査ログ］パネル」を参照してください。

付録C　メニュー一覧

JP1/IT Desktop Management 2で表示される各ウィンドウおよびアイコンのメニュー一覧を次に示します。

付録C.1　［システム構成］ウィンドウのメニュー一覧

［システム構成］ウィンドウのメニュー一覧を次に示します。

メニュー

機能

表示されるダイアログボックス

ファイル(F)

新規作成(N)

システム構成(S)

［システム構成］ウィンドウを表示します。

−

あて先(N)

［あて先］ウィンドウを表示します。

−

パッケージ(P)

［パッケージ］ウィンドウを表示します。

−

ジョブ定義(D)

［ジョブ定義］ウィンドウを表示します。

−

ジョブ実行状況(J)

［ジョブ実行状況］ウィンドウを表示します。

−

管理情報リスト(L)

［管理情報リスト］ウィンドウを表示します。

−

閉じる(C)

［システム構成］ウィンドウを閉じます。

−

ホストの新規作成(A)...

ホストを作成します。

ホストの作成

名前の変更(R)

ホスト名を変更します。

−

プロパティ(Y)...

選択したホストのプロパティを表示します。

XXXのプロパティ（XXXはホスト名またはIPアドレス）

属性の変更(H)...

ホストの属性を変更します。

属性の変更

ID管理元中継へのIDの登録・削除(J)...

ID管理元中継ごとにIDを登録、および削除します。

ID管理元中継へのIDの登録・削除

システム構成情報の削除履歴(D)...

システム構成情報からホストを削除した履歴を表示します。

システム構成情報の削除履歴

ファイルから作成(I)...

システム構成を設定したファイルから、システム構成を作成します。

システム構成の作成※1

ファイルへ保存(E)...

システム構成から、ファイルを作成します。

システム構成の保存

印刷情報の設定(U)...

印刷する情報を設定します。

印刷情報の設定

印刷プレビュー(V)...

印刷イメージを表示します。

印刷情報の設定

印刷(T)...

システム構成の情報を印刷します。

印刷情報の設定

プリンタの設定(S)...

使用するプリンタを設定します。

−

CSVファイル出力(O)...

配布管理システムで管理する情報をCSV形式のファイルに出力します。

CSVファイル出力

終了(X)

リモートインストールマネージャを終了します。

−

編集(E)

切り取り(T)

選択したホストを切り取ります。

−

コピー(C)

選択したホストをコピーします。

−

貼り付け(P)

選択した位置にホストを貼り付けます。

−

削除(D)

システム構成からホストを削除します。

−

インストールパッケージ情報の削除(I)...

ホストにインストールされているソフトウェアの情報を削除します。

インストールパッケージ情報の削除

中継のパッケージ削除(M)...

中継システムまたは管理用中継サーバにあるパッケージを削除します。

中継のパッケージ削除

すべて選択(A)

ウィンドウの右枠に表示されているすべての情報を選択します。

−

選択の切り替え(R)

ウィンドウの右枠の選択状態を逆にします。

−

実行(A)

ジョブの実行(E)...

ジョブを新規に作成します。

ジョブ定義の新規作成

ファイル転送の中断/再開

中断させる(S)

下位システムとのファイル転送を中断します。

ファイル転送の中断

再開させる(R)

下位システムとのファイル転送を再開します。

ファイル転送の再開

表示(V)

表示する情報(I)

一覧(L)

あて先の一覧を表示します。

−

属性情報(A)

ホストの属性を表示します。

−

インストールパッケージ(P)

インストールパッケージ情報を表示します。

−

表示情報の切替(R)

表示するタブを切り替えます。

−

表示情報の設定(F)...

表示する項目を設定します。

表示情報の設定

表示するソフトウェア(P)

ユーザプログラム、データ(U)

パッケージ種別が「ユーザープログラム、データ」のソフトウェア情報を表示します。

−

日立プログラムプロダクト(H)

パッケージ種別が「日立プログラムプロダクト」のソフトウェア情報を表示します。

−

他社ソフトウェア(O)

パッケージ種別が「他社ソフトウェア」のソフトウェア情報を表示します。

−

パッチ情報(P)

UNIXエージェントでパッケージングしたOSパッチの情報を表示します。

−

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

名前順(N)

情報を名前順に表示します。

−

ID順(D)

情報をID順に表示します。

−

日付順(J)

情報を日付順に表示します。

−

オプション(O)

検索(F)...

ホストを検索します。

検索

ジョブ(J)...

ジョブの実行状況の監視時間を設定します。

ジョブの環境設定

整列パターン(R)...

ウィンドウのレイアウトを設定します。

整列パターン

あて先グループ/IDの自動メンテナンス(G)...※2

−

−

リモートコントロールの開始(E)...※3

リモートコントロールを開始します。

−

ツールの起動(T)

ツールの登録(R)...

リモートインストールマネージャから起動するツールを登録します。

ツールの登録

ツール名※4

登録したツールを起動します。

−

ウィンドウ(W)

重ねて表示(C)

開かれているすべてのウィンドウを重ねて表示します。

−

並べて表示(T)

開かれているすべてのウィンドウを横に並べて表示します。

−

最新情報の表示(N)

ウィンドウの情報を最新にします。

−

ウィンドウの整列(R)

設定したレイアウトでウィンドウを整列します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

注※1

あて先またはシステム構成が存在する場合は、システム構成を作成する前に、あて先またはシステム構成を保存する画面が表示されます。

注※2

このウィンドウでは常に非活性となっています。

注※3

コントローラがインストールされている場合に活性になります。

注※4

登録したツール名が表示されます。ツールは最大10個表示されます。

付録C.2　［あて先］ウィンドウのメニュー一覧

［あて先］ウィンドウのメニュー一覧を次に示します。

メニュー

機能

表示されるダイアログボックス

ファイル(F)

新規作成(N)

システム構成(S)

［システム構成］ウィンドウを表示します。

−

あて先(N)

［あて先］ウィンドウを表示します。

−

パッケージ(P)

［パッケージ］ウィンドウを表示します。

−

ジョブ定義(D)

［ジョブ定義］ウィンドウを表示します。

−

ジョブ実行状況(J)

［ジョブ実行状況］ウィンドウを表示します。

−

管理情報リスト(L)

［管理情報リスト］ウィンドウを表示します。

−

閉じる(C)

［あて先］ウィンドウを閉じます。

−

あて先の新規作成(A)...

あて先を作成します。

あて先の作成

グループの新規作成(P)...

あて先グループとあて先グループのポリシーを設定します。

あて先グループの作成

名前の変更(R)

あて先グループ名を変更します。

−

プロパティ(Y)...

選択したあて先のプロパティを表示します。

XXXのプロパティ（XXXはホスト名、IPアドレス、ID名称、またはあて先グループ名）

IDの作成(M)...

IDを作成します。

IDの作成

IDの削除(D)...

選択したIDを削除します。

IDの削除

IDの属性変更(Z)...

IDを管理する中継システムを変更します。

IDの属性変更

ファイルからID への登録(F)...

作成したファイルを指定して、複数のホストを一括してIDへと登録します。

IDへの登録

IDホストをファイルへ保存(H)...

IDとIDに登録されているホストをファイルへ保存します。

IDホストの保存

システム構成情報の削除履歴(G)...

システム構成情報からホストを削除した履歴を表示します。

システム構成情報の削除履歴

ファイルから作成(I)...

あて先グループを設定したファイルから、あて先グループを作成します。

あて先の作成※1

ファイルから追加(J)...

あて先グループを設定したファイルから、あて先グループを追加します。

あて先の追加

ファイルへ保存(E)...

あて先グループから、ファイルを作成します。

あて先の保存

印刷情報の設定(U)...

印刷する情報を設定します。

印刷情報の設定

印刷プレビュー(V)...

印刷イメージを表示します。

印刷情報の設定

印刷(T)...

あて先の情報を印刷します。

印刷情報の設定

プリンタの設定(S)...

使用するプリンタを設定します。

−

CSVファイル出力(O)...

配布管理システムで管理する情報をCSV形式のファイルに出力します。

CSVファイル出力

終了(X)

リモートインストールマネージャを終了します。

−

編集(E)

切り取り(T)

選択したホストを切り取ります。

−

コピー(C)

選択したホストをコピーします。

−

貼り付け(P)

選択した位置にホストを貼り付けます。

−

削除(D)

あて先からホストとあて先グループを削除します。

−

インストールパッケージ情報の削除(I)...

ホストにインストールされているソフトウェアの情報を削除します。

インストールパッケージ情報の削除

すべて選択(A)

ウィンドウの右枠に表示されているすべての情報を選択します。

−

選択の切り替え(R)

ウィンドウの右枠の選択状態を逆にします。

−

実行(A)

ジョブの実行(E)...

ジョブを新規に作成します。

ジョブ定義の新規作成

ファイル転送の中断/再開

中断させる(S)

下位システムとのファイル転送を中断します。

ファイル転送の中断

再開させる(R)

下位システムとのファイル転送を再開します。

ファイル転送の再開

表示(V)

表示する情報(I)

一覧(L)

あて先の一覧を表示します。

−

属性情報(A)

ホストの属性を表示します。

−

インストールパッケージ(P)

インストールパッケージ情報を表示します。

−

ID管理元中継(M)

IDを管理している中継システムまたは管理用中継サーバを表示します。

−

表示情報の切替(R)

表示するタブを切り替えます。

−

表示情報の設定(F)...

表示する項目を設定します。

−

表示するソフトウェア(P)

ユーザプログラム、データ(U)

パッケージ種別が「ユーザープログラム、データ」のソフトウェア情報を表示します。

−

日立プログラムプロダクト(H)

パッケージ種別が「日立プログラムプロダクト」のソフトウェア情報を表示します。

−

他社ソフトウェア(O)

パッケージ種別が「他社ソフトウェア」のソフトウェア情報を表示します。

−

パッチ情報(P)

UNIXエージェントでパッケージングしたOSパッチの情報を表示します。

−

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

名前順(N)

情報を名前順に表示します。

−

ID順(D)

情報をID順に表示します。

−

日付順(J)

情報を日付順に表示します。

−

IDをダブルクリックしたときだけID下のあて先を表示する(V)

IDをダブルクリックしたときだけID下のあて先を右画面に表示します。ID下のあて先が10,000台以上ある場合、ID下のあて先を参照する必要がないときに使用すると便利です。IDをシングルクリックしただけでは、ID下のあて先を表示しません。

−

あて先を表示する(O)...

選択したID下のあて先情報を表示します。

IDエージェント情報

オプション(O)

検索(F)...

ホストを検索します。

検索

ジョブ(J)...

ジョブの実行状況の監視時間を設定します。

ジョブの環境設定

整列パターン(R)...

ウィンドウのレイアウトを設定します。

整列パターン

あて先グループ/IDの自動メンテナンス(G)...※2

あて先グループおよびIDのポリシーを編集する画面を表示します。

ポリシーの設定

リモートコントロールの開始(E)...※3

リモートコントロールを開始します。

−

ツールの起動(T)

ツールの登録(R)...

リモートインストールマネージャから起動するツールを登録します。

ツールの登録

ツール名※4

登録したツールを起動します。

−

ウィンドウ(W)

重ねて表示(C)

開かれているすべてのウィンドウを重ねて表示します。

−

並べて表示(T)

開かれているすべてのウィンドウを横に並べて表示します。

−

最新情報の表示(N)

ウィンドウの情報を最新にします。

−

ウィンドウの整列(R)

設定したレイアウトでウィンドウを整列します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

注※1

あて先が存在する場合は、あて先を保存する画面が表示されます。

注※2

このウィンドウでは常に非活性となっています。

注※3

コントローラがインストールされている場合に活性になります。

注※4

登録したツール名が表示されます。ツールは最大10個表示されます。

付録C.3　［パッケージ］ウィンドウのメニュー一覧

［パッケージ］ウィンドウのメニュー一覧を次に示します。

メニュー

機能

表示されるダイアログボックス

ファイル(F)

新規作成(N)

システム構成(S)

［システム構成］ウィンドウを表示します。

−

あて先(N)

［あて先］ウィンドウを表示します。

−

パッケージ(P)

［パッケージ］ウィンドウを表示します。

−

ジョブ定義(D)

［ジョブ定義］ウィンドウを表示します。

−

ジョブ実行状況(J)

［ジョブ実行状況］ウィンドウを表示します。

−

管理情報リスト(L)

［管理情報リスト］ウィンドウを表示します。

−

閉じる(C)

［パッケージ］ウィンドウを閉じます。

−

キャビネットの新規作成(B)...

キャビネットを作成します。

キャビネットの作成

名前の変更(R)...

キャビネット名を変更します。

キャビネットの名前の変更

プロパティ(Y)...

選択したキャビネットまたはパッケージの情報を表示します。

XXXのプロパティ（XXXはキャビネット名またはパッケージ名）

オフラインマシンの管理(L)

インストール媒体作成(T)...

オフラインマシンへソフトウェアをインストールするための媒体を準備します。

インストール媒体作成

システム構成情報の削除履歴(D)...

システム構成情報からホストを削除した履歴を表示します。

システム構成情報の削除履歴

印刷情報の設定(U)...

印刷する情報を設定します。

印刷情報の設定

印刷プレビュー(V)...

印刷イメージを表示します。

印刷情報の設定

印刷(T)...

パッケージの情報を印刷します。

印刷情報の設定

プリンタの設定(S)...

使用するプリンタを設定します。

−

CSVファイル出力(O)...

配布管理システムで管理する情報をCSV形式のファイルに出力します。

CSVファイル出力

終了(X)

リモートインストールマネージャを終了します。

−

編集(E)

削除(D)

選択したキャビネット、またはパッケージを削除します。

−

中継のパッケージ削除(M)...

中継システムまたは管理用中継サーバにあるパッケージを削除します。

中継のパッケージ削除

すべて選択(A)

ウィンドウの右枠に表示されているすべての情報を選択します。

−

選択の切り替え(R)

ウィンドウの右枠の選択状態を逆にします。

−

実行(A)

ジョブの実行(E)...

ジョブを新規に作成します。

ジョブ定義の新規作成

ファイル転送の中断/再開(S)

中断させる(S)

下位システムとのファイル転送を中断します。

ファイル転送の中断

再開させる(R)

下位システムとのファイル転送を再開します。

ファイル転送の再開

表示(V)

表示する情報(I)

一覧(L)

パッケージの一覧を表示します。

−

属性情報(A)

パッケージの属性を表示します。

−

パッケージ内容(P)

パッケージの内容を表示します。

−

表示情報の切替(R)

表示するタブを切り替えます。

−

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

名前順(N)

情報を名前順に表示します。

−

ID順(D)

情報をID順に表示します。

−

バージョン順(V)

情報をバージョン順に表示します。

−

世代番号順(G)

情報を世代番号順に表示します。

−

作成日付順(M)

情報を日付順に表示します。

−

サイズ順(Z)

情報をサイズ順に表示します。

−

更新日時順(L)

情報を更新日付順に表示します。

−

オプション(O)

ジョブ(J)...

ジョブの実行状況の監視時間を設定します。

ジョブの環境設定

整列パターン(R)...

ウィンドウのレイアウトを設定します。

整列パターン

ウィンドウ(W)

重ねて表示(C)

開かれているすべてのウィンドウを重ねて表示します。

−

並べて表示(T)

開かれているすべてのウィンドウを横に並べて表示します。

−

最新情報の表示(N)

ウィンドウの情報を最新にします。

−

ウィンドウの整列(R)

設定したレイアウトでウィンドウを整列します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

付録C.4　［ジョブ定義］ウィンドウのメニュー一覧

［ジョブ定義］ウィンドウのメニュー一覧を次に示します。

メニュー

機能

表示されるダイアログボックス

ファイル(F)

新規作成(N)

システム構成(S)

［システム構成］ウィンドウを表示します。

−

あて先(N)

［あて先］ウィンドウを表示します。

−

パッケージ(P)

［パッケージ］ウィンドウを表示します。

−

ジョブ定義(D)

［ジョブ定義］ウィンドウを表示します。

−

ジョブ実行状況(J)

［ジョブ実行状況］ウィンドウを表示します。

−

管理情報リスト(L)

［管理情報リスト］ウィンドウを表示します。

−

閉じる(C)

［ジョブ定義］ウィンドウを閉じます。

−

フォルダの新規作成(F)...

フォルダを作成します。

フォルダの作成

ジョブ定義の新規作成(J)...

ジョブを新規に作成します。

ジョブ定義の新規作成

名前の変更(R)

フォルダ、またはジョブの名称を変更します。

−

システム構成情報の削除履歴(D)...

システム構成情報からホストを削除した履歴を表示します。

システム構成情報の削除履歴

CSVファイル出力(O)...

配布管理システムで管理する情報をCSV形式のファイルに出力します。

CSVファイル出力

終了(X)

リモートインストールマネージャを終了します。

−

編集(E)

ジョブ定義の編集(J)...

ジョブの定義内容を変更します。

ジョブの編集

削除(D)

選択したフォルダ、またはジョブを削除します。

−

ジョブ定義のカスタマイズ(C)...

ジョブの定義に使用するダイアログボックスをカスタマイズします。

ジョブ定義のカスタマイズ

すべて選択(A)

ウィンドウの右枠に表示されているすべての情報を選択します。

−

選択の切り替え(R)

ウィンドウの右枠の選択状態を逆にします。

−

実行(A)

ジョブの実行(E)...

保存したジョブを実行します。

ジョブ登録中

ファイル転送の中断/再開(S)

中断させる(S)

下位システムとのファイル転送を中断します。

ファイル転送の中断

再開させる(R)

下位システムとのファイル転送を再開します。

ファイル転送の再開

表示(V)

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

名前のみ(N)

ジョブを名前だけで表示します。

−

すべて表示(A)

ジョブの情報をすべて表示します。

−

表示情報の設定(P)...

表示する項目を設定します。

表示する情報の設定

名前順(M)

情報を名前順に表示します。

−

作成日付順(C)

情報を作成日付順に表示します。

−

更新日付順(D)

情報を更新日付順に表示します。

−

オプション(O)

ジョブ(J)...

ジョブの実行状況の監視時間を設定します。

ジョブの環境設定

整列パターン(R)...

ウィンドウのレイアウトを設定します。

整列パターン

ウィンドウ(W)

重ねて表示(C)

開かれているすべてのウィンドウを重ねて表示します。

−

並べて表示(T)

開かれているすべてのウィンドウを横に並べて表示します。

−

最新情報の表示(N)

ウィンドウの情報を最新にします。

−

ウィンドウの整列(R)

設定したレイアウトでウィンドウを整列します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

付録C.5　［ジョブ実行状況］ウィンドウのメニュー一覧

［ジョブ実行状況］ウィンドウのメニュー一覧を次に示します。

メニュー

機能

表示されるダイアログボックス

ファイル(F)

新規作成(N)

システム構成(S)

［システム構成］ウィンドウを表示します。

−

あて先(N)

［あて先］ウィンドウを表示します。

−

パッケージ(P)

［パッケージ］ウィンドウを表示します。

−

ジョブ定義(D)

［ジョブ定義］ウィンドウを表示します。

−

ジョブ実行状況(J)

［ジョブ実行状況］ウィンドウを表示します。

−

管理情報リスト(L)

［管理情報リスト］ウィンドウを表示します。

−

閉じる(C)

［ジョブ実行状況］ウィンドウを閉じます。

−

システム構成情報の削除履歴(D)...

システム構成情報からホストを削除した履歴を表示します。

システム構成情報の削除履歴

印刷情報の設定(U)...

印刷する情報を設定します。

印刷情報の設定

印刷プレビュー(V)...

印刷イメージを表示します。

印刷情報の設定

印刷(T)...

ジョブ実行状況の情報を印刷します。

印刷情報の設定

プリンタの設定(S)...

使用するプリンタを設定します。

−

CSVファイル出力(O)...

配布管理システムで管理する情報をCSV形式のファイルに出力します。

CSVファイル出力

終了(X)

リモートインストールマネージャを終了します。

−

編集(E)

削除(D)

選択したフォルダ、またはジョブを削除します。

−

すべて選択(A)

フォルダ、またはジョブをすべて選択します。

−

選択の切り替え(R)

ウィンドウの右枠の選択状態を逆にします。

−

実行(A)

ジョブの再実行(R)...

ジョブを再実行します。

ジョブの再実行

分割配布の強制完了(F)

分割配布のジョブを通常配布に切り替えて、未転送のパッケージを一括して転送します。

強制完了の確認

ファイル転送の中断/再開(S)

中断させる(S)

下位システムとのファイル転送を中断します。

ファイル転送の中断

再開させる(R)

下位システムとのファイル転送を再開します。

ファイル転送の再開

表示(V)

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

表示情報の設定(I)...

表示する日時項目を設定します。

表示する項目の設定

ジョブの詳細情報の表示(D)...

選択したジョブの詳細情報を表示します。

詳細情報

指定された情報のみ表示(N)

情報を階層ごとに表示します。

−

すべてのジョブの表示(L)

選択した階層下のすべてのジョブを表示します。

−

すべてのジョブ詳細の表示(E)

選択した階層下のすべてのジョブの詳細情報を表示します。

−

全種類のジョブの表示(A)

特定の実行状況のジョブを選択して表示したあと、再度すべてのジョブを表示します。

−

ジョブの種類の指定(K)...

特定の実行状況のジョブを表示します。

表示するジョブの選択

IDジョブエージェント表示(C)

あて先としてIDを設定したジョブの実行状況を表示します。

−

削除中のジョブを表示する(P)

中継システム、管理用中継サーバ、およびエージェントで削除中のジョブを表示します。

−

並べ替え(O)...

表示した情報を並べ替えます。

ソート順序の設定

オプション(O)

ジョブ(J)...

ジョブの実行状況の監視時間を設定します。

ジョブの環境設定

整列パターン(R)...

ウィンドウのレイアウトを設定します。

整列パターン

ウィンドウ(W)

重ねて表示(C)

開かれているすべてのウィンドウを重ねて表示します。

−

並べて表示(T)

開かれているすべてのウィンドウを横に並べて表示します。

−

最新情報の表示(N)

ウィンドウの情報を最新にします。

−

ウィンドウの整列(R)

設定したレイアウトでウィンドウを整列します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

付録C.6　［管理情報リスト］ウィンドウのメニュー一覧

［管理情報リスト］ウィンドウのメニュー一覧を次に示します。

メニュー

機能

表示されるダイアログボックス

ファイル(F)

新規作成(N)

システム構成(S)

［システム構成］ウィンドウを表示します。

−

あて先(N)

［あて先］ウィンドウを表示します。

−

パッケージ(P)

［パッケージ］ウィンドウを表示します。

−

ジョブ定義(D)

［ジョブ定義］ウィンドウを表示します。

−

ジョブ実行状況(J)

［ジョブ実行状況］ウィンドウを表示します。

−

管理情報リスト(L)

［管理情報リスト］ウィンドウを表示します。

−

閉じる(C)

［管理情報リスト］ウィンドウを閉じます。

−

検索リストの新規作成(A)...

検索リストを作成します。

ソフトウェア検索リスト一覧

名前の変更(R)...

検索リストの名前を変更します。

検索リストの名前の変更

ファイルから作成(I)...

検索リストファイル（*.DMP）から、検索リストを作成します。

検索リストの読み込み

ファイルへ保存(E)...

検索リストファイル（*.DMP）を作成します。

検索リストの保存

システム構成情報の削除履歴(D)...

システム構成情報からホストを削除した履歴を表示します。

システム構成情報の削除履歴

プリンタの設定(S)...

使用するプリンタを設定します。

−

CSVファイル出力(O)...

配布管理システムで管理する情報をCSV形式のファイルに出力します。

CSVファイル出力

終了(X)

リモートインストールマネージャを終了します。

−

編集(E)

編集(C)...

選択した検索リストを編集します。

ソフトウェア検索リスト一覧

削除(D)

選択した検索リストを削除します。

−

表示(V)

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

ウィンドウ(W)

重ねて表示(C)

開かれているすべてのウィンドウを重ねて表示します。

−

並べて表示(T)

開かれているすべてのウィンドウを横に並べて表示します。

−

ウィンドウの整列(R)

設定したレイアウトでウィンドウを整列します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

付録C.7　［IT Desktop Management 2 アンアーカイバ］ウィンドウのメニュー一覧

［IT Desktop Management 2 アンアーカイバ］ウィンドウのメニュー一覧を次に示します。

メニュー

機能

表示されるダイアログボックス

ファイル(F)

ファイルの復元(U)...

アーカイブ、または圧縮されたファイルを復元します。

復元

アンアーカイバの終了(X)

アンアーカイバを終了します。

−

ディスク(D)

ドライブの変更(C)...

復元するファイルがほかのドライブにある場合、ドライブを変更します。

ドライブの選択

表示(V)

ファイルの種類の指定(K)...

特定の拡張子のファイルだけを表示します。

表示するファイルの種類の指定

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

フォント(F)...

ウィンドウのフォントを変更します。

フォント

ヘルプ(H)

バージョン情報（DMUNARC）(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

付録C.8　［JP1/ITDM2 パッケージャ］ウィンドウのメニュー一覧

［JP1/ITDM2 パッケージャ］ウィンドウに表示される、3種類のウィンドウのメニュー一覧を次に示します。

(1)　［パッケージ］ウィンドウ

メニュー

機能

表示されるダイアログボックス

ファイル(F)

プロパティ(R)

選択したキャビネットまたはパッケージのプロパティを表示します。

XXXのプロパティ（XXXはキャビネット名またはパッケージ名）

終了(X)

パッケージャを終了します。

−

編集(E)

削除(D)

選択したパッケージをキャビネットから削除します。

−

表示(V)

表示する情報(I)

キャビネット/パッケージ(C)

キャビネットまたはパッケージの一覧を表示します。

−

パッケージ情報(P)

キャビネットまたはパッケージの属性情報を表示します。

−

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

名前順(N)

名前順で、キャビネット/パッケージ欄をソートします。

−

識別ID順(Z)

パッケージ識別ID順で、キャビネット/パッケージ欄をソートします。

−

バージョン順(V)

バージョン順で、キャビネット/パッケージ欄をソートします。

−

世代番号順(G)

世代番号順で、キャビネット/パッケージ欄をソートします。

−

日付順(D)

日付順で、キャビネット/パッケージ欄をソートします。

−

オプション(O)

デフォルト値のカスタマイズ(C)...

パッケージング処理の環境や、［JP1/ITDM2 パッケージング］ダイアログボックスのデフォルト値を設定します。

デフォルト値のカスタマイズ

ウィンドウ(W)

重ねて表示(C)

子ウィンドウを重ねて表示します。

−

並べて表示(T)

子ウィンドウを並べて表示します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ファイル一覧ウィンドウ(F)

新しい［ファイル一覧］ウィンドウを表示します。

−

最新状態の表示(G)

ウィンドウを最新の状態で表示します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

(2)　［ファイル］ウィンドウ

メニュー

機能

表示されるダイアログボックス

ファイル(F)

終了(X)

パッケージャを終了します。

−

ディスク(D)

ドライブの選択(S)

パッケージングするファイルのドライブを表示します。

−

実行(R)

パッケージング(P)...

ソフトウェアをパッケージングします。

JP1/ITDM2 パッケージング

表示(V)

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

名前順(N)

名前順で、表示するファイルをソートします。

−

容量順(Z)

容量順で、表示するファイルをソートします。

−

日付順(D)

日付順で、表示するファイルをソートします。

−

条件の設定(C)...

[条件の設定]ダイアログボックスを表示します。

−

オプション(O)

デフォルト値のカスタマイズ(C)...

パッケージング処理の環境や、［JP1/ITDM2 パッケージング］ダイアログボックスのデフォルト値を設定します。

デフォルト値のカスタマイズ

ウィンドウ(W)

重ねて表示(C)

子ウィンドウを重ねて表示します。

−

並べて表示(T)

子ウィンドウを並べて表示します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ファイル一覧ウィンドウ(F)

新しい［ファイル一覧］ウィンドウを表示します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

(3)　［パッケージ実行状況］ウィンドウ

メニュー

機能

表示されるダイアログボックス

ファイル(F)

終了(X)

パッケージャを終了します。

−

表示(V)

ツールバー(T)

ツールバーの表示の有無を切り替えます。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

オプション(O)

デフォルト値のカスタマイズ(C)...

パッケージング処理の環境や、［JP1/ITDM2 パッケージング］ダイアログボックスのデフォルト値を設定します。

デフォルト値のカスタマイズ

ウィンドウ(W)

重ねて表示(C)

子ウィンドウを重ねて表示します。

−

並べて表示(T)

子ウィンドウを並べて表示します。

−

アイコンの整列(A)

最小化したウィンドウのアイコンを整列します。

−

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

付録C.9　［Package Setup Manager］ウィンドウのメニュー一覧

［Package Setup Manager］ウィンドウで切り替えて表示できるウィンドウのメニュー一覧を次に示します。

(1)　［パッケージ］ウィンドウ

メニュー

機能

表示されるダイアログボックス

ファイル(F)

終了(X)

パッケージセットアップマネージャを終了します。

−

編集(E)

インストール先の変更(I)...

選択したパッケージのインストール先ディレクトリを変更します。

インストール先の変更

実行(X)

インストール(I)

選択したパッケージをインストールします。

インストール方法の指定

設定(C)

起動時に上位システムから情報を取得する(G)

パッケージセットアップマネージャの起動のタイミングで、上位システムから情報を取得します。

−

表示(V)

詳細情報の表示(D)...

選択したパッケージの詳細情報を表示します。

パッケージの詳細

最新の情報に更新(R)

インストールを許可されたパッケージの情報を最新の情報に切り替えます。

−

ツールバー(T)

標準のボタン(S)

ツールバーのボタンを標準のサイズにします。

−

大きいボタン(L)

ツールバーのボタンを大きなサイズにします。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

表示列(C)

バージョン(V)

このメニューをチェックするとバージョンの列を表示します。

−

サイズ(S)

このメニューをチェックするとサイズの列を表示します。

−

作成日付(D)

このメニューをチェックすると作成日付の列を表示します。

−

パッケージの名前順(N)

未インストール優先の名前順(A)

未インストール状態のパッケージを先に表示します。

−

名前順(B)

パッケージの状態に関係なく、名前順に表示します。

−

バージョン順(V)

パッケージをバージョン順に表示します。

−

サイズ順(Z)

パッケージをサイズ順に表示します。

−

作成日付順(M)

パッケージを作成日付順に表示します。

−

インストールパッケージの表示(O)

［インストールパッケージ］ウィンドウを表示します。

−

フォント(F)...

ウィンドウのフォントを変更します。

フォント

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

(2)　［インストールパッケージ］ウィンドウ

メニュー

機能

表示されるダイアログボックス

ファイル(F)

終了(X)

パッケージセットアップマネージャを終了します。

−

編集(E)

インストールパッケージ情報の削除(D)

選択したパッケージを一覧から削除します。

−

表示(V)

最新の状態に更新(R)

管理対象のコンピュータにインストールされたパッケージの情報を最新の情報に切り替えます。

−

表示列(C)

パッケージ識別ID(I)

このメニューをチェックするとパッケージ識別IDの列を表示します。

−

バージョン(V)

このメニューをチェックするとバージョンの列を表示します。

−

世代番号(G)

このメニューをチェックすると世代番号の列を表示します。

−

インストール日時(T)

このメニューをチェックするとインストール日時の列を表示します。

−

インストール先(D)

このメニューをチェックするとインストール先の列を表示します。

−

ツールバー(T)

標準のボタン(S)

ツールバーのボタンを標準のサイズにします。

−

大きいボタン(L)

ツールバーのボタンを大きなサイズにします。

−

ステータスバー(S)

ステータスバーの表示の有無を切り替えます。

−

パッケージの表示(P)

［パッケージ］ウィンドウを表示します。

−

フォント(F)...

ウィンドウのフォントを変更します。

フォント

ヘルプ(H)

バージョン情報(A)...

JP1/IT Desktop Management 2のバージョン情報を表示します。

−

（凡例）　−：表示されない

付録C.10　［Automatic Installation Tool］ウィンドウのメニュー一覧

［Automatic Installation Tool］ウィンドウのメニュー一覧を次の表に示します。

表C‒1　［Automatic Installation Tool］ウィンドウのメニュー一覧

メニュー

機能

ショートカットキー

ファイル

新規作成

AITファイルを新規に作成します。

［Ctrl］+［N］

開く

既存のAITファイルを開きます。

［Ctrl］+［O］

閉じる

アクティブなAITファイルを閉じます。

−

上書き保存

アクティブなAITファイルを上書き保存します。

［Ctrl］+［S］

名前を付けて保存

アクティブなAITファイルに新しいファイル名を付けて保存します。

−

すべて保存

ウィンドウ上の、変更が加えられたすべてのAITファイルを保存します。

−

印刷

アクティブなAITファイルを印刷します。

［Ctrl］+［P］

印刷プレビュー

アクティブなAITファイルの印刷イメージを表示します。

−

印刷設定

［プリンタの設定］ダイアログボックスを表示します。プリンタの設定を変更できます。

−

最近使ったファイル

最近使ったファイルをリストから選択して表示します。

−

終了

Automatic Installation Toolを終了します。

［Alt］+［F4］

編集

元に戻す

直前の編集操作を取り消します。

［Ctrl］+［Z］

やり直し

取り消した直前の編集操作をやり直します。

［Ctrl］+［Y］

切り取り

文字列を切り取ってクリップボードに貼り付けます。

［Ctrl］+［X］

コピー

文字列をコピーしてクリップボードに貼り付けます。

［Ctrl］+［C］

貼り付け

クリップボードの文字列を貼り付けます。

［Ctrl］+［V］

削除

選択した文字列を削除します。

［Delete］

すべて選択

AITファイル全体を選択します。

［Ctrl］+［A］

検索

［検索］ダイアログボックスを表示します。指定した文字列を検索します。

［Ctrl］+［F］

次を検索

カーソル位置から、後方に対して文字列の検索を続行します。

［F3］

前を検索

カーソル位置から、前方に対して文字列の検索を続行します。

［Shift］+［F3］

置換

［置換］ダイアログボックスを表示します。検索文字列を指定した文字列に置換します。検索文字列には正規表現を指定できます。

［Ctrl］+［H］

ジャンプ

［ジャンプ］ダイアログボックスを表示します。指定した行にカーソルを移動します。

［Ctrl］+［G］

表示

ツールバー

次に示すツールバーの表示/非表示を切り替えます。

［標準］ツールバー

［ビルド］ツールバー

［ユティリティ］ツールバー

また、［カスタマイズ］ダイアログボックスを表示し、ツールバーおよびコマンドの配置を設定できます。

−

ステータスバー

ステータスバーの表示/非表示を切り替えます。

−

アウトプット

アウトプットウィンドウを表示します。

［Alt］+［F2］

監視ウィンドウ

デバッグ中に、監視ウィンドウを表示します。

［Alt］+［F3］

ワークブック

ワークブックモード

アクティブファイルビュー時のワークブックモードの表示/非表示を切り替えます。

トグルアイコン

ワークブックモードビューでのファイルのワークブックタブアイコンの表示/非表示を切り替えます。

−

ビルド

文法チェック

アクティブなAITファイルの文法をチェックし、アウトプットウィンドウに警告とエラーを表示します。

［Ctrl］+［F7］

実行

アクティブなAITファイルの文法をチェックしたあと、実行を開始します。

［Ctrl］+［F5］

デバッグ

実行

現在のステートメントからブレークポイントまで、AITファイルを実行します。

［F5］

デバッグの中断

デバッグを終了し、通常の編集に戻ります。

［Shift］+［F5］

ステップオーバー

現在のステートメントから次のステートメントまでAITファイルを実行します。

［F10］

カーソル行の前まで実行

カーソルのある行の前まで、AITファイルを実行します。カーソル行に一時的なブレークポイントを設定した場合と同じです。

［Ctrl］+［F10］

ブレークポイントの追加／削除

指定した位置でブレークポイントを追加、削除できます。

［F9］

ブレークポイントの設定

［ブレークポイントの設定］ダイアログボックスを表示し、ブレークポイントを追加、削除できます。

［Alt］+［F9］または［Ctrl］+［B］

ツール

レコーダ

［レコーダ］ダイアログボックスを表示します。ユーザ操作をレコーディングし、AITファイルを自動生成します。

［Ctrl］+［R］

ウィンドウプロパティ

［ウィンドウプロパティ］ダイアログボックスを表示します。指定したウィンドウまたはコントロールの属性を取得します。

［Ctrl］+［W］

パッケージ情報

［パッケージ情報］ダイアログボックスを表示します。PACKAGE_INFOセクションを生成します。

［Ctrl］+［P］

オプション

［オプション］ダイアログボックスを表示します。

AITファイルの書式、文法チェック時のメッセージ表示数、レコーダのログ出力世代数などを設定できます。

［Ctrl］+［O］

カスタマイズ

［カスタマイズ］ダイアログボックスを表示します。ツールバーおよびコマンドの配置を設定できます。

［Ctrl］+［C］

ウィンドウ

新規ウィンドウ

新しいアクティブなAITファイルを開きます。

［Ctrl］+［N］

重ねて表示

開かれているすべてのウィンドウを重ねて表示します。

［Ctrl］+［C］

並べて表示

開かれているすべてのウィンドウを横に並べて表示します。

［Ctrl］+［T］

アイコンの整列

ウィンドウのアイコンを下段に整列します。

［Ctrl］+［A］

閉じる

アクティブなAITファイルを閉じます。

［Ctrl］+［O］

すべて閉じる

AITファイルをすべて閉じます。

［Ctrl］+［L］

ヘルプ

バージョン情報

Automatic Installation Toolのバージョン情報を表示します。

［Ctrl］+［A］

（凡例）　−：該当なし

付録D　アイコン一覧

JP1/IT Desktop Management 2で表示される各ウィンドウのアイコン一覧を次に示します。

付録D.1　［システム構成］ウィンドウのアイコン

システムを構成するホストの種類には、マネージャ、管理用中継サーバ、中継システム、および管理対象のコンピュータがあり、それぞれ表示されるアイコンが異なります。ホストの階層の最上位には、マネージャのアイコンが表示されます。

［システム構成］ウィンドウに表示されるアイコンを次に示します。

[図データ]：マネージャ

[図データ]：管理用中継サーバ

[図データ]：中継システム

[図データ]：コンピュータ

付録D.2　［あて先］ウィンドウのアイコン

あて先には、グループとホストがあります。ホストは、グループの下に設定します。

［あて先］ウィンドウに表示されるアイコンを次に示します。

[図データ]：マネージャ

[図データ]：管理用中継サーバ

[図データ]：中継システム

[図データ]：コンピュータ

[図データ]：あて先グループ

[図データ]：ID

付録D.3　［パッケージ］ウィンドウのアイコン

［パッケージ］ウィンドウでは、配布管理システム、キャビネットおよびパッケージをアイコンで表示します。

［パッケージ］ウィンドウに表示されるアイコンを次に示します。

[図データ]：配布管理システムのホスト

[図データ]：キャビネット（Windows用）

[図データ]：キャビネット（UNIX用）

[図データ]：通常のパッケージ（正常にパッケージングされたもの）

[図データ]：通常のパッケージ（パッケージング中、またはパッケージングに失敗したもの）

付録D.4　［ジョブ定義］ウィンドウのアイコン

保存したジョブは、［ジョブ定義］ウィンドウにアイコンで表示されます。

［ジョブ定義］ウィンドウに表示されるアイコンを次に示します。

[図データ]：マネージャ

[図データ]：フォルダ

[図データ]：ジョブ

付録D.5　［ジョブ実行状況］ウィンドウのアイコン

ジョブの実行状況は、アイコンで表示されます。アイコンは、ジョブの種別や実行状況によって異なります。

［ジョブ実行状況］ウィンドウに表示されるアイコンを次に示します。

[図データ]：配布管理システムのホスト

[図データ]：ジョブの対象となるホスト

[図データ]：フォルダ

[図データ]：IDジョブ

[図データ]：ジョブの状態（実行待ち）

[図データ]：ジョブの状態（実行中または実行完了）

[図データ]：ジョブの状態（実行期限切れ）

[図データ]：ジョブ種別（パッケージのインストール）※

[図データ]：ジョブ種別（中継までのパッケージの転送）

[図データ]：ジョブ種別（中継のパッケージの一括削除）

[図データ]：ジョブ種別（クライアントユーザによるインストール）

[図データ]：ジョブ種別（リモートコレクト）

[図データ]：ジョブ種別（中継までのリモートコレクト）

[図データ]：ジョブ種別（中継からのコレクトファイル収集）

[図データ]：ジョブ種別（中継のコレクトファイル削除）

[図データ]：ジョブ種別（コンピュータ（UNIX）のシステム情報の取得）※

[図データ]：ジョブ種別（コンピュータ（UNIX）のソフトウェア情報の取得）※

[図データ]：ジョブ種別（システム構成情報の取得）

[図データ]：ジョブ種別（中継からの結果通知保留）

[図データ]：ジョブ種別（中継の結果通知保留の解除）

[図データ]：ジョブ種別（ファイル転送の中断）

[図データ]：ジョブ種別（ファイル転送の再開）

注※

このジョブはMacエージェントにも適用できます。

付録D.6　［Package Setup Manager］ウィンドウのアイコン

［Package Setup Manager］ウィンドウでは、パッケージの状態およびパッケージ種別をアイコンで示します。

(1)　［パッケージ］ウィンドウ

パッケージの状態によって、次に示すアイコンが表示されます。

[図データ]：配布管理システムからインストールを許可されたパッケージ（通常のパッケージ）

[図データ]：管理対象のコンピュータで正常にインストールを終えたパッケージ

[図データ]：管理対象のコンピュータでのインストールに失敗したパッケージ

(2)　［インストールパッケージ］ウィンドウ

パッケージ種別によって、次に示すアイコンが表示されます。

[図データ]：日立プログラムプロダクト

[図データ]：他社ソフトウェア

[図データ]：ユーザプログラムまたはユーザデータ

付録E　リモートインストールマネージャからのツールの起動

任意のツールを登録して、リモートインストールマネージャから起動できます。ツールの起動時には、リモートインストールマネージャで選択したホストのシステム構成情報を、ツールの引数として利用できます。

例えば、IPアドレスで指定したホストの接続状態を確認するツールを登録した場合、リモートインストールマネージャで選択したホストのIPアドレスをツールの引数として自動的に取り込めるので、ツールを起動したあとでIPアドレスを指定する手間が省けます。

登録したツールは、［ツールの起動］メニューから起動できます。［ツールの起動］メニューを表示できるのは、リモートインストールマネージャの次の画面からです。

［システム構成］ウィンドウ

［あて先］ウィンドウ

［検索］ダイアログボックス

リモートインストールマネージャでのツールの登録方法、起動方法、および運用例について説明します。

付録E.1　メニューにツールを登録する

リモートインストールマネージャのメニューからツールを起動するには、［ツールの登録］ダイアログボックスでツールを登録する必要があります。また、［ツールの登録］ダイアログボックスでは、ツールの登録内容を変更したり、登録したツールをメニューから削除したりもできます。

(1)　登録の手順

［ツールの起動］メニューにツールを登録する手順を次に示します。

［システム構成］ウィンドウまたは［あて先］ウィンドウの［オプション］メニューから、［ツールの起動］−［ツールの登録］を選択する。

［ツールの登録］ダイアログボックスが表示されます。

なお、［ツールの登録］ダイアログボックスは、次の方法で表示することもできます。

［システム構成］ウィンドウまたは［あて先］ウィンドウに表示されているホストを右クリックして、［ツールの起動］−［ツールの登録］を選択する。

［検索］ダイアログボックスに表示されているホストを右クリックして、［ツールの起動］−［ツールの登録］を選択する。

図E‒1　［ツールの登録］ダイアログボックス

各項目を指定する。

各項目について説明します。

メニュー名（必ず指定）

［ツールの起動］メニューに表示されるメニュー名を、半角で255文字（全角で127文字）以内で指定します。同じメニュー名を複数登録することはできません。

登録するメニュー名にショートカットキーを指定する場合は、「メニュー名(&X)」の形式で指定します。「(&X)」はすべて半角で指定してください。「X」に指定した文字のキーが、ショートカットキーになります。例えば、「接続確認ツール」というメニューに［R］キーをショートカットキーとして登録する場合は、「接続確認ツール(&R)」と指定します。

ツールのパス名（必ず指定）

登録するツールのフルパスを、半角で260文字（全角で130文字）以内で指定します。［参照］ボタンをクリックして表示されるダイアログから、選択したツールのフルパスを指定できます。また、「ツールのパス名」には、ネットワーク上のホストや、表E-1に示す予約語も指定できます。

「ツールのパス名」には、EXEファイル、BATファイル、CMDファイルなどの実行ファイルを指定してください。TXTファイルなどを指定しても起動できません。また、存在しないファイル名またはアクセスできないファイル名を指定した場合、ツールの起動時にエラーとなります。

引数

ツールの起動時に引数として渡す値を、半角で260文字（全角で130文字）以内で指定します。リモートインストールマネージャで選択したホストのシステム構成情報を引数として渡すには、予約語を指定します。予約語の指定方法については、「付録E.1(2)　予約語の指定方法」を参照してください。

［登録］ボタンをクリックする。

指定した内容が「メニューの一覧」に追加されます。ツールは10個まで登録できます。

［OK］ボタンをクリックする。

［ツールの登録］ダイアログボックスが閉じ、「メニューの一覧」に表示されているツールが［ツールの起動］メニューに登録されます。なお、［キャンセル］ボタンをクリックした場合、ツールは登録されません。

(2)　予約語の指定方法

予約語は、次の方法で指定できます。

［引数］ボタンをクリックして表示されるメニューからシステム構成情報を選択する。

テキストボックスに直接入力する。

引数として渡せるシステム構成情報と、対応する予約語を次の表に示します。

表E‒1　システム構成情報と対応する予約語

システム構成情報

予約語

ツールに渡す形式

運用キー

$(KEY)

ホスト名運用の場合

ホスト名

IPアドレス運用の場合

XXX.XXX.XXX.XXX

ホスト名

$(NAME)

ホスト名

IPアドレス

$(ADDRESS)

XXX.XXX.XXX.XXX

ホスト識別子

$(HOSTID)

#ホスト識別子

MACアドレス

$(MACADDRESS)

MACアドレス

経路

$(ROUTE)

¥経路※

ホスト種別

$(TYPE)

中継システムの場合

MASTER

管理対象のコンピュータの場合

CLIENT

更新日時

$(UPDATE)

YYYYMMDD.hhmmss

作成日時

$(CRTDATE)

YYYYMMDD.hhmmss

コメント

$(COMMENT)

コメント

注※　システム構成情報の経路の区切りには「!」が使われていますが、ツールに渡す形式では、経路の区切りが「¥」になります。なお、ルート直下のホストの場合、「¥」だけがツールに渡されます。

注意事項

直接予約語を入力する場合は、必ず半角大文字で指定してください。例えば、「$(name)」と入力しても、予約語として認識されません。

システム構成情報に値がない場合、指定した予約語には値が入りません。

予約語を指定して、ホスト名、ホスト識別子およびMACアドレスをツールの引数として渡す場合の、「引数」の指定例を次に示します。

/n $(NAME) /id $(HOSTID) /mac $(MACADDRESS)

このように指定した場合、ツールの起動時に実行される内容は次のようになります。

(3)　登録内容の変更

［ツールの起動］メニューに登録したツールの、「メニュー名」、「ツールのパス名」および「引数」を変更する手順を次に示します。なお、複数のツールの登録内容を同時に変更することはできません。

［ツールの登録］ダイアログボックスの「メニューの一覧」から、登録内容を変更したいメニューを選択する。

「メニュー名」、「ツールのパス名」および「引数」に登録されている内容が表示されます。

登録内容を変更する。

［登録］ボタンをクリックする。

変更した内容が、「メニューの一覧」に反映されます。

［OK］ボタンをクリックする。

［ツールの登録］ダイアログボックスが閉じ、「メニューの一覧」の内容が［ツールの起動］メニューに反映されます。なお、［キャンセル］ボタンをクリックした場合、変更した内容は［ツールの起動］メニューに反映されません。

(4)　登録したツールの削除

［ツールの起動］メニューに登録したツールを削除する手順を次に示します。複数のツールを選択して、一括して削除することもできます。

［ツールの登録］ダイアログボックスの「メニューの一覧」から、削除したいメニューを選択する。

［削除］ボタンをクリックする。

選択したメニューが、「メニューの一覧」から削除されます。

［OK］ボタンをクリックする。

［ツールの登録］ダイアログボックスが閉じ、「メニューの一覧」の内容が［ツールの起動］メニューに反映されます。なお、［キャンセル］ボタンをクリックした場合、ツールは削除されません。

付録E.2　メニューからツールを起動する

リモートインストールマネージャのメニューから、ツールを起動する手順を次に示します。

［システム構成］ウィンドウ、［あて先］ウィンドウ、または［検索］ダイアログボックスで、ホストを選択する。

ツールを起動できるのはホストを選択した場合だけです。ホストと同時にIDまたはあて先グループを選択した場合、IDまたはあて先グループに対してはツールを起動できません。なお、複数のホストを選択してツールを起動した場合、選択したホストそれぞれに対してツールが起動します。例えば、10台のホストを選択してツールを起動した場合、同じツールが10個起動します。一度に多くのホストを選択してツールを起動すると、メモリを大量に使用してシステムが不安定になるおそれがあるので注意が必要です。

［オプション］メニューまたは右クリックで表示されるメニューから［ツールの起動］を選択する。

［検索］ダイアログボックスでは、右クリックでだけメニューが表示されます。

図E‒2　［システム構成］ウィンドウからのツール起動

起動したいツールを選択する。

選択したツールが起動します。「ツールのパス名」または「引数」に予約語を指定している場合は、選択したホストのシステム構成情報に置き換わります。

付録E.3　ツールを起動する運用例

引数として与えられたIPアドレスのホストにpingを実行するツールを、リモートインストールマネージャから起動する運用例を次の図に示します。

図E‒3　リモートインストールマネージャからツールを起動する運用例

ツールの登録

［ツールの登録］ダイアログボックスで、リモートインストールマネージャのメニューにPINGツールを登録します。

IPアドレスをツールの引数とするため、「引数」に「$(ADDRESS)」を指定します。

ツールの起動

リモートインストールマネージャでホスト「CLT002」を選択して、メニューからPINGツールを起動します。

ツールの引数として、CLT002のシステム構成情報からIPアドレス「192.168.24.12」が渡されます。

ツールの実行結果の確認

IPアドレスが「192.168.24.12」のCLT002にPINGツールが実行されるので、その結果を確認します。

付録F　PP識別情報ファイルの編集方法

AITファイル作成時に生成されたPP識別情報ファイルは、JP1/IT Desktop Management 2のインストール先フォルダ¥DMPRMに、PPDEFAIT.DMPというファイル名で格納されます。生成されたPP識別情報ファイルを編集する場合は、ここで説明する形式に従って設定してください。

PP識別情報ファイルの形式は、次のとおりです。

情報マップ;パッケージ識別ID;バージョン;パッケージ名;AITファイルのフルパス;識別用ファイル名1;識別用ファイル名2;...;識別用ファイル名N;

PP識別情報ファイルには、1行に1ソフトウェアの定義を499バイト以内で記述します。ソフトウェアが複数ある場合は、複数行記述してください。各項目はセミコロン（;）で区切ります。各項目の詳細は次のとおりです。なお、PP識別情報ファイルで定義した「パッケージ識別ID」、「バージョン」、および「パッケージ名」は、パッケージング時に［JP1/ITDM2 パッケージング］ダイアログボックスに表示され、変更できません。

情報マップ（必ず記述）

000001を記述します。

パッケージ識別ID（必ず記述）

配布するソフトウェアのパッケージ識別IDです。AITファイルで指定したパッケージ識別IDを記述します。

バージョン（必ず記述）

配布するソフトウェアのバージョンです。AITファイルで指定したバージョンを記述します。

パッケージ名（必ず記述）

配布するソフトウェアのパッケージ名です。AITファイルで指定したパッケージ名を記述します。

AITファイルのフルパス（必ず記述）

AITファイルの完全なパス名を、ドライブ名も含めて記述します。256バイト以内で指定してください。全角文字は使用できません。

識別用ファイル名1〜N（必ず記述）

配布するソフトウェアをユニークに識別できるファイル名を記述します。パッケージング時に、このファイルが存在すると、配布するソフトウェアであると判断されます。複数のファイルを記述した場合は、すべてのファイルが存在するとき、配布するソフトウェアであると判断されます。

AITファイル「AR505.ais」が「C:¥ADOBE」にある場合の、PP識別情報ファイルの例を次に示します。

000001;ADOBEACROBATREADER;505;Adobe Acrobat Reader 5.05;C:¥ADOBE¥AR505.ais;Ar505jpn.exe;

付録G　UNIXエージェント、Macエージェントのシステム情報とソフトウェア情報の取得

ここでは、UNIXエージェント、Macエージェントのシステム情報とソフトウェア情報を取得する方法について説明します。

付録G.1　UNIXエージェント、Macエージェントのシステム情報の取得

ここでは、UNIXエージェント、Macエージェントのシステム情報の取得方法および確認方法について説明します。

(1)　システム情報の取得手順

システム情報は、リモートインストールマネージャから「コンピュータ（UNIX）のシステム情報の取得」ジョブを実行して取得します。ここでは、画面遷移を中心に、システム情報の取得手順を説明します。

システム情報の取得手順を次に示します。

［ジョブ定義］ウィンドウで［ファイル］−［ジョブ定義の新規作成］を選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されます。

ジョブ種別に「コンピュータ（UNIX）のシステム情報の取得」を指定し、［OK］ボタンをクリックする。

［ジョブの作成］ダイアログボックスが表示されます。

［取得項目］パネルで、取得するシステム情報の項目を設定する。

［取得項目］パネルの設定方法については、「付録G.1(2)　［取得項目］パネルの設定」を参照してください。ダイアログボックス上に表示されるそのほかのパネルの種類および設定内容は次のとおりです。

［ジョブ］パネル

ジョブ名を設定します。［ジョブ］パネルの設定方法については、「10.2.3　［ジョブ］パネルの設定」を参照してください。

［あて先］パネル

システム情報を取得するホストを設定します。必ず一つ以上設定してください。［あて先］パネルの設定方法については、「10.2.4　［あて先］パネルの設定」を参照してください。

［スケジュール］パネル

配布管理システムおよび管理対象のコンピュータでのジョブ実行日時を設定します。［スケジュール］パネルの設定方法については、「10.2.5　［スケジュール］パネルの設定」を参照してください。

［クライアント制御］パネル

クライアント制御機能を使用するかどうかを設定できます。［クライアント制御］パネルの設定方法については、「10.2.6　［クライアント制御］パネルの設定」を参照してください。

［実行］、［保存］、または［保存&実行］ボタンをクリックして、ジョブを保存または実行する。

ジョブが保存または実行されます。

ジョブを保存しておくと、ジョブが失敗した場合に再実行したり、既存のジョブを編集してジョブを新規作成する手間を省いたりできます。［保存］または［保存&実行］ボタンを使用していったんジョブを保存することをお勧めします。

ジョブの実行状況を確認する。

リモートインストールマネージャの［ファイル］メニューから、［新規作成］−［ジョブ実行状況］を選択して、［ジョブ実行状況］ウィンドウを表示します。

システム情報の取得に関するジョブの実行状況は、「機器情報の収集」フォルダで確認できます。実行したジョブを選択すると、右枠に実行状況が表示されます。

ジョブの実行が完了したら、取得したシステム情報を確認する。

取得したシステム情報は、JP1/IT Desktop Management 2 の機器画面で確認します。システム情報の確認方法については、「付録G.1(4)　取得したシステム情報の確認」を参照してください。

(2)　［取得項目］パネルの設定

［取得項目］パネルでは、OSがUNIXまたはMacのコンピュータから取得するシステム情報の項目について設定します。

ジョブ実行時のネットワークの転送量を削減したい場合は、「前回取得したシステム情報から変更された項目だけを取得する」を選択してください。

図G‒1　［取得項目］パネル

すべての項目を取得する

システム情報のすべての項目を取得する場合に指定します。初回は、こちらを選択してください。

前回取得したシステム情報から変更された項目だけを取得する

前回取得したシステム情報から変更された項目だけを取得する場合に指定します。

(3)　システム情報を取得するときの注意事項

「コンピュータ（UNIX）のシステム情報の取得」ジョブ実行時の注意事項を次に示します。

エージェントのハードウェアの環境によっては、システム情報が正しく取得できないことがあります。

システム情報の取得に時間が掛かることがあります。

(4)　取得したシステム情報の確認

取得したシステム情報は、JP1/IT Desktop Management 2の機器画面の［システム情報］タブと［ハードウェア情報］タブで確認できます。確認方法を次に示します。

機器画面の［機器一覧］画面で、システム情報を表示するホストを選択する。

下部のタブから［システム情報］タブと［ハードウェア情報］タブを選択する。

システム情報が表示されます。

システム情報を取得したときに更新される項目は、ジョブ作成時の［取得項目］パネルでの設定によって次のように異なります。

「すべての項目を取得する」を選択した場合

既存のシステム情報がすべて削除され、エージェントから通知されたシステム情報が表示されます。

「前回取得したシステム情報から変更された項目だけを取得する」を選択した場合

エージェントからは、システム情報の変更部分だけが通知され、通知されたシステム情報が反映されます。

エージェント側で情報が取得できなかった項目は、配布管理システムに通知されません。エージェントから情報が通知されなかった場合、システム情報の更新時に項目が非表示になります。

付録G.2　UNIXエージェント、Macエージェントのソフトウェア情報の取得

ここでは、UNIXエージェント、Macエージェントのソフトウェア情報の取得方法について説明します。

(1)　ソフトウェア情報の取得手順

ソフトウェア情報は、リモートインストールマネージャから「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブを実行して取得します。ここでは、画面遷移を中心に、ソフトウェア情報の取得手順を説明します。

ソフトウェア情報の取得手順を次に示します。

［ジョブ定義］ウィンドウで［ファイル］−［ジョブ定義の新規作成］を選択する。

［ジョブ定義の新規作成］ダイアログボックスが表示されます。

ジョブ種別に「コンピュータ（UNIX）のソフトウェア情報の取得」を指定し、［OK］ボタンをクリックする。

［ジョブの作成］ダイアログボックスが表示されます。

［検索対象］パネルで、ソフトウェア情報取得の対象となるソフトウェアを設定する。

［検索対象］パネルの設定方法については、「付録G.2(2)　［検索対象］パネルの設定」を参照してください。ダイアログボックス上に表示されるそのほかのパネルの種類および設定内容は次のとおりです。

［ジョブ］パネル

ジョブ名を設定します。［ジョブ］パネルの設定方法については、「10.2.3　［ジョブ］パネルの設定」を参照してください。

［あて先］パネル

ソフトウェア情報を取得するホストを設定します。必ず一つ以上設定してください。［あて先］パネルの設定方法については、「10.2.4　［あて先］パネルの設定」を参照してください。

［スケジュール］パネル

配布管理システムおよび管理対象のコンピュータでのジョブ実行日時を設定します。［スケジュール］パネルの設定方法については、「10.2.5　［スケジュール］パネルの設定」を参照してください。

［クライアント制御］パネル

クライアント制御機能を使用するかどうかを設定できます。［クライアント制御］パネルの設定方法については、「10.2.6　［クライアント制御］パネルの設定」を参照してください。

［実行］、［保存］、または［保存&実行］ボタンをクリックして、ジョブを保存または実行する。

ジョブが保存または実行されます。

ジョブを保存しておくと、ジョブが失敗した場合に再実行したり、既存のジョブを編集してジョブを新規作成する手間を省いたりできます。［保存］または［保存&実行］ボタンを使用していったんジョブを保存することをお勧めします。

ジョブの実行状況を確認する。

リモートインストールマネージャの［ファイル］メニューから、［新規作成］−［ジョブ実行状況］を選択して、［ジョブ実行状況］ウィンドウを表示します。

実行したジョブを選択すると、右枠に実行状況が表示されます。

ジョブの実行が完了したら、取得したソフトウェア情報を確認する。

取得したソフトウェア情報は、JP1/IT Desktop Management 2 の機器画面で確認します。ソフトウェア情報の確認方法については、「付録G.2(5)　取得したソフトウェア情報の確認」を参照してください。

(2)　［検索対象］パネルの設定

［検索対象］パネルでは、OSがUNIXまたはMacのコンピュータから取得するソフトウェア情報の対象となるソフトウェアを設定します。

図G‒2　［検索対象］パネル

検索対象ソフトウェア

ソフトウェア情報取得の対象となるソフトウェアを設定します。次に示す項目を選択できます。

リモートインストールしたソフトウェア

JP1/IT Desktop Management 2 - Managerでインストールしたソフトウェアの情報を取得します。

すべてのソフトウェア

次に示すソフトウェア情報を取得します。

検索リスト

検索対象ソフトウェアとして「すべてのソフトウェア」を指定した場合、次に示すソフトウェア検索リストを利用してUNIXまたはMacのコンピュータにインストールされているソフトウェアを検索できます。

ソフトウェア検索リストを使用する場合、マネージャに保存されている検索リスト、またはエージェントに保存されている検索リストのどちらを使用するか選択します。

マネージャに保存されている検索リストを使用して検索を実行すると、実行先のエージェントに指定した検索リストが送付され、エージェントに保存されます。エージェントにすでに存在している場合は、検索リストが上書きされます。前回と同じ検索リストを使用して検索を実行したい場合は、エージェントに保存されている検索リストを使用します。

デフォルトは「エージェントに存在する検索リスト」です。

エージェントに存在する検索リスト

前回検索リストを使用してソフトウェア検索した時に、エージェント側に保存された検索リストです。

ユーザ指定検索リスト

検索対象にするソフトウェアを任意に登録できる検索リストです。

ユーザ指定検索リストは、検索するエージェントの範囲ごとに作成したり、エージェントのOSごとに作成したり、複数作成できます。なお、テキストボックスに直接指定する場合、「¥」「/」「*」「"」「:」「!」「|」「<」「>」「'」「.」「?」および半角スペースは指定できません。

ソフトウェア検索リストの作成方法については、「付録G.2(4)　ソフトウェア検索リストの作成方法」を参照してください。

使用しない

検索リストを使用しないで検索を実行したい場合に選択します。

この項目を選択してジョブを実行したときは、実行先のエージェントに保存されている検索リストがすべて削除されます。

次回以降の検索で検索リストを使用したいときは、マネージャに保存されている検索リストを使用して検索を実行してください。

なお、検索リストを使用して定期的にソフトウェア情報を取得する運用では、使用する検索リストが異なると取得する情報も異なってしまうので、［ジョブの作成］ダイアログボックスをカスタマイズして、毎回使用する検索リストをデフォルトにしておくことをお勧めします。

［ジョブの作成］ダイアログボックスのカスタマイズについては、「10.6.2　［ジョブの作成］ダイアログボックスのカスタマイズ」を参照してください。

検索対象のファイルシステム

検索対象ソフトウェアとして「すべてのソフトウェア」を指定した場合に、検索の対象とするファイルシステムを次のうちから選択します。

ローカル

ローカルファイルシステムを検索の対象とする場合に指定します。

ローカルとネットワーク

ローカルファイルシステムとネットワークファイルシステムを検索の対象とする場合に指定します。

(3)　ソフトウェア情報を取得するときの注意事項

ソフトウェア情報を取得するときの注意事項を次に示します。

UNIXやMacのソフトウェア情報を取得してJP1/IT Desktop Management 2の操作画面で管理するには、コンフィグレーションファイル（jdn_manager_config.conf）を編集する必要があります。コンフィグレーションファイルの編集方法については、マニュアル「JP1/IT Desktop Management 2 構築ガイド」のUNIXエージェント、Macエージェントのソフトウェア情報管理の設定を変更する手順の説明を参照してください。

いったんソフトウェア情報を取得したあと、再度［検索対象］パネルの設定を変えてジョブを実行すると、両方の取得情報がマージされます。

現在のコードページに変換できない文字が含まれているソフトウェアの情報は取得できない場合があります。

(4)　ソフトウェア検索リストの作成方法

ソフトウェア検索リストの内容は［ソフトウェア検索リスト一覧］ダイアログボックスで確認できます。

［ソフトウェア検索リスト一覧］ダイアログボックスの表示方法を次に示します。

［管理情報リスト］ウィンドウに表示されている検索リストを選択して、右クリックで表示されるメニューから［編集］を選択する。

［管理情報リスト］ウィンドウで、［ファイル］−［検索リストの新規作成］を選択する。

図G‒3　［ソフトウェア検索リスト一覧］ダイアログボックス（［ユーザ指定検索リスト］パネル）

［ユーザ指定検索リスト］パネルには、ユーザ指定検索リストの内容が表示されます。作成した検索リストの内容を編集することもできます。

ユーザ指定検索リストの作成方法

ユーザ指定検索リストを新規に作成する方法を次に示します。

［管理情報リスト］ウィンドウで、［ファイル］−［検索リストの新規作成］を選択する。

［ソフトウェア検索リスト一覧］ダイアログボックスが表示されます。

［追加］ボタンをクリックする。

［ソフトウェア検索リストの編集］ダイアログボックスが表示されます。

図G‒4　［ソフトウェア検索リストの編集］ダイアログボックス

検索対象にするソフトウェアの情報を入力します。次の項目は必ず指定してください。

パッケージ名称

半角で1〜50文字（全角で1〜25文字）で指定します。「¥」および「;」は使用できません。

パッケージ識別ID

半角で1〜44文字で指定します。使用できる文字は、「A」〜「Z」、「0」〜「9」、「_」および「-」です。

ファイル名

半角で1〜256文字（全角で1〜128文字）で指定します。「¥」および「;」は使用できません。

なお、［参照］ボタンをクリックしてファイルを指定すると、ソフトウェアの情報が自動的に設定されます。このとき、「最終更新時間」は配布管理システムのローカル時間で設定されます。

［追加］ボタンをクリックする。

設定した項目が［ユーザ指定検索リスト］パネルに追加されます。続けて項目を追加できます。

［キャンセル］ボタンをクリックする。

［ソフトウェア検索リストの編集］ダイアログボックスが閉じます。

［保存］ボタンをクリックする。

［検索リスト名の設定］ダイアログボックスが表示されます。

名前を指定し［OK］ボタンをクリックする。

設定した内容を保存して［ソフトウェア検索リスト一覧］ダイアログボックスが閉じます。作成した検索リストは、［管理情報リスト］ウィンドウに表示されます。

ファイルを利用したユーザ指定検索リストの作成

ユーザ指定検索リストは、［ソフトウェア検索リスト一覧］ダイアログボックスで作成するほかに、検索リストの項目を設定したファイルから作成することもできます。また、［管理情報リスト］ウィンドウに表示されているユーザ指定検索リストをファイルに出力することもできます。

ユーザ指定検索リストのファイル形式

ユーザ指定検索リストのファイル形式を次に示します。検索リストは、検索対象のソフトウェアごとに1行で以下の形式の情報を設定します。ファイルはテキスト形式です。

1カラム目に「#」を付けると、その行はコメントとみなされます。

形式

情報マップ;プログラム識別子;ファイル名;パッケージ識別ID;［バージョン］; パッケージ名称;［ファイル最終更新時間］;［ファイルサイズ］;［世代番号］

説明

情報マップ（必ず指定）

必ず半角で「001」を設定します。

プログラム識別子（必ず指定）

プログラム識別子を半角で次のように設定します。

P：日立プログラムプロダクト

I：他社ソフトウェア

スペース：ユーザプログラム、データ

上記以外の指定は、未指定と見なします。

ファイル名（必ず指定）

検索対象のソフトウェアを構成するファイルのうちの1ファイルを、半角で256文字（全角で128文字）以内で指定します。検索をより正確に行うため、ファイル名には検索対象のソフトウェアの特徴的なファイルを設定することをお勧めします。

パッケージ識別ID（必ず指定）

各ソフトウェアについてユニークな文字列を、44文字以内で指定します。使用できる文字は、半角の「A」〜「Z」、「0」〜「9」および「-」です。ユーザ指定検索リストに新規のソフトウェアの情報を登録する場合、エージェントに存在する検索リストで使用されていないものを指定してください。また、プログラムについては次のように指定することをお勧めします。

日立プログラムプロダクトの場合：製品型名（例：P-2642-78BLなど）

他社ソフトウェアの場合：「（会社）-（製品名）」の形式

バージョン

検索対象のソフトウェアのバージョンを、6文字以内で設定します。使用できる文字は、半角の「A」〜「Z」、「0」〜「9」および「/」です。もし設定されていない場合、検索対象ファイルのバージョンリソースからバージョンを取得します。バージョンを取得できないときは、自動的に「000000」が設定されます。

パッケージ名称（必ず指定）

検索対象ソフトウェアの名称を、半角で50文字（全角で25文字）以内で指定します。ただし、半角の「¥」は使用できません。

ファイル最終更新時間

「ファイル名」で設定したファイルの最終更新時間を設定します。検索対象のソフトウェアのバージョンが複数ある場合に設定します。

「YYYY/MM/DD/hh/mm/ss」の形式で、必要な項目まで設定してください。

YYYY：年（西暦）（1900〜2100）

MM：月（01〜12）

DD：日（01〜31）

hh：時間（00〜23）

mm：分（00〜59）

ss：秒（00〜59）

（例）

2015年10月1日11時に作成したファイル：2015/10/01/11

ファイルサイズ

「ファイル名」で設定したファイルのファイルサイズをバイト単位で設定します。検索対象のソフトウェアのバージョンが複数ある場合に設定します。ファイルサイズは、最大10けたで、0〜2,147,483,647を設定してください。

世代番号

検索対象ソフトウェアの世代番号を4文字以内で設定します。使用できる文字は、半角の「A」〜「Z」、および「0」〜「9」です。設定されていない場合は、自動的に「0000」が設定されます。

指定例

001;I;oracle;ORACLE-DATABASE;0920;Oracle Database;2007/08/09/18/45;66146800;

ファイルからのユーザ指定検索リストの作成手順

検索リストの項目を設定したファイルから、ユーザ指定検索リストを作成する手順を次に示します。

［管理情報リスト］ウィンドウで、［ファイル］−［ファイルから作成］を選択する。

［検索リストの読み込み］ダイアログボックスが表示されます。

ファイルを選択し、［OK］ボタンをクリックする。

［検索リスト名の設定］ダイアログボックスが表示されます。

名前を指定し［OK］ボタンをクリックする。

指定したファイルを読み込んで、検索リストが作成されます。

ファイルの記述内容に誤りがあった場合は、エラーの個所を示すダイアログボックスが表示されます。ファイルを修正したあと、再度実行してください。

ユーザ指定検索リストのファイルへの出力手順

［管理情報リスト］ウィンドウに表示されているユーザ指定検索リストの内容をファイルに出力する手順を次に示します。

［管理情報リスト］ウィンドウで、出力したいユーザ指定検索リストを選択する。

［ファイル］−［ファイルへ保存］を選択する。

［検索リストの保存］ダイアログボックスが表示されます。

ファイル名を設定し、［OK］ボタンをクリックする。

ユーザ指定検索リストの内容がファイルに出力されます。

ユーザ指定検索リストの項目の編集

登録済みのユーザ指定検索リストの項目を編集する方法を次に示します。

［ユーザ指定検索リスト］パネルで編集したい項目を選択する。

［変更］ボタンをクリックする。

［ソフトウェア検索リストの編集］ダイアログボックスが表示されます。

登録内容を編集する。

［ソフトウェア検索リストの編集］ダイアログボックスで、登録内容を編集してください。

［OK］ボタンをクリックする。

編集した内容が、ユーザ指定検索リストに反映されます。

(5)　取得したソフトウェア情報の確認

取得したソフトウェア情報は、次に示す方法で確認できます。

コンフィグレーションファイル（jdn_manager_config.conf）でUNIXエージェント、Macエージェントのソフトウェア情報を「管理する」にしている場合

JP1/IT Desktop Management 2の機器画面の［インストールソフトウェア情報］タブで確認できます。確認方法を次に示します。

機器画面の［機器一覧］画面で、ソフトウェア情報を表示するホストを選択する。

下部のタブから［インストールソフトウェア情報］タブを選択する。

選択したホストにインストールされているソフトウェアの情報が表示されます。

コンフィグレーションファイル（jdn_manager_config.conf）でUNIXエージェント、Macエージェントソフトウェア情報を「管理しない」にしている場合

リモートインストールマネージャの［システム構成］および［あて先］ウィンドウの［インストールパッケージ］パネルで確認できます。確認方法を次に示します。

［システム構成］または［あて先］ウィンドウの左枠で、ソフトウェア情報を表示するホストを選択する。

右枠で［インストールパッケージ］タブを選択する。

選択したホストにインストールされているソフトウェアの情報が表示されます。

(6)　取得したソフトウェア情報の削除

「コンピュータ（UNIX）のソフトウェア情報の取得」ジョブを実行して配布管理システムが情報を取得したあと、エージェントが不要なソフトウェアを削除した場合など、配布管理システムで取得したソフトウェア情報とエージェントのソフトウェア情報が一致しなくなることがあります。そのような場合は、配布管理システム側のソフトウェア情報を、いったん削除してください。

配布管理システム側のソフトウェア情報を削除する方法は、インストール済みパッケージ情報を削除する手順と同じです。詳細は、「7.5　インストールパッケージ情報の削除」を参照してください。なお、「パッケージ」を「ソフトウェア」と読み替えてください。

付録H　各バージョンの変更内容

付録H.1　12-60の変更内容

インストール定義ファイルの作成を追加した。

付録H.2　12-50の変更内容

CentOS 8.1、Linux 8、およびOracle Linux 8をJP1/IT Desktop Management 2 - Agentの適用OSに追加した。

付録H.3　12-10の変更内容

Windows Server 2019を次の製品の適用OSに追加した。

JP1/IT Desktop Management 2 - Manager

JP1/IT Desktop Management 2 - Agent

JP1/IT Desktop Management 2 - Network Monitor

JP1/IT Desktop Management 2 - Asset Console

JP1/IT Desktop Management 2 - Internet Gateway

Remote Install Manager

Windowsの更新プログラムおよびWindows 10のFeature Updateをリモートインストールマネージャでパッケージングして配布できるようにした。

付録H.4　12-00の変更内容

Windows Server 2008 R2を次の製品の適用OS外とした。

JP1/IT Desktop Management 2 - Manager

JP1/IT Desktop Management 2 - Network Monitor

JP1/IT Desktop Management 2 - Asset Console

Remote Install Manager

上位システムの接続先を自動で切り替えてファイルを配布できるようにした。

付録H.5　11-51の変更内容

2ギガバイトを超えるファイルを配布できるようにした。

dcmpackコマンドで配布対象のファイルを一定のサイズで分割するオプションを追加した。

catAndValidatePackagingFileコマンドを追加した。

付録H.6　11-50の変更内容

Macエージェントに対して、ソフトウェアおよびファイルの配布（リモートインストール）をできるようにした。

Citrix XenApp、Microsoft RDSがインストールされているサーバにエージェントを導入して、JP1/IT Desktop Management 2で管理できるようにした。

IDの自動メンテナンスで、機器情報（モデル、メーカー、IPアドレス、インストールされているソフトウェア情報、資産管理項目）を条件としたポリシーを設定できるようにした。

付録H.7　11-10の変更内容

Windows Server 2016を次の製品の適用OSに追加した。

JP1/IT Desktop Management 2 - Manager

JP1/IT Desktop Management 2 - Agent

JP1/IT Desktop Management 2 - Network Monitor

JP1/IT Desktop Management 2 - Asset Console

Remote Install Manager

JP1/IT Desktop Management 2 - Agentの適用OSとして次を追加した。

Red Hat Enterprise Linux(R) 5

OSがMacのコンピュータにエージェントを導入して管理できるようにした。

提供する機能

・システム情報およびソフトウェア情報の取得

・RFB接続によるリモートコントロール（エージェントレスでは提供済み）

・ネットワーク制御（オンデマンドでの接続/遮断）

提供しない機能（提供予定の機能を含む）

・ソフトウェアやファイルの配布（リモートインストール）

・ファイル収集（リモートコレクト）

・エージェント設定やエージェントの配信

・セキュリティ管理（セキュリティ判定・自動対策）

・操作ログ

・デバイス制御

パッケージング時に、複数のパッケージ条件およびソフトウェア条件を設定した場合の判定方法を選択できるようにした。

付録H.8　11-01の変更内容

Windows 10をJP1/IT Desktop Management 2 - Network Monitorの適用OSに追加した。

操作画面から、オンラインヘルプを起動するためのアイコンおよびボタンを削除した。

機器のメンテナンスで削除候補機器として検出された重複機器や不稼働機器を自動または手動で削除したとき、連動して自動的に、その機器のシステム構成情報が削除され、所属していたあて先グループやIDからもその機器が削除されるようにして、［システム構成情報の自動メンテナンス］メニュー、［システム構成情報の手動メンテナンス］メニューおよび［重複ホスト検索］タブを削除した。

接続先設定ファイル（itdmhost.conf）でエージェントの接続先を設定できるようにした。

「システム構成情報の取得」ジョブを実行するときの注意事項を追記した。

［システム構成］ウィンドウから表示できる［名前の変更］ダイアログボックスで、IPアドレスを変更する手順を削除した。また、運用キーの設定によって、［属性の変更］ダイアログボックスで変更できる項目が異なることを追記した。

システム構成情報のホスト名を変更する場合の注意事項を変更した。

ジョブを管理するフォルダの作成手順を修正した。

付録H.9　11-00の変更内容

JP1/IT Desktop Management 2 - Managerが複数サーバ構成の場合の説明をマニュアルに追記した。それに伴い、ジョブ種別およびGUIの用語を見直した。

Windows 10を次の製品の適用OSに追加した。

JP1/IT Desktop Management 2 - Agent

JP1/IT Desktop Management 2 - RC Manager

Remote Install Manager

Windows Server 2003およびWindows Server 2008（Windows Server 2008 R2を除く）を次の製品の適用OS外とした。

JP1/IT Desktop Management 2 - Manager

JP1/IT Desktop Management 2 - Agent

JP1/IT Desktop Management 2 - Network Monitor

JP1/IT Desktop Management 2 - RC Manager

マニュアル「JP1/IT Desktop Management 2 Automatic Installation Tool運用ガイド」をこのマニュアルに統合した。

OSがUNIXのコンピュータにエージェントを導入して管理できるようにした。

付録I　このマニュアルの参考情報

付録I.1　関連マニュアル

このマニュアルの関連マニュアルを次に示します。必要に応じてお読みください。

JP1 Version 12 JP1 資産・配布管理 基本ガイド（3021-3-E11）

JP1 Version 12 JP1/IT Desktop Management 2 導入・設計ガイド（3021-3-E12）

JP1 Version 12 JP1/IT Desktop Management 2 構築ガイド（3021-3-E13）

JP1 Version 12 JP1/IT Desktop Management 2 運用ガイド（3021-3-E14）

JP1 Version 12 JP1/IT Desktop Management 2 - Asset Console 構築・運用ガイド（3021-3-E16）

JP1 Version 12 JP1/IT Desktop Management 2 - Asset Console アクセス定義ファイル作成ガイド（3021-3-E17）

JP1 Version 12 JP1/IT Desktop Management 2 メッセージ（3021-3-E18）

JP1 Version 12 JP1/IT Desktop Management 2 - Agent(UNIX(R)用)（3021-3-E22）

JP1 Version 12 JP1/Automatic Job Management System 3 導入ガイド（3021-3-D21）

JP1 Version 12 JP1/Automatic Job Management System 3 設計ガイド（システム構築編）（3021-3-D22）

JP1 Version 12 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3021-3-D23）

JP1 Version 12 JP1/Automatic Job Management System 3 運用ガイド（3021-3-D25）

JP1 Version 12 JP1/Automatic Job Management System 3 トラブルシューティング（3021-3-D26）

JP1 Version 12 JP1/Automatic Job Management System 3 操作ガイド（3021-3-D27）

JP1 Version 12 JP1/Automatic Job Management System 3 コマンドリファレンス（3021-3-D28）

JP1 Version 12 JP1/Automatic Job Management System 3 連携ガイド（3021-3-D29）

JP1 Version 12 JP1/Automatic Job Management System 3 メッセージ（3021-3-D30）

JP1 Version 12 JP1/Integrated Management 2 - Manager 構築ガイド（3021-3-D52）

JP1 Version 12 JP1/Integrated Management 2 - Manager 運用ガイド（3021-3-D53）

JP1 Version 12 JP1/Base 運用ガイド（3021-3-D65）

JP1 Version 12 JP1/Base メッセージ（3021-3-D66）

JP1 Version 12 JP1/Base 関数リファレンス（3021-3-D67）

JP1 Version 11 JP1/Integrated Management - Manager 構築ガイド（3021-3-A08）

JP1 Version 11 JP1/Integrated Management - Manager 運用ガイド（3021-3-A09）

付録I.2　このマニュアルでの表記

このマニュアルでは、製品名称を次のように表記しています。

表記

製品名称および名称

ActiveX

ActiveX(R)

AMT

Intel Active Management Technology

Citrix XenApp

Citrix XenApp(R)

Citrix Virtual Apps

InstallShield

InstallShield(R)

Itanium 2

Intel(R) Itanium(R) 2プロセッサ

JP1/AJS

JP1/Automatic Job Management System 2

JP1/Automatic Job Management System 3

JP1/IM

JP1/IM - Manager

JP1/Integrated Management - Manager

JP1/Integrated Management 2 - Manager

JP1/IM - View

JP1/Integrated Management - View

JP1/Integrated Management 2 - View

Linux

CentOS

CentOS 6

CentOS 7

CentOS 8.1

Oracle Linux

Oracle Linux 6.1 (x86)

Oracle Linux 6.1 (x64)

Oracle Linux 7.1

Oracle Linux 8

Red Hat Enterprise Linux Server

Red Hat Enterprise Linux 5 (x86)

Red Hat Enterprise Linux 5 (AMD/Intel 64)

Red Hat Enterprise Linux 5 Advanced Platform (x86)

Red Hat Enterprise Linux 5 Advanced Platform (AMD/Intel 64)

Red Hat Enterprise Linux Server 6 (32-bit x86)

Red Hat Enterprise Linux Server 6 (64-bit x86_64)

Red Hat Enterprise Linux Server 7 (64-bit x86_64)

Red Hat Enterprise Linux(R) Server 8

Mac

Mac OS

OS X 10.10

OS X 10.11

macOS 10.12

macOS 10.13

macOS 10.14

UNIX

AIX

AIX V6.1

AIX V7.1

AIX V7.2

Solaris

Solaris 10(SPARC)

Solaris 11(SPARC)

HP-UX

HP-UX 11i V3サーバ (IPF)

Pentium

Intel Pentium(R)

このマニュアルでは、マイクロソフト製品の名称を次のように表記しています。

表記

製品名

Internet Explorer

Microsoft(R) Internet Explorer

Windows(R) Internet Explorer(R)

MS-DOS

Microsoft(R) MS-DOS(R)

Windows

Windows 7

Windows 7 Enterprise

Microsoft(R) Windows(R) 7 Enterprise

Windows 7 Home Basic

Microsoft(R) Windows(R) 7 Home Basic

Windows 7 Home Premium

Microsoft(R) Windows(R) 7 Home Premium

Windows 7 Professional

Microsoft(R) Windows(R) 7 Professional

Windows 7 Starter

Microsoft(R) Windows(R) 7 Starter

Windows 7 Ultimate

Microsoft(R) Windows(R) 7 Ultimate

Windows 8

Windows 8

Windows(R) 8

Windows 8 Enterprise

Windows(R) 8 Enterprise

Windows 8 Pro

Windows(R) 8 Pro

Windows 8.1

Windows 8.1

Windows(R) 8.1

Windows 8.1 Enterprise

Windows(R) 8.1 Enterprise

Windows 8.1 Pro

Windows(R) 8.1 Pro

Windows 10

Windows 10 Enterprise

Windows(R) 10 Enterprise

Windows 10 Pro

Windows(R) 10 Pro

Windows Server 2003※1

Windows Server 2003※1

Windows Server 2003 Enterprise

Microsoft(R) Windows Server(R) 2003 R2, Enterprise Edition

Microsoft(R) Windows Server(R) 2003, Enterprise Edition

Windows Server 2003 Standard

Microsoft(R) Windows Server(R) 2003 R2, Standard Edition

Microsoft(R) Windows Server(R) 2003, Standard Edition

Windows Server 2003 (x64)

Windows Server 2003 Enterprise (x64)

Microsoft(R) Windows Server(R) 2003 R2, Enterprise x64 Edition

Microsoft(R) Windows Server(R) 2003, Enterprise x64 Edition

Windows Server 2003 Standard (x64)

Microsoft(R) Windows Server(R) 2003 R2, Standard x64 Edition

Microsoft(R) Windows Server(R) 2003, Standard x64 Edition

Windows Server 2008※2

Windows Server 2008※2

Windows Server 2008 Datacenter

Microsoft(R) Windows Server(R) 2008 Datacenter

Microsoft(R) Windows Server(R) 2008 Datacenter without Hyper-V(R)

Windows Server 2008 Enterprise

Microsoft(R) Windows Server(R) 2008 Enterprise

Microsoft(R) Windows Server(R) 2008 Enterprise without Hyper-V(R)

Windows Server 2008 Standard

Microsoft(R) Windows Server(R) 2008 Standard

Microsoft(R) Windows Server(R) 2008 Standard without Hyper-V(R)

Windows Server 2008 R2

Microsoft(R) Windows Server(R) 2008 R2 Datacenter

Microsoft(R) Windows Server(R) 2008 R2 Enterprise

Microsoft(R) Windows Server(R) 2008 R2 Standard

Windows Server 2012※3

Windows Server 2012※3

Windows Server 2012 Datacenter

Microsoft(R) Windows Server(R) 2012 Datacenter

Windows Server 2012 Standard

Microsoft(R) Windows Server(R) 2012 Standard

Windows Server 2012 R2

Microsoft(R) Windows Server(R) 2012 R2 Datacenter

Microsoft(R) Windows Server(R) 2012 R2 Standard

Windows Server 2016

Windows Server 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Datacenter

Windows Server 2016 Standard

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2019

Windows Server 2019 Datacenter

Microsoft(R) Windows Server(R) 2019 Datacenter

Windows Server 2019 Standard

Microsoft(R) Windows Server(R) 2019 Standard

Windows Vista

Microsoft(R) Windows Vista(R) Business

Microsoft(R) Windows Vista(R) Enterprise

Microsoft(R) Windows Vista(R) Home Basic

Microsoft(R) Windows Vista(R) Home Premium

Microsoft(R) Windows Vista(R) Ultimate

Windows XP

Windows XP Home Edition

Microsoft(R) Windows(R) XP Home Edition Operating System

Windows XP Professional

Microsoft(R) Windows(R) XP Professional Operating System

注※1

Windows Server 2003 (x64)を併記している場合は、Windows Server 2003にWindows Server 2003 (x64)は含みません。

注※2

Windows Server 2008 R2を併記している場合は、Windows Server 2008にWindows Server 2008 R2は含みません。

注※3

Windows Server 2012 R2を併記している場合は、Windows Server 2012にWindows Server 2012 R2は含みません。

付録I.3　このマニュアルで使用する英略語

英略語

正式名称

API

Application Programming Interface

BIOS

Basic Input Output System

CD-R

Compact Disc Recordable

CD-ROM

Compact Disc Read Only Memory

CPU

Central Processing Unit

CSV

Comma Separated Value

DB

Database

DHCP

Dynamic Host Configuration Protocol

DLL

Dynamic Linking Library

DNS

Domain Name System

DoS

Denial of Service

DVD

Digital Versatile Disk

DVD-R

Digital Versatile Disk Recordable

FTP

File Transfer Protocol

GUI

Graphical User Interface

HTTP

Hypertext Transfer Protocol

ID

Identifier

IP

Internet Protocol

ISO

International Organization for Standardization

JIS

Japanese Industrial Standards

LAN

Local Area Network

MAC

Media Access Control

MS-DOS

Microsoft Disk Operating System

NIC

Network Interface Card

OS

Operating System

OU

Organizational Unit

PC

Personal Computer

PME

Power Management Event

RWU

Remote-Wake-UP

SD

Secure Digital

SNMP

Simple Network Management Protocol

SSL

Secure Sockets Layer

TCP

Transmission Control Protocol

TCP/IP

Transmission Control Protocol/Internet Protocol

USB

Universal Serial Bus

VPN

Virtual Private Network

WINS

Windows Internet Name Service

WS

Workstation

WWW

World Wide Web

XML

Extensible Markup Language

付録I.4　このマニュアルで使用している書式について

このマニュアルに記載しているWindowsのメニュー名の表記は、次のOSを前提としています。

管理用サーバ、データベースサーバ、ネットワークモニタを有効化するコンピュータ、およびコントローラをインストールするコンピュータの場合

Windows Server 2008 R2

エージェントを導入するコンピュータの場合

Windows 7

Windows Server 2019、Windows Server 2016、Windows 8.1、Windows 8、またはWindows Server 2012の場合は［スタート］メニューが表示されないため、画面左下から表示できる［スタート］画面からメニューを選択してください。

説明文で使用する書式

このマニュアルで使用している記号を次のように定義します。

記号

意味

［　］

ウィンドウ、ダイアログボックス、タブ、パネル、メニュー、ボタン、アイコン、グループ、フォルダ、およびキーの名称を示します。

「　」

画面上の項目名、記号、およびジョブの名称を示します。

［　］−［　］

メニューを連続して選択することを示します。

（例）［ファイル］−［新規作成］を選択します。

上記の例では、［ファイル］メニュー内の［新規作成］を選択することを示します。

［　］＋［　］

キーボードのキーを同時に押すことを示します。

（例）［Ctrl］＋［Alt］＋［Delete］は、［Ctrl］キー、［Alt］キー、および［Delete］キーを同時に押すことを示します。

斜体文字

可変の値を示します。

（例）日付はYYYYMMDDの形式で指定します。

・

この記号で区切られている項目は、複数項目のすべてを示します。

（例）A・Bは、「AおよびB」を示します。

/

この記号で区切られている項目は、複数項目のうちどれかを示します。

（例）A/Bは、「AまたはB」を示します。

文法で使用している記号

文法で使用している記号を次のように定義します。

記号

意味

△

半角スペースを示します。

［　］

(角括弧)

この記号で囲まれている項目は任意に指定できます(省略もできます)。

（例）［A］は「何も指定しない」か「Aを指定する」ことを示します。

{　}

(波括弧)

この記号で囲まれている複数の項目の中から、必ず1組の項目を選択します。項目の区切りは|で示します。

（例）{A|B|C}は「A、BまたはCのどれかを指定する」ことを示します。

　|

(ストローク)

複数の項目に対し、項目間の区切りを示し、「または」の意味を示します。

（例）A|B|C は、「A、BまたはC」を示します。

　…

(点線)

この記号の直前に示された項目を繰り返して複数個、指定できます。項目と項目の間は、1つ以上のスペースで区切ります。

（例）A…　は「AのあとにAを必要個数指定できる」ことを示します。

　_

(下線)

括弧内のすべてを省略したときに、システムが採る標準値を示します。標準値がない場合は、指定した項目だけが有効です。

（例）［A|B］はこの項目を指定しなかった場合に、Aを選択したと見なすことを示します。

付録I.5　オンラインヘルプについて

JP1/IT Desktop Management 2では、次に示すオンラインヘルプを提供しています。

画面説明のヘルプ

表示中の操作画面について説明するヘルプです。操作画面に表示される［ヘルプ］ボタンから起動できます。

付録I.6　KB（キロバイト）などの単位表記について

1KB（キロバイト）、1MB（メガバイト）、1GB（ギガバイト）、1TB（テラバイト）はそれぞれ1,024バイト、1,024²バイト、1,024³バイト、1,024⁴バイトです。

付録J　用語解説

（英字）

AITファイル

専用のインストーラなどを使用して対話形式でソフトウェアをインストールするときの手順を記録したファイルで、Automatic Installation Toolを使用して作成します。

Citrix XenApp、Microsoft RDSサーバ

Citrix XenAppおよびMicrosoft RDS（リモートデスクトップサービス）がインストールされているサーバのことです。Citrix XenApp、Microsoft RDSがインストールされているサーバにエージェントを導入して、JP1/IT Desktop Management 2で管理できます。

ID

複数のコンピュータあてにジョブを実行するために、コンピュータをグルーピングする方法の一つです。IDに所属するコンピュータは、エージェントまたは配布管理システムで登録します。

ID管理元中継

IDジョブおよびIDに属するコンピュータを管理する中継システムまたは管理用中継サーバです。IDジョブが実行されると、ID管理元中継はIDジョブを自システムに保管し、このIDに属するコンピュータに対してジョブを実行します。

IDジョブ

あて先にIDを指定して実行するジョブです。

ITDM互換配布

JP1/IT Desktop Management 2が提供する2つの配布機能のうち、操作画面の配布画面を使用して配布する機能のことです。リモートインストールマネージャを使用した配布に対してこう呼びます。

JP1/AJS

JP1/AJSは、業務を自動的に運用するためのプログラムです。処理を順序付けて定期的に実行したり、特定の事象が発生したときに処理を開始したりできます。

JP1/Base

JP1/IMの基盤機能を提供するプログラムです。

JP1イベントの送受信を制御します。また、JP1/IMシステムのエージェントとしての役割も持ちます。

JP1/Baseは、JP1/IM - Managerの前提プログラムです。

JP1/IM

JP1/IMは、分散システムを集中的に監視するためのプログラムです。分散システム内での業務の実行状況や障害などの情報は、JP1イベントとして、JP1/IMに送られます。JP1/IMは、JP1イベントを登録、管理し、システム管理者の端末に表示します。

JP1イベント

システム内で何らかの事象が発生した際に、その事象に関してJP1/Baseに通知される情報です。

Remote Install Manager

JP1/IT Desktop Management 2のコンポーネントです。リモートインストールマネージャを使用した配布を利用する場合にインストールします。

Wake on LAN

Wake on LANはLANで接続されたネットワーク上のマシンに対して、ネットワーク経由でほかのマシンからリモートで起動するための規格です。

（ア行）

あて先グループ

複数のコンピュータあてにジョブを実行するためにコンピュータをグルーピングする方法の一つです。業務や組織ごとなど配布目的に合わせ、配布管理システムからホストをグルーピングします。

アプリケーションゲートウェイ方式

ファイアウォール実現方式の一つです。パケットの中継を禁止して、アプリケーションゲートウェイでアクセスを制御します。外部から内部にアクセスする場合には、ゲートウェイのログインとパスワードを入力させ、内部に直接アクセスできないようにします。

アンアーカイバ

リモートコレクト時に、アーカイブされたファイルや、圧縮されたファイルを元の形式に復元するためのプログラムです。

イベント

ユーザの操作やプログラムの状態変化などのコンピュータが検知できる事象です。ユーザ操作によって発生するイベントとしては、マウスクリック、メニュー選択、キーボード操作、時間経過などがあります。そのほかのイベントは、未処理例外や、ウィンドウの作成および消滅などのように、アプリケーションの内部またはオペレーティングシステムの内部で発生するものです。

インストールモード

管理対象のコンピュータでのパッケージのインストール方法です。インストーラを使用する「GUIインストールモード」、インストーラを使用しないでファイルのコピーだけでインストールする「バックグラウンドインストールモード」の2種類があります。

エージェント

JP1/IT Desktop Management 2で管理される側のコンピュータにインストールするプログラムです。JP1/IT Desktop Management 2 - Manager に情報を通知したり、JP1/IT Desktop Management 2 - Manager からの指示でコンピュータを制御したりします。プログラム名は「JP1/IT Desktop Management 2 - Agent」です。

エージェント設定

管理用サーバ側で管理する、エージェントのセットアップの設定内容です。操作画面でエージェント設定を作成し、エージェントに割り当てることで、エージェントのセットアップをリモートで変更できます。

オフラインインストール

インストール媒体を使用することで、ネットワークを介さないでソフトウェアをインストールする機能です。

オフラインマシン

JP1/IT Desktop Management 2で管理するシステム構成情報に登録していない、Windowsのコンピュータです。例えば、次のようなコンピュータです。

スタンドアロンで使用していて、JP1/IT Desktop Management 2 - Agent（エージェント）をインストールしているコンピュータ

ネットワーク内でJP1/IT Desktop Management 2 - Agent（エージェント）をインストールしているが、JP1/IT Desktop Management 2のシステム構成情報に登録していないコンピュータ

なお、オフラインマシンにソフトウェアをインストールすることもできます。

（カ行）

監査ログ

JP1製品が共通で出力するログです。「だれが」、「いつ」、「どのような操作を実行したか」を示します。

管理対象のコンピュータ

JP1/IT Desktop Management 2 - Agent（エージェント）がインストールされているマシン、およびシステム構成情報上でJP1/IT Desktop Management 2 - Agent（中継システム）がインストールされているマシンの配下にある中継システムと同一名称のエージェントのことです。配布管理システムから直接、または中継システムおよび管理用中継サーバを介してリモートインストールされるソフトウェアを受信し、自システムにインストールしたり、インストール結果を配布管理システムへ通知したりできます。

管理用サーバ

JP1/IT Desktop Management 2 - Managerがインストールされているコンピュータです。単数サーバ構成の管理用サーバ、複数サーバ構成の統括管理用サーバ、および複数サーバ構成の拠点管理用サーバのことを示します。

管理用中継サーバ

配布管理システムを階層化したシステムで、最上位の配布管理システム（マネージャ）の配下に位置するJP1/IT Desktop Management 2 - Managerのことです。配布管理システムと管理対象のコンピュータの間で、リモートインストールやファイル転送などのジョブを中継できます。

関連付けるラベル

コントロールの一種です。このテキストをユーザが操作したり変更したりすることはできません。一般に、関連づけるラベルは、キャプションが付いていないリストボックスなど、別のコントロールの説明としても使用されます。タブオーダーで、コントロールの直前のテキストが関連づけるラベルになります。

機器情報

JP1/IT Desktop Management 2 が管理対象の機器から収集する情報です。管理対象のコンピュータでのハードウェアの使用状況やインストールされているソフトウェアの種類など、コンピュータの管理に必要な情報です。機器情報は、機器画面の［機器情報］画面で確認できます。

キャビネット

配布管理システムにあるパッケージを保管するための領域です。

キャプション

コントロールの上部またはウィンドウのタイトルとして表示されるテキストです。

クライアント制御

ネットワーク経由で、手元のPCから離れた場所にあるPCを起動したり、シャットダウンしたりする機能です。この機能を使って、JP1/IT Desktop Management 2では、深夜や休日などの電源が入っていない状態のPCに対してソフトウェアをリモートインストールできます。クライアント制御を利用するには、PCがAMTまたはWake on LANに対応していることが必要です。

子ウィンドウ

別のウィンドウ（親ウィンドウ）の子孫に当たるウィンドウです。例えば、一般にアプリケーションは、子ウィンドウを使って、1つの親ウィンドウを複数の作業エリアに分割します。ダイアログボックスの内部では、チェックボックスやテキストボックスなどの各種コントロールが、ダイアログボックスの子ウィンドウに相当します。

更新プログラム

日本マイクロソフト社が公開する、WindowsやInternet Explorerを更新するためのプログラムです。

コレクトファイル

管理対象のコンピュータからリモートコレクトで収集したファイルです。

コントローラ

管理対象のコンピュータをリモートコントロールするためのプログラムです。

コントロール

テキストボックスやコマンドボタンなど、ウィンドウ上に配置されているグラフィカルオブジェクトのことです。コントロールは、コントロールを表示しているウィンドウの子ウィンドウに相当します。

（サ行）

資源登録システム

リモートインストールするソフトウェアを配布管理システムに登録するプログラムです。Windows版のJP1/IT Desktop Management 2のパッケージャに相当します。UNIX版のJP1/IT Desktop Management 2 - Agentの用語です。

資源のグループ名

キャビネットを識別するためのユニークなIDです。Windows版のJP1/IT Desktop Management 2のキャビネット識別IDに相当します。UNIX版のJP1/IT Desktop Management 2 - Agentの用語です。

資源名

パッケージング時にソフトウェアに付ける名称です。Windows版のJP1/IT Desktop Management 2のパッケージ識別IDに相当します。UNIX版のJP1/IT Desktop Management 2 - Agentの用語です。

資産管理項目

利用者名、メールアドレス、部署、設置場所などのJP1/IT Desktop Management 2で管理できる資産項目です。リモートインストールマネージャを使用した配布では、部署、設置場所、およびハードウェア資産情報の追加管理項目をあて先グループまたはIDグループの自動メンテナンスポリシーで指定できます。

システム情報

JP1/IT Desktop Management 2のシステムを構成するホストのハードウェアの情報です。

実行タイミング

パッケージを管理対象のコンピュータにインストールするタイミングです。管理対象のコンピュータの起動時にインストールする「次回起動時に実行」、またはパッケージが管理対象のコンピュータに転送された時点でインストールする「すぐに実行」を選択できます。

自動メンテナンスポリシーファイル

あて先グループおよびIDの自動メンテナンスのポリシーが記述されたXML形式のファイルです。

上位システムアドレス格納ファイル

ホスト名とIPアドレスの対応が記述された設定ファイルです。ホスト名運用のコンピュータが上位システムを名前解決できないときに、上位システムのIPアドレスを認識するために使用されます。

ジョブ

JP1/IT Desktop Management 2の機能の実行単位です。

（タ行）

タブオーダー

タブキーを押して、フォーカスをあるコントロールから次のコントロールへと移動させていく際の順序のことです。

中継システム

配布管理システムと管理対象のコンピュータの間で、リモートインストールやファイル転送などのジョブを中継するJP1/IT Desktop Management 2 - Agentのことです。

ドメイン

ネットワーク内のホストおよびユーザを管理する単位です。

（ナ行）

日時ピッカー

コントロールの一種で、日付または時刻を選択できます。

（ハ行）

配布管理システム

JP1/IT Desktop Management 2 - Managerのことです。

パケットフィルタリング方式

ファイアウォールを通過するパケットを制限する、ファイアウォール実現方式の一つです。内部から外部へのアクセスは許可して、外部から内部へのアクセスは禁止するといった運用ができます。また、インターネットにアクセスする端末を限定できます。

パッケージ（リモートインストールマネージャを使用した配布用）

リモートインストールマネージャを使用して配布するソフトウェアの単位です。パッケージャでパッケージを作成すると、配布管理システムのキャビネットに保管されます。保管されたパッケージは、リモートインストールマネージャまたはコマンドで配布できます。

パッケージ種別

パッケージの種類を示します。「ユーザプログラム、データ」、「日立プログラムプロダクト」、および「他社ソフトウェア」の3種類があります。

パッケージセットアップマネージャ

配布管理システム、または中継システムから受け取ったソフトウェアを、利用者側で任意に選択してインストールするための機能です。選択したソフトウェアのインストール先のディレクトリを変更したり、リモートインストールマネージャから配布されたソフトウェアの一覧を確認したりもできます。

パッケージャ

リモートインストールするソフトウェアを配布管理システムに登録するプログラムです。

パッケージング

パッケージャを使用して、パッケージを作成することです。

ハンドル

ユニークな4バイトの整数値です。これを使用してウィンドウやコントロールを識別してアクセスできます。この値は、オペレーティングシステムによって割り当てられています。

ファイアウォール

インターネットと内部システムの境界に設置して、外部からの不正なアクセスが内部システムへ侵入することを防ぐものです。

フォーカス

ユーザーインターフェースオブジェクト（ウィンドウ、ビュー、ダイアログボックス、ボタンなど）の一時的な属性で、フォーカスされたオブジェクトは、ユーザ入力を受け取ることができます。例えば、テキストボックスが「フォーカスされた」とき、ユーザが文字列を入力すると、その文字列がテキストボックスに表示されます。通常フォーカスは、強調表示で示されます。

複数LAN接続

複数のLANで構成されたシステムに対応するJP1の機能です。この機能を使うと、複数のLANに接続されたホスト上で、JP1の通信に使うLANを設定できます。システムやほかのアプリケーションとは別にJP1独自に通信設定できるので、多様なネットワーク構成や運用方法に柔軟に対応できます。なお、複数のLANに接続したホストを、マルチホームホストや複数NICのホストと呼ぶこともあります。

JP1/IT Desktop Management 2では、次の複数LAN接続の環境での運用をサポートしています。

複数のネットワークに分かれている環境

ネットワークが多重化されている環境

分割配布

ネットワークに負荷を掛けないためにユーザが指定したサイズで分割して転送し、かつ転送と転送の間にインターバル（転送休止時間）を置きながら配布する方法です。サイズは、エージェント設定時とジョブの作成時、さらにパッケージの転送途中の中継地点でも指定できます。大容量のパッケージを配布する場合に有効です。

ホスト

JP1/IT Desktop Management 2での操作の対象となる、ネットワークを構成するWindows、UNIX、またはMacのコンピュータです。

ホスト識別子

システム内でホストを一意に識別できるキーです。ネットワーク構成に左右されないため、システム管理者がホストを管理する負担を軽減できます。

ポリシー

システム構成情報の自動反映機能によって新規にシステム構成に追加されたホストを、自動的にあて先グループまたはIDに振り分けるために、あらかじめ設定しておく条件です。

（マ行）

マネージャ

JP1/IT Desktop Management 2 - Managerのことです。

マルチキャストアドレス

各マルチキャストグループに固有のIPアドレスです。マルチキャスト配布の送信側と受信側のセットアップで設定します。

マルチキャストグループ

マルチキャスト配布をするとき、ジョブの配布先となる概念上のグループです。マルチキャストアドレスというグループ固有のIPアドレスを持っています。上位システムがマルチキャストグループにジョブのパケットを送信すると、そのグループに所属している各コンピュータに、パケットが配信されます。

マルチキャスト配布

ジョブの配布方式の一つです。IPマルチキャストプロトコルを利用して、上位システムから特定多数のコンピュータへパケットを送信します。コンピュータの数に関係なく、上位システムはマルチキャストグループ1か所だけにジョブのパケットを送信すればよいため、通信量を削減できます。

（ヤ行）

ユニキャスト配布

ジョブの配布方式の一つです。上位システムからコンピュータへ1対1でパケットを送信します。上位システムは、送信先のコンピュータごとにジョブのパケットを送信する必要があるため、パケットの送信数は、コンピュータ数の増加に対応して増大します。

（ラ行）

リモートインストール

管理用サーバから利用者のコンピュータへ、ネットワークを経由してソフトウェアおよびファイルを一括で配布する機能です。

リモートインストールマネージャ

Remote Install Managerのことです。

リモートインストールマネージャを使用した配布

JP1/IT Desktop Management 2が提供する2つの配布機能のうち、JP1/IT Desktop Management 2のコンポーネントであるRemote Install Managerを使用して配布する機能のことです。コマンドを使用して配布することもできます。ITDM互換配布に対してこう呼びます。

リモートコレクト

管理対象のコンピュータに格納されているファイルを、リモートインストールマネージャを使用して一括で収集する機能です。

リモートコントロール機能

遠隔地にあるコンピュータに接続し、呼び出したコンピュータの画面に対してキーボード操作やマウス操作ができる機能です。

リモートデスクトップ

このマニュアルでは、Windows Server 2019、Windows Server 2016、Windows 10、Windows 8.1、Windows 8、Windows Server 2012、Windows Server 2008、Windows Server 2003、Windows 7、Windows Vista、またはWindows XPの「管理用リモート デスクトップ」または「リモート デスクトップ」の機能を「リモートデスクトップ」と呼んでいます。

リモコンエージェント

エージェントのプログラムの一部です。 リモコンエージェントとコントローラが標準接続することで、すべてのリモートコントロール機能が使用できるようになります。

索引

記号

［CSVファイル出力］ダイアログボックス[1]

［ITDM2_Startup］フォルダ[1]

［管理情報リスト］ウィンドウ[1]

［検索対象］パネル[1]

［システム構成］ウィンドウで印刷できる情報[1]

［取得項目］パネル[1]

［リモートコントロールの開始］ダイアログボックス[1]

数字

2ギガバイトを超えるファイルを配布する[1]

A

action[1]

AIT_ASCIIToChar[1]

AIT_ChangeFileAttribute[1]

AIT_CharToASCII[1]

AIT_CheckResolution[1]

AIT_ComboBoxCloseUp[1]

AIT_ComboBoxDropDown[1]

AIT_CtrlClick[1]

AIT_CtrlItemCount[1]

AIT_CtrlItemIndex[1]

AIT_CtrlSetFocus[1]、[2]

AIT_CtrlSetFocusの使用例[1]、[2]

AIT_DefaultButtonCount[1]

AIT_DirCopy[1]

AIT_DirCreate[1]

AIT_DirRemove[1]

AIT_DMPSTRC[1]

AIT_Exec[1]

AIT_ExecCommand[1]

AIT_ExistWindow[1]

AIT_Exit[1]

AIT_FileClose[1]

AIT_FileCopy[1]

AIT_FileDelete[1]

AIT_FileEOF[1]

AIT_FileExists[1]

AIT_FileGetLine[1]

AIT_FileGetPos[1]

AIT_FileOpen[1]

AIT_FilePutLine[1]

AIT_FileRename[1]

AIT_FileSetPos[1]

AIT_FileSize[1]

AIT_FindCloseFile[1]

AIT_FindFirstFile[1]

AIT_FindNextFile[1]

AIT_FindSubStr[1]

AIT_FocusWindow[1]、[2]

AIT_FocusWindowの使用例[1]、[2]

AIT_GetCtrlText[1]

AIT_GetCtrlTextLen[1]

AIT_GetCurrentDirectory[1]

AIT_GetDate[1]

AIT_GetDtPickerDate[1]

AIT_GetDtPickerTime[1]

AIT_GetEditCurrentLineIndex[1]

AIT_GetEditFirstLineIndex[1]

AIT_GetEditTextLineLen[1]

AIT_GetEnv[1]

AIT_GetErrorText[1]

AIT_GetIndexText[1]

AIT_GetIndexTextLen[1]

AIT_GetKeyState[1]

AIT_GetLastError[1]

AIT_GetMenu[1]

AIT_GetMenuIndex[1]

AIT_GetMenuText[1]

AIT_GetOSType[1]

AIT_GetProfileFirstSection[1]

AIT_GetProfileFirstSectionNames[1]

AIT_GetProfileNextSection[1]

AIT_GetProfileNextSectionNames[1]

AIT_GetProfileString[1]

AIT_GetSubMenu[1]

AIT_GetSubStr[1]

AIT_GetTime[1]

AIT_GetWindowText[1]

AIT_IMEGetConversionStatus[1]

AIT_IMEGetOpenStatus[1]

AIT_IMEGetProperty[1]

AIT_IMEGetStatusWindowPos[1]

AIT_IMESetConversionStatus[1]

AIT_IMESetOpenStatus[1]

AIT_IMESetStatusWindowPos[1]

AIT_IMESimulateHotKey[1]

AIT_InitLog[1]

AIT_IsEmpty[1]

AIT_LogMessage[1]

AIT_MenuItemClick[1]

AIT_MessageBox[1]

AIT_MinWnd[1]

AIT_MouseClick[1]

AIT_MouseDblClk[1]

AIT_MouseDown[1]

AIT_MouseDragDrop[1]

AIT_MouseMoveTo[1]

AIT_MouseUp[1]

AIT_PlayKey[1]、[2]

AIT_PlayKeyの使用例[1]、[2]

AIT_PostMessage[1]

AIT_RegCloseKey[1]

AIT_RegCreateKey[1]

AIT_RegDeleteKey[1]

AIT_RegDeleteValue[1]

AIT_RegGetDWORDValue[1]

AIT_RegGetStringValue[1]

AIT_RegisterWindowMessage[1]

AIT_RegKeyExists[1]

AIT_RegOpenKey[1]

AIT_RegSetDWORDValue[1]

AIT_RegSetStringValue[1]

AIT_RegValueExists[1]

AIT_SelectIPAddressField[1]

AIT_SelectListItem[1]

AIT_SelectMultipleListItem[1]

AIT_SelectText[1]

AIT_SetActWnd[1]

AIT_SetCheck[1]

AIT_SetComboEditSelText[1]

AIT_SetCurrentDirectory[1]

AIT_SetDefaultWaitTimeout[1]

AIT_SetDtPickerDate[1]

AIT_SetDtPickerTime[1]

AIT_SetKeyState[1]

AIT_SetProfileString[1]

AIT_SetScrollPos[1]

AIT_SetSpinPos[1]

AIT_SetWndPos[1]

AIT_SetWndPosSize[1]

AIT_Sleep[1]

AIT_StatusBox[1]

AIT_StatusBoxClose[1]

AIT_StrLeft[1]

AIT_StrLength[1]

AIT_StrLower[1]

AIT_StrLTrim[1]

AIT_StrRight[1]

AIT_StrRTrim[1]

AIT_StrTrim[1]

AIT_StrUpper[1]

AIT_TaskbarClk[1]

AIT_TaskbarHasFocus[1]

AIT_TaskbarSetFocus[1]

AIT_VerifyCharPos[1]

AIT_VerifyCount[1]

AIT_VerifyDateTime[1]

AIT_VerifyDefaultButton[1]

AIT_VerifyEnabled[1]、[2]

AIT_VerifyEnabledの使用例[1]、[2]

AIT_VerifyExistence[1]、[2]

AIT_VerifyExistenceの使用例[1]、[2]

AIT_VerifyFirstVisible[1]

AIT_VerifyFocus[1]

AIT_VerifyIndex[1]

AIT_VerifyKeyState[1]

AIT_VerifyLine[1]

AIT_VerifyLocation[1]

AIT_VerifyMenuChecked[1]

AIT_VerifyMenuEnabled[1]

AIT_VerifyNoOfCtrls[1]

AIT_VerifyPos[1]、[2]

AIT_VerifyPosの使用例[1]、[2]

AIT_VerifySelected[1]

AIT_VerifyState[1]

AIT_VerifyText[1]

AIT_Wow64DisableWow64Redirection[1]

AIT_Wow64RevertWow64Redirection[1]

ait.log[1]

aitapi.log[1]

aitexec.log[1]

AITのトラブルシューティング[1]

AITファイル[1]

AITファイルとは[1]

AITファイルの監視時間[1]

AITファイルの完成例[1]

AITファイルの形式[1]

AITファイルの構造[1]

AITファイルの構造と作成手順[1]

AITファイルの作成[1]

AITファイルの設定[1]

［AITファイルの設定］パネル[1]

AITファイル〔用語解説〕[1]

AITファイルを作成および使用する場合の注意事項[1]

AITファイルを使用しないパッケージング方法[1]

AITファイルを使ったリモートインストール[1]

AITファイルを使ったリモートインストール手順[1]

API一覧[1]

APIの詳細[1]

APIの使用例[1]

APIの説明形式[1]

APIリファレンス[1]

Automatic Installation Toolの機能[1]

B

base_fullpath[1]

bool型[1]

break[1]

C

cabinet_id[1]

cabinet_name[1]

catAndValidatePackagingFile.exe[1]

Citrix XenApp、Microsoft RDSサーバ〔用語解説〕[1]

client_shutdown[1]

client_wake_up[1]

compress[1]

compress_type[1]

condition（システム条件）[1]

condition（ソフトウェア条件）[1]

condition（パッケージ条件）[1]

continue[1]

CSV形式ファイルに出力できる項目[1]

CSV形式ファイルの出力範囲の設定[1]

CSV形式ファイルへの出力[1]

CSV形式ファイルへの出力方法[1]

CSVファイル出力[1]

D

dcmcoll.exe[1]

dcmgpmnt.exe[1]

dcminst.exe[1]

dcmjbrm.exe[1]

dcmjexe.exe[1]

dcmpack.exe[1]

dcmpkget.exe[1]

dcmpkput.exe[1]

dcmpkrm.exe[1]

dcmrmgen.exe[1]

dcmrtry.exe[1]

dcmstat.exe[1]

dcmstsw.exe[1]

dcmsusp.exe[1]

DEFINE[1]

destination_id[1]

DHCP[1]

directory[1]

dmhost.txt[1]

dmpbkdelコマンド[1]

dmpbklstコマンド[1]

dmprcvryコマンド[1]

dmz_path[1]

DNS[1]

do-while[1]

E

ERROR[1]

exit[1]

expiration_date[1]

expiration_days[1]

external_program_error_handler[1]

external_program_executed_after_installation[1]

external_program_executed_before_installation[1]

external_program_handler[1]

F

FILE_COLLECTION[1]

file_path[1]

FILE_PROPERTIES[1]

float型[1]

for-next[1]

G

generation[1]

goto[1]

group[1]

GUIインストールモード[1]、[2]

H

host_name[1]

hostsファイル[1]

I

IDからの登録解除待ち[1]

ID管理元中継[1]、[2]

ID管理元中継およびパスワードの変更[1]

ID管理元中継からIDを削除する[1]

ID管理元中継からの自動通知が遅延した場合の対処[1]

ID管理元中継ごとのジョブ実行状況を表示する[1]

［ID管理元中継］タブ[1]

ID管理元中継として定義されている中継システムが削除された場合の例[1]

ID管理元中継として定義されている中継システムの接続先を変更した場合の例[1]

ID管理元中継と接続していないときのID登録[1]

ID管理元中継と接続しているときのID登録[1]

ID管理元中継へIDを登録する[1]

［ID管理元中継へのIDの登録・削除］ダイアログボックス[1]

ID管理元中継〔用語解説〕[1]

［IDグループの編集］フォルダ[1]

ID〔作成できるグループの種類〕[1]

ID情報を修正する[1]

IDジョブ[1]

ID〔ジョブの実行〕[1]

IDジョブの実行状況の表示方法[1]

IDジョブの実行状況を確認するときの注意事項[1]

IDジョブ〔用語解説〕[1]

IDに登録されたコンピュータの接続先を変更した場合の例[1]

IDに登録されたコンピュータを削除した場合の例[1]

IDに登録したコンピュータの削除[1]

IDの運用手順[1]

IDの運用方法[1]

IDの削除[1]

IDの作成[1]

［IDの作成］ダイアログボックス[1]

IDの自動メンテナンス[1]、[2]

IDの自動メンテナンス運用時の注意事項[1]

［IDの属性変更］ダイアログボックス[1]

IDのポリシーを設定する[1]

IDファイルを作成する[1]

IDへ登録するときの注意事項[1]

IDへの登録[1]

IDへの登録（メニュー）[1]

IDへの登録待ち[1]

IDへの登録を解除する[1]

ID〔用語解説〕[1]

IDを作成する[1]

IDを使用する場合の注意事項[1]

IDをファイルに出力する[1]

if-else-endif[1]

IME操作[1]

IME操作に関するマクロ[1]

INIファイル操作[1]

installation_date_and_time[1]

INSTALLATION_METHOD[1]

installation_mode[1]

installation_timing[1]

INSTALLSOFTWARE_CONDITIONS[1]

integer型[1]

IPアドレスでJP1/IT Desktop Management 2のノードを管理する[1]

ITDM2LINSTコマンド[1]

ITDM互換配布〔用語解説〕[1]

J

JOB_ATTRIBUTE[1]

JOB_CLIENT_CONTROL[1]

JOB_DESTINATION[1]

JOB_DESTINATION_ID[1]

job_entry_date[1]

job_execution_date[1]

job_expiration_date[1]

job_folder[1]

job_generator[1]

JOB_SCHEDULE[1]

JOB_SPLIT_DELIVERY[1]

jobno[1]

［JP1_IT Desktop Management 2 - Agent］[1]

JP1/AJS〔用語解説〕[1]

JP1/AJSと連携した自動運用の概要[1]

JP1/AJSと連携したジョブの自動実行[1]

JP1/Base〔用語解説〕[1]

JP1/IM〔用語解説〕[1]

［JP1/IT Desktop Management 2 ジョブの保留］ダイアログボックス[1]、[2]

JP1/IT Desktop Management 2とのインターフェース[1]

JP1/IT Desktop Management 2 - Agent（エージェント）を使用する場合[1]

JP1/IT Desktop Management 2 - Agent全体のログ[1]

JP1/IT Desktop Management 2 - Agentのトラブルシューティング[1]

JP1/IT Desktop Management 2 - Agent を使用するときの注意事項[1]

JP1/IT Desktop Management 2 - Managerのトラブルシューティング[1]

［JP1/ITDM2 アンアーカイバ］ウィンドウ[1]

JP1イベントの拡張属性（JP1/IM連携）[1]

JP1イベントの基本属性（JP1/IM連携）[1]

JP1イベントの種類（JP1/IM連携）[1]

JP1イベントの属性（JP1/IM連携）[1]

JP1イベント〔用語解説〕[1]

M

Macエージェントのシステム情報とソフトウェア情報の取得[1]

Macエージェントのシステム情報の管理[1]

Macエージェントのシステム情報の取得[1]

Macエージェントのソフトウェア情報の管理[1]

Macエージェントのソフトウェア情報の取得[1]

MAIN[1]

MAIN.LOGファイルを確認する[1]、[2]

O

OPTION[1]

P

package_code[1]

package_id[1]

PACKAGE_INFO[1]

PACKAGE_INFOセクションの生成手順[1]

PACKAGE_INFOセクションを生成する[1]

package_name[1]

［Package Setup Manager］ウィンドウ[1]

PACKAGING_INFORMATION[1]

PACKAGING_SOURCE[1]

permission[1]

PPDEFAIT.DMP[1]

PP識別情報ファイル[1]

PP識別情報ファイルの形式[1]

PP識別情報ファイルの作成[1]

PP識別情報ファイルの生成手順[1]

PP識別情報ファイルの編集方法[1]

PP識別情報ファイルの例[1]

processing_dialog[1]

R

reboot[1]

Remote Install Manager〔用語解説〕[1]

restore[1]

rimfindn.log[1]

S

SCHEDULE[1]

SOFTWARE_CONDITIONS[1]

source_path[1]

split_size[1]

string型[1]

switch-endswitch[1]

SYSTEM_CONDITIONS[1]

T

TCP/IP環境の設定[1]

TCP/IPの確認[1]

timeout[1]

U

unarc_path[1]

UNIXエージェントで外部プログラムを起動する場合の注意事項[1]

UNIXエージェントのシステム情報とソフトウェア情報の取得[1]

UNIXエージェントのシステム情報の管理[1]

UNIXエージェントのシステム情報の取得[1]

UNIXエージェントのソフトウェア情報の管理[1]

UNIXエージェントのソフトウェア情報の取得[1]

UNIX共用〔データ圧縮〕[1]

unsuspended[1]

USER_PROGRAM_INSTALLATION_CONDITIONS[1]

V

version_revision[1]

W

wait[1]

wait_code[1]

wait_time[1]

Wake on LAN〔用語解説〕[1]

Wake on LANを利用する場合の設定〔クライアント制御〕[1]

while-loop[1]

Windows専用〔データ圧縮〕[1]

Windowsのイベントログを確認する[1]

WINS[1]

あ

アウトプットウィンドウ[1]、[2]

新しいウィンドウを開く[1]

圧縮指定[1]

［あて先］ウィンドウ[1]

［あて先］ウィンドウで印刷できる情報[1]

あて先グループ〔作成できるグループの種類〕[1]

あて先グループ〔ジョブの実行〕[1]

あて先グループにポリシーを一括反映する[1]

あて先グループの階層化の仕組み[1]

あて先グループの作成方法の種類[1]

あて先グループの作成例[1]

あて先グループの自動メンテナンス[1]

あて先グループの編集[1]

あて先グループのポリシーを設定する[1]

あて先グループファイル[1]、[2]

あて先グループファイルを作成する[1]

あて先グループ名の変更[1]

あて先グループ〔用語解説〕[1]

あて先グループを［あて先］ウィンドウで作成する[1]

あて先グループを作成する[1]

あて先グループをファイルから作成する[1]

あて先グループをファイルから追加する[1]

あて先グループをファイルに出力する[1]

あて先グループを変更する[1]

あて先とジョブ種別の関係[1]

あて先のグルーピング方法[1]

あて先の検索[1]

［あて先の作成］ダイアログボックス[1]

あて先の追加方法[1]

［あて先］パネル[1]

あて先を設定するときの注意事項[1]

あて先を編集するときの注意事項[1]

アプリケーションゲートウェイ方式ファイアウォール[1]

アプリケーションゲートウェイ方式〔用語解説〕[1]

アンアーカイバ[1]

アンアーカイバ（メニュー）[1]

アンアーカイバ〔用語解説〕[1]

アンインストール結果受信による削除[1]

い

［一覧］タブ（［システム構成］ウィンドウ）[1]

［一覧］タブ（［パッケージ］ウィンドウ）[1]

一般ユーザ権限でのインストール時の制限事項[1]

イベントフラグ[1]

イベント〔用語解説〕[1]

印刷[1]

印刷できる項目[1]

印刷方法[1]

インストール画面の順序を調査する[1]

インストール画面の属性を調査する[1]

インストール後コンピュータを再起動する[1]

インストール先ディレクトリ[1]

インストールされているソフトウェアをチェックしてインストールする[1]

インストールしたソフトウェアの設定を変更する[1]

インストール条件[1]

［インストール条件の一括設定］ダイアログボックス[1]

インストール条件の変更[1]

インストール操作をレコーディングする[1]

インストール日時[1]

インストール媒体の準備[1]

［インストールパッケージ］ウィンドウ[1]

インストールパッケージ情報の削除[1]、[2]

［インストールパッケージ］タブ[1]

インストールプログラムと識別用ファイルの指定方法[1]

インストールプロセスがハングアップした場合の対処[1]

インストール方法[1]

［インストール方法］パネル[1]

インストールモード[1]

インストールモードとユーザ権限[1]

インストールモード〔用語解説〕[1]

う

ウィンドウ処理について[1]

ウィンドウ処理の例[1]

ウィンドウ操作[1]

ウィンドウ操作に関するマクロ[1]

ウィンドウの検索で使用するAPI[1]

ウィンドウの構成と基本操作（リモートインストールマネージャ）[1]

ウィンドウの操作で使用するAPI[1]

ウィンドウの属性を取得する[1]

ウィンドウフラグ[1]

［ウィンドウプロパティ］ダイアログボックス[1]

ウィンドウプロパティツール[1]

ウィンドウを整列させる[1]

え

エージェント稼働中[1]

エージェント起動時[1]

エージェント設定〔用語解説〕[1]

エージェントでの外部プログラム起動[1]

エージェントの基本ログ[1]

エージェントの接続先の自動変更[1]

エージェントの動作環境について[1]

エージェントのポーリング方法[1]

エージェントのマルチポーリング環境[1]

エージェント〔用語解説〕[1]

エージェントを使用する前に[1]

エージェントを操作する[1]

エラージョブの再実行[1]

エラージョブの詳細情報を確認する方法[1]

エラージョブを効率的に確認する方法[1]

エラー処理の追加[1]

エラー処理の追加とリターンコードの設定例[1]、[2]

エラーロギングに関するマクロ[1]

演算子[1]

演算子の優先順位[1]

お

同じパッケージがあったら上書き[1]

オプション[1]

［オプション］パネル[1]

オフラインインストール[1]

オフラインインストールの実行コマンド[1]

オフラインインストールの手順[1]

オフラインインストールの利用[1]

オフラインインストール〔用語解説〕[1]

オフラインインストールを実行するときの注意事項[1]

オフラインマシンでのインストール結果の確認[1]

オフラインマシンでのインストールの実行[1]

オフラインマシン〔用語解説〕[1]

親ウィンドウにジャンプ[1]

か

カーソル行の前まで実行する[1]

解析時のメッセージ[1]

階層下のすべてのジョブの詳細情報を表示する[1]

階層下のすべてのジョブを表示する[1]

階層ごとの情報を表示する[1]

解像度のチェック[1]

外部プログラム[1]

外部プログラム監視時間[1]

外部プログラム起動[1]

外部プログラム処理結果の取得方法[1]

外部プログラムの時間監視[1]

外部プログラムの実行権限[1]

外部プログラムの終了通知[1]

外部プログラムの終了通知の扱い[1]

［外部プログラム］パネル[1]

［外部プログラム用詳細設定］ダイアログボックス[1]

各拠点のファイルを収集し、加工して再配布する（JP1/AJS連携）[1]

確認操作[1]

確認操作に関するマクロ[1]

型変更[1]

加法演算子[1]

監査ログに出力される事象の種別[1]

監査ログの出力形式[1]

監査ログの保存形式[1]

監査ログ〔用語解説〕[1]

監査ログを出力するための設定[1]

監視ウィンドウ[1]

監視時間経過時の取り扱い[1]

関数呼び出し[1]

管理者による削除[1]

管理情報の出力[1]

管理情報を印刷する[1]

管理情報を出力する[1]

管理対象のコンピュータが起動できない[1]

管理対象のコンピュータがスリープ状態から復帰したあとのジョブの実行の注意事項[1]

管理対象のコンピュータからIDに登録する[1]

管理対象のコンピュータごとの実行状況を表示する[1]

管理対象のコンピュータでの設定[1]

管理対象のコンピュータの起動に時間が掛かる[1]

管理対象のコンピュータの登録を解除する（ID）[1]

管理対象のコンピュータ〔用語解説〕[1]

管理対象のコンピュータをIDへ登録する[1]

管理用サーバでのIDの作成[1]

管理用サーバ〔用語解説〕[1]

管理用中継サーバ上のパッケージの削除[1]

管理用中継サーバ上のパッケージの削除[1]

管理用中継サーバ上のファイルの削除[1]

管理用中継サーバでのIDの管理[1]

管理用中継サーバ配下のシステム構成情報を取得する[1]

管理用中継サーバ配下のシステム構成情報を変更する[1]

管理用中継サーバへのパッケージの転送[1]、[2]

管理用中継サーバ〔用語解説〕[1]

関連付けるラベル〔用語解説〕[1]

き

キーワード[1]

機器情報〔用語解説〕[1]

起動していないコンピュータに対してインストールを実行する[1]

起動時の注意事項〔クライアント制御〕[1]

起動と終了[1]

決められた時刻にインストールする[1]

キャビネット識別ID[1]

キャビネットの確認[1]

キャビネットの管理[1]

キャビネットの削除[1]

キャビネットの作成[1]

キャビネット名[1]

キャビネット名の変更[1]

キャビネット〔用語解説〕[1]

キャプション〔用語解説〕[1]

強制完了[1]

記録する実行結果の設定[1]

く

クライアント制御の利用[1]

［クライアント制御］パネル[1]

クライアント制御〔用語解説〕[1]

クライアント制御を利用するための設定[1]

クライアントに適用する更新プログラムの取得[1]

クライアントユーザによるインストール[1]

クライアントユーザによるインストール〔ジョブ〕[1]

グルーピングしたホストへのジョブ実行[1]

グローバル変数[1]

グローバル変数の利用例[1]

け

経路の変更方法[1]

結果出力ファイル[1]

結合順序[1]

検索[1]

検索したホストを［あて先］ウィンドウにコピーする[1]

検索したホストをシステム構成情報から削除する[1]

こ

子ウィンドウ〔用語解説〕[1]

更新プログラム〔用語解説〕[1]

更新プログラムを管理[1]

コマンド実行時の入出力情報（JP1/AJS連携）[1]

コマンドのエラー情報の確認方法（JP1/AJS連携）[1]

コマンドの種類（JP1/AJS連携）[1]

コマンドの入力形式（JP1/AJS連携）[1]

［コレクトファイル］パネルの設定[1]

コレクトファイル〔用語解説〕[1]

コントローラ〔用語解説〕[1]

コントロールの属性を取得する[1]

コントロール〔用語解説〕[1]

コンパイル[1]

コンピュータ（UNIX）のシステム情報の取得〔ジョブ〕[1]

コンピュータ（UNIX）のソフトウェア情報の取得〔ジョブ〕[1]

コンピュータのグルーピング[1]

コンピュータを削除する方法[1]

コンポーネントの選択[1]

［コンポーネントの選択］パネル[1]

さ

再起動を伴うインストール操作のレコーディング[1]

最初の子ウィンドウにジャンプ[1]

削除したコンピュータの情報を参照する[1]

削除中のジョブを表示する[1]

削除日時[1]

削除要因[1]

［削除履歴のCSV出力］ダイアログボックス[1]

作成できるジョブの種類[1]

し

次回起動時に実行[1]、[2]

資源登録システム〔用語解説〕[1]

資源のグループ名〔用語解説〕[1]

資源名〔用語解説〕[1]

資産管理項目〔用語解説〕[1]

［システム構成］ウィンドウ[1]

システム構成から削除[1]

システム構成情報[1]

システム構成情報とIDの連携時の注意事項[1]

システム構成情報とIDの連携例[1]

システム構成情報とIDを連携させる運用[1]

システム構成情報とIDを連携させるには[1]

システム構成情報の確認[1]

システム構成情報の管理[1]

システム構成情報の検索[1]

［システム構成情報の削除履歴］ダイアログボックス[1]

システム構成情報の削除履歴の管理[1]

システム構成情報の削除履歴を管理する[1]

システム構成情報の取得〔ジョブ〕[1]

「システム構成情報の取得」ジョブの実行方法[1]

システム構成情報のバックアップ[1]

システム構成情報のメンテナンス[1]、[2]

システム構成情報のメンテナンスの例[1]

システム構成情報ファイル[1]

システム構成情報ファイルの内容をシステム構成情報に反映する[1]

システム構成情報ファイルを編集する[1]

システム構成情報編集時の注意事項[1]

システム構成情報を作成する[1]

システム構成情報を［システム構成］ウィンドウで作成する[1]

システム構成情報を自動的に作成するため[1]

システム構成情報を自動的に作成するために必要なTCP/IP環境の設定[1]

システム構成情報を自動的に作成するときの注意事項[1]

システム構成情報をファイルに出力して更新する[1]

システム構成情報をファイルに出力する[1]

システム構成情報を変更する[1]

システム構成情報を変更するときの注意事項[1]

システム構成についての注意事項〔クライアント制御〕[1]

システム構成の自動登録機能[1]

システム構成の自動登録機能の設定[1]

システム構築時の注意事項[1]

システム条件[1]、[2]

システム条件の作成[1]

［システム条件］パネル[1]

システム情報〔用語解説〕[1]

システム設計[1]

実行[1]

実行結果の確認（リモートコレクト）[1]

実行結果を確認したあとの対処[1]

実行されたジョブの流れ[1]

実行時のメッセージ[1]

実行状況[1]

実行状況の監視間隔の設定[1]

実行状況を示す色[1]

実行状態[1]

実行タイミング[1]

実行タイミング〔用語解説〕[1]

実行中のジョブを中断、再開する[1]

指定された情報のみ表示[1]

自動インストール[1]

自動メンテナンスポリシーファイル[1]

自動メンテナンスポリシーファイルの入出力方法[1]

自動メンテナンスポリシーファイルの編集方法[1]

自動メンテナンスポリシーファイル〔用語解説〕[1]

シャットダウン時の注意事項〔クライアント制御〕[1]

収集したファイルの復元[1]

収集対象の削除[1]

収集対象の追加[1]

収集タイミング[1]

収集ファイル[1]

収集ファイルの復元[1]

修正のポイント[1]

終了を正しく判定する[1]

出力できる項目（CSVファイル出力）[1]

出力範囲の設定方法（CSVファイル出力）[1]

手動インストール[1]

手動でソフトウェアをインストールする場合の注意[1]

上位システムアドレス格納ファイルの形式[1]

上位システムアドレス格納ファイル〔用語解説〕[1]

上位システムを名前解決できない環境に新規にコンピュータを導入する場合の設定[1]

上位システムを名前解決できない場合の接続設定〔エージェント〕[1]

上位接続先情報ファイル[1]、[2]

上位接続先情報ファイル（dmhost.txt）の作成[1]

上位接続先情報ファイルの形式[1]

上位接続先情報ファイルの作成例[1]

上位接続先情報ファイルを作成する[1]

上位接続先情報ファイルを配布したあとの注意事項[1]

上位マネージャの指示による削除[1]

障害が発生した中継システムを回避してジョブを実行する[1]

障害が発生した中継システムを回避してリモートインストールする[1]

条件を指定して情報の表示順序を変える[1]

乗除演算子[1]

使用できるファイアウォール[1]

［ジョブあて先経路変更］ダイアログボックス[1]

ジョブ完了イベント（JP1/IM連携）[1]

［ジョブ実行状況］ウィンドウ[1]

［ジョブ実行状況］ウィンドウで印刷できる情報[1]

［ジョブ実行状況］ウィンドウで表示される項目[1]

［ジョブ定義］ウィンドウ[1]

［ジョブ定義の新規作成］ダイアログボックスのカスタマイズ[1]

［ジョブ定義の新規作成］ダイアログボックスの表示方法[1]

ジョブとは[1]

ジョブの管理[1]

［ジョブの再実行］ダイアログボックス[1]

ジョブの削除[1]、[2]

［ジョブの作成］ダイアログボックスに表示されるパネル[1]

［ジョブの作成］ダイアログボックスのカスタマイズ[1]

ジョブの作成と実行（リモートコレクト）[1]

ジョブの作成、実行手順[1]

ジョブの実行結果を確認したあとの対処[1]

ジョブの実行順序[1]

ジョブの実行状況の確認[1]

ジョブの実行状況の遷移例[1]

ジョブの実行状況の表示方法[1]

ジョブの実行状況を確認するときの設定[1]

ジョブの実行状況を確認するときの注意事項[1]

ジョブの実行状態の種類[1]

ジョブの実行状態の遷移[1]

ジョブの実行タイミングのコントロール[1]

ジョブの実行と保存[1]、[2]

ジョブの実行例[1]

ジョブの詳細設定[1]

ジョブの対象コンピュータ数の調整[1]

ジョブの中断と再開[1]

ジョブの中断と再開の仕組み[1]

ジョブの中断と再開の適用範囲[1]

ジョブのトラブルシューティング[1]

［ジョブの配布属性］パネルの設定[1]

ジョブのパケットの送信量を削減する[1]

ジョブの保存[1]

ジョブの保留機能[1]、[2]

ジョブの保留機能を使用する[1]

［ジョブ］パネル[1]

ジョブ〔用語解説〕[1]

ジョブを管理する[1]

ジョブを保留する場合の注意事項[1]

ジョブを保留する方法[1]

処理中ダイアログの表示[1]

［処理中ダイアログ］パネル[1]

処理中ダイアログボックスの表示／非表示[1]

指令完了イベント（JP1/IM連携）[1]

指令完了イベントの拡張属性の詳細情報（JP1/IM連携）[1]

新規に追加されたコンピュータを管理する例[1]

す

すぐに実行[1]、[2]

スケジュール[1]

スケジュールの一括設定[1]

スケジュール配布[1]

［スケジュール］パネル[1]、[2]

スタンドアロンPCへのソフトウェアのインストール〔機能詳細〕[1]

ステートメント単位で実行する[1]

［ステップオーバー］[1]

すべてのジョブ詳細の表示[1]

すべてのジョブの表示[1]

せ

性能低下を回避するためにメンテナンスする[1]

セクション[1]

セクションの概要[1]

世代番号[1]

接続先が変更されるタイミング[1]

接続先設定ファイル[1]

接続先の自動変更[1]

接続先の自動変更関連のログ[1]

接続先の自動変更と他機能との関係[1]

接続する上位システムを自動的に設定・変更する[1]

セットアップ〔マルチキャスト配布〕[1]

そ

［ソート順序の設定］ダイアログボックス[1]

属性情報（タブ）[1]

［属性］タブ[1]

属性の取得[1]

［属性の変更］ダイアログボックス[1]

ソフトウェア条件[1]

［ソフトウェア条件］パネル[1]

ソフトウェアのインストール状況の確認[1]

ソフトウェアの配布〔機能詳細〕[1]

ソフトウェアを配布する[1]

た

代入操作[1]

代表的な運用例[1]

タグの指定方法（JP1/AJS連携）[1]

タグの種類（JP1/AJS連携）[1]

他社ソフトウェア[1]

他社ソフトウェアインストール時の注意事項[1]

他社ソフトウェアのパッケージングのバリエーション[1]

多重代入[1]

多数のコンピュータを削除する場合の注意事項[1]

タスクバー操作[1]

タブオーダー〔用語解説〕[1]

単項演算子[1]

単項否定[1]

単項プラス[1]

単項マイナス[1]

ち

中継からの結果通知保留〔ジョブ〕[1]

中継からのコレクトファイル収集[1]

中継からのコレクトファイル収集〔ジョブ〕[1]

中継システム上のパッケージの削除[1]

中継システム上のパッケージの削除[1]

中継システム上のファイルの削除[1]

中継システムの利用[1]

中継システムへのパッケージの転送[1]、[2]

中継システム〔用語解説〕[1]

中継でのパッケージ保管期限[1]

中継の結果通知保留の解除〔ジョブ〕[1]

中継のコレクトファイル削除[1]

中継のコレクトファイル削除〔ジョブ〕[1]

中継のパッケージ削除[1]

中継のパッケージの一括削除〔ジョブ〕[1]

中継までのパッケージの転送[1]

中継までのパッケージの転送〔ジョブ〕[1]

中継までのリモートコレクト[1]

中継までのリモートコレクト〔ジョブ〕[1]

中断中にジョブを配布する[1]

調査内容[1]

つ

通信環境ファイルの設定[1]

ツールを起動する運用例[1]

次のウィンドウにジャンプ[1]

て

停止時に実行[1]、[2]

定数[1]

ディレクトリ操作[1]

ディレクトリ操作に関するマクロ[1]

［ディレクトリ］パネル[1]

データ型[1]

デバッグ[1]

デバッグする[1]

［デバッグの中断］[1]

デバッグを終了する[1]

［デフォルト値のカスタマイズ］ダイアログボックス[1]

転送休止時間[1]

と

同時に接続する中継システム数の調整[1]

同時に接続するホストの台数の調整[1]

登録解除待ちのIDを取り消す[1]

登録待ちのIDを取り消す[1]

特殊な文字[1]

特定の位置まで実行する[1]

特定の実行状況のジョブの表示方法[1]

ドメイン〔用語解説〕[1]

トラブルシューティング[1]

トラブル発生時の対処方法[1]

に

二項演算子[1]

日時操作[1]

日時ピッカー〔用語解説〕[1]

任意のソフトウェアをパッケージングする場合の手順[1]

ね

ネットワーク環境[1]

ネットワークに負荷を掛けない運用方法[1]

の

ノード識別キー[1]

は

バージョン/リビジョン[1]

バージョンアップ時リストア対象とする[1]

ハードウェアについての注意事項〔クライアント制御〕[1]

ハードディスクの空き容量などをチェックしてインストールする[1]

配布管理システムからファイルを使って管理対象のコンピュータをIDに登録する[1]

配布管理システムの開始と停止[1]

配布管理システムのメニュー[1]

配布管理システム〔用語解説〕[1]

配布管理システムを階層化したシステムでのIDの運用方法[1]

配布管理システムを操作する[1]

配布されたソフトウェアのインストール[1]

配布できるソフトウェアの種類[1]

配布日時を2段階に分けて設定する[1]

配布用の上位システムを自動で切り替えてファイルを配布する[1]

パケットフィルタリング方式ファイアウォール[1]

パケットフィルタリング方式〔用語解説〕[1]

パスワードロック時の注意事項[1]

バックアップ取得状況一覧の出力[1]

バックアップファイルの削除[1]

バックアップファイルを管理するコマンド[1]

バックグラウンドインストールモード[1]、[2]

パッケージ条件[1]

パッケージ（リモートインストールマネージャを使用した配布用）〔用語解説〕[1]

［パッケージ］ウィンドウ[1]

［パッケージ］ウィンドウで印刷できる情報[1]

パッケージ識別ID[1]

パッケージ種別[1]、[2]

パッケージ種別〔用語解説〕[1]

パッケージ条件[1]

［パッケージ条件］パネル[1]

パッケージ情報[1]

［パッケージ情報］ダイアログボックス[1]

パッケージ情報ツール[1]

パッケージセットアップマネージャ[1]

パッケージセットアップマネージャ（メニュー）[1]

パッケージセットアップマネージャからのインストール[1]

パッケージセットアップマネージャ〔用語解説〕[1]

パッケージセットアップマネージャを操作する[1]

［パッケージ属性］パネル[1]

パッケージデータを圧縮する[1]

パッケージ内容（タブ）[1]

パッケージのインストール[1]

パッケージのインストール〔ジョブ〕[1]

パッケージの確認[1]

パッケージの管理[1]

パッケージの削除[1]

パッケージの削除（パッケージの管理）[1]

パッケージの詳細情報を表示する[1]

パッケージの詳細設定[1]

パッケージの追加[1]

パッケージの分割配布[1]

［パッケージ］パネルの設定[1]

パッケージ保管先キャビネット[1]

パッケージ名[1]

パッケージャとの連動[1]

パッケージャの起動[1]

パッケージャ〔用語解説〕[1]

パッケージを分割して配布する[1]

パッケージング環境のカスタマイズ[1]

パッケージング時に設定できるインストール条件[1]

パッケージング時の注意事項[1]

［パッケージング情報］パネル[1]

パッケージングするディレクトリ[1]

パッケージングの手順[1]

パッケージングの方法[1]

パッケージング〔用語解説〕[1]

パラメタファイル（JP1/AJS連携）[1]

パラメタファイルの形式（JP1/AJS連携）[1]

パラメタファイルの作成（JP1/AJS連携）[1]

判定条件[1]

ハンドル〔用語解説〕[1]

ひ

比較演算子[1]

日立PPのインストール[1]

日立総合インストーラからパッケージングする[1]

日立プログラムプロダクト[1]

日付による検索[1]

日付によるホストの検索方法[1]

ビット単位AND演算子[1]

ビット単位OR演算子[1]

ビット単位演算子[1]

［表示する項目の設定］ダイアログボックス[1]

表示する日時項目を選択する[1]

ビルド[1]

ふ

ファイアウォール環境での配布機能の運用[1]

ファイアウォール〔用語解説〕[1]

ファイルからあて先グループを作成する[1]

ファイル操作[1]

ファイル操作に関するマクロ[1]

ファイル属性[1]

［ファイル属性］パネル[1]

「ファイル転送の再開」ジョブ[1]

ファイル転送の再開〔ジョブ〕[1]

「ファイル転送の中断」ジョブ[1]

ファイル転送の中断〔ジョブ〕[1]

ファイルの格納[1]

ファイルの更新を検知して自動的にリモートインストールする（JP1/AJS連携）[1]

ファイルの収集〔機能詳細〕[1]

ファイルの復元[1]

ファイルを収集する[1]

ファイルを使って管理対象のコンピュータをIDに登録する[1]

ファインダ[1]

フォーカス〔用語解説〕[1]

フォルダ[1]

フォルダの削除[1]

フォルダまたはジョブを削除するときの注意事項[1]

フォルダ名またはジョブ名の変更[1]

復元先のファイル構成[1]

［復元］ダイアログボックス[1]

複数LAN接続環境での配布機能の運用[1]

複数LAN接続〔用語解説〕[1]

複数の配布管理システムで同じIDを管理する場合[1]

複数パッケージを計画的に実行する方法[1]

復帰と改行を削除する（APIの使用例）[1]

フラグについて[1]

［ブレークポイントの設定］ダイアログボックス[1]

［ブレークポイントの追加／削除］[1]

ブレークポイントまで実行する[1]

ブレークポイントを設定する[1]

プログラムフローの制御[1]

分割サイズ[1]

分割配布[1]

分割配布したジョブを強制完了する[1]

分割配布の強制完了[1]

分割配布の注意事項[1]

分割配布の場合の注意事項[1]

分割配布〔用語解説〕[1]

文法チェック[1]

へ

変化するテキストをウィンドウの判定に使わない[1]

編集[1]

編集ウィンドウ使用時のメッセージ[1]

変数[1]

変数を監視する[1]

変数を変更する[1]

ほ

保管期限[1]

保管したパッケージの確認[1]

ホスト識別子[1]

ホスト識別子〔用語解説〕[1]

［ホストの作成］ダイアログボックス[1]

ホストの属性を変更する[1]

ホストの登録[1]

ホストの編集[1]

ホスト名でJP1/IT Desktop Management 2のノードを管理する[1]

ホスト名とIPアドレスの定義[1]

ホスト名の管理[1]

ホスト名の付け方[1]

ホスト名を変更する[1]

ホスト〔用語解説〕[1]

ホストを移動する[1]

ホストを削除する[1]

ホストを識別する運用キーの決定[1]

保存したジョブおよびフォルダの管理[1]

保存したジョブの修正[1]

ホットスタンバイ[1]

ポリシー[1]

ポリシーの一括反映[1]

ポリシーの作成例[1]

ポリシー〔用語解説〕[1]

ポリシーをファイルから作成する[1]

保留したジョブの実行方法[1]

ま

前のウィンドウにジャンプ[1]

マクロ[1]

マネージャ〔用語解説〕[1]

マルチキャストアドレス[1]

マルチキャストアドレス〔用語解説〕[1]

マルチキャストグループ[1]

マルチキャストグループ〔用語解説〕[1]

マルチキャスト配布[1]

マルチキャスト配布が適用される経路[1]

マルチキャスト配布〔機能概要〕[1]

マルチキャスト配布〔設定方法〕[1]

マルチキャスト配布に必要なネットワーク環境[1]

マルチキャスト配布の実行方法[1]

マルチキャスト配布の対象となるジョブ[1]

マルチキャスト配布の標準的なシステム構成[1]

マルチキャスト配布〔用語解説〕[1]

マルチキャスト配布を指定したジョブの作成[1]

マルチキャスト配布をするためのシステム構成[1]

マルチキャスト配布をするための設定[1]

マルチキャスト配布をする場合の注意事項[1]

マルチポーリング[1]

マルチポーリング環境での注意事項〔エージェント〕[1]

マルチポーリング環境でのポーリング方法の選択[1]

マルチポーリング環境の設定〔エージェント〕[1]

マルチホスト[1]

む

無効フラグ[1]

め

名称による検索[1]

名称によるホストの検索方法[1]

メッセージ操作[1]

メッセージ操作に関するマクロ[1]

メッセージの確認[1]

メッセージの形式[1]

メニューからツールを起動する[1]

メニューにツールを登録する[1]

も

文字列操作[1]

文字列を抽出する（APIの使用例）[1]

ゆ

ユーザ固有の条件でインストールの適否をチェックする[1]

ユーザプログラム、データ[1]

優先順位[1]

ユティリティ操作[1]

ユティリティ操作に関するマクロ[1]

ユニキャスト配布[1]

ユニキャスト配布とマルチキャスト配布[1]

ユニキャスト配布とマルチキャスト配布の概念[1]

ユニキャスト配布〔用語解説〕[1]

よ

用語解説[1]

予約語の指定方法（JP1/AJS連携）[1]

予約語の使用例（JP1/AJS連携）[1]

予約語を使用する場合の注意事項（JP1/AJS連携）[1]

ら

ラベル[1]

り

リストアの再試行[1]

リターンコードの設定[1]

リダイレクト操作[1]

リモートインストール[1]

リモートインストール機能を使用してJP1/IT Desktop Management 2 - Agentを配布する[1]

リモートインストール時の中継システムの動作[1]

リモートインストール時にレジストリのHKEY_CURRENT_USERを操作する（APIの使用例）[1]

リモートインストールの運用例[1]

リモートインストールのエラーを検知しリトライする（JP1/AJS連携）[1]

リモートインストールの作業の流れ[1]

リモートインストールの実行[1]

リモートインストールの実行手順[1]

リモートインストールの失敗による旧バージョンの破壊を防ぐ[1]

リモートインストールマネージャ（メニュー）[1]

リモートインストールマネージャからのツールの起動[1]

リモートインストールマネージャとの連動[1]

リモートインストールマネージャ〔用語解説〕[1]

リモートインストールマネージャを起動する[1]

リモートインストールマネージャを終了する[1]

リモートインストールマネージャを使用した配布機能のコマンド[1]

リモートインストールマネージャを使用した配布機能の紹介[1]

リモートインストールマネージャを使用した配布に関するエージェントの機能を使用する場合の注意事項[1]

リモートインストールマネージャを使用した配布に関するエージェントのメニュー[1]

リモートインストールマネージャを使用した配布に関する監査ログの出力[1]

リモートインストールマネージャを使用した配布〔用語解説〕[1]

リモートインストール〔用語解説〕[1]

リモートインストールを実行するジョブ種別[1]

リモートインストールを実行するときの注意事項[1]

リモートコレクト〔機能詳細〕[1]

リモートコレクト実行時の注意事項[1]

リモートコレクト〔ジョブ〕[1]、[2]

リモートコレクトの運用例[1]

リモートコレクトのオプションの設定[1]

リモートコレクトの作業の流れ[1]

リモートコレクトの実行[1]

リモートコレクトの操作[1]

リモートコレクト〔用語解説〕[1]

リモートコレクトを実行するジョブ種別[1]

リモートコントロール機能〔用語解説〕[1]

リモートコントロール機能を利用する[1]

リモートデスクトップ〔用語解説〕[1]

リモコンエージェント〔用語解説〕[1]

利用者の都合に合わせたインストール[1]

れ

レコーダ[1]

レコーダ操作[1]

［レコーダ］ダイアログボックス[1]

レコーディング[1]

レコーディングの一時停止[1]

レコーディングの再開[1]

レジストリ操作[1]

レジストリ操作に関するマクロ[1]

ろ

ログに出力する[1]

ログファイル[1]

ログファイルの確認[1]、[2]

論理AND演算子[1]

論理OR演算子[1]

論理演算子[1]

わ

ワークディレクトリ[1]