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

4.2.12 Job definition for monitoring message-queue message reception

This paragraph explains how to specify a job definition for monitoring reception of messages sent from a message queue.

The following gives the format of, and the parameters for a message-queue message reception monitoring job definition.
Format
[mqcor=correlation-ID;]
[mqque=message-input-queue-name;]
[mqdsc=message-ID;]
[mqmdl=model-queue-name;]
[mqsfn="message-storage-file-name";]
[jpoif=?macro-variable-name?:take-over-information-name;]
[etm=n;]
[fd=time-required-for-execution;]
[ex="execution-agent-name";]
[ha={y|n};]
[eu={ent|def};]
[ets={kl|nr|wr|an};]
 
Parameters

mqcor=correlation-ID;

Define the correlation ID of a received message.

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

mqque=message-input-queue-name;

Define the queue name of a queue to monitor message reception.

You can set a character string of 1 to 48 bytes. Specify a queue name using an MQ character string. When linking MQSeries, specify the name of a queue that exists in the default queue manager.

mqdsc=message-ID;

Define the message ID of a received message.

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

mqmdl=model-queue-name;

Define the model queue name of a queue to monitor message reception.

You can set a character string of 1 to 48 bytes. Specify a queue name using an MQ character string. When linking MQSeries, specify the name of a queue that exists in the default queue manager.

mqsfn="message-storage-file-name";

Define the name of a file that stores messages matching monitoring conditions.

You can set a character string of 1 to 256 bytes. The file name must be the full path file name.

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

jpoif=?macro-variable-name?:take-over-information-name;

Define a macro variable name in the ?AJS2xxxxxxxxx? format. That is, the character string xxxxxxxxx is preceded by AJS2 and it is entirely enclosed in a pair of question marks (?). Note that only uppercase alphabetic and numeric characters and periods (.) can be used in the xxxxxxxxx part.

You can set a character string of 1 to 64 bytes as the macro variable name, which corresponds to the ?AJS2xxxxxxxxx? part.

This parameter can contain up to 2,048 bytes in the "jpoif=?macro-variable-name?:take-over-information-name;".

This parameter makes it possible to take over event information of subsequent Unix jobs, PC jobs, and action jobs.

etm=n;

Define the time-out period using the relative minutes from the start time. You can set 1 to 1,440 minutes. This parameter is invalid for a job within the start condition.

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 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. This parameter is invalid for a job within the start condition.

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. This parameter is ignored in an event job.

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

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

ets={kl|nr|wr|an};

Define the state of the event job after the execution time-out period elapses. The default is kl. This parameter is invalid for a job within the start condition.

kl: Killed

nr: Ended normally

wr: Ended with warning

an: Ended abnormally

[Contents][Back][Next]

[Trademarks]