CHGPWRSCDE (Change Power On/Off Schedule Entry)

CHGPWRSCDE Command syntax diagram

 

Purpose

The Change Power On/Off Schedule Entry (CHGPWRSCDE) command is used to change the system's power on/off schedule. The user can change power-on or power-off default values for the days of the week or change the values for a particular day. The user can also change or set the time the system sends a message that warns users of an impending power off. The changes the user makes in the power on/off schedule are effective immediately.

Restriction: The user of this command must have *ALLOBJ and *SECADM special authority and authority to the Power Down System (PWRDWNSYS) command.

 

Required Parameters

DAY

Specifies the day or days for which the user wants to change the power on/off schedule.

*TODAY: The schedule for the current date is changed.

*ALL: The default values for all days of the week are changed.

*DAY-OF-WEEK: The default values for the specified day of the week are changed.

date: Specify the date to be changed. The date must be specified in the format defined by the job.

 

Optional Parameters

PWRONTIME

Specifies the power-on time.

*SAME: The value does not change.

*NONE: No power-on time or default power-on time is set.

*DFT: The power-on time for the date being changed is set to the default value for the day of the week on which the date occurs. This value is allowed only if *TODAY or a specific date is specified on the DAY parameter.

time: Specify the power-on time. The time is specified in 24-hour format with or without a time separator as follows:

• With a time separator, specify a string of 5 or 8 digits, where the time separator for the job separates the hours, minutes, and seconds. If you issue this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command fails.
  
• Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Valid values for hh range from 00 through 23. Valid values for mm and ss range from 00 through 59.

PWROFFTIME

Specifies the power-off time.

*SAME: The value does not change.

*NONE: No power-off time or default power-off time is set.

*DFT: The power-off time for the date being changed is set to the default value for the day of the week on which the date occurs. This value is allowed only if *TODAY or a date is specified on the DAY parameter.

time: Specify the power-off time. See the PWRONTIME parameter for a description of time formats.

DAYDESC

Specifies the description for the day. The user can enter an explanation of the day's power on/off schedule. This parameter is allowed only if *TODAY or a date is specified on the DAY parameter.

*SAME: The value does not change.

'description': Specify up to 38 characters of text for an explanation of the day's power on/off schedule.

MSGITV

Specifies the number of minutes before the scheduled power off that a message is sent to all work stations warning users of the impending power off. This parameter is allowed only if DAY(*ALL) is specified.

*SAME: The value does not change.

*DFT: A message is sent 30 minutes prior to the power off.

message-interval: Specify the message interval. Valid values range from 0 through 60 minutes.

Examples for CHGPWRSCDE

Example 1: Changing the Schedule For An Entire Week

CHGPWRSCDE   DAY(*ALL)  PWRONTIME(0800)
  PWROFFTIME(1800)
CHGPWRSCDE   DAY(*SAT)  PWRONTIME(*NONE)
  PWROFFTIME(*NONE)
CHGPWRSCDE   DAY(*SUN)  PWRONTIME(*NONE)
  PWROFFTIME(*NONE)

These commands set the power on and power off values for an entire week.

Example 2: Changing the Power-Off Time

CHGPWRSCDE   DAY('01/22/90')  PWROFFTIME(2000)
CHGPWRSCDE   DAY('01/22/90')  PWROFFTIME(2000)
 PWRONTIME(*SAME)

Either of these commands is used to set the power-off time to 8 p.m. on January 22, 1990.

Example 3: Changing the Power-On Time

CHGPWRSCDE   DAY(012590)  PWRONTIME(060000)
  PWROFFTIME(*NONE)

This command sets the power-on time to 6 a.m. for January 25, 1990 and sets no power-off time.

Example 4: Changing Back to the Defaults

CHGPWRSCDE   DAY(012590)  PWROFFTIME(*DFT)
  PWRONTIME(*DFT)

This command sets the power on and off times for January 25, 1990 back to the defaults for that day of the week.

Error messages for CHGPWRSCDE

*ESCAPE Messages

CPF1E2A

Unexpected error in QSYSSCD job.

CPF1E2B

Power scheduler and cleanup options not found.

CPF1E2C

Error occurred scheduling next power on and off.

CPF1E23

Power schedule or cleanup options in use by another user.

CPF1E26

Cannot change a date or a time that has passed.

CPF1E27

Not authorized to change power on/off schedule.

CPF1E99

Unexpected error occurred.

CPF2105

Object &1 in &2 type *&3 not found.

CPF9808

Cannot allocate one or more libraries on library list.