Job Management Partner 1/Automatic Job Management System 3 Command Reference 1

ajsagtprint

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

An environment variable used for command execution is incorrect.

The JP1/AJS3 service is not running.

The -h option is specified but the specified logical host does not exist or environment settings are incorrect.

The target host is starting operation, stopping operation, has stopped operation, or is operating in reduced mode.

The specified execution agent does not exist.

The specified execution agent group does not exist.

The authentication server is not running.

A compatible ISAM configuration is used.

8 An argument specified in the command is incorrect.

12 Memory became insufficient during command processing.

20 An attempt to access the database or shared memory failed because the access target was locked.

24 Permission to execute the command is not granted.

36

A database input or output error occurred.

An error occurred in communication with the JP1/AJS3 service or the JP1/AJS3 service does not respond.

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^#>
#,AGENT,HOST,CON-EXE,STATUS,DESCRIPTION
"A","AP1","Host1","1:00-3:00=10","Ef","Agent1"
#

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.

Ef:
Indicates that the job transfer restriction status is effective.

In:
Indicates that the job transfer restriction status is ineffective.

Hd:
Indicates that the job transfer restriction status is Hold.

Bl:
Indicates that the job transfer restriction status is Blocked.

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^#>
#,AGENT GROUP,LINK AGENT,STATUS,DESCRIPTION
"G","AGG1","AG1:1","Ef","AgentGroup1"
#

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.

Ef:
Indicates that the job transfer restriction status is effective.

In:
Indicates that the job transfer restriction status is ineffective.

Hd:
Indicates that the job transfer restriction status is Hold.

Bl:
Indicates that the job transfer restriction status is Blocked.

DESCRIPTION

Indicates that the comment on the execution agent group is output in this column.

[Contents][Back][Next]

[Trademarks]

0	Normal end.
4	An environment variable used for command execution is incorrect. The JP1/AJS3 service is not running. The -h option is specified but the specified logical host does not exist or environment settings are incorrect. The target host is starting operation, stopping operation, has stopped operation, or is operating in reduced mode. The specified execution agent does not exist. The specified execution agent group does not exist. The authentication server is not running. A compatible ISAM configuration is used.
8	An argument specified in the command is incorrect.
12	Memory became insufficient during command processing.
20	An attempt to access the database or shared memory failed because the access target was locked.
24	Permission to execute the command is not granted.
36	A database input or output error occurred. An error occurred in communication with the JP1/AJS3 service or the JP1/AJS3 service does not respond.
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.