Console Commands in NetWare 5.1: SERIALVER, SET, SET TIME, SET TIME ZONE, SPEED
Articles and Tips: article
Senior Research Engineer
Novell AppNotes
01 Nov 2001
This section is one in a series that intends to describe each of the NetWare 5.1 console commands (both normal and hidden) in alphabetical order and to tell when, why, and how to use them properly. To see a list of the commands that you can perform at the server console, type HELP<Enter> at the server console prompt. To use the commands described here, simply type the command at the server console prompt followed by the <Enter> key.
SERIALVER
Object Serialization in Java refers to being able to write the complete state of an object to an output stream. This gives you the ability to recreate the object later by reading its serialized state from an input stream. Object Serialization is used in many places in Java, such as the cut and paste operation. Additionally, it is used to transfer objects between a client and server for remote class execution.
SERIALVER is a command that is used with object serialization. When you deserialize an object, it is critical to verify that the version of the class file for that object matches the version that was used to serialize it. This is done by executing a unique number for the class and encoding it to a private location in the class.
When you type SERIALVER <Enter> at the NetWare server console, you will get the following usage message:
Usage: serailver [-show] [classname...]
SERIALVER will display the version number, or serialization-unique identifier, for a class or classes. SERIALVER's output is a line of Java code, suitable for pasting into a class definition.
|
Options
|
Description
|
|
- show |
The -show command-line option causes the creation of a simple graphical interface that allows the user to type in a single classname at a time, obtaining its serializing UID. When using the -show option, no class names may be specified on the command-line. |
|
classname... |
Any number of classnames may be specified on the command-line when not using the -show option. The output will contain class names with their respective version number or serialization-unique identifier. |
SET
The NetWare server allows the setting and modifying of SET parameters, much like DOS does. The NetWare server environment has over 14 categories, each with several set commands. You have the ability to view or set current operating system parameters. Typically, most parameters do not need to be changed, however, they nay be configured to fit your situation.
There are two command-line parameters. The first is the parameter you want to modify. The second is the value to set the parameter to.
SET [parameter name] [= parameter_value]
Type SET to list the categories of server set commands.
Type SET parameter name to see the current value of a SET parameter.
Type SET parameter name = value to set the parameter name to the new value.
Edward Liebing's "Beyond the Basics" column has been covering the different SET parameters in greater detail for some months now and would be worth a look if you are interested in what each parameter means and does. Also, October's "Tips & Tricks" section contains a list of all of the new SET parameters that come with NetWare 6.
SET TIME
The SET TIME console command simply sets the NetWare server's internal clock and calendar. There are two command-line parameters:
SET TIME [month/day/year] [hour:minute:second]
The first is the date, which is displayed as month/day/year when you get help for the command (HELP SET TIME <Enter>). However, the date may be entered as day/month/year or month/day/year. You must keep the year as the third entry, as entering the year in either of the other two spaces will cause misinterpreted data.
The second is the time, which must be entered in the form hh:mm:ss. However, you can leave the seconds off if you wish.
After resetting the time, you may be prompted with the following warning:
Warning: Time synchronization is active on this server. Are you sure you want to change the time?
It's important that you have your hardware clock set (whether by DOS or another means) before you bring your server up. This will ensure that you have the least amount of time variance--especially in a multi-server environment.
If you are running eDirectory on a multi-server network, changing a secondary server's time may not be desirable because you run the risk of throwing that server into "synthetic time." Changing the time on the Primary time server can cause problems if the time is set behind any secondary servers that are getting their time from this Primary time server. You then also run the risk of throwing the servers into synthetic time.
Synthetic time occurs when time synchronization is lost because the server's local time has been set backwards. Synthetic time is the process of creating timestamps from the most recent timestamp in eDirectory. From this timestamp, the event counter increments until it reaches 65,535 events, then another second is added to time and the event counter continues to increment. This process continues until real time catches up with the synthetic time stamps being used.
You can type "N" for NO to not change the time, or "Y" or YES to go ahead and change the time anyway.
An example would be in the form of:
SET TIME November 29 2001 10:11:12 pm
To verify the server's date and time, type TIME at the server prompt and press <Enter>. Output similar to the following will appear on the server console:
Time Zone String: "MST7MDT" DST Status: ON DST Start: Sunday, April 7, 2002 2:00:00 am MST DST End: Sunday, October 28, 2001 2:00:00 am MDT Time synchronization is active Time is synchronized to the network Thursday, September 27, 2001 10:39:29 pm UTC Thursday, September 27, 2001 4:39:29 pm MDT
SET TIME ZONE
The SET TIME ZONE console command can be used to either display the server's current time zone or set the server's time zone. To display the server's current time zone, type the following on the server console:
SET TIME ZONE <Enter>
Text similar to the following will be displayed on the server's console:
Time zone is set to: MST7MDT
In order to set the server's time zone, you need to use the command's command-line parameter:
SET TIME ZONE [hour [daylight]]
An example of this would be:
SET TIME Zone MST7MDT
The following are valid Standard Time Zone Settings:
|
Time Zone
|
Standard Time Zone
|
Daylight Savings Time
|
|
"Australia, Central Time" |
CST, '-09:30' |
CSut, '+1:00' |
|
"Australia, Eastern Time" |
EST, '-10:00' |
ESuT, '+1:00' |
|
"Australia, Western Time" |
WST, '-08:00' |
WSuT, ' +1:00' |
|
"Belgium, Mid-European Time" |
MET, '-1:00' |
MEST, '+1:00' |
|
"Canada, Newfoundland Time" |
STD: NST, '+03:30' |
NDT, '+1:00' |
|
"Canada, Atlantic Time" |
AST, '+04:00' |
ADT, '+1:00' |
|
"Canada, Central Time" |
CST, '+06:00' |
CDT, '+1:00' |
|
"Canada, Eastern Time" |
EST, '+05:00' |
EDT, '+1:00' |
|
"Canada, Mountain Time" |
MST, '+07:00' |
MDT, '+1:00' |
|
"Canada, Pacific Time" |
PST, '+08:00' |
PDT, '+1:00' |
|
"England, Greenwich Mean Time" |
STD: GMT, '+00:00' |
BST, '+1:00' |
|
"France, Mid-European Time" |
MET, '-01:00' |
MEST, '+1:00' |
|
"Germany, Mid-European Time" |
MET, '-01:00' |
MEST, '+1:00' |
|
"India, Indian Time" |
IST, '-05:30' |
|
|
"Italy, Mid-European Time" |
MET, '-01:00 |
MEST, '+1:00' |
|
"Ireland, Greenwich Mean Time" |
STD: GMT, '+00:00' |
BST, '+1:00' |
|
"Japan, Japan Time" |
JST, '-09:00' |
|
|
"Luxemburg, Mid-European Time" |
MET, '-01:00' |
DAY: MEST, '+1:00' |
|
"Netherlands, Mid-European Time" |
MET, '-01:00' |
DAY: MEST, '+1:00 |
|
"New Zealand, New Zealand Time" |
STD: NZST, '-12:00' |
DAY: NZDT, '+1:00' |
|
"United Kingdom, Greenwich Mean Time" |
GMT, '+00:00' |
DAY BST, '+1:00' |
|
"United States of America, Alaskan Time" |
KST, '+09:00' |
KDT, '+1:00' |
|
"United States of America, Atlantic Time" |
AST, '+04:00 |
ADT, '+1:00' |
|
"United States of America, Central Time" |
CST, '+06:00' |
CDT, '+1:00' |
|
"United States of America, Eastern Time" |
EST, '+05:00' |
EDT, '+1:00' |
|
"United States of America, Hawaiian-Aleutian Time" |
HST, '+10:00' |
HDT, '+1:00' |
|
"United States of America, Mountain Time" |
MST, '+O7:00' |
MDT, '+1:00' |
|
"United States of America, Pacific Time" |
PST, '+O8:00' |
PDT, '+1:00' |
The time zone is composed of three elements. For example: MST7MDT is made up of:
MST = First Component 7 = Second Component MDT = Third Component
The first component indicates the type of time. In this case, MST is Mountain Standard Time. The second component is the time relative to Grenwich Mean Time (GMT), which is an international time standard. In this case, MST is +7 hours relative to GMT. The third component indicates if Daylight Savings Time is used in the time zone. In this case, MDT means Mountain Daylight Time, which is a type of Daylight Savings Time. This variable gives the NetWare server all the information it needs to change the time when Daylight Savings Time goes on and goes off.
SPEED
This console command displays the server's processor speed. If the server has more than one processor, information is displayed for each processor. This is accomplished by using special APIs that Intel provides through requesting specific version information from the processor (s). To execute the console command, type the following on the server's console:
SPEED <Enter>
The output is displayed on the server console, appearing similar to:
Processor Speed 450 MHZ, CPUID: Genuine Intel Family 6, Model 15, Stepping 2 Feature Flags 183F9FF L1 cache: 32K bytes, L2 cache: 512K bytes Current revision: 14
The following is a description of the information returned:
Processor Speed: The actual operating speed of the system processor. In this case it is 450 MHZ.
CPUID: This identifies who manufactured the processor. In this case, Intel manufactured the processor.
Family: This identifies the group or family of which the processor is a part of. In this case it is family 6, which is a specific part of the Intel Pentium family.
Model: This identifies the model of the processor. In this case, 15.
Stepping: This identifies a change to the mask used to manufacture the processor. This can occur for a variety of reasons: to fix bugs, to improve the number of good chips on a wafer, or to solve an electrical issue. Intel defines stepping in two forms. A letter change is a major revision which indicates a complete change of masks to manufacture the chip. A number change refers to a change in a subset of the masks.
For example, A1 to A2 is a change involving only one or two masks. B0 to C0 is a change to all the masks. In this case, the stepping value is 2, indicating a minor revision.
It is important to remember that you shouldn't mix steppings in a multi-processor (MPK) system. If the steppings are mismatched, your MPK system will be headed for serious problems.
Feature Flags: The feature flags denote what features of your processor are available to be used. These are all very low-level features that an operating system will typically utilize. More information about the features flags can be obtained in Intel's Instruction Set Reference for your processor model.
L1 and L2 Cache: This refers to the size of the caches available for the processor to use. The L1 cache is typically on board with the processor, while the L2 cache is usually external to the processor, but not always. This cache is used by the processor to store look-ahead instructions, and to make sure the processor is always operating as efficiently as possible. In this case, there is a L1 cache of 32K bytes and a L2 cache of 512K bytes.
Current Revision: This refers to the revision of the processor. The revision can be used, along with the model and stepping to determine the exact type of processor. The samples revision is 14.
The commands we have discussed in this column are summarized below:
|
Console Command
|
Function
|
Example
|
|
SERIALVER |
Displays the serial version UID for one or more classes so you can copy it into an evolving class. |
SERIALVER -show SERIALVER myClass yourClass |
|
SET |
View or set current operating system parameters. |
SET replace console prompt with server name = off |
|
SET TIME |
Sets the file server date and time. |
SET TIME October 9 2001 5:25:00 pm |
|
SET TIME ZONE |
Displays or sets the file server time zone. |
SET TIME ZONE SET TIME ZONE MST7MDT |
|
SPEED |
Display processor relative speed and other processor information. |
SPEED |
* Originally published in Novell AppNotes
Disclaimer
The origin of this information may be internal or external to Novell. While Novell makes all reasonable efforts to verify this information, Novell does not make explicit or implied claims to its validity.