ajsagtprint
- Organization of this page
Format
ajsagtprint [-h logical-host-name] {-a execution-agent-name | -g execution-agent-group-name | -l}
Format1 (for outputting the execution agent definition)
ajsagtprint [-h logical-host-name] -a execution-agent-name
Format2 (for outputting the execution agent group)
ajsagtprint [-h logical-host-name] -g execution-agent-group-name
Format3 (for outputting the definition information of all execution agents and execution agent groups)
ajsagtprint [-h logical-host-name] -l
Description
The ajsagtprint command outputs the definition information of execution agents or execution agent groups to the standard output file in CSV format.
Execution privileges
You must have any of the following JP1 privileges:
-
JP1_JPQ_Admin privilege
-
JP1_JPQ_Operator privilege
-
JP1_JPQ_User privilege
or
In Windows: Administrators privilege
In UNIX: Superuser privileges
Arguments
-h logical-host-name
Specify the logical host name of the local host on which the execution agents or execution agent groups whose definition information you want to output are registered.
You can specify a character string of 1 to 255 bytes.
If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable 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
If you want to output the definition information of a specific execution agent, specify the name of the execution agent.
You can specify a character string of 1 to 255 bytes.
-g execution-agent-group-name
If you want to output the definition information of a specific execution agent group, specify the name of the execution agent group.
You can specify a character string of 1 to 255 bytes.
-l
Specify this option if you want to output the definition information for all execution agents and execution agent groups.
Note
-
During linkage with JP1/NQSEXEC and JP1/OJE for VOS3, you cannot use this command for JP1/NQSEXEC queues and JP1/OJE for VOS3 queues.
-
This command cannot be executed for JP1/AJS3 - Manager installed on another host.
Return values
0 |
Normal end. |
4 |
|
8 |
An argument specified in the command is incorrect. |
12 |
Memory became insufficient during command processing. |
20 |
An attempt to access shared memory failed because the access target was locked. |
24 |
Permission to execute the command is not granted. |
40 |
A system limit was exceeded during allocation of shared memory, file descriptors, or resources for exclusive use. |
120 |
An unexpected error was detected for an OS system call. |
124 |
An unexpected error was detected in JP1/AJS internal processing. |
Example 1
In the following example, the command outputs the definition information for execution agent AP1.
ajsagtprint -a AP1
Example 2
In the following example, the command displays the information about all execution agents or execution agent groups.
ajsagtprint -l
Output example 1
The following shows a sample execution of the command with the -a option specified:
ajsagtprint -a AP1 # <time-stamp> HOSTNAME:<host-name#1> #,AGENT,HOST,CON-EXE,STATUS,DESCRIPTION "A","AP1","Host1","1:00-3:00=10","Ef","Agent1"
- #1
-
For a physical host, the local host name is displayed. For a logical host, the name of the logical host is output.
The following shows the meaning of the output.
- flag
-
-
#:
Indicates a comment line.
-
A:
Indicates the definition information of an execution agent.
-
- AGENT
-
Indicates that execution agent names are output in this column.
- HOST
-
Indicates that target host names (agent host names) are output in this column.
- CON-EXE
-
Indicates that the maximum number of concurrently executable jobs is output in this column.
- STATUS
-
Indicates the job transfer restriction status of the execution agent.
Value
Status
Description
Ef
Effective
Jobs are accepted and then delivered to the target host.
In
Ineffective
New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
Hd
Hold
Jobs are accepted but are not delivered to the target host.
Bl
Blockade
Jobs are neither accepted nor delivered to the target host.
- DESCRIPTION
-
Indicates that the comment on the execution agent is output in this column.
Output example 2
The following shows a sample execution of the command with the -g option specified:
ajsagtprint -g AGG1 # <time-stamp> HOSTNAME:<host-name#1> #,AGENT GROUP,LINK AGENT,STATUS,DESCRIPTION "G","AGG1","AG1:1","Ef","AgentGroup1"
- #1
-
For a physical host, the local host name is displayed. For a logical host, the name of the logical host is output.
The following shows the meaning of the output.
- flag
-
-
#:
Indicates a comment line.
-
G:
Indicates the definition information of an execution agent group.
-
- AGENT GROUP
-
Indicates that execution agent group names are output in this column.
- LINK AGENT
-
Indicates that the name and priority of the execution agent in the execution agent group are output in this column.
- STATUS
-
Indicates the job transfer restriction status of the execution agent group.
Value
Status
Description
Ef
Effective
Jobs are accepted and then delivered to the target host.
In
Ineffective
New jobs are not accepted but the jobs that have already been accepted are delivered to the target host.
Hd
Hold
Jobs are accepted but are not delivered to the target host.
Bl
Blockade
Jobs are neither accepted nor delivered to the target host.
- DESCRIPTION
-
Indicates that the comment on the execution agent group is output in this column.