ADD-CHANGE-DATE

Define a new changeover time

Component:	BS2000
Functional area:	System control and optimization
Domain:	SYSTEM-MANAGEMENT
Privileges:	TSOS

Function

The ADD-CHANGE-DATE command defines a new future changeover time from standard daylight time to daylight saving time (and vice versa).

A valid GTIME parameter set with consistent changeover times for the past is required, see the “Introduction to System Administration” [14].

The new changeover time must satisfy the following conditions:

• It must be later than all changeover times which have already been defined

• It may not be within the next hour

• It must be at least 4 to 8 months later than the previous changeover time

The ADD-CHANGE-DATE command defines the new changeover time for the current session. If required, also enter the new changeover time in the GTIME parameter set of the startup parameter file so that it is valid for future sessions.

Format

ADD-CHANGE-DATE                                                                                                                                    

DATE = <date>

,TIME = <time>

Operands

DATE = <date>
Date of the new changeover time.

TIME = <time>
Time of day of the new changeover time in the format hh:mm.
No seconds may be specified.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed
	1	CHD0010	Syntax error in the command
	32	CMD0221	System error in the command
	64	CHD0011	Semantic error in the command

Note

Subsequently, inserting or deleting a changeover time can alter wait times that have already started and will end after the changeover time. Examples:

• An already accepted ENTER job is started one hour too early or too late if its start time lies after the changeover time.

• An already started /WAIT-EVENT waits an hour too short or too long if its wait time ends after the changeover time.