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

4.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};]
 
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 number sign (#) 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.

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.

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.

[Contents][Back][Next]

[Trademarks]