5.2.19 Message-queue message sending job definition

This paragraph explains how to specify a definition for a message-queue message sending job.

The following gives the format of, and the parameters for a message-queue message sending job definition.

Format

[mqque=queue-name;]
[mqcor=correlation-ID;]
[mqdsc=message-ID;]
[mqprm={y|n};]
[mqmgr=queue-manager-name;]
[mqmdl=model-queue-name;]
[mqpgm=related-queue-management-program-name;]
[mqmfn=format-name;]
[mqmdn="message-data-file-name";]
[mqhld=hold-time;]
[mqpri=priority:]
[mqeqn=dead-letter-queue-name;]
[pfm={u|p};]
[etm=n;]
[fd=time-required-for-execution;]
[ex="execution-agent-name";]
[ha={y|n};]
[eu={ent|def};]
[jty={q|n};]
[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

mqque=queue-name;

Define the name of a queue to be sent the message.

You can set a character string of 1 to 48 bytes. Specify a queue name using an MQ character string.

mqcor=correlation-ID;

Define a correlation ID to be added to a send message.

You can set a character string of 1 to 24 bytes. You can, however, set only uppercase alphanumeric characters.

mqdsc=message-ID;

Define a message ID to be added to a send message.

You can set a character string of 1 to 24 bytes. You can, however, set only uppercase alphanumeric characters.

mqprm={y|n};

Define the permanence of a message to be sent. The default is n.

• y: Permanent

• n: Not permanent

mqmgr=queue-manager-name;

Define the name of a queue manager for sending the message.

You can set a character string of 1 to 48 bytes. Specify a queue manager name using an MQ character string.

mqmdl=model-queue-name;

Define the name of a model queue for sending the message.

You can set a character string of 1 to 48 bytes. Specify a model queue name using an MQ character string.

mqpgm=related-queue-management-program-name;

Define a program name for message destination queue management or a program name for queue management that allows you to identify a queue name.

You can set a character string of 1 to 48 bytes. Specify a program name using an MQ character string.

mqmfn=format-name;

Define a format to identify the format of the information in message data.

You can set a character string of 1 to 8 bytes. You can, however, set only uppercase alphanumeric characters.

mqmdn="message-data-file-name";

Define the name of a message data file to be sent as the message.

You can set a character string of 1 to 256 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.

mqhld=hold-time;

Define hold time for a message to be sent.

You can set 1 to 9,999,999 minutes.

mqpri=priority;

Define the priority of a message to be sent.

You can set 0 to 9.

mqeqn=dead-letter-queue-name;

Define the queue name of a related queue management program to which the message is to be transferred if message send processing encounters an error.

You can set a character string of 1 to 48 bytes. Specify a dead letter queue name using an MQ character string.

pfm={u|p};

Define a platform type for job execution. The default is p.

• u: UNIX environment

• p: Windows environment

etm=n;

Define the time-out period using the relative minutes from the start time. You can set 1 to 1,440 minutes.

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).

ex="execution-agent-name";

Define the name of the execution agent or execution agent group that is used to execute jobs.

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 with #. That is, use #" instead of ", and use ## instead of #.

ha={y|n};

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

• y: Suspends job execution.

• n: Does not suspend job 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.

jty={q|n};

Define the queuing attribute type. If you do not specify this option, q is assumed.

• q: The queuing attribute exists.

• n: The queuing attribute does not exist.

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.

To Page Top