% Librarian T09-20%զJgJ<=5NEXITHELPTSETSHOW/$SPAWN0START8STOP oMަJ1 EXITB Stops execution of SCACP and returns control to the DCL command8 level. You can also enter Ctrl/Z at any time to exit. Format EXIT 2 Parameters None. 2 Qualifiers None. 2 Example SCACP> EXIT $A This command stops execution of SCACP and returns control to the DCL command level. wwoMަJ1 HELPB The SCA Control Program (SCACP) is a cluster management utilityA that performs certain privileged cluster management functions.? With SCACP, you can modify cluster operational parameters to> specify management characteristics of cluster communication? paths. You can look at status and counters that describe the; operational state of these cluster communications paths. Format HELP [topic] 2 Parameter topicD Specifies a subject for which you want information: SCACP commandA or command plus command keyword. If you enter the HELP commandD with a command name only, such as HELP SET, SCACP displays a list< of all of the command keywords used with the SET command. 2 Qualifiers None. 2 Example SCACP> HELP SET TRACED The HELP command in this example displays information about the SET TRACE command. wwoMަJ1 SET 2 CHANNELA Sets CHANNEL management parameters, including priority values. Format SET CHANNEL nodename 3 Parameter "Nodename[,nodename1,nodename2,...]= Includes channels to specific nodes, which you can specifyA using wildcards. Each node name can be accompanied by optionalC qualifiers to specify local and remote device names. If no localD or remote device name is specified, all channels to the specified node name are included.C Use the SHOW CHANNEL command to display node names and local and remote device names. 3 Qualifiers /EXCLUDE* /EXCLUDE[=(nodename1,nodename2,...)]= Excludes channels to specific nodes, which you can specifyA using wildcards. Each node name can be accompanied by optionalC qualifiers to specify local and remote device names. If no localC or remote device name is specified, all channels associated with# the specified node are included. /LOCAL_DEVICE5 /LOCAL_DEVICE[=(landevicename1,landevice2,...)]C Includes specific LAN devices that identify the local end of the9 channel; you  can use wildcards to specify LAN devices.? Use the SHOW CHANNEL command to display node names and localA and remote device names, or use the SHOW LAN_DEVICE command to display device names. /PRIORITY /PRIORITY[=n]> Sets the management priority value for channels to selected nodes. /REMOTE_DEVICE6 /REMOTE_DEVICE[=(landevicename1,landevice2,...])D Includes specific LAN devices that identify the remote end of the9 channel; you can use wild cards to specify LAN devices.? Use the SHOW CHANNEL command to display node names and localA and remote device names, or 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. 3 Example$ SCACP> SET CHANNEL/PRIORITY=3 NODE5D The command in this example sets the priorities of all channels to node NODE5 to 3. 2 DEFAULT_PORT: Sets the default port to which to a$ pply SCACP commands. Format SET DEFAULT_PORT portname 3 Parameter portname9 Identifies the port name; PEA0 is the name of the port implemented by PEDRIVER. 3 Qualifiers None. 3 Example SCACP> SET DEFAULT_PORT PEA0C The command in this example sets the default port to PEDRIVER. 2 LAN_DEVICE: Sets device management parameters: management priority. Format" SET LAN_DEVICE landevicename 3 Paramet ers )landevicename[,landevice1,landevice2,...]= Includes specific LAN devices, which you can specify using wildcards.5 Use the /EXCLUDE qualifier to exclude LAN devices.; Use the SHOW LAN_DEVICE command to display device names. 3 Qualifiers /EXCLUDE4 /EXCLUDE[=(landevicename1,landevicename2,...)]= Excludes specific LAN devices, which you can specify using wildcards.; Use the SHOW LAN_DEVICE command to display device names.  /PRIORITY /PRIORITY[=n]? Sets the management priority value for the selected devices. 3 Example% SCACP> SET LAN_DEVICE/PRIORITY=3 EWAA The command in this example sets the management priority for device EWA to 3. 2 TRACE: SET TRACE sets or modifies PEDRIVER tracing parameters.& NOTE= This command is reserved for use by Compaq Services and= OpenVMS Engineering only. Trace commands and output are0 subject to change from release to release. Format SET TRACE nodename 3 Parameters "nodename[,nodename1,nodename2,...]A 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 channelsB associated with the specified node are included, as well as the VC to the specified node.C Use the SHOW CHANNEL command to display node names and local and remote device names. 3 Qualifiers /AFTER /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. /DEFAULTB 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" /EVENT[=(event1,event2,...)]B Enables tracing on specific events, which you can specify usingC wildcards. The default is a subset of the events, which includesB 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. /EXCLUDE7 /EXCLUDE[=(nodename1[/LOCAL_DEVICE=landevicename]3 [/REMOTEDEVICE=landevicename],nodename2,...)]B Excludes VCs or channels, or both, to specific nodes, which youA can specify using wildcards. Each node name can be accompaniedC by optional qualifiers to specify local and remote device names.A If no local or remote device name is specified, the VC and all< channels associated with the specified node are excluded. /LOCAL_DEVICE5 /LOCAL_DEVICE[=(landevicename1,landevice2,...)]C Includes specific LAN devices that identify the local end of the, channel; you can specify using wildcards.; Use the SHOW LAN_DEVICE command to display device names. /REMOTE_DEVICE6 /REMOTE_DEVICE[=(landevicename1,landevice2,...)]D Includes specific LAN devices that identify the remote end of the9 channel; you can use wildcards to specify LAN devices.; Use the SHOW LAN_DEVICE command to display device names. /STOP! /STOP[=(event1,event2,...)]@ Stops tracing on specific events, which you can specify using2 wildcards. The default is "no events included."= Use the SHOW TRACE/CONTEXT command to display event names. /SIZE /SIZE[=n]B Specifies a trace buffer size of n bytes to be used by PEDRIVERC for each trace buffer: one for global PEDRIVER use, one for each2 selected channel, and one for each selected VC. 3 Examples. 1.SCACP> SET TRACE/EVENT=CC_STATE/SIZE=1000A The command in this example specifies that the trace buffersC for each channel, VC, and the global buffer each be 1000 bytes in length.5 2.SCACP> SET TRACE/EVENT=* NODE10/LOCAL=EWA,NODE20D The command in this example specifies that all events are to beB recorded; when applicable to a particular node, however, onlyD channels and VCs to nodes NODE10 and NODE20 are to be included.0 3.SCACP> SET TRACE/EVENT=(ALL,NOTIMER) NODE10A The command in this example specifies that all events except4 timer events on node NODE10 are to be included. 2 VC6 Sets VC management parameters: checksumming values.& NOTEB In the initial release of OpenVMS Version 7.3, PEDRIVER does not support this command. Format SET VC nodename 3 Parameter "nodename[,nodename1,nodename2,...]> Includes VCs to specific nodes, which you can specify using wildcards.? 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. 3 Qualifiers /CHECKSUMMING /CHECKSUMMING/ NOCHECKSUMMING (default)D Enables or disables checksum verification on the VCs to specified nodes. /EXCLUDE* /EXCLUDE[=(nodename1,nodename2,...)]> Excludes VCs to specific nodes, which you can specify using  wildcards. 3 Example) SCACP> SET VC/CHECKSUMMING NODE10,NODE20A The command in this example enables checksum verification of$ VCs to nodes NODE10 and NODE20. wwߦJ1 SHOW 2 CHANNELA 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.C Use the SHOW CHANNEL command to display node names and local and remote device names. Format SHOW CHANNEL nodename 3 Parameters "nodename[,nodename1,nodename2,...]= Includes channels to specific nodes, which you can specifyA using wildcards. Each node name can be accompanied by optionalC qualifiers to specify local and remote device names. If no localC or remote device name is specified, all channels associated with( the specified node name are included. 3 Qualifiers /ALL Includes all channel data. /COUNTERS" Includes channel counters data. /ECS /ECS (/NOECS)C Includes only channels that are (or are not) members of the ECS. /EXCLUDE( /EXCLUDE[,nodename1,nodename2,...]= Excludes channels to specific nodes, which you can specifyA using wildcards. Each node name can be accompanied by optionalC qualifiers to specify local and remote device names. If no localC or remote device name is specified, all channels associated with# the specified node are included. /INTERVALD For the /COUNTERS display, displays the changes to counters since the last SHOW command. /LOCAL_DEVICE5 /LOCAL_DEVICE[=(landevicename1,landevice2,...)]C Includes specific LAN devices that identify the local end of the9 channel; you can use wildcards to specify LAN devices.; Use the SHOW LAN_DEVICE command to display device names. /nA Displays the nth page. To select a particular page of a multi-D page display, specify the number of the page you want to display. /OUTPUT /OUTPUT[=filespec]7 Creates the specified file and directs output to it. /REMOTE_DEVICE6 /REMOTE_DEVICE[=(landevicename1,landevice2,...)]D Includes specific LAN devices that identify the remote end of the9 channel; you can use wildcards to specify LAN devices.; Use the SHOW LAN_DEVICE command to display device names. /SDAC 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,4 /COUNTERS, and /SDA qualifiers are not specified. 3 Examples) 1.SCACP> SHOW CHANNEL NODE20/LOCAL=EWAA The command in this example displays channel definition data? for all nodes defined with local device EWA and any remote6 device and remote node name starting with NODE20.* 2.SCACP> SHOW  CHANNEL/COUNTERS/INTERVAL SCACP> SPAWN WAIT 0:0:10* SCACP> SHOW CHANNEL/COUNTERS/INTERVAL@ The first command in this example displays channel countersA since the last SHOW command. The SPAWN command tells the DCL> WAIT command to insert a 10-second delay. The second SHOWB CHANNEL command displays counters after the 10-second period. 3.SCACP> SHOW CHANNEL/1/3C The command in this example displays the first and third pages> of data for all channels." The first page contains ChannelA Summary data, and the third page contains Channel Equivalent Channel Set (ECS) data. 2 DEFAULT_PORT% Displays the current default port. Format SHOW DEFAULT_PORT 3 Parameters None 3 Qualifiers /OUTPUT /OUTPUT[=filespec]7 Creates the specified file and directs output to it. 3 Example SCACP> SHOW DEFAULT_PORT@ The command in this example displays the currently selected* port, PEA0, which indicates PEDRIVER. 2 LAN_DEVICEC Displays PEDRIVER device data. Each device is a local LAN device= on the system, which can be used for NISCA communications. Format# SHOW LAN_DEVICE landevicename 3 Parameters )landevicename[,landevice1,landevice2,...]= Includes specific LAN devices, which you can specify using wildcards.5 Use the /EXCLUDE qualifier to exclude LAN devices.; Use the SHOW LAN_DEVICE comma nd to display device names. 3 Qualifiers /ALL Includes all device data. /COUNTERSD Includes device counters data maintained by PEDRIVER and counters& data maintained by the LAN drivers. /INTERVALD For the /COUNTERS display, displays the changes to counters since the last SHOW command. /nA Displays the nth page. To select a particular page of a multi-D page display, specify the number of the page you want to display. /OUTPU!T /OUTPUT[=filespec]7 Creates the specified file and directs output to it. /SDAA Includes LAN device data displayed in SDA format, with all the4 data collected in one display for one LAN device. /SUMMARY= Includes device summary data. This is the default if /ALL,4 /COUNTERS, and /SDA qualifiers are not specified. 3 Examples$ 1.SCACP> SHOW LAN_DEVICE/COUNTERS: The command in this example displays device counters.- 2.SCACP> SHOW L"AN_DEVICE/COUNTERS/INTERVAL SCACP> SPAWN WAIT 0:0:10- SCACP> SHOW LAN_DEVICE/COUNTERS/INTERVAL? The first command in this example displays device countersA since the last SHOW command. The SPAWN command tells the DCL> WAIT command to insert a 10-second delay. The second SHOW: command displays counters after the 10-second period. 2 TRACE1 Displays PEDRIVER tracing data and parameters.& NOTE= This command is re#served for use by Compaq Services and= OpenVMS Engineering only. Trace commands and output are0 subject to change from release to release. Format SHOW TRACE nodename 3 Parameters "nodename[,nodename1,nodename2,...]= Includes channels to specific nodes, which you can specifyA using wildcards. Each node name can be accompanied by optionalC qualifiers to specify local and remote device names. If no localC or remote device name is specified, a$ll channels associated with# the specified node are included.C Use the SHOW CHANNEL command to display node names and local and remote device names. 3 Qualifiers /CONTEXTB Displays only PEDRIVER trace settings and the event definition.D If this qualifier is not included, trace event data is displayed. /EVENT" /EVENT[=(event1,event2,...)]B Enables tracing on specific events, which you can specify usingD wildcards. The default is all of the %events that are in the trace buffer.= Use the SHOW TRACE/CONTEXT command to display event names. /EXCLUDE* /EXCLUDE[=(nodename1,nodename2,...)]= Excludes channels to specific nodes, which you can specifyA using wildcards. Each node name can be accompanied by optionalC qualifiers to specify local and remote device names. If no localC or remote device name is specified, all channels associated with# the specified node are included. /GLOBAL3 &/GLOBAL (default when no nodes are specified)2 /NOGLOBAL (default when nodes are specified)9 Specifies whether global trace data is to be returned. /INPUT /INPUT[=filename]< Reads trace data from the specified file and displays it. /LOCAL_DEVICE5 /LOCAL_DEVICE[=(landevicename1,landevice2,...)]C Includes specific LAN devices that identify the local end of the9 channel; you can use wildcards to specify LAN devices.; Use the SHOW LAN_DEVI'CE command to display device names. /OUTPUT /OUTPUT[=filename]> Creates the specified file and directs output to it. If the= filename extension is .DMP, the trace data is written to a@ dump file so that you can use the /INPUT qualifier to display it later. /REMOTE_DEVICE6 /REMOTE_DEVICE[=(landevicename1,landevice2,...)]A Includes specific LAN devices which identify the remote end of6 the channel, which you can specify using wildcards.; Use( the SHOW LAN_DEVICE command to display device names. /SORT /SORT /NOSORT (default)A Returns trace data sorted across channels, VCs, and the global= trace buffer by sequence number. The default is trace dataA returned for channels and VCs one at a time, in order, for the2 channel or VC, but not across channels and VCs. 3 Examples 1.SCACP> SHOW TRACE/CONTEXT< The command in this example displays trace settings and definition.( ) 2.SCACP> SHOW TRACE/OUTPUT=NODE10.TRCB The command in this example displays trace data and writes it to the specified file.D An example of the screen output of a SHOW TRACE/CONTEXT command follows.4 SYS999 Trace Context 31-JAN-2001 10:59:28.25:/ Trace buffer size requested 2048 bytes1 Trace buffer total allocated 92160 bytes/ Trace buffer allocations 45 successful* Trace buffer allocations 0 failed0 Current trace s*equence number 812286047( System cycle counter 404196 cps/ Stop tracing 0 events after stop event$ Trace Stop Default Event$ ----- ---- ------- -----$ Active Y Error* Active Penalize_ch$ Active Timer* Active Listen_timr* Active Handsh_timr) Active Size_probe) Active Delay_msmt( Activ +e Verf_vack' Active Y CC_event' Active Y CC_state) Active Y Path_state( Active Y ECS_state* Active ACK_process* Active Y Chan_update* Active Rcvd_CC_msg* Active Rcvd_TR_msg* Active Send_TR_msg) Active Xmt_failed' Active Y VC_state* , Active ACK_timeout) Active Y TMO_listen& Y No_path Channel Selection:? Local Dev Remote Dev Remote Node Name Selection? --------- ---------- ---------------- ---------( All channels and VCs selected 2 VC> Displays PEDRIVER virtual circuit data. Each VC is an SCACPC communications path between the local system and a remote system" comprised of a set of$- channels.B Use the SHOW CHANNEL or SHOW VC commands to display node names,2 which are simply the names of the remote nodes. Format SHOW VC nodename 3 Parameters "nodename[,nodename1,nodename2,...]B Includes specific nodes, which you can specify using wildcards. 3 Qualifiers /ALL Includes all VC data. /COUNTERS Includes VC counter data. /EXCLUDE* /EXCLUDE[=(nodename1,nodename2,...)]B Excludes specific n.odes, which you can specify using wildcards.@ Use the SHOW CHANNEL or SHOW VC commands to display VC names,2 which are simply the names of the remote nodes. /INTERVALD For the /COUNTERS display, displays the changes to counters since the last SHOW command. /nA Displays the nth page. To select a particular page of a multi-D page display, specify the number of the page you want to display. /OUTPUT /OUTPUT[=filespec]7 Creates the specified f/ile and directs output to it. /SDA, Includes VC data displayed in SDA format. /SUMMARYD Includes VC summary data. This is the default if /ALL, /COUNTERS,) and /SDA qualifiers are not specified. 3 Examples# 1.SCACP> SHOW VC/COUNTERS NODE10A The command in this example displays VC counters for all VCs6 whose name (remote node name) starts with NODE10.% 2.SCACP> SHOW VC/COUNTERS/INTERVAL SCACP> SPAWN WAIT 0:0:10% SCACP> SHOW VC/CO0UNTERS/INTERVALA The first command in this example displays VC counters since@ the last SHOW command. The SPAWN command tells the DCL WAITD command to insert a 10-second delay. The second SHOW VC command2 displays counters after the 10-second period. wwOJ1 SPAWNA Creates a subprocess of the current process. The SPAWN commandA copies the context of the subprocess from the current process. Format SPAWN [command-string] 2 1 Parameters command-stringD A string of commands to be executed in the context of the createdD subprocess. After the command string is executed, control returns to SCACP. 2 Qualifiers None. 2 Example SCACP> SPAWN SHOW TIME 24-AUG-2000 15:22:39 SCACP>D The command in this example creates a subprocess of the current# process and displays the time. wwOJ1 START 2 LAN_DEVICE@ Directs PEDRIVER to start u2sing the specified LAN device. TheA original (and still supported) means of starting PEDRIVER on a- LAN device is SYS$EXAMPLES:LAVC$START_BUS. Format$ START LAN_DEVICE landevicename 3 Parameters )landevicename[,landevice1,landevice2,...]= Includes specific LAN devices, which you can specify using wildcards.5 Use the /EXCLUDE qualifier to exclude LAN devices.; Use the SHOW LAN_DEVICE command to display device names. 3 Qualifiers 3/EXCLUDE4 /EXCLUDE[=(landevicename1,landevicename2,...)]= Excludes specific LAN devices, which you can specify using wildcards.; Use the SHOW LAN_DEVICE command to display device names. 3 Example SCACP> START DEVICE EWA8 This command starts PEDRIVER on the LAN device EWA. 2 TRACEA Starts or resumes PEDRIVER tracing, optionally setting tracing options.& NOTE= This command is reserved for use by 4Compaq Services and= OpenVMS Engineering only. Trace commands and output are0 subject to change from release to release. Format START TRACE nodename 3 Parameters "nodename[,nodename1,nodename2,...]= Includes channels to specific nodes, which you can specifyA using wildcards. Each node name can be accompanied by optionalC qualifiers to specify local and remote device names. If no localC or remote device name is specified, all channels associ5ated with# the specified node are included.C Use the SHOW CHANNEL command to display node names and local and remote device names. 3 Qualifiers /AFTER /AFTER[=n]? After the trace stop condition has been satisfied, continues> tracing for n events, and then stops. If you do not specify@ /AFTER, tracing does not continue after the trace stop event. /DEFAULTB Sets the trace context back to the default settings, which are: channe6lname=* /AFTER=0! /EVENT=default settings /STOP /SIZE=512 /EVENT" /EVENT[=(event1,event2,...)]B Enables tracing on specific events, which you can specify usingC wildcards. The default is a subset of the events, which includes! most errors and state changes.= Use the SHOW TRACE/CONTEXT command to display event names. /EXCLUDE4 /EXCLUDE[=(landevicename1,landevicename2,...)]= Excludes specific LAN devices7, which you can specify using wildcards.; Use the SHOW LAN_DEVICE command to display device names. /LOCAL_DEVICE5 /LOCAL_DEVICE[=(landevicename1,landevice2,...)]D Includes specific LAN devices which identify the local end of the9 channel; you can use wildcards to specify LAN devices.; Use the SHOW LAN_DEVICE command to display device names. /REMOTE_DEVICE6 /REMOTE_DEVICE[=(landevicename1,landevice2,...)]A Includes specific LAN devices whi8ch identify the remote end of6 the channel, which you can specify using wildcards.; Use the SHOW LAN_DEVICE command to display device names. /STOP! /STOP[=(event1,event2,...)]@ Stops tracing on specific events, which you can specify using/ wildcards. The default is to stop no events.= Use the SHOW TRACE/CONTEXT command to display event names. /SIZE /SIZE[=n]B Specifies a trace buffer size of n bytes to be used by PEDRIVERC for each tr9ace buffer: one for global PEDRIVER use, one for each2 selected channel, and one for each selected VC. 3 Examples0 1.SCACP> START TRACE/EVENT=CC_STATE/SIZE=2000B The command in this example changes the Trace Channel Control/ layer state with a 2000-byte trace buffer./ 2.SCACP> START TRACE/EVENT=ALL NODE10,NODE20C The command in this example traces all events but only for the NODE10 and NODE20 channels. wwgJ1 STOP 2 : LAN_DEVICE? Directs PEDRIVER to stop using the specified LAN device. TheA original (and still supported) means of stopping PEDRIVER on a. LAN devices is SYS$EXAMPLES:LAVC$START_BUS.' CAUTIONB As with SYS$EXAMPLES:LAVC$STOP_BUS, you can cause the systemA to CLUEXIT if you do not maintain at least one path to each member of the cluster. Format# STOP LAN_DEVICE landevicename 3 Parameters )landevicename[,l;andevice1,landevice2,...]= Includes specific LAN devices, which you can specify using wildcards.5 Use the /EXCLUDE qualifier to exclude LAN devices.; Use the SHOW LAN_DEVICE command to display device names. 3 Qualifiers /EXCLUDE4 /EXCLUDE[=(landevicename1,landevicename2,...)]= Excludes specific LAN devices, which you can specify using wildcards.; Use the SHOW LAN_DEVICE command to display device names. 3 Example SCACP> STOP L<AN_DEVICE EWA7 This command stops PEDRIVER on the LAN device EWA. 2 TRACEB Stops PEDRIVER tracing. You can read the trace data recorded so! far with a SHOW TRACE command.B To revert trace behavior to initial settings, enter the command SET TRACE/DEFAULT.& NOTE= This command is reserved for use by Compaq Services and= OpenVMS Engineering only. Trace commands and output are0 subject to change from release to release. Format STOP TRACE 3 Parameters None. 3 Qualifiers None. 3 Example SCACP> STOP TRACE8 The command in this example stops PEDRIVER tracing.ww