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

[Contents][Glossary][Index][Back][Next]

jpqqueadd

Format

jpqqueadd
     [-mh manager-host-name]
     -q queue-name
     [-mj maximum-number-of-jobs-in-queues]
     [-wj warning-value-for-jobs-count-in-queues]
     [-en {open|close}]
     [-ex {open|close}]

Description

Adds a queue.

Execution privileges

You must have the following JP1 privilege:

Arguments

-mh manager-host-name

Specify a manager host name to which a queue is to be added.

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

By default, the system assumes the local host name.

-q queue-name

Specify a queue name you want to add.

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

Note that agent names are not case sensitive, but that queue names are.

-mj maximum-number-of-jobs-in-queues

Specify the maximum number of jobs which can be accumulated in the queue.

You can specify a value between 1 and 4,294,967,295.

If you omit this option, the system assumes 4,294,967,295.

This setting also includes the number of jobs that are actually being executed.

The number of jobs is the sum of the values of QUEUING and EXECUTING displayed by the jpqqueshow command with the -q option specified.

In spite of this setting, however, the submit process will fail if the queue still contains as many jobs as the system's maximum number of jobs.

-wj warning-value-for-jobs-count-in-queues

Specify a warning value to inform you that the number of jobs in a particular queue is nearing the maximum number of jobs that can be stored in the queue.

You can specify a value of 1 to 4,294,967,295; however, the value must be equal to, or smaller than, the value specified by the -mj option.

This setting also includes the number of jobs that are actually being executed.

The number of jobs is the sum of the values of QUEUING and EXECUTING displayed by the jpqqueshow command with the-q option specified.

By default, the system assumes the value specified in the -mj option. Without the -mj option specified, the system assumes the value of 4,294,967,295.

-en {open|close}

Specify the status of the job entrance in the queue.

By default, the system assumes open.

-ex {open|close}

Specify the status of the job exit in the queue.

By default, the system assumes open.

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.

Return values

0 Normal end
1 Invalid parameter value
2 The queue could not be added successfully owing to an internal cause of the adding requester.
5 Initialization has failed.
  • The definition of the logical host name or the environment setting contains an error.
6 Queue adding requester's insufficient memory
7 The queue adding requester encountered a logic error.
100 The manager host cannot be connected for TCP/IP communication.
  • As TCP/IP is not validly set, the manager host cannot be connected.
  • The manager host name is invalid, or the manager host process stopped.
102 The IP address could not be solved successfully by the manager host name.
200 The manager host does not accept a queue adding request.
  • The manager host is now being started, now being stopped, has stopped, or is running in the reduced-operation mode.
202 No response from the manager host
203 The queue could not be added successfully owing to an internal cause of the manager host.
206 You do not have the privilege required to add the queue.
219 The manager host is busy.
220 Insufficient manager host memory
222 A fatal error has occurred.
  • A system call error has occurred.
223 The manager host encountered a logic error.
224 You have issued a request to a host other than JP1/AJS3.
226 Invalid execution environment
232 The additional queue has the same name as an existing queue.
235 The maximum number of queue definitions has been exceeded.

[Contents][Back][Next]

[Trademarks]

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