jssitemcount (counts Items)
- Organization of this page
Description
This command displays the number of managed and stored Items registered in JP1/Service Support. If the number of Items that can be added to a process work board becomes smaller than the threshold value, or if the number of Items reaches the maximum limit (until which time Items can be registered in the process work board), a warning message is output. The threshold value can be set in the system property file (hptl_jp1_imss_main_setting.properties). For details, see System property file (hptl_jp1_imss_main_setting.properties) in Chapter 13. Definition Files.
Format
jssitemcount {-ALL | -s -id system-ID | -p -id process-work-board-ID}
[-ct start-date-end-date]
Required execution permission
Administrator permissions
Storage folder
JP1/SS-path\bin\
Arguments
-ALL
Checks the number of Items registered in all process work boards.
-s -id system-ID
Checks the number of Items registered in a selected system. For system-ID, use 1 to 64 half-width alphanumeric characters.
-p -id process-work-board-ID
Checks the number of Items registered in a selected process work board. For process-work-board-ID, use 1 to 64 half-width alphanumeric characters.
-ct start-date-end-date
Specify the registration date range in order to check the number of Items registered in that specified period. Specify start-date and end-date with character strings in YYYY/MM/DD format, and connect them with a hyphen (-).
For start-date and end-date, you can specify values from 1970/01/01 to 2107/01/01. Specify the values so that start-date is earlier than end-date. The following explains start-date and end-date:
- start-date
-
Counts the number of Items registered after the date specified for start-date (including start-date). If a specified date does not exist as a date in the specified range, an error occurs.
- end-date
-
Counts the number of Items registered before the date specified for end-date (including end-date). If a specified date does not exist as a date in the specified range, an error occurs.
For example, if 2013/01/01-2013/12/31 is specified, Items whose registration date is in the range from 2013/01/01 00:00:00(.000) to 2013/12/31 23:59:59(.999) are counted.
Return values
|
Return value |
Meaning |
|---|---|
|
0 |
Normal end, no warning message output |
|
1 |
Normal end, warning message output |
|
2 |
Abnormal end |
Statuses of the target system and target process work board
The jssitemcount command is targeted to systems in which one or more process work boards are registered. For such systems, Items can be counted without depending on the statuses of the systems, process work boards, and Items. The Items waiting to be deleted are also counted. Note that if the number of Items registered in a process work board is 0, 0 is displayed.
Prerequisites for executing the command
-
For details about the status of services when the command is executed, see Status of services when commands are executed in Chapter 12. Commands.
-
Two or more jssitemcount commands cannot be executed at the same time.
Remarks
-
If you cancel the jssitemcount command by using Ctrl+C while the command is being executed, counting the number of Items might fail. For this reason, do not use Ctrl+C to cancel the command during execution. If you happen to do so, wait for a while, and then re-execute the command.
-
While the jssitemcount command is being executed, if you delete an Item to be counted (by executing the jssdelrec command), register a new Item, or escalate an Item, the relevant Item might not be counted, depending on the timing of such an operation.
-
You can output the result of executing the jssitemcount command to a log file and check the result. For details, see User log definition file (jp1itemcount.conf) in Chapter 13. Definition Files.
Example
The following example shows how to check the number of Items registered in the period from 2013/1/1 to 2013/12/31 for process work board pwb001.
jssitemcount -p -id pwb001 -ct 2013/01/01-2013/12/31