Synopsis
jobschcontrol [project name/] job net name control [start option] [rerun option] [-sys subsystem-number](*1)
[-sys subsystem-number] is the option of Systemwalker Operation Manager EE.
Description
The jobschcontrol command controls (cancel/start/restart/pause/continue/disable/enable/cope/reinstate/revoke) job nets.
Options
project name
Specifies the project name to which the job net you want to control belongs. If there is only one project having job nets registered among the projects accessible for operation by the user of executing the jobschcontrol command, this option can be omitted.
job net name
Specifies the name of the job net to be controlled.
control
Specify one of the following ten control items:
Cancels the job net.
Starts the job net.
Restarts the job net that terminated abnormally, was canceled, or confirmed.
Child job nets can be restarted only when the parent job net is in the executing or warning status.
Pauses the job net.
Cancels the paused status of the job net.
Disables the job net.
Enables the disabled job net
Changes the status of abnormally ended job net to Confirmed.
If Check canceled has been specified in the Advanced Settings for Verification window (which is displayed by clicking the Details button in the Verification at error occurrence section of the Use function 1 tab of the Define Jobscheduler Startup Parameters window), then canceled job nets will also be subject to verification control.
Clear the execution result of the job net that was already executed.
Releases the carried over status of the job net.
rerun options
Only when rerun is specified in the control option, the following two control items are available. When the rerun option is omitted, this command restarts jobs, starting with the job that abnormally terminated. If a restart point is set on the job prior to the abnormally terminated job, the job net is restarted from the job on which the restart point is set.
Restarts the job net after setting the "Invalid at next restart" option for the abnormally terminated job (child job net). The abnormally terminated job (child job net) will be skipped and the subsequent job will be executed. Canceled jobs will be handled in the same manner as abnormally terminated jobs (child job nets).
Restarts the job net from the top of the jobs.
Start option
These options can be specified only if "start" has been specified for the "control" option.
Specify the variable parameter to be passed to each job in the job net to be started. If this option is specified, any "@.VPARAM@" variables in the job definitions will be replaced with the string specified for this option.
Specify the variable parameter using a string that is no more than 200 bytes long. The variable parameter should not include user-defined characters.
This option can be omitted. In this case, the "@.VPARAM@" variables in the job definitions will be replaced with an empty string before the jobs start.
The variable parameter is also passed to job nets in the second and lower levels of nested job nets (child job nets).
This option can only be specified once.
Refer to "Using variable parameters to start a job net" in the Systemwalker Operation Manager User's Guide for information about the "@.VPARAM@" variable.
-sys subsystem-number
In the system with multiple subsystems, this option is used to specify the subsystem that you want to operate. Specify the target subsystem number using a range of 0 to 9. If omitted, the default is subsystem 0.
Command Location
Windows | Systemwalker Operation Manager installation directory\MpWalker.JM\bin |
Solaris | /usr/bin |
Cautions
After entering this command, issue the jobschprint -n command to confirm the status of the job net.
This command only requests the server to operate the job net. Thus, it does not guarantee the completion of requested operation on the job net on the server side even if the command is complete. Therefore, after executing this command, it may take time to execute the requested processing on the server.
Note the following point when specifying "-p param" with the start option.
For the variable parameter, specify a string that that does not exceed the maximum number of characters and does not contain any invalid characters for the definition item that replaces the @.VPARAM@ variable in the job definitions for the job net to be started. If the job definitions become invalid as a result of replacing the variable parameters, the job will not execute and will terminate abnormally with completion code 245 or 246.
This command can only be used to pause, continue, disable, or enable master linked job nets or job nets nested therein.
When specifying the option for rerun, note the following:
When the option for rerun is specified for a child job net, the option for rerun will be ignored and jobs will be restarted, starting with the abnormally terminated job.
If the restart point has been set for a job that precedes the abnormally terminated job, the restart will begin from the job that was set as the restart point.
If the following messages are output even after you confirmed the job net completion using the jobschprint command, wait for a while and execute the command again because the messages were output due to the marginal timing issue while the job net status was transitioning to the completed status.
"The job net is already in the executing or warning state."
"The job net is already in the executing state or warning state."
"The job net cannot be reactivated, because it is not in an abnormally ended state or forced or coping."
"Cannot reinstate the job net because it is not executed today."
