 |
HP OpenVMS System Management Utilities Reference
Manual
CALCULATE
Calculates values you can use with SET commands to control OpenVMS
Cluster communications. Currently, this command calculates the window
size that can be used with the SET VC /WINDOW=TRANSMIT_SIZE=value and
SET VC /WINDOW=RECEIVE_SIZE=value commands.
Parameters for calculating other values might be added in future
releases.
Format
CALCULATE Parameter
Parameters
WINDOW_SIZE
Calculates a VC window size based on distance and aggregate line speed
between two nodes.
Qualifiers
/SPEED=linespeed
Supplies the total speed in Megabits/Sec. of all LAN connections
between two nodes to be used in calculating the window size.
/DISTANCE=KILOMETERS [or =MILES]=distance
Supplies the distance in kilometers or miles of the cable route between
two nodes to be used in calculating the window size.
/OPTIMIZE=LOCKING [or =IO]=distance
Supplies the calculation with the type of intersite cluster
communications to be optimized as follows:
- LOCKING indicates that the window size is to be optimized for lock
messages that are relatively small, or for ICC communications using
message sizes of up to a few hundred bytes.
- IO indicates that the window size is to be optimized for MSCP
served IO, or for ICC communications using large messages.
Examples
| #1 |
SCACP> CALCULATE WINDOW_SIZE /SPEED=1000/DISTANCE=KILOMETERS=500
|
The command in this example calculates the window size to be used
between two nodes that are 500 kilometers apart, connected by a
1Gigabit/Second line speed. The command produces output similar to the
following:
Calculate Window Size 2-JUN-2006 17:49:18.41:
Inter-node link DISTANCE: 500 KILOMETERS
Inter-node link SPEED: 1000 Mb/s
------------------------ ------------------
Recommended WINDOW SIZE: 1024 frames
|
Note that the calculated window size is never smaller than the window
size PEdriver automatically selects for the VC between two nodes, which
is based solely on the reported local and remote line speeds. However,
the calculated value is often larger because it includes packets stored
in the inter-site link and the packet-size mix that the /OPTIMIZE
qualifier enforces.
EXIT
Stops execution of SCACP and returns control to the DCL command level.
You can also enter Ctrl/Z at any time to exit.
Format
EXIT
Parameters
None.
Qualifiers
None.
Example
This command stops execution of SCACP and returns control to the DCL
command level.
HELP
Provides online help information about the SCACP utility.
Format
HELP [topic]
Parameter
topic
Specifies a subject for which you want information: an SCACP command or
a command plus a command keyword. If you enter the HELP command with a
command name only, such as HELP SET, SCACP displays a list of all of
the command keywords used with the SET command.
Qualifiers
None.
Example
The HELP command in this example displays information about the SET
TRACE command.
RELOAD
This results in PEdriver refreshing the IP unicast address in
PE$IP_CONFIG.DAT file and transmits hello packet based on the list.
This is used in IP clusters when a node is added to a cluster and IP
unicast is used for cluster communication. All the existing members
must have the IP address of new nodes for the node to join the cluster.
This rule is applicable only if the new node has only IP channels for
cluster communication.
Format
RELOAD
Parameters
None.
Qualifiers
None.
SET CHANNEL
Sets CHANNEL management parameters, currently limited to priority
values.
Note
If a LAN device/IP interface is disabled for use by cluster
communications, all channels associated with that device/interface are
deleted. This means that all management settings for that device and
its associated channels will be deleted.
|
Format
SET CHANNEL nodename
Parameter
nodename[,...]
Includes channels to specific nodes, which you can use wildcards to
specify. Each node name can be accompanied by optional qualifiers to
specify local and remote device names. If no local or remote device
name is specified, all channels to the specified node name are included.
Use the SHOW CHANNEL command to display node names and local and remote
device names.
Qualifiers
/EXCLUDE=(nodename[,...])
Excludes channels to specific nodes, which you can use wildcards to
specify. Each node name can be accompanied by optional qualifiers to
specify local and remote device names. If no local or remote device
name is specified, all channels associated with the specified node are
included.
/LOCAL_DEVICE=(landevicename/IPinterfacename[,...])
Specifies a LAN device/IP interface that identifies the local end of
the channel; you can use wildcards to specify LAN devices/IP interfaces.
Use the SHOW CHANNEL command to display node names and local and remote
device names, or use the SHOW LAN_DEVICE/SHOW IP_INTERFACE command to
display device names.
/PRIORITY=n
Sets the management priority value for channels to selected nodes.
n can be a value between -128 and +127. Suggested values are:
2 to cause channels to be preferred
-2 to exclude channels
Note
A channel whose priority is -128 is not used for cluster communicati
ons. The priority of a LAN channel is the sum of the management
priority assigned to the local LAN device and the channel itself.
Similarly the priority of IP channel is the sum of the management
priority assigned to local IP interface and channel itself. Therefore,
you can assign any combination of channel and LAN/IP device management
priority values to achieve a total of -128.
|
Caution
If you set the priority of all channels to -128, you totally disable
use of the LAN/IP for cluster communication. This can cause the system
to CLUEXIT.
|
/REMOTE_DEVICE=(landevicename/IPinterfacename[,...])
Specifies a LAN device/IP interface that identifies the remote end of
the channel; you can use wildcards to specify LAN/IP devices.
Use the SHOW CHANNEL command to display node names and local and remote
device names, or use the SHOW LAN_DEVICE/SHOW IP_INTERFACE command to
display device names.
Use the SHOW LAN_DEVICE/SHOW IP_INTERFACE command on the remote node to
display remote device names.
Examples
| #1 |
SCACP> SET CHANNEL/PRIORITY=3 NODE5
|
The command in this example sets the priorities of all channels to node
NODE5 to 3.
| #2 |
SCACP> SET CHANNEL/LOCAL=EWA/REMOTE=EWB -
_SCACP> NODE10,NODE15/L=F*/R=F*,NODE20/PRIORITY=10
|
The command in this example is equivalent to the following command:
SET CHANNEL NODE10/L=EWA/R=EWB,NODE15/L=F*/R=F*,NODE20/L=*/R:*/PRIORITY=10
|
This command sets the priority of the following channels to 10:
- To node NODE10, the channel with local LAN device EWA and remote
device EWB
- To node NODE15, the channels with local LAN devices starting with F
and remote LAN devices starting with F
- All channels to node NODE20
| #3 |
SCACP> SET CHANNEL/LOCAL=WE0/REMOTE=IE0/PRIORITY=10 NODE20
|
This command sets priority of IP channel whose local interface is WE0
and remote interface is IE0 to 10.
Note
A node can have both LAN and IP channels with a remote node. In such a
scenario, by default, the PEdriver uses LAN channel for cluster
communications. However, you can override this by using SET
CHANNEL/PRIORITY and assign a higher priority to IP channels over LAN
channels.
|
SET CIRCUIT
Sets the circuit management priority value.
Note
If a circuit is closed, it is deleted. This means that the management
settings for that circuit are also deleted. If the circuit is opened
again, it has the default values for its management settings.
|
Format
SET CIRCUIT nodename
Parameter
nodename[,...]
Names a circuit or circuits to specific nodes, which you can use
wildcards to specify. You can qualify each node name with additional
parameters to uniquely identify a single circuit.
Qualifiers
/EXCLUDE=(nodename[/PORT=portname[/RSTATION=n]][,...])
Allows you to exclude a specific circuit to a node. If multiple
circuits to the same node exist, you can use the /PORT and /RSTATION
qualifiers to uniquely identify the circuit.
/PORT=portname[/RSTATION=n]
If multiple circuits to the same node exist, you can use the /PORT and
/RSTATION qualifiers to uniquely identify the circuit. You can use the
/RSTATION qualifier only in conjunction with the /PORT qualifier.
Example
|
SCACP> SET CIRCUIT CLUIO1 /PORT=PIB0 /PRI=10
|
The command in this example sets the priority of the circuit to node
CLUIO1 through PIB0 to 10. You need to use the /PORT qualifier if
multiple circuits to node CLUI01 exist and only the circuit through
PIB0 is meant to have its priority raised.
SET IP_INTERFACE
Sets IP interface management priority parameter.
Format
SET IP_INTERFACE ipinterface
Parameter
ipinterface[,...]
Includes one or more specific IP interface, which you can use wildcards
to specify.
- Use the /EXCLUDE qualifier to exclude an IP interface.
- Use the SHOW IP_INTERFACE command to display device names.
Qualifiers
/EXCLUDE=(ipinterface1[,...])
Excludes one or more specific IP interface which you can use wildcards
to specify.
/PRIORITY=n
Sets the management priority value for the selected interfaces.
n can be a value between -128 and +127. Suggested values are:
- 2 to cause devices to be preferred
- -2 to exclude devices
Note
A channel whose priority is -128 is not used for cluster
communications. The priority of a channel is the sum of the management
priority assigned to the IP interface and the channel itself.
Therefore, you can assign any combination of channel and IP interface
management priority values to achieve a total of -128.
|
Caution
If you set the priority of all devices to -128, you totally disable use
of the IP for cluster communication. This can cause the system to
CLUEXIT.
|
Example
|
SCACP> SET IP_INTERFACE/PRIORITY=3 WE0
|
The command in this example sets the management priority for device WE0
to 3.
SET LAN_DEVICE
Sets device management priority parameter.
Format
SET LAN_DEVICE landevicename
Parameter
landevicename[...,]
Includes specific LAN devices, which you can use wildcards to specify.
Use the /EXCLUDE qualifier to exclude LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
Qualifiers
/EXCLUDE=(landevicename1[,...])
Excludes one or more specific LAN devices, which you can use wildcards
to specify.
/PRIORITY=n
Sets the management priority value for the selected devices. n
can be a value between -128 and +127. Suggested values are:
- 2 to cause devices to be preferred
- -2 to exclude devices
Note
The channel whose priority is -128 is not used for cluster
communications. The priority of a channel is the sum of the management
priority assigned to the local LAN device and the channel itself.
Therefore, you can assign any combination of channel and LAN device
management priority values to achieve a total of -128.
|
Caution
If you set the priority of all devices to -128, you totally disable use
of the LAN for cluster communication. This can cause the system to
CLUEXIT.
|
Example
|
SCACP> SET LAN_DEVICE/PRIORITY=3 EWA
|
The command in this example sets the management priority for device EWA
to 3.
SET PORT
Sets a port management priority value.
Format
SET PORT portname
Parameter
portname[,...]
Specifies SCA port names, in which you can include wildcards.
Use the /EXCLUDE qualifier to exclude specific ports.
Use the SHOW PORT command to display all ports available on your system.
Qualifiers
/EXCLUDE=(portname[,...])
Excludes specific ports from the operation.
/PRIORITY=n
Sets the management priority value for the selected ports. n
can be any value between -128 and +127.
Examples
| #1 |
SCACP> SET PORT PEA0/PRIORITY=5
|
The command in this example sets the management priority for the PEA0
port to 5.
| #2 |
SCACP> SET PORT PEA0 /PRIORITY=5 /EXCLUDE=PEA0
|
The command in this example sets all ports with the exception of PEA0
to a management priority of 5.
SET TRACE
SET TRACE sets or modifies PEdriver tracing parameters.
Note
This command is reserved for use by HP Services and OpenVMS Engineering
only. Trace commands and output are subject to change from release to
release.
|
Format
SET TRACE nodename
Parameter
nodename[,...]
Includes channels and VCs to specific nodes, which you can use
wildcards to specify. Each node name can be accompanied by optional
qualifiers to specify local and remote device names.
If no local or remote device name is specified, all channels associated
with the specified node are included, as well as the VC to the
specified node.
Use the SHOW CHANNEL command to display node names and local and remote
device names.
Qualifiers
/AFTER=n
After the trace stop condition has been satisfied, continue tracing for
n events, and then stop. If you do not specify /AFTER, tracing
does not continue after the trace stop event. n can be any
value between 0 and FFFFFFF.
/DEFAULT
Sets the trace context back to the default settings, which are:
trace all channels and VCs
/AFTER=0
/EVENT=default settings
/STOP
/SIZE=512
|
/EVENT=(event1[,...])
Enables tracing on specific events, which you can use wildcards to
specify. The default is a subset of the events, which includes most
errors and state changes when the system parameter SYSTEM_CHECK is set
to 0. The default is "all events included" when SYSTEM_CHECK
is set to 1.
Use the SHOW TRACE/CONTEXT command to display event names.
/EXCLUDE=(nodename[/LOCAL_DEVICE=landevicename/ipinterfacename]
[/REMOTEDEVICE=landevicename/ipinterfacename][,...])
Excludes VCs or channels, or both, to specific nodes, which you can use
wildcards to specify. Each node name can be accompanied by optional
qualifiers to specify local and remote device names. If no local or
remote device name is specified, the VC and all channels associated
with the specified node are excluded.
/LOCAL_DEVICE=(landevicename/ipinterfacename[,...])
Includes specific LAN devices that identify the local end of the
channel. You can use wildcards to specify LAN devices.
/REMOTE_DEVICE=(landevicename/ipinterfacename[,...])
Includes specific LAN devices that identify the remote end of the
channel; you can use wildcards to specify LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
/STOP=(event1[,...])
Stops tracing on specific events, which you can use wildcards to
specify. The default is "no events included."
Use the SHOW TRACE/CONTEXT command to display event names.
/SIZE=n
Specifies a trace buffer size of n bytes to be used by PEdriver for
each trace buffer: one for global PEdriver use, one for each selected
channel, and one for each selected VC. n can be any value
between 0 and FFFFFFF.
Examples
| #1 |
SCACP> SET TRACE/EVENT=CC_STATE/SIZE=1000
|
The command in this example specifies that the trace buffers for each
channel, VC, and the global buffer each be 1000 bytes in length.
| #2 |
SCACP> SET TRACE/EVENT=* NODE10/LOCAL=EWA,NODE20
|
The command in this example specifies that all events are to be
recorded; when applicable to a particular node, however, only channels
and VCs to nodes NODE10 and NODE20 are to be included.
| #3 |
SCACP> SET TRACE/EVENT=(ALL,NOTIMER) NODE10
|
The command in this example specifies that all events except timer
events on node NODE10 are to be included.
| #4 |
SCACP> SET TRACE/LOCAL=EWA/REMOTE=EWB
NODE10,NODE15/L=F*/R=F*,NODE20
|
The command in this example is equivalent to the following command:
SET TRACE NODE10/L=EWA/R=EWB,NODE15/L=F*/R=F*,NODE20/L=EWA/R:EWB
|
The command in the example sets tracing on the following channels:
- On node NODE10, channels with local device EWA and remote device EWB
- On node NODE15, channels with local LAN device starting with F and
remote LAN device starting with F
- On node NODE20, channels with local LAN device EWA and remote LAN
device EWB
|
