5.2.23 Remote power control job definition
This paragraph explains how to specify a remote power control job definition.
The following gives the format of, and the parameters for a remote power control job definition.
- Format
[pwrh="target-host-name";] [pwrf={o|m|r|f|p|s};] [pwrn={n|a|c:[mm/dd.]hh:mm};] [pwrr={y|n};] [pwrw={y|n};] [pwrp={p|u};] [pfm={u|p};] [etm=n;] [fd=time-required-for-execution;] [ex="execution-agent-name";] [ha={y|n};] [eu={ent|def};] [jty={q|n};] [mm={and|or};] [nmg={y|n};] [eun=name-of-the-unit-whose-end-is-being-waited-for;] [ega={exec|execdeffer|none};] [uem={y|n};]
- Parameters
-
- pwrh="target-host-name";
-
Define the name of the JP1/Power Monitor agent host subject to power control.
You can set a character string of 1 to 255 bytes.
If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character by #. That is, use #" instead of " and use ## instead of #.
You can specify a macro variable.
- pwrf={o|m|r|f|p|s};
-
For the JP1/Power Monitor agent host, define the type of request for how to terminate the monitor application when the system terminates. The default is p if you specify p in pwrp, or m if you specify u in pwrp.
-
o: Turns on power.
-
m: Monitored termination. You can specify this only when pwrp=u; is specified.
-
r: Restrictive termination. You can specify this only when pwrp=u; is specified.
-
f: Kill
-
p: Planned termination. You can specify this only when pwrp=p; is specified.
-
s: Forced stop
-
- pwrn={n|a|c:[mm/dd.]hh:mm};
-
Define the time when the JP1/Power Monitor agent host will be turned on next. The default is a.
-
n: Does not set the next power-on time.
-
a: Validates the next power-on time that is set in the JP1/Power Monitor agent host.
-
c:[mm/dd.]hh:mm: Specify the next power-on time.
mm: You can set 1 to 12 for the month.
dd: You can set 1 to 31 for the day.
hh: You can set 0 to 23 for the hours.
mm: You can set 0 to 59 for the minutes.
-
- pwrr={y|n};
-
Define whether to restart the JP1/Power Monitor agent host after it is shut down. The default is n.
-
y: Restarts the agent host.
-
n: Does not restart the agent host.
-
- pwrw={y|n};
-
Define whether to wait for completion of the turning off the JP1/Power Monitor agent host before terminating the remoter power control job. The default is n.
-
y: Waits for the system to end.
-
n: Does not wait for the system to end.
The end of power-off means that the JP1/Power Monitor on the agent host reports the start of a shutdown to the manager host of the JP1/Power Monitor.
-
- pwrp={p|u};
-
Specify the type of platform for the target JP1/Power Monitor host (agent) responsible for performing power control using the remote power control job. The default is p.
-
p: Controls the JP1/Power Monitor agent host in Windows.
-
u: Controls the JP1/Power Monitor agent host in UNIX.
-
- pfm={u|p};
-
Define a platform type for job execution. The default is p.
-
u: UNIX environment
-
p: Windows environment
-
- etm=n;
-
Define the time-out period using the relative minutes from the start time. You can set 1 to 1,440 minutes.
- 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 or execution agent group that is used to execute jobs.
You can set a character string of 1 to 255 bytes.
If you want to use a double quotation mark (") or a hash mark (#) as a character, prefix the character with #. That is, use #" instead of ", and use ## instead of #.
If the job has the queuing attribute (jty=q), you can specify a macro variable.
- ha={y|n};
-
Define whether to suspend job execution. The default is n.
-
y: Suspends job execution.
-
n: Does not suspend job execution.
-
- eu={ent|def};
-
Define the JP1 user who executes the job. The default is ent.
-
ent: The JP1 user who registered the jobnet executes the job.
-
def: The JP1 user who owns the job executes the job.
-
- jty={q|n};
-
Define the queuing attribute type. If you do not specify this option, q is assumed.
-
q: The queuing attribute exists.
-
n: The queuing attribute does not exist.
-
- mm={and|or};
-
Define the wait method with respect to the specified units whose ends are being waited for.
The default is and.
-
and: Start executing at completion of all units whose ends are being waited for.
-
or: Start executing at completion of one of the units whose ends are being waited for.
-
- nmg={y|n};
-
Define the behavior when there are no generations of the root jobnet for the specified unit whose end is being waited for.
The default is n.
-
y: Start executing.
-
n: Do not start executing.
-
- eun=name-of-the-unit-whose-end-is-being-waited-for;
-
Define the full-path name of a unit whose end is being waited for.
To specify multiple units, repeat the parameter. You can specify a maximum of 32 units.
You can use a character string of 1 to 930 bytes as the unit name.
- ega={exec|execdeffer|none};
-
Specify the behavior when a jobnet with start conditions is specified as the jobnet whose end is being waited for and the execution generation ends abnormally.
If you omit this option, the system assumes none.
-
exec: Start executing.
-
execdeffer: Do not start executing. However, if the execution generation is in the Skipped so not exe. status, start executing.
-
none: Do not start executing.
-
- uem={y|n};
-
Specify the behavior when a jobnet with start conditions is specified as the jobnet whose end is being waited for and the monitoring generation is in the Unmonitored + Ended status.
If you omit this option, the system assumes n.
-
y: Start executing.
-
n: Do not start executing.
-