4.15 jobschoperate command

Synopsis

jobschoperate control -prj [project name] [-sys subsystem-number](*1)

*1:: [-sys subsystem-number] is the option of Systemwalker Operation Manager EE.

Description

The jobschoperate command controls (Pause All, Continue All, Disable All, Enable All) all job nets and groups in a project.

However, the following job nets and groups are not paused, continue, disabled, or enabled and are not subject to operation.

Job nets in a group
Child job net/ring job net (job net at level from 2 to 5)
Copy destination job nets

Options

control

Specify one of the following four control items.

pause: Places all job nets and groups in a stopped state.

continue: Release the stopped state of all job nets and groups.

disable: Places all job nets and groups in a disabled state.

enable: Release the disabled state of all job nets and groups.

-prj project name

Performs batch control of job nets and groups in a specified project.

Specifies the name of the project for which you want to perform batch operations on job nets/groups. If the user who executes the jobschoperate command can operate only one project in which the job net is registered, you can omit this option.

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

Relationship between job nets/group status and operations

The relationship between the operation target status and whether the operation is enabled or disabled is shown below

Job nets

		Operations
		Pause	Continue	Disable	Enable
Job nets Status	Normally completed	A	C	A	C
	Pseudo-normal	A	C	A	C
	Abnormally ended	A	C	A	C
	Canceled	A	C	A	C
	Warning	B	C	B	C
	Running /Completion delayed	B	C	B	C
	Waiting/Execution delayed	A	C	A	C
	Paused	C	A	A	C
	Disabled	B	C	C	A
	Confirmed	A	C	A	C
	Carried over	A	C	A	C

A:Can operete
B:Cannot operete (WARNING is output)
C:Ignored

Group
Operations
Pause
Continue
Disable
Enable
Group Status
Normally completed
A
C
A
C
Pseudo-normal
A
C
A
C
Abnormally ended
A
C
A
C
Canceled
A
C
A
C
Warning
B
C
B
C
Running
B
C
B
C
Waiting
A
C
A
C
Paused
C
A
A
C
Disabled
B
C
C
A
Confirmed
A
C
A
C
```
A:Can operate
B:Cannot operate (WARNING is output)B
C:Ignored
```

	Operations
Pause	Continue	Disable	Enable
Group Status	Normally completed	A	C	A	C
Pseudo-normal	A	C	A	C
Abnormally ended	A	C	A	C
Canceled	A	C	A	C
Warning	B	C	B	C
Running	B	C	B	C
Waiting	A	C	A	C
Paused	C	A	A	C
Disabled	B	C	C	A
Confirmed	A	C	A	C

Return Values

Return value	Meaning
0	All operation targets can be operated. In the "Relationship between job nets/group status and operations" the target of the bulk operation corresponds to "A: Can operate" or "C: Ignored", indicating that all operations have been performed for the target of "A:Can operate".
1	Some operations could not be performed. In the "Relationship between job nets/group status and operations", indicates that. One or more items corresponding to "B: Cannot operate" are subject to batch operation. Or, One or more targets of the bulk operation could not be operated because of a change request or an operation request, even though they correspond to "A: Can operate". Processing is not interrupted and all controllable job nets/groups are processed. If multiple job nets and groups cannot be controlled, only one message is output.
2	An error occurred. Processing is interrupted.

Return value

Meaning

All operation targets can be operated.

In the "Relationship between job nets/group status and operations" the target of the bulk operation corresponds to "A: Can operate" or "C: Ignored", indicating that all operations have been performed for the target of "A:Can operate".

Some operations could not be performed.
In the "Relationship between job nets/group status and operations", indicates that.

One or more items corresponding to "B: Cannot operate" are subject to batch operation.
Or,
One or more targets of the bulk operation could not be operated because of a change request or an operation request, even though they correspond to "A: Can operate".

Processing is not interrupted and all controllable job nets/groups are processed. If multiple job nets and groups cannot be controlled, only one message is output.

An error occurred. Processing is interrupted.

Command Location

Windows	<Systemwalker Operation Manager installation directory>\MpWalker.JM\bin
Solaris Linux	/usr/bin

Cautions

This command simply requests the server to operate the job net. When the command execution is completed, the server does not guarantee that the operation to the job net is completed.
Therefore, the requested operation may be executed a while after this command is completed.
After entering this command, issue the jobschprint -n and jobschprint -x command to confirm the status of the job net.
If at least one of the operation target job nets/groups succeeds, the execution result of the audit log becomes SUCCESS (success).

Execution Results/Output Format

Return 0: No message is output.

Return 1,2: The error information is output to the standard error output.

Example

Example of batch stopping a project "prj1" in subsystem 1

jobschoperate pause -prj prj1 -sys 1