ajsagtreport
- Organization of this page
Format
ajsagtreport
[-h logical-host-name]
-a execution-agent-name
[-n [-r minutes]|
[-b year/month/day] [-s hours:minutes]
[-e year/month/day] [-f hours:minutes]]
[-i collection-interval]
[-H]
Description
The ajsagtreport command outputs execution agent performance report.
Execution privileges
In Windows: Administrators privileges
In UNIX: Superuser privileges
Storage directory
- In Windows:
-
JP1/AJS3 - Manager-installation-folder\bin\
- In UNIX:
-
/opt/jp1ajs2/bin/
Arguments
-h logical-host-name
Specifies the logical host name of the local host on which the target execution agent (the execution agent for which you want to output execution agent performance data) is registered. You can specify a character string of 1 to 255 bytes.
By default, the system assumes the logical host name specified by the JP1_HOSTNAME environment variable. If environment variable JP1_HOSTNAME is not specified, the physical host name is assumed.
For a physical host, make sure that you specify neither this option nor the JP1_HOSTNAME environment variable.
-a execution-agent-name
Specify the name of an execution agent for which you want to output execution agent operation status. You can specify a character string of 1 to 255 bytes.
-n
Specify this option to output the execution agent operation status that is most recent as of the date and time when the command was executed.
If you specify -r, the command outputs the execution agent operation status for the number of minutes (specified for -r) immediately before the zero seconds (.000) of the command execution time. The value specified for -r is based on the zero seconds on the date and time that the command was executed.
If you specify -i, you can specify the interval at which the execution agent operation status is to be collected within the time range specified for -r.
You cannot specify this option with the -b, -s, -e, and -f options.
-r minutes
Specify the number of minutes before the time at which the command was executed.
The default is 1 (minute).
You cannot specify this option with the -b, -s, -e, and -f options.
-
minutes
You can specify a value between 1 and 1,440 for the minute.
-b year/month/day
Specify the start date of the period for which the execution agent operation status is to be output.
If you omit this option, the start date is assumed to be the date on which the command was executed.
You cannot specify this option with the -n and -r options.
-
year
You can specify a value between 1994 and 2099 for the year.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31.
-s hours:minutes
Specify the start time of the period for which the execution agent operation status is to be output.
If you omit this option, the start time is assumed to be 00:00.
You cannot specify this option with the -n and -r options.
-
hours
You can specify a value between 0 (or 00) and 23.
-
minutes
You can specify a value between 0 (or 00) and 59.
-e year/month/day
Specify the end date of the period for which the execution agent operation status is to be output.
If you omit this option, the end date is assumed to be the same as the start date specified for -b.
You cannot specify this option with the -n and -r options.
You cannot specify a date earlier than the start date that is specified for the -b option or that is set by default.
-
year
You can specify a value between 1994 and 2099 for the year.
-
month
You can specify a value between 1 (or 01) and 12.
-
day
You can specify a value between 1 (or 01) and 31.
-f hours:minutes
Specify the end time of the period for which the execution agent operation status is to be output.
If you omit this option, the end time is assumed to be 24 hours after the start time.
If you omit both the -e option and -f option, the end date and time are calculated by adding 24 hours to the start date and time.
You cannot specify this option with the -n and -r options.
The date and time you specify for the -e and -f options cannot be same or earlier than the date and time you specify for the -b and -s options.
-
hours
You can specify a value between 0 (or 00) and 23.
-
minutes
You can specify a value between 0 (or 00) and 59.
The following table shows examples of execution agent performance report collection periods specified by using combinations of the -b, -s, -e, and -f options.
|
No. |
-b option |
-s option |
-e option |
-f option |
Start date and time |
End date and time |
Collection period |
|---|---|---|---|---|---|---|---|
|
1 |
Omitted |
Omitted |
Omitted |
Omitted |
2025/09/08 00:00 |
2025/09/09 00:00 |
1 day from 2025/09/08 00:00:00.000 to 2025/09/08 23:59:59.999 |
|
2 |
2025/09/01 |
Omitted |
Omitted |
Omitted |
2025/09/01 00:00 |
2025/09/02 00:00 |
1 day from 2025/09/01 00:00:00.000 to 2025/09/01 23:59:59.999 |
|
3 |
Omitted |
09:00 |
Omitted |
Omitted |
2025/09/08 09:00 |
2025/09/09 09:00 |
1 day from 2025/09/08 09:00:00.000 to 2025/09/09 08:59:59.999 |
|
4 |
2025/09/01 |
11:00 |
Omitted |
Omitted |
2025/09/01 11:00 |
2025/09/02 11:00 |
1 day from 2025/09/01 11:00:00.000 to 2025/09/02 10:59:59.999 |
|
5 |
Omitted |
Omitted |
2025/09/08 |
Omitted |
2025/09/08 00:00 |
2025/09/09 00:00 |
1 day from 2025/09/08 00:00:00.000 to 2025/09/08 23:59:59.999 |
|
6 |
Omitted |
Omitted |
Omitted |
20:00 |
2025/09/08 00:00 |
2025/09/08 20:00 |
Approximately 1 day from 2025/09/08 00:00:00.000 to 2025/09/08 19:59:59.999 |
|
7 |
Omitted |
Omitted |
2025/09/08 |
22:30 |
2025/09/08 00:00 |
2025/09/08 22:30 |
Approximately 1 day from 2025/09/08 00:00:00.000 to 2025/09/08 22:29:59.999 |
|
8 |
2025/09/01 |
Omitted |
2025/09/07 |
Omitted |
2025/09/01 00:00 |
2025/09/08 00:00 |
7 days from 2025/09/01 00:00:00.000 to 2025/09/07 23:59:59.999 |
|
9 |
Omitted |
11:00 |
Omitted |
22:30 |
2025/09/08 11:00 |
2025/09/08 22:30 |
Approximately 0.5 days from 2025/09/08 11:00:00.000 to 2025/09/08 22:29:59.999 |
|
10 |
2025/09/01 |
08:00 |
2025/09/07 |
21:30 |
2025/09/01 08:00 |
2025/09/07 21:30 |
Approximately 7 days from 2025/09/01 08:00:00.000 to 2025/09/07 21:29:59.999 |
-i collection-interval
Specify the interval at which to collect the execution agent operating status.
The default is 1 (minute).
If you specify this option at the same time as the -r option, the value you specify for this option must not be greater than the value you specify for the -r option.
-
collection-interval
You can specify a value between 1 and 1,440 for the minute.
-H
Specify this option if you do not want to output header information (including the date and time when the command was executed, the command specification details, and item names) for the execution agent operating status.
Notes
-
This command cannot be executed remotely.
-
Always separate the option and its value by at least one space character.
-
You cannot use regular expressions when you specify execution agent names.
-
This command outputs the results collected at the system time.
-
If you execute this command while a jobnet or job is running, information about the jobnet or job whose status changed during execution is not included in the collection results. This information is assumed as the information after the start of the collection.
-
If the message "KAVS1112-E" is output when the ajsagtreport command is executed, make sure that the execution agent performance log file storage directory exists.
-
This command increases the execution time and memory usage of the command as the report period increases. If you want to shorten the execution time of the ajsagtreport command, or reduce the impact of increased memory usage, specify a shorter report output period and execute the ajsagtreport command separately.
-
When the ajsagtreport command is executed, the CPU load is temporarily increased by the process of the ajsagtreport command. We recommend to execute the ajsagtreport command when the CPU load is low.
Return values
|
0 |
Normal end |
|
Values other than 0 |
Abnormal end |
Items output to an execution agent performance report
The following describes the items that are output to an execution agent performance report.
|
No. |
Item |
Description |
Collection type |
|---|---|---|---|
|
1 |
MAX_CON-EXE |
Indicates the maximum number of concurrently executable jobs. |
Max./time |
|
2 |
QUEUING_JOB_NUM |
Indicates the number# of the following jobs that are queued: UNIX jobs, PC jobs, flexible jobs, HTTP connection jobs, action jobs, custom jobs, and passing information setting jobs. |
Max./time |
|
3 |
RUNNING_JOB_NUM |
Indicates the number of the following jobs that are running: UNIX jobs, PC jobs, flexible jobs, HTTP connection jobs, action jobs, custom jobs, and passing information setting jobs. |
Max./time |
|
4 |
RUNNING_EVJOB_NUM |
Indicates the number of the following jobs that are running: event jobs and custom event jobs. |
Max./time |
|
5 |
JOB_QUEUING_START_NUM |
Indicates the number# of the following jobs for which queueing started: UNIX jobs, PC jobs, flexible jobs, HTTP connection jobs, action jobs, custom jobs, and passing information setting jobs. |
Number/time |
|
6 |
JOB_QUEUING_END_NUM |
Indicates the number# of the following jobs for which queueing ended: UNIX jobs, PC jobs, flexible jobs, HTTP connection jobs, action jobs, custom jobs, and passing information setting jobs. |
Number/time |
|
7 |
JOB_EXEC_START_NUM |
Indicates the number of the following jobs for which execution started: UNIX jobs, PC jobs, flexible jobs, HTTP connection jobs, action jobs, custom jobs, and passing information setting jobs. |
Number/time |
|
8 |
JOB_EXEC_END_NUM |
Indicates the number of the following jobs for which execution ended: UNIX jobs, PC jobs, flexible jobs, HTTP connection jobs, action jobs, custom jobs, and passing information setting jobs. |
Number/time |
|
9 |
EVJOB_EXEC_START_NUM |
Number of event jobs and custom event jobs whose execution has started. |
Number/time |
|
10 |
EVJOB_EXEC_END_NUM |
Indicates the number of the following jobs for which execution ended: event jobs and custom event jobs. |
Number/time |
- #
-
Jobs that specify a group of execution agents as the execution destination in the job definition are excluded.
Example
In the following example, the command outputs the operational conditions of the AGT01 execution agent when the command is executed on January 1, 2025.
ajsagtreport -a AGT01
Output example
#exectime: 2025/01/01 09:02:51
#command: ajsagtreport -a AGT01
#DATE,MAX_CON-EXE,QUEUING_JOB_NUM,RUNNING_JOB_NUM,RUNNING_EVJOB_NUM,...
2025/01/01 09:00,5,0,3,0,...
2025/01/01 09:01,5,1,5,0,...
: ,:,:,:
2025/01/01 21:29,5,0,0,0,...