Document revision date: 15 July 2002

The SCA Control Program (SCACP) is a cluster management utility that performs certain privileged cluster communications management functions.

Format

RUN SYS$SYSTEM:SCACP

Parameters

None.

Description

To invoke SCACP, enter the following command at the DCL prompt:

$ RUN SYS$SYSTEM:SCACP

SCACP displays the following prompt, at which you can enter SCACP commands using the standard rules of DCL syntax:

SCACP>

To exit SCACP and return to the DCL command level, enter the EXIT command at the SCACP> prompt or press Ctrl/Z.

Note OpenVMS Version 7.3 and later require SYSPRV privilege to issue SCACP commands.

SCACP also requires you to have the following privileges:

• A minimum of DISPLAY privilege is required to issue commands that display information or influence SCACP execution (that is, SHOW, HELP, SPAWN, EXIT, and so on.)
• SYSPRV privilege is reqired to issue commands that change cluster communications operations (that is, SET, START,and STOP).

Example

$ CREATE COUNT.COM
SHOW LAN_DEVICE/COUNTERS
SPAWN WAIT 00:01:00
@COUNT
 
[Ctrl/Z]
$ RUN SYS$SYSTEM:SCACP
SCACP> @COUNT
      

This example creates and runs a command procedure, COUNT.COM, which displays device counters once a minute.

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: SCACP command or command plus 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:

SET TRACE Sets or modifies PEDRIVER tracing parameters. Format SET TRACE Additional information available: Parameters Qualifiers /AFTER /DEFAULT /EVENT /EXCLUDE /LOCAL_DEVICE /REMOTE_DEVICE /STOP /SIZE Examples SET TRACE Subtopic?

Sets CHANNEL management parameters, including priority values.

Note If a LAN device is disabled for use by cluster communications, all channels associated with that device are deleted. This means that all management settings for the device and the 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.

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[,...])

Specifies a LAN device that identifies the local end of the channel; you can use wildcards to specify LAN devices.

/PRIORITY=n

Sets the management priority value for channels to selected nodes. n can be a value between -127 and +127.

/REMOTE_DEVICE=(landevicename[,...])

Specifies a LAN device that identifies the remote end of the channel; you can use wildcards to specify LAN devices.

Usage Notes

• Use the SHOW CHANNEL command to display node names and local and remote device names.
• Use the SHOW LAN_DEVICE command to display device names.
• Use the SHOW LAN_DEVICE 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 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

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.

/PRIORITY=n

Sets the management priority value for the selected circuits. n can be a value between -127 and +127.

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 device management parameters: management priority and maximum buffer size.

Format

SET LAN_DEVICE landevicename

Parameter

landevicename[...,]

Includes specific LAN devices, which you can use wildcards to specify.

Usage Note

• Use the /EXCLUDE qualifier to exclude LAN devices.
• Use the SHOW LAN_DEVICE command to display device names.

Qualifiers

/BUFFER_SIZE_MAXIMUM=n

When a channel is created, the maximum buffer size is determined by the lowest common denominator buffer size. This qualifier provides a means of overriding the default. n can be any value between 0 and 65535.

/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 any value between -127 and +127.

Usage Note

Use the SHOW LAN_DEVICE command to display device names.

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.

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 -127 and +127.

Usage Notes

• To display all ports available on your system, use the SHOW PORT command.
• Use the /EXCLUDE qualifier to exclude specific ports.

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.

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.

/EXCLUDE=(nodename[/LOCAL_DEVICE=landevicename] [/REMOTEDEVICE=landevicename][,...])

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[,...])

Includes specific LAN devices that identify the local end of the channel. You can use wildcards to specify LAN devices.

/REMOTE_DEVICE=(landevicename[,...])

Includes specific LAN devices that identify the remote end of the channel; you can use wildcards to specify LAN devices.

/STOP=(event1[,...])

Stops tracing on specific events, which you can use wildcards to specify. The default is "no events included."

/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.

Usage Notes

