Instruction manual

SETENV

Set an environment variable to the speciﬁed value.

Format

status = DISPATCH(SETENV,

env_id,

buffer_ptr,

buffer_length);

Arguments

SETENV

SETENV function code (20

env_id

ID number of the environment variable.

buffer_ptr

Virtual address of the byte stream containing the value.

buffer_length

Length of the byte stream.

Description

This routine causes the environment variable associated with env_id to have the

value passed in by the user. Table 62 lists DEC 3000 AXP-supported environment

variables. If the variable does not already exist in the environment variable name

space, it is added to the list.

Returns:

R0<63:61> = 000 Success

R0<63:61> = 110 Failure, variable not recognized

R0<63:61> = 100 Failure, variable read-only

R0<60:0> Should be zero

Table 62 Environment Variable ID Numbers

ID-Name Type Description

01-$$auto_action NV Speciﬁes the action the console takes on

HALT

02-$$boot_dev NV Speciﬁes the default boot device or devices

03-$$bootcmd_dev NV Speciﬁes the boot device or devices from

which booting is to be attempted.

04-$$booted_dev T,R Speciﬁes the device which was last booted

(continued on next page)

16–70 Console