HP OpenVMS Systems Documentation

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

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.

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

SCACP> EXIT
$
      

This command stops execution of SCACP and returns control to the DCL command level.

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

SCACP> HELP SET TRACE
      

The HELP command in this example displays information about the SET TRACE command.

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.

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

SCACP> SET CHANNEL/PRIORITY=3 NODE5
      

The command in this example sets the priorities of all channels to node NODE5 to 3.

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

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.

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.

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.

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.

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

SCACP> SET PORT PEA0/PRIORITY=5
      

The command in this example sets the management priority for the PEA0 port to 5.

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 sets or modifies PEdriver tracing parameters.

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

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.

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.

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.

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