The command-line interface interacts with the job scheduler to submit and manipulate a batch job. It is located in the was_root/bin directory as the lrcmd.sh or lrcmd.bat script and can be started from any location in the WebSphere® cell.
Use the lrcmd script to perform the following commands:
Command | Arguments | Description | Additional Information |
---|---|---|---|
Display usage information for lrcmd. | None | This command displays usage information for the lrcmd command. | Example: lrcmd |
Submit a job to the job scheduler. | -cmd=submit -xJCL=<xjcl_filename> [-host=<host>] [-port=<port>], or -cmd=submit -job=<job_name> [-startDate=<startDate> - startTime=<startTime>] [-host=<host>] [-port=<port>] |
When an XML Job Control Language (xJCL) file
is specified, -xJCL=<xjcl_filename> specifies
the path of the xJCL to be submitted from the file system and optionally
saved. Optional arguments:
Both variations of the command return a job ID for the submitted job. |
Examples:
|
Cancel a previously submitted job. | -cmd=cancel -jobid=<jobid> [-<host>] [-port=<port>] |
This command cancels the start of a previously
submitted job, or cancels the execution of a running job. Use -jobid=<jobid> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The -cmd=status command can also be used to identify the job ID for a particular job. Optional arguments:
|
Example: lrcmd -cmd=cancel -jobid=myjob:2 -host=myLRShost -port=9083 |
Restart a job. | -cmd=restart -jobid=<jobid> [-host=<host>] [-port=<port>] |
This command restarts the start of a job. Only
jobs in restartable state can be restarted. Use -jobid=<jobid> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The -cmd=status command can also be used to identify the job ID for a particular job. Optional arguments:
|
Only a batch job associated with
batch applications can be restarted. When a batch job is canceled
using the -cmd=cancel command, its state is changed to restartable. When the job is restarted, processing resumes from the last successfully committed checkpoint. Example: lrcmd -cmd=restart -jobid=myjob:2 -host=myLRShost -port=9081 |
Purge job information. | -cmd=purge -job=<jobid> [-host=<host>] [-port=<port>] |
This command purges job information from the job scheduler and grid endpoints. The job scheduler maintains information about a job after the job has completed. The purge command permanently deletes job information from the job scheduler and grid endpoint databases. The command also purges the job log of the job. Use -jobid=<jobid> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The -cmd=status command can also be used to identify the job ID for a particular job. Optional arguments:
|
The job scheduler maintains
information about a job after the job has completed. The purge command
permanently deletes job information from the job scheduler and grid endpoint databases.
The command also purges the job log of the job. Example: lrcmd -cmd=purge -jobid=myjob:2 |
Show the status of a batch job. | -cmd=statusor -cmd=status -jobid=<jobid> [-host=<host>] [-port=<port>] |
This command displays status information about
one or more jobs in the job scheduler database. Optional argument: -job=<jobid>, if specified, indicates that only job information for the specified job is displayed. |
Examples:
|
Suspend a job. | -cmd=suspend -jobid=<jobid> -seconds=<seconds> [-host=<host>] [-port=<port>] |
This command suspends the start of a grid batch
job for the specified number of seconds. Unless manually resumed
(with lrcmd -cmd=resume, for example), the job automatically resumes
running after the specified number of seconds. Use -jobid=<jobid> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The -cmd=status command can also be used to identify the job ID for a particular job. Optional arguments: Use -seconds=<seconds> to indicate the number of seconds that the job start is suspended. If not specified, the default value of 15 seconds is used. If -seconds=0 is specified, the job does not start until manually resumed.
|
Examples: lrcmd -cmd=submit -xJCL=myxjcl.xml (returns job ID myjob:23). After job myjob:23 has begun execution, it can be suspended for five minutes (for example), with: lrcmd -cmd=suspend -jobid=myjob:23 -seconds=300 -port=81 -host=myODRHost Execution of the job can be resumed before the 5 minutes expires with: lrcmd -cmd=resume -jobid=myjob:23 |
Resume start of a previously suspended job. | -cmd=resume -jobid=<jobid> [-host=<host>] [-port=<port>] |
This command resumes start of a previously suspended
batch job. Use -jobid=<jobid> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The -cmd=status command can also be used to identify the job ID for a particular job. |
See description of -cmd=suspend. |
Display the output for a job. | -cmd=output -jobid=<jobid> [-host=<host>] [-port=<port>] |
Displays the output generated by the job scheduler and grid endpoint during the
execution of the specified job. Use -jobid=<jobid> as the ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The -cmd=status command can also be used to identify the job ID for a particular job. |
(none) |
Display the return code of a batch job. | -cmd=getBatchJobRC -jobid=<jobid> [-host=<host>] [-port=<port>] |
Displays the overall return code produced by
a grid batch job. Use -jobid=<jobid> as the ID assigned
to the job by the job scheduler. The job
ID is returned by the lrcmd -cmd=submit command that initially
submitted the job. The -cmd=status command can also be used
to identify the job ID for a particular job.
|
(none) |
Command | Arguments | Description | Additional information |
---|---|---|---|
Display usage information for lrcmd. | None | This command displays usage information for the lrcmd command. | Example: lrcmd |
Stop the execution of a previously submitted job. | -cmd=stop [-jobid=<job_id> [-host=<host>] [-port=<port>] |
This command stops the execution of a previously
submitted job when a checkpoint occurs. Use -jobid=<jobid> as the job ID assigned to the job by the job scheduler Optional
arguments:
|
Examples:
|
Show the symbolic variables that are referenced in the job definition xJCL. | -cmd=getSymbolicVariables -xJCL=<xjcl_file> [-<host>] [-port=<port>] |
This command shows the symbolic variables which
are referenced in the job definition xJCL. Use -jobid=<jobid> as the job ID assigned to the job by the job scheduler Optional
arguments:
|
Examples:
|
Save the job log. | -cmd=saveJobLog -jobid=<job_id> [-host=<host>] [-fileName=<fileName>] |
This command saves the job log associated with
the requested job identifier to the local file system. Use -jobid=<job_id> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The Use -fileName=<fileName> to indicate the name of a file on the local file system where the compressed job log data is to be saved. The file is replaced if it exists. The file name <fileName>might not contain embedded blanks. Optional arguments:
|
Examples:
|
Get job log. | -cmd=getJobLog -jobid=<job_id> |
Displays the job log associated with the requested
job identifier. Use -jobid=<job_id> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. Optional arguments:
|
Examples:
|
Purge job log |
-cmd=getJobLog -jobid=<job_id> -logTimeStamp=<logTimeStamp> |
Removes the job log associated with the requested
job identifier and log time stamp. A job log entry remains in, for
example: /opt/IBM/WebSphere/AppServer/profiles/scheduler/joblogs/PostingsSampleEar_99/14022007_164535/part.0.log.
The entry tracks the reason why the job log was removed.
|
Examples:
|
Display the job log metadata for the requested job identifier. | -cmd=getLogMetaData -jobid=<job_id> |
The job log metadata indicates the log time
stamps associated with the requested job identifier. The metadata
or time stamp identifies a unique instance of the job. Logs from
multiple different jobs with the same job number can exist. Use -jobid=<job_id> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. |
Examples:
|
Display the job log part list. | -cmd=getLogPartList -jobid=<job_id> -logTimeStamp=<logTimeStamp> |
Displays the job log part list associated with
the requested job identifier and log time stamp. Use the command getLogMetaData to
return a timestamp to use with -logTimeStamp=<timestamp>. Use -jobid=<job_id> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. |
Examples:
|
Display the job log part. | -cmd=getLogPart -jobid=<job_id> -logTimeStamp=<logTimeStamp> -logPart=<logPart> |
Displays the job log part associated with the
requested job identifier, log time stamp, and log part. Use -jobid=<job_id> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. Use -logTimeStamp=<logTimeStamp>to indicate the time stamp (the subdirectory name), which identifies the job log whose part list information is to be returned. The time stamp is returned by -cmd=getLogMetaData. Use -logPart=<logPart> to indicate the portion of the job log associated with the requested job identifier and time stamp to be returned. The log part information is returned by -cmd=getLogPartList. |
Examples:
|
Display the size of the job log associated with the requested job identifier. | -cmd=getLogSize -jobid=<job_id> -logTimeStamp=<logTimeStamp> |
This command returns the size of the job log
in bytes. Use -jobid=<job_id> as the job ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. Use -logTimeStamp=<logTimeStamp> to indicate the time stamp; that is, the subdirectory name, which identifies the job log whose part list information is to be returned. The time stamp is returned by -cmd=getLogMetaData. |
Examples:
|
Return the age of the job log in the seconds since it was last modified. | -cmd=getLogAge -jobid=<job_id> -logTimeStamp=<logTimeStamp> |
Displays the age of the
Use -jobid=<jobid> as the ID assigned to the job by the job scheduler. The job ID is returned by the lrcmd -cmd=submit command that initially submitted the job. The -cmd=status command can also be used to identify the job ID for a particular job. Use -logTimeStamp=<logTimeStamp>to indicate the time stamp; that is, the subdirectory name, which identifies the job log whose part list information is to be returned. The time stamp is returned by -cmd=getLogMetaData. |
Examples:
|
Example of retrieving output of a batch job:
lrcmd -cmd=output -jobid=mybatchjob:63 -host=myLRSHost -port=9081
CWLRB4940I: com.ibm.websphere.batch.wsbatch : -cmd=output -jobid=mybatchjob:63 CWLRB5000I: Wed Jun 15 17:55:36 EDT 2005 : com.ibm.websphere.batch.wsbatch : response to output CWLRB1740I: [Wed Jun 15 17:55:36 EDT 2005] Job [mybatchjob:63] is in job setup. CWLRB1760I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] is submitted for execution. CWLRB2420I: [Wed Jun 15 17:55:37 EDT 2005] Job [mybatchjob:63] Step [Step1] is in step setup. CWLRB2440I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] is dispatched. CWLRB2460I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] is in step breakdown. CWLRB2600I: [Wed Jun 15 17:55:38 EDT 2005] Job [mybatchjob:63] Step [Step1] completed normally rc=0. CWLRB2420I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Step [Step2] is in step setup. CWLRB2440I: [Wed Jun 15 17:55:39 EDT 2005] Job [mybatchjob:63] Step [Step2] is dispatched. CWLRB2460I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Step [Step2] is in step breakdown. CWLRB2600I: [Wed Jun 15 17:55:40 EDT 2005] Job [mybatchjob:63] Step [Step2] completed normally rc=4. End