SET-RESTART-OPTIONS

Control automatic restart

Component:	BS2000
Functional area:	System control and optimization
Domain:	not allocated
Privileges:	OPERATING
Routing code:	R

Function

The SET-RESTART-OPTIONS command specifies whether, and if so when, an automatic restart is to be performed. In the case of an automatic restart, the type of error documentation to be generated before the restart can also be defined.

For information on automatic restart see the “Introduction to System Administration” [14].

Format

SET-RESTART-OPTIONS                                                                                                                             

MODE = *ON(...) / *OFF
	*ON(...)
		|		DELAY = *STD / <integer 0..32767 seconds>
		|		,UPTIME = *STD / <integer 0..32767 minutes>
		|		,DUMP = *STD / *NO / *SNAP / *SLED

Operands

MODE =
Specifies whether the automatic restart is to be activated.

MODE = *ON(...)
The automatic restart is to be activated.
In the event of a system crash the system will be reloaded automatically.

DELAY =
After a system crash has been reported (NRTT501 SETS;...) it defines how much time elapses before a memory dump is taken with SLED.
This gives the operator an opportunity to intervene.

DELAY = *STD
No waiting is the default.

DELAY = <integer 0..32767 seconds>
Specifies the time in seconds to be waited before making a memory dump.

UPTIME =
Specifies a time interval in minutes after SYSTEM READY. If a system crash occurs within this time, no automatic restart is initiated.

UPTIME = *STD
The default time interval after SYSTEM READY is 10 minutes, in which time no automatic restart is to be initiated.

UPTIME = <integer 0..32767 minutes>
If a system crash occurs within the time specified in minutes after SYSTEM READY, no automatic restart is to be initiated.

DUMP = *STD / *NO / *SNAP / *SLED
Determines what type of error documentation is to be generated before an automatic restart.
The default value is *STD, i.e. the caller determines the type of error documentation. *SNAP and *SLED specify snapshot and SLED documentation respectively.

MODE = *OFF
The automatic restart is not to be activated.
Any previous SET-RESTART-OPTIONS command with MODE = *ON is ineffective, i.e. the system is not automatically reloaded after a system crash.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
2	0	EXC0750	Automatic restart must be set because of STCK error
	1	CMD0202	Syntax error or semantic error
	64	CMD0216	Caller is not privileged
	64	EXC0688	IPL disk is not a public disk