Machine Administration Guide 2.6

4.5 apcsset (1M)

Name

apcsset - Starts or ends automatic power control, or sets schedule and operation information about power recovery.

Format

/opt/FJSVapcs/sbin/apcsset -S|-T
/opt/FJSVapcs/sbin/apcsset -l [-f] [-n]
/opt/FJSVapcs/sbin/apcsset -L [days] [-f]
/opt/FJSVapcs/sbin/apcsset -a {[-s time][-e time -t type]} schedule_date
/opt/FJSVapcs/sbin/apcsset -a -h yymmdd
/opt/FJSVapcs/sbin/apcsset -d {[-s time][-e time -t type]} schedule_date
/opt/FJSVapcs/sbin/apcsset -d -h yymmdd
/opt/FJSVapcs/sbin/apcsset -d -n num[,num*] [-y]
/opt/FJSVapcs/sbin/apcsset -D
/opt/FJSVapcs/sbin/apcsset -P [mode]
/opt/FJSVapcs/sbin/apcsset -F [mode [time] ]
/opt/FJSVapcs/sbin/apcsset -C

Function

Starts or ends power control according to the set schedule.
Also displays or sets operation information about power recovery.
The automatic power control supplies power to the machine at the specified time (-s time).
This function shuts off the power supply following the specified power-off procedure (-t type) at the specified time (-e time).
Information about power recovery includes the power recovery mode. The power recovery mode is for determining the operation on power recovery after power supply to the main unit in operation has been shut off by a cause such as a power failure.
See the following manual for information about automatic power control of the GP7000F M1000/M2000 and PRIMEPOWER 800/1000/2000.
System Console Software User's Guide

Option

The options are:

-S

Starts automatic power control.

-T

Stops automatic power control.

-l [-f] [-n]

Displays the status (start/stop) of automatic power control and the set schedule information.
Specifying the -f option displays the year in four digits.
By default, only the last two digits are displayed (ex: 00 for 2000).
Specifying the -n option displays the schedule information together with the item numbers. These item numbers are used for deletion of schedule information. The details are described in the explanation of the -d option.

-L days [-f]

Displays the planned execution of automatic power control after the current time. In days, specify the number of days for which you want to display information. If you omit days, the system displays the information for seven days.
Specifying the -f option displays the year in four digits.
By default, only the last two digits are displayed (ex: 00 for 2000).

-a

Adds an automatic power control schedule. Adding a schedule after the number of schedules reaches 1024 results in an error.

-d

Deletes an automatic power control schedule.
There are two ways to specify a schedule to be deleted.
One is to specify the same option (schedule_date) you specified when you added the schedule. The other is to use the -n [num] option to specify the item number of the schedule that was given when you displayed the schedule information by specifying the -n option. When you specify the -n [num] option, a confirmation message appears asking whether you really want to delete this schedule. If you do not want this confirmation message displayed, specify the -y option.

-D

Deletes all automatic power control schedules that are currently set.

-s time

Specify the power supply time. The format of time is HHMM.
Specify the value of HH within the range of 00 - 23, and MM within the range of 00 - 59.

-e time

Specify the power-off time. The format of time is HHMM.
Specify the value of HH within the range of 00 - 23, and MM within the range of 00 - 59.

-t type

Specify the type of power-off processing. The following two types can be specified as type.
The default setting is "norm". Specifying this option without specifying "-e" results in an error.

norm

Outputs a warning on the display and starts power-off processing three minutes after such display.
Executing the apcscancel command within these three minutes interrupts the power-off processing.

For information on the interruption of power-off processing, see the explanation of apcscancel(1M).

force

Starts power-off processing immediately.

schedule_date

Sets an automatic power control schedule.

-c yymmdd|mm1dd1-mm2dd2|dd1-dd2

Specify the dates of power-on and power-off for a specified day or days, or on a monthly basis.
If you specify this, you cannot specify "-w".

	yymmdd
		Specify the date of power-on or power-off for a specified day. If -r is specified when the date is specified in this format, an error occurs.
	mm1dd1-mm2dd2
		Specify the date of power-on or power-off on a daily basis (mm1dd1 - mm2dd2). If -r is specified when the date is specified in this format, an error occurs.
	dd1-dd2
		Specify the date of power-on or power-off on a monthly basis (dd1 - dd2). Omitting "-r" makes the system assume a schedule from dd1 to dd2 of the month when you execute the command.

-w SUN,MON,....

Specify the day of the week when the schedule is executed every week. Specify the day of the week in the following format.
For this specification, you must specify "-r".
You cannot specify "-c".
- Sunday: SUN or sun
- Monday: MON or mon
- Tuesday: TUE or tue
- Wednesday: WED or wed
- Thursday: THU or thu
- Friday: FRI or fri
- Saturday: SAT or sat

-r mm1-mm2

Specify the month (period) when the schedule is executed.
The system executes the schedule from mm1 to mm2.

-h yymmdd

Specify the date of a holiday (when power-on/off is not performed).

-F [mode [time] ]

Forcibly shuts off the power supply.
Shutdown processing starts according to the shutdown schedule for automatic power control. Even if some problem like a hang-up of the operating system interrupts this processing in progress, the operating system will be shut down.

[mode]

	enable
		Enables forced power-off.
	disable
		Disables forced power-off. The default is "disable".

[time]

Specify the timeout time in minutes within the range of 10 - 255 (minutes).
The default is 10 minutes.
If you omit the option of [mode [time]], the current settings of forced power-off are displayed.

-P [mode]

Displays or sets the power recovery mode.
If you do not specify the mode, the system displays the current power recovery mode.
You can specify one mode out of the following three:

on

After a power failure occurs and the power supply to the main unit is shut off during its operation, power is automatically supplied when the power recovers.

off

After a power failure occurs and the power supply to the main unit is shut off during its operation, power is not automatically supplied when the power recovers. You have to supply power manually or by using the automatic power control function.

auto

After a power failure occurs and the power supply to the main unit is shut off during its operation, power is automatically supplied when the power recovers within the operating time.
The operating time is the period of time between the power-on time and power-off time specified in the automatic power control schedule.

-C

Copies the settings for automatic power control set on the node where the apcsset command is executed, to all the other nodes in the cluster system established by SynfinityCLUSTER.

End status

The end status can be:
0: Normal end
1: Error in option specification
2: No root qualification
3: Main unit or hardware error
4: An existing schedule is added again or nonexistent schedule is deleted.
5: Multiple commands are executed at the same time.
6: Operation not applicable to the current status (start/stop).
7: Specified time or date is inconsistent (nonexistent or equivocal).
8: A schedule is added exceeding 1024.

• You cannot use this command unless you have root permission. You cannot execute multiple commands at the same time, either.
• To add or delete a schedule, you have to stop automatic power control.
• If you specify a value not included in the ranges of 00 - 37 and 70 - 99 as yy for yymmdd in the specification of a schedule, an error results.

  If you specify a value from 00 to 37 in yy, the year is in the 2000s.

  If you specify a value from 70 to 99 in yy, the year is in the 1900s.

  Example: 92 means 1992. 21 means 2021.

• If the date is specified in the yymmdd format, specifying a nonexistent date (February 30, for example) results in an error.
• If the date is specified in a format other than yymmdd, no error results if the specified month is 01 - 12 and specified date is 01 - 31.
• Schedule setting is implemented only for the existing dates within the specified range.
• On a holiday set by the -h option, all the other schedule settings are ignored and power-on/off is not performed.
• On a date with specific day settings specified by "-c yymmdd", all schedule settings other than the setting for holiday and the settings for the specified date are ignored.

  Except for holidays, you have to specify either the power-on time or power-off time.

• In countries where daylight saving time is used, there are nonexistent times or equivocal times at changeover from the standard time to daylight saving time or vice versa. Note this fact, and carefully specify the power-on time and power-off time to avoid inconsistencies.
• You cannot set a schedule before 00:00 on January 1st, 1970 under the standard time. Automatic power control manages schedules according to the time zone. Therefore, there is a time difference with the standard time.

  Example: If the time zone is "Japan", 09:00 of January 1st, 1970 is 00:00 of January 1st, 1970 under the standard time.

• Be careful with the interval between the power-off time and power-on time.

  If the interval is one minute or longer, no error results.

  If the interval is less than one minute, an error results and the schedule is ignored.

  Set schedules with intervals that are greater than the following value:

  Minimum schedule interval = Main unit startup time + Main unit shutdown time

  The main unit startup time means the time from the specified power-on time to completion of starting up the main unit.

  The main unit shutdown time means the time from the specified power-off time to actual power-off.

  When you finish schedule setting, use the -L days option to display the planned execution of automatic power control and verify that the actual operation is in accordance with the settings.

• If the main unit has only a single user, power-off by automatic power control is disabled.
• Automatic power control does not function when the mode switch on the operator panel of the processing unit is set to manual (or MAINTENANCE).
• If, for any of the reasons below, the system cannot be operated in accordance with the Automatic Power Control schedule setting for long periods of time, it may not run in accordance with the schedule even when the Automatic Power Control is in operation.
  • the main power was left off for a long period of time
  • only the power-off schedule is set, and the main power is normally turned on manually (no power-on schedule has been set.)
  • the system was operated for a long period of time in single user mode
• In any of the above cases, restore normal power operation by momentarily stopping the Automatic Power Control and then starting the system again.