Syntax diagram for J2EE jms job type

Purpose

If you set JOBTYPE to (/j2ee/jms), you can run an existing j2ee jms class:

This section provides detailed information about the syntax diagram for the j2ee jms job type.

Format


1  JOBREC?  AUTHALIAS (  authentication alias )  CONNFACTORY (  connection factory )  DESTINATION (  message destination )?  INVOKEYTYPE (
2.1! DIRECT
2.1 INDIRECT
1 )?  JOBPWD (
2.1! NO
2.1 YES
2.1 AGENT
1 )  JOBTYPE (
2.1 /j2ee/jms
1 )?  JOBUSR (  user name )?  MESSAGE (  message )?  WSNAME (  workstation name )

Parameters

AUTHALIAS(authentication alias)
The Java Authentication and Authorization Service (JAAS) authentication alias. This keyword is valid only if you set INVOKEYTYPE to (DIRECT).
CONNFACTORY(connection factory)
The administered object that a client uses to create a connection to the Java Messaging Service (JMS) provider. This keyword is required.
DESTINATION(message destination)
The administered object that encapsulates the identity of a message destination, which is where messages are delivered and consumed. This keyword is required.
INVOKEYTYPE(INDIRECT|DIRECT)
The type of scheduling. This keyword is valid only if you set JOBTYPE to (/j2ee/jms). Allowed values are:
INDIRECT
HCL Workload Automation for Z uses an existing WebSphere® Application Server scheduling infrastructure already configured on an external WebSphere® Application Server.
DIRECT
HCL Workload Automation for Z immediately forwards the job to the components of the external WebSphere® Application Server instance.
JOBPWD(YES|NO|AGENT)
Specifies if the user name entered in JOBUSR or set by using the job-submit exit EQQUX001 is associated with a password.

If you set JOBPWD to YES, HCL Workload Automation for Z searches for the user password in the USRPSW keyword of the USRREC initialization statement .

If you set JOBPWD to AGENT, this means that the password is resolved locally on the agent. The password must have been defined on the agent by issuing the param command. This feature is available independently of the operating system of the workstation.

Typically, the password is required for users who schedule jobs to run on Windows workstations. Set JOBPWD to NO if the user works with UNIX workstations and if no password is required.

JOBTYPE(/xajob/access method name|/j2ee/jms|/web service|/file transfer|/database|/java)
To run a j2ee jms job, specify /j2ee/jms. For information about the other types of job, see the specific section for each job type. This keyword is required.
/j2ee/jms
Set this value to submit a Java Messaging Service (JMS) job.
JOBUSR(user name)
The user name for accessing WebSphere Application Server, if required.
If the user schedules jobs to run on Windows workstations, ensure that a user password is also defined (see the JOBPWD keyword).
  • If you are defining a Windows domain user, use the following format:
    JOBUSR(domainName\user1)
  • If you are defining a Windows user in the username@internet_domain format, use the following format:
    JOBUSR('administrator@mywindom.com')

To specify the user name, you can also use the job-submit exit EQQUX001. This user name overrides the value specified for JOBUSR. In turn, the value specified for JOBUSR overrides the value specified for USRNAM in the USRREC statement.

MESSAGE(message)
The object that is sent from one application to another.
WSNAME(workstation_name)
The name of the workstation from which user name and password must be retrieved. User name and password can be specified in the statement, using the JOBUSR and JOBPWD keywords, or can be associated to a workstation with the USRREC statement. With the WSNAME keyword, you can specify a workstation where the user name and password are stored, which is different from the workstation where the job runs.

Examples

The following is an example of a JOBREC statement to submit a JMS job:
//JOBREC                   
JOBTYPE(/j2ee/jms)         
INVOKEYTYPE(DIRECT)        
CONNFACTORY(jms/MyCF)      
DESTINATION(jms/MyQueue)   
MESSAGE(This is my message)
JOBUSR(administrator)      
JOBPWD(YES)                
//END JOBREC