Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


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

  • n: Does not suspend jobnet 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.