Job Management Partner 1/Client Security Control Description, User's Guide and Operator's Guide

cscexportpclist (outputs PC list information)

Function

This command outputs to a CSV file PC list information that contains asset information and judgment results for clients whose security levels were judged on the specified date and time.

Format

cscexportpclist[ -j "security-level-judgment-date"][ -k search-condition-file-name]
[ -o file-output-destination-folder][ -s][ -l number-of-lines]

Server for execution

JP1/CSC - Manager

Required permissions

Administrator permissions

Command directory

JP1/CSC - Manager-installation-folder\bin

Arguments

-j "security-level-judgment-date"

Specify the security level judgment date for which you want to output PC list information. Use YYYY/MM/DD hh:mm:ss format enclosed in double quotation marks (").

The asset information and judgment results for the clients whose security levels were judged at the date and time specified here will be output to the PC list information file.

For details about the date of security level judgment you can specify, see judgment-date=[security-level-judgment-date] output to the JP1/CSC - Manager log file or the PC List window of the Client Security Management window.

When this argument is omitted, the latest information will be output for all clients registered in JP1/CSC.

-k search-condition-file-name

Specify by full path the name of the search condition file containing the names of the groups to which the clients subject to the output of information belong. When this argument is specified, the asset information and judgment results of all clients in the groups specified in the search condition file are output to the PC list information file.

Create the search condition file in any directory on the management server, using any file name.

For details about the search condition file, see 16.6 Search condition file.

When this argument is omitted, information for all clients registered in JP1/CSC - Manager will be output to the PC list information file.

-o file-output-destination-folder

Specify by full path the output destination folder for the PC list information file.

To specify a path that includes spaces, enclose the entire path in double quotation marks (").

When this argument is omitted, the PC list information will be created in the current folder in which the command was started.

For details about the PC list information, see 16.10 PC list information file.

-s

Specify this argument to output the items related to the judgment results Danger, Warning, Caution, Safe, and Unknown to the judgment result file for PC list information.

When this argument is not specified, the items related to the judgment results Danger, Warning, Caution, and Unknown will be output to the judgment result file.

-l number-of-lines (specifiable range: 1-2147483647)

Specify the maximum number of lines that can be output to the PC list information file. If the number of lines exceeds the maximum, the remaining lines will be output to another file. If this argument is omitted, all lines will be output to one file.

File names are assigned according to the following rules:

First file: fileName.csv

Second file: fileName2.csv

Nth file: fileNameN.csv

Legend:

fileName: File name of an asset information list file or a judgment result file

The following shows an example of outputting a file:

Asset information list file: cscmassetinfo.csv

Number of output lines: 50000

Number of lines specified by -l: 20000

Notes

• If you specify the -j and -k arguments, information for the following clients is output to the PC list information file:
  Clients whose security levels were judged on the specified date of security level judgment and that belong to the groups specified in the search condition file.
  
• Even when the date of security level judgment contained in the JP1/CSC - Manager log file is specified in the -j argument, output of PC list information might fail if the judgment and action history saved in the database has wrapped around and been overwritten from the beginning.
• Execute this command when the asset management database of AIM is active. Note that this command can be executed even when JP1/CSC - Manager is inactive.
• If a file with the same name already exists in the output destination folder, the file is overwritten.
• If information to be output is not found, no file is created when this command is executed. If a file has already been created in the output destination folder, the file is not changed.
• Specifying too small value in the -l argument could result in the creation of many PC list information files.

Output messages

For details about the messages displayed, see 17.3 List of JP1/CSC messages.

Return values

Return value	Description
0	Command processing terminated normally.
3	The specified command arguments are incorrect.
4	The specified file could not be accessed.
5	You do not have execution permissions for the command.
6	JP1/CSC - Manager has not been set up.
7	The format of the security level judgment date is incorrect.
8	A database access error occurred.
9	The search condition file contains an error.
10	PC list information corresponding to the security level judgment date was not found. Alternatively, no clients belong to the groups specified in the search condition file.
11	AIM is not installed.
12	No clients have been registered in JP1/CSC - Manager.
15	A judgment history cannot be acquired.
255	An error other than those listed above has occurred.

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, 2011, Hitachi, Ltd.
Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated