Hitachi

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


5.2.7 QUEUE job definition

This paragraph explains how to specify a definition for a QUEUE job.

The following gives the format of, and the parameters for a QUEUE job definition.

Format
[qu="queue-name";]
[qm="host-name";]
[req="job-name";]
[sc="script-file-name";]
[prm="parameter";]
[fd=time-required-for-execution;]
[pr=n;]
[jd={nm|ab|cod};]
[wth=n;]
[tho=n;]
[abr={y|n};]
[rjs=lower-limit-of-return-codes-to-be-retried-automatically;]
[rje=upper-limit-of-return-codes-to-be-retried-automatically;]
[rec=maximum-number-of-retry-executions;]
[rei=retry-interval;]
[ts1="transfer-source-file-name-1";]
[td1="transfer-destination-file-name-1";]
[ts2="transfer-source-file-name-2";]
[td2="transfer-destination-file-name-2";]
[ts3="transfer-source-file-name-3";]
[td3="transfer-destination-file-name-3";]
[ts4="transfer-source-file-name-4";]
[td4="transfer-destination-file-name-4";]
[ha={y|n};]
[eu={ent|def};]
[mm={and|or};]
[nmg={y|n};]
[eun=name-of-the-unit-whose-end-is-being-waited-for;]
[ega={exec|execdeffer|none};]
[uem={y|n};]
Parameters
qu="queue-name";

Define the name of the queue to which a QUEUE job is submitted.

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

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

qm="host-name";

Define the JP1/AJS3 - Manager host name, JP1/NQSEXEC host name and the JP1/OJE for VOS3 host name for linkage. The default is the local host name. You can set a character string of 1 to 255 bytes. If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

req="job-name";

Define a job name to submit a QUEUE job.

You can set a character string of 1 to 63 bytes. The default is the unit name of a QUEUE job.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

sc="script-file-name";

Define an execution file name.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

prm="parameter";

Define a parameter for the execution file.

You can set a character string of 1 to 1,023 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

fd=time-required-for-execution;

Define the time-required-for-execution within which the job is expected to be terminated.

You can specify a decimal value between 1 and 1,440 (minutes).

pr=n;

Define the priority of job execution.

You can set 1 to 5. The lowest priority of execution is 1, while the highest priority is 5. The default depends on the definition of the upper-level jobnet. If this parameter is not specified, and if the pr parameter and the ni parameter of all upper-level jobnets of the job are not specified, the priority of the job is assumed to be the value specified for the DEFAULTPRIORITY environment setting parameter (If no value is specified for the DEFAULTPRIORITY environment setting parameter, then the priority is assumed to be 1). For details about the DEFAULTPRIORITY environment setting parameter, see 20.4.2(108) DEFAULTPRIORITY in the JP1/Automatic Job Management System 3 Configuration Guide.

jd={nm|ab|cod};

Define the type of end judgment. The default is cod.

If you specify a value other than cod, you cannot specify y for the abr parameter. If you specify y, the KAVS0674-E message is output, and the unit cannot be created.

  • nm: Always assumes a normal end.

  • ab: Always assumes an abnormal end.

  • cod: Normal end if the return code is below a set value.

wth=n;

Define the threshold for the end with warning.

You can set 0 to 2,147, 483, 647.

tho=n;

Define the threshold for the abnormal end.

You can set 0 to 2,147, 483, 647. The default is 0.

abr={y|n};

Define whether retrying on an abnormal end is enabled. If you omit this option, the system assumes n.

You can specify y only when you specify cod for the jd parameter.

  • y: Automatic retries are performed if an abnormal end occurs.

  • n: Automatic retries are not performed if an abnormal end occurs.

rjs=lower-limit-of-return-codes-to-be-retried-automatically;

Define the lower limit of the return codes to be retried automatically when automatic retrying is performed for an abnormal end.

You can define the lower limit only when you specify y for the abr parameter.

You can specify a value from 1 to 4,294,967,295. If you specify a value equal to or smaller than the abnormal threshold and a value greater than the upper limit of the return codes to be retried automatically, the KAVS0668-E message is output, and the unit cannot be created.

If you omit this option, the system assumes abnormal-threshold + 1 when the job is executed.

rje=upper-limit-of-return-codes-to-be-retried-automatically;

Define the upper limit of the return codes to be retried automatically if automatic retrying is performed for an abnormal end.

You can define the upper limit only when you specify y for the abr parameter.

You can specify a value from 1 to 4,294,967,295. If you specify a value equal to or smaller than the abnormal threshold and a value smaller than the lower limit of the return codes to be retried automatically, the KAVS0668-E message is output, and unit creation fails.

If you omit this option, the system assumes the maximum value (4,294,967,295) when the job is executed.

rec=maximum-number-of-retry-executions;

Define the maximum number of retry executions when automatic retrying is performed for an abnormal end.

You can specify this parameter only when you specify y for the abr parameter.

You can specify a value from 1 to 12 (times). If you omit this option, the system assumes 1.

rei=retry-interval;

Define the retry interval when automatic retrying is performed for an abnormal end.

You can specify this parameter only when you specify y for the abr parameter.

You can specify a value from 1 to 10 (minutes). If you omit this option, the system assumes 1.

ts1="transfer-source-file-name-1";

Define a full-path transfer source file name.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

td1="transfer-destination-file-name-1";

Define the name of a transfer destination file to be transferred to the agent host.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

ts2="transfer-source-file-name-2";

Define a full-path transfer source file name.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

td2="transfer-destination-file-name-2";

Define the name of a transfer destination file to be transferred to the agent host.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

ts3="transfer-source-file-name-3";

Define a full-path transfer source file name.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

td3="transfer-destination-file-name-3";

Define the name of a transfer destination file to be transferred to the agent host.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

ts4="transfer-source-file-name-4";

Define a full-path transfer source file name.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

td4="transfer-destination-file-name-4";

Define the name of a transfer destination file to be transferred to the agent host.

You can set a character string of 1 to 511 bytes.

If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.

You can specify a macro variable.

ha={y|n};

Define whether to suspend job execution. The default is n.

  • y: Suspends jobnet execution.

  • n: Does not suspend jobnet execution.

eu={ent|def};

Define the JP1 user who executes the job. The default is ent.

  • ent: The JP1 user who registered the jobnet executes the job.

  • def: The JP1 user who owns the job executes the job.

mm={and|or};

Define the wait method with respect to the specified units whose ends are being waited for.

The default is and.

  • and: Start executing at completion of all units whose ends are being waited for.

  • or: Start executing at completion of one of the units whose ends are being waited for.

nmg={y|n};

Define the behavior when there are no generations of the root jobnet for the specified unit whose end is being waited for.

The default is n.

  • y: Start executing.

  • n: Do not start executing.

eun=name-of-the-unit-whose-end-is-being-waited-for;

Define the full-path name of a unit whose end is being waited for.

To specify multiple units, repeat the parameter. You can specify a maximum of 32 units.

You can use a character string of 1 to 930 bytes as the unit name.

ega={exec|execdeffer|none};

Specify the behavior when a jobnet with start conditions is specified as the jobnet whose end is being waited for and the execution generation ends abnormally.

If you omit this option, the system assumes none.

  • exec: Start executing.

  • execdeffer: Do not start executing. However, if the execution generation is in the Skipped so not exe. status, start executing.

  • none: Do not start executing.

uem={y|n};

Specify the behavior when a jobnet with start conditions is specified as the jobnet whose end is being waited for and the monitoring generation is in the Unmonitored + Ended status.

If you omit this option, the system assumes n.

  • y: Start executing.

  • n: Do not start executing.