Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


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:

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

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 specified execution agent does not exist.

  • The specified execution agent group does not exist.

  • The authentication server is not running.

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.