10.4.2 Running the JP1/AJS3 - Print Option data collection tool

(1) Running the JP1/AJS3 - Print Option data collection tool

The following shows an example of a command line that executes the JP1/AJS3 - Print Option data collection tool. In this example, the tool is stored in the folder C:\usertools.

c:\>c:\usertools\PO_ras.bat

The data collection tool outputs the data it collects to subfolders of folder-where-data-collection-tool-is-stored\jp1ajs2po\backlog.

\PO_1st

Primary data is output to this folder.

\PO_2nd

Secondary data is output to this folder.

Note

• You can specify options that limit the range of data collected by the data collection tool. For details about the syntax of these options, see (2) Syntax of the JP1/AJS3 - Print Option data collection tool.

• For details about the types of primary and secondary data collected by the data collection tool, see (3) Data collected by the JP1/AJS3 - Print Option data collection tool.

To Page Top

(2) Syntax of the JP1/AJS3 - Print Option data collection tool

Format

PO_ras.bat
     [-t]
     [-u]

Description

Acquires maintenance information associated with JP1/AJS3 - Print Option. This information includes log information of various types and information output by the OS.

Required permission

Administrators permission

Arguments

-t

Specify this option when you do not want to collect the hosts file and the services file.

-u

Specify this option when you do not want to collect a user dump.

Output destination

folder-where-data-collection-tool-is-stored\jp1ajs2po\backlog

Return values

0	Normal termination
Other than 0	Abnormal termination

Messages

Message	Description	Behavior
Finished. Press any key.	Processing finished normally. Press any key.	Waits for a response from the user.
Failed. Press any key.	Processing did not finish normally. Press any key. Identify and address the cause of the problem by reviewing the messages output by the OS and other relevant information, and then try again.	Waits for a response from the user.
File file-name is exist. Delete to continue? (y/n)	A file with the specified name created by a prior instance of the data collection tool exists. Enter y to delete the file and continue processing. To cancel processing, enter n.	Waits for a response from the user.
Directory folder-name is exist. Delete to continue? (y/n)	A folder with the specified name created by a prior instance of the data collection tool exists. Enter y to delete the folder and continue processing. To cancel processing, enter n.	Waits for a response from the user.
Error exists in option.	An option is specified incorrectly. Specify the option correctly, and then try again.	Finishes processing.

Cautionary notes:

• The data collection tool does not compress the data it collects. To compress the data, use a third-party tool.

• A confirmation message appears if a file output by a previous instance of the batch file exists at the same location. To overwrite the file, enter y. To cancel the operation, enter n.

• If you perform an operation on a collected file (such as moving or deleting it) immediately after the data collection tool has finished executing, a message might appear indicating that the process cannot access the file because the file is in use by another process. This message appears because internal processing to collect OS information is still taking place even though the data collection tool itself has finished executing. If you encounter this message, wait a few minutes and try again.

• You must start the data collection tool from a command prompt with administrator privileges. To open the command prompt, right-click Command prompt in the Start menu and choose Run as administrator.

  If you run the data collection tool without Administrators permission, UAC will display dialog boxes several times requiring confirmation from the user.

  You do not need to open the command prompt as an Administrator if UAC is disabled.

• Do not run more than one instance of the data collection tool at once.

To Page Top

(3) Data collected by the JP1/AJS3 - Print Option data collection tool

There are two categories of data collected by the JP1/AJS3 - Print Option data collection tool: primary data and secondary data. The tables below list the folders and files associated with each category.

Primary data (folder-where-data-collection-tool-is-stored\jp1ajs2po\backlog\PO_1st)

Table 10‒5: Primary data for JP1/AJS3 - Print Option

Folder or file containing collected data	Contents
\FILELIST.txt	A list of the files in the JP1/AJS3 - Print Option installation folder
\GETERROR.log	Log data output by the data collection tool (PO_ras.bat)
\HOSTS	hosts file
\services	services file
\ProductInfo.txt \Version.txt	Product information file
\jprpo.ini	Operation settings file for management
\JP1AJS2PO.DAT \NETFRAMEWORK.DAT \OFFICE.DAT	Registry information for various products
\WIN.DAT	Windows registry information
\OSINFO.txt	OS version information, Windows environment variables, IP configuration information, network configuration information, statistics
\PERMISSIONINFO.TXT	Permission information for the JP1/AJS3 - Print Option folder, folders in which log information is kept, and log files, Permission information for the Users folder and its sub-folders while the multi-user remote operation functionality is used
\SECEDIT.txt	Local security policy settings acquired by the secedit command, including account policies, audit policies, event log settings, and security options.
\WINMSD.TXT	Information acquired by the msinfo32 command, including an overview of the system, information about running tasks, and service information. This file contains all system information collected by the msinfo32 command.
\ALLUSERSPROFILE\INI	Storage folder for configuration files
\ALLUSERSPROFILE\Format	Storage folder for format definition files
\ALLUSERSPROFILE\FlowFormat	Storage folder for jobnet flow format definition files
\ALLUSERSPROFILE\Map	Work files for map output and flow output
\ALLUSERSPROFILE\Map\Tmp	Work file folders and work files for map output and flow output when the jprmpflw command is executed
\ALLUSERSPROFILE\Log	Storage folder for log files
\HITACHI_JP1_INST_LOG \HCDINST	Log files for integrated installer
\LicLog	Log file for installer license checking
\common	License information file
\ALLUSERSPROFILE\Users	Folders and files in the Users folder while multi-user remote operation is enabled

Secondary data (folder-where-data-collection-tool-is-stored\jp1ajs2po\backlog\PO_2nd)

Table 10‒6: Secondary data for JP1/AJS3 - Print Option

Folder or file containing collected data	Contents
\eventlog\AppEvent.txt	Application event log
\eventlog\SysEvent.txt	System event log
\eventlog\UACVirtualEvent.txt	Event log entries related to UAC file virtualization
\USERDUMP\*.dmp \WTSNDUMP\*.dmp	User dump files#

#

The data collection tool can acquire a user dump file only if one has been output by the user.

To Page Top