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

ajsagtdel

Format

ajsagtdel
     [-h logical-host-name]
     {-a execution-agent-name | -g execution-agent-group-name}

Format1 (for deleting an execution agent)

ajsagtdel
     [-h logical-host-name]
     -a execution-agent-name

Format2 (for deleting an execution agent group)

ajsagtdel
     [-h logical-host-name]
     -g execution-agent-group-name

Description

Deletes an execution agent or execution agent group.

Execution privileges

This command can be executed by a user at the following JP1 permission level:

• JP1_JPQ_Admin privilege

Arguments

-h logical-host-name

Specify the logical host name of the local host on which the execution agent or execution agent group you want to delete is 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

Specify the name of an execution agent you want to delete.

You can specify a character string of 1 to 255 bytes.

-g execution-agent-group-name

Specify the name of an execution agent group you want to delete.

You can specify a character string of 1 to 255 bytes.

Notes

• Before you execute this command, use the ajsagtalt command to change the job transfer restriction status of the execution agent you want to delete to Blocked so that jobs are not executed on the agent. For details about the job transfer restriction status of an execution agent, see 5.2 Restricting job transfer in the manual Job Management Partner 1/Automatic Job Management System 3 Overview.
  Note that the job transfer restriction status of an execution agent has no effect on event jobs. Therefore, ensure that a new event job or jobnet with start conditions is not executed on the execution agent to be deleted.
  You cannot delete an execution agent on which a job (PC, UNIX, custom, action, or event job) is running. To delete an execution agent on which a job is running, you must forcibly terminate the job.
  You can use the ajsagtshow command to check for jobs that are running. For details on the ajsagtshow command, see ajsagtshow in 2. Commands.
  
• If you execute this command on a target host on which an event job or a jobnet with start conditions was executed, the target host remembers the manager host name specified in the -h option of the command. If the target host remembers the manager host name, the host performs communication with the manager host to report that the host has started or stopped. Because this communication is unnecessary, use the following procedure to delete the manager host name specified for the -h option of this command.
  To delete the manager host name remembered by the target host you want to delete:
  
  1. Check whether the target host remembers the manager host name specified in the -h option of the ajsagtdel command.
     To do this, on the target host, execute the following command:
     jpoagoec -p
     
  2. Delete the manager host specified in the -h option of the ajsagtdel command.
     Execute the following command:
     jpoagoec -d manager-host-name-specified-in-the-h-option
     
  For details on the jpoagoec command, see jpoagoec in 2. Commands.
  
• If an event job or a jobnet with start conditions is running on the target host to be deleted, do not shut down the OS or turn off the host before stopping the JP1/AJS3 service on the target host. If the OS is shut down or the host is turned off in this situation, you cannot use this command to delete the target host. You need to execute this command either after stopping the JP1/AJS3 service on the manager host (and then perform a cold start), or after deleting the information about the event job or jobnet from the target host.
  To delete the information about an event job or jobnet with start conditions that is running on the target host:
  
  1. On the manager host, stop the JP1/AJS3 service.
  2. On the manager host, confirm that there is an event job being executed on the target host or a jobnet with start conditions being monitored on the target host.
     Execute the following command:
     jpomanjobshow -h manager-host-name -a the-deleted-execution-agent-host-name
     
  3. On the manager host, delete the information about the event job being executed on the target host or a jobnet with start conditions being monitored on the target host.
     Execute the following command:
     jpomanevreset -h manager-host-name -a execution-agent-host-name -s
     For details on the jpomanjobshow command, see jpomanjobshow in 2. Commands. For details on the jpomanevreset command, see jpomanevreset in 2. Commands.
     
• 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 target host cannot be deleted because a job is being executed. The authentication server is not running. A compatible ISAM configuration is used. The specified execution agent cannot be deleted because it is connected from an execution agent group. The execution agent or execution agent group cannot be deleted because the job transfer restriction status is not Blocked.
8	An argument specified in the command is incorrect.
12	Memory became insufficient during command processing.
16	The database area is not enough. Alternatively, secondary allocation of the database area failed.
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

To delete execution agent AP1, execute the following command:

 
ajsagtdel -a AP1
 

Example 2

To delete execution agent group APG1, execute the following command:

 
ajsagtdel -g APG1

[Contents][Back][Next]

Copyright (C) 2009, 2010, Hitachi, Ltd.
Copyright (C) 2009, 2010, Hitachi Solutions, Ltd.