• Use the SHOW CHANNEL command to display node names and local and remote device names.
• Use the SHOW TRACE/CONTEXT command to display event names.
• Use the SHOW LAN_DEVICE command to display device names.
• Use the SHOW TRACE/CONTEXT command to display event names.

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

Sets VC management parameters: checksumming values.

Format

SET VC nodename

Parameter

nodename[,...]

Includes VCs to specific nodes, which you can use wildcards to specify.

Usage Notes

• Use the /EXCLUDE qualifier to exclude VCs to specific nodes.
• Use the SHOW CHANNEL or SHOW VC commands to display VC names, which are simply the names of remote nodes.

Qualifiers

/CHECKSUMMING/

NOCHECKSUMMING (default)

Enables or disables checksum verification on the selected VCs to specified nodes.

You can use this command alone or in combination with the system parameter NISCS_PORT_SERV. (Refer to online help for NISCS_POST_SERV for more information.)

VC CLOSURE SIDE-EFFECT When you enable or disable checksumming on a circuit, the circuit closes briefly and then reopens using the specified operating mode. This is necessary to ensure that both ends of the circuit are synchronized. Because the SET VC/CHECKSUMMING setting is not valid beyond the life of the system, you might want to include SET VC/CHECKSUMMING commands in your startup file, or reissue these commands at the next boot.

/EXCLUDE=(nodename[,...])

Excludes VCs to specific nodes, which you can use wildcards to specify.

Example

SCACP> SET VC/CHECKSUMMING NODE10,NODE20
      

The command in this example enables checksum verification of VCs to nodes NODE10 and NODE20.

Displays PEDRIVER channel information for specific nodes. Each channel is a single NISCA communications path between a LAN device on a local system and a LAN device on a remote system.

Usage Note

Use the SHOW CHANNEL command to display node names and local and remote device names.

Format

SHOW 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 associated with the specified node name are included.

Qualifiers

/ALL

Includes all channel data.

/COUNTERS

Includes channel counters data.

/ECS

/NOECS

Includes only channels that are (or are not) members of the ECS.

/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.

/INTERVAL

For the /COUNTERS display, displays the changes to counters since the last SHOW command.

/LOCAL_DEVICE=(landevicename[,...])

Includes specific LAN devices that identify the local end of the channel; you can use wildcards to specify LAN devices.

/n

Displays the nth page. To select a particular page of a multipage display, specify the number of the page you want to display.

/OUTPUT=filespec

Creates the specified file and directs output to it.

/REMOTE_DEVICE=(landevicename[,...])

Includes specific LAN devices that identify the remote end of the channel; you can use wildcards to specify LAN devices.

/SDA

Includes channel data displayed in SDA format, with all the data collected in one display for one channel.

/SUMMARY

Includes channel summary data. This is the default if /ALL, /COUNTERS, and /SDA qualifiers are not specified.

Usage Note

Use the SHOW LAN_DEVICE command to display device names.

Examples

SCACP> SHOW CHANNEL
      

The command in this example produces output similar to the following:

SYS999 PEA0 Channel Summary 31-JAN-2001 10:59:15.99: Remote LAN Dev Channel Total ECS Priority Buffer Delay Load Total Node Loc Rmt State Errors State Cur Mgt Hops Size (uSec) Class Pkts(S+R) ---- --- --- ----- ------ ----- --- --- ---- ---- ------ ----- --------- NODE17 EWC EIB Open 2 N(T,I,S) 0 0 2 1426 390.9 10 35401 NODE17 EWC EIA Open 2 N(T,I,S) 0 0 2 1426 1032.3 10 35528 NODE17 EWD EIB Open 2 N(T,I,S) 0 0 2 1426 705.7 10 35402 NODE17 EWD EIA Open 3 N(T,I,F) 0 0 2 1426 453.6 10 35529 . . .

SCACP> SHOW CHANNEL/ALL
      

The command in this example produces output similar to the following:

SYS999 PEA0 Channel Summary 31-JAN-2001 10:59:17.43: Remote LAN Dev Channel Total ECS Priority Buffer Delay Load Total Node Loc Rmt State Errors State Cur Mgt Hops Size (uSec) Class Pkts(S+R) ---- --- --- ----- ------ ----- --- --- ---- ---- ------ ----- --------- NODE17 EWC EIB Open 2 N(T,I,S) 0 0 2 1426 390.9 10 35401 NODE17 EWC EIA Open 2 N(T,I,S) 0 0 2 1426 1032.3 10 35528 NODE17 EWD EIB Open 2 N(T,I,S) 0 0 2 1426 705.7 10 35402 NODE17 EWD EIA Open 3 N(T,I,F) 0 0 2 1426 453.6 10 35529 . . . SYS999 PEA0 Channel Equivalent Channel Set (ECS) 31-JAN-2001 10:59:17.43: Loc Rmt Remote ECS ECS ECS Average Remote Remote Rsvp Channel ECS Dev Dev Node State Losses Transitions RTTime Ring Size Rcv Cache Thresh Open Time Member Time --- --- ---- ----- ------ ----------- ----- --------- --------- ------ --------- ----------- EWA EWB SYS11 Y(T,P,F 0 41 3028.9 31 31 2 00:34:57.62 00:33:17.95 EWB EWC SYS11 Y(T,P,F) 0 53 2571.8 16 31 7197 00:38:38.99 00:35:19.57 EWB EWA SYS111 Y(T,P,F) 0 1 117079.2 16 31 0 19:10:04.85 19:10:04.81 EWB EWB SYS22 Y(T,P,F) 0 1 109055.9 16 31 96 19:10:16.21 19:10:16.21 EWB EXA SYS222 Y(T,P,F) 0 1 9262.7 31 31 39182 20:01:40.85 20:01:40.85 . . . SYS999 PEA0 Channel Counters and Errors 31-JAN-2001 10:59:17.43: Loc Rmt Remote -- Transmit -- -- Receive -- Retransit TransmitFail Receive Other Dev Dev Node Messages Bytes Messages Bytes Errors Penalties Errors Errors --- --- ---- -------- ----- -------- ----- ------ --------- ------ ------ EWA EWB SYS11 3520 494938 5973 876922 10 0 0 9 EWB EWC SYS11 5497 789781 9385 1406215 11 0 0 29 EWB EWA SYS111 268360 36700156 356173 48271657 67 0 0 1 EWB EWB SYS22 546214 89400904 583298 80580667 92 0 0 1 EWB EXA SYS222 4841514 913885390 3764456 3888518960 2 0 0 1 . . . SYS999 PEA0 Channel Errors 31-JAN-2001 10:59:17.43: Loc Rmt Remote -------------------- Receive -------------------- -- Timeouts- No MSCP Disk Not Topology Path Dev Dev Node Bad Auth Bad ECO Bad MCA Short Incompat Old Chan Handshake Listen Server Served Change Restart --- --- ---- -------- ------- ------- ----- -------- -------- --------- ------ ------ ------ ------ ------- EWA EWB SYS11 0 0 0 0 0 0 0 4 0 0 5 0 EWB EWC SYS11 0 0 0 0 0 0 0 4 0 20 5 0 EWB EWA SYS111 0 0 0 0 0 0 0 0 0 0 1 0 EWB EWB SYS22 0 0 0 0 0 0 0 0 0 0 1 0 EWB EXA SYS222 0 0 0 0 0 0 0 0 0 0 1 0 . . .

SCACP> SHOW CHANNEL NODE20/LOCAL=EWA
      

The command in this example displays channel definition data for all nodes defined with local device EWA and any remote device and remote node name starting with NODE20.

SCACP> SHOW CHANNEL/COUNTERS/INTERVAL
SCACP> SPAWN WAIT 0:0:10
SCACP> SHOW CHANNEL/COUNTERS/INTERVAL
      

---

Previous

Next

Contents

Index

	privacy and legal statement
6048PRO_055.HTML