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

cscexportcount (outputs statistics on the status of security measures)

Function

This command outputs statistics relating to the status of security measures for specified groups to a CSV file. Statistics can be output from a variety of perspectives.

Format

cscexportcount[ -d| -w[ day-of-week]| -m][ -s total-start-date][ -e total-end-date][ -k search-condition-file-name][ -r group-level][ -c type-of-totals][ -o output-file-name]

Server for execution

JP1/CSC - Manager

Required permissions

Administrator permissions

Command directory

JP1/CSC - Manager-installation-folder\bin

Arguments

-d

Specify this argument to accumulate statistics on a daily basis.

-w day-of-week

Specify this argument to accumulate statistics on a weekly basis. Also specify the day of the week from which to start the weekly totals, as a numeral from 1 to 7. If you do not specify a day of the week, the weekly totals will begin on Sunday.

The following table shows which numerals correspond to which days of the week.

Argument	Description
1	Start weekly totals on Sunday.
2	Start weekly totals on Monday.
3	Start weekly totals on Tuesday.
4	Start weekly totals on Wednesday.
5	Start weekly totals on Thursday.
6	Start weekly totals on Friday.
7	Start weekly totals on Saturday.

When statistics are accumulated weekly, the totals may reflect data from a shorter period depending on the collection period and the day on which the week starts. The following shows an example of such a situation:

-m

Specify this argument to accumulate statistics on a monthly basis.

When statistics are accumulated monthly, the totals may reflect data from a shorter period depending on the collection period. The following shows an example of such a situation:

-s total-start-date

Specify the start date for the totals, in the format YYYY/MM/DD. When this argument is omitted, the date of the oldest statistics stored in the asset management database is used as the start date.

-e total-end-date

Specify the end date for the totals, in the format YYYY/MM/DD. When this argument is omitted, the date of the most recent statistics stored in the asset management database is used as the end date.

-k search-condition-file-name

Specify by full path the name of the search condition file containing the names of the groups for which statistics are to be accumulated.

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.

-r group-level

Specify the level of the group for which statistics will be accumulated, as a numeral from 0 to 256. Note that you cannot specify the -r argument if 3 is specified in the -c argument.

When this argument is omitted and value other than 3 is specified for the -c argument, group level 1 is used.

Specify the level of groups under the groups specified by the -k option (level 0). For example, if Sales Dept. and Accounting Dept. exist under Head Office and you want to output statistics for Head Office/Sales Dept. and Head Office/Accounting Dept., specify Head Office as the group name and specify 1 for the group level.

-c type-of-totals

Specify the perspective from which to accumulate the statistics, as a numeral from 1 to 3 or 101 to 110. When this argument is omitted, countermeasure usage is totaled across all judgment items.

The following table shows which numeral corresponds to which type of total.

Argument	Description
1	Totals evaluation points.
2	Totals countermeasure usage across all judgment items.
3	Totals countermeasure usage for individual judgment items.
101	Totals countermeasure usage for the first user-defined judgment item.
102	Totals countermeasure usage for the second user-defined judgment item.
103	Totals countermeasure usage for the third user-defined judgment item.
104	Totals countermeasure usage for the fourth user-defined judgment item.
105	Totals countermeasure usage for the fifth user-defined judgment item.
106	Totals countermeasure usage for the sixth user-defined judgment item.
107	Totals countermeasure usage for the seventh user-defined judgment item.
108	Totals countermeasure usage for the eighth user-defined judgment item.
109	Totals countermeasure usage for the ninth user-defined judgment item.
110	Totals countermeasure usage for the tenth user-defined judgment item.

-o output-file-name

Specify by full path the name of the output file (CSV format) for the statistics. This file can have the extension .txt or .csv. To specify a file name that includes spaces, enclose the entire name in double quotation marks (").

When this argument is omitted, the output file will be created with one of the following file names in the current folder in which the command was executed:

Item	Output file name	Description
1	cscjudgemark.csv	Output file name when evaluation points is specified as the type of total
2	csctotal.csv	Output file name when countermeasure usage across all judgment items is specified as the type of total
3	cscjudgeitems.csv	Output file name when countermeasure usage per judgment item is specified as the type of total
4	cscuseritemnnn.csv#	Output file name when countermeasure usage for user-defined judgment items is specified as the type of total

#

nnn is a number from 101 to 110, corresponding to the value specified for the -c option.

Notes

• Execute this command when JP1/CSC setup has completed and the asset management database of AIM is active.
• If a file with the same name already exists in the output destination folder, the file is overwritten.
• If the statistics to be output are 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 left unchanged.
• You cannot specify a folder in a shared folder or on a network drive as the output target.
• If none of the arguments -d, -w, or -m are specified, statistics are accumulated on a monthly basis.

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	A date is specified incorrectly.
8	A database access error occurred.
9	The search condition file contains an error.
10	The specified group does not exist, or no groups belong to the specified group.
11	AIM is not installed.
12	No statistics meeting the specified conditions were found.
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