Networking and Data Communications Library SCF Reference Manual for SCP Abstract Part Number This manual describes the SCF commands used to configure, control, and inquire about the SCP data-communications subsystem.
Document History Edition Part Number Product Version Operating System Version Date First Edition 18098 SCF C20, SCP C20 GUARDIAN 90 C20 March 1989 New editions incorporate any updates issued since the previous edition. Copyright All rights reserved. No part of this document may be reproduced in any form, including photocopying or translation to another language, without the prior written consent of Tandem Computers Incorporated. Copyright 1989 Tandem Computers Incorporated.
CONTENTS PREFACE ....................................................... v NOTATION CONVENTIONS ........................................ vii SECTION 1. INTRODUCTION .................................... 1-1 Object Types and Object Names ............................. 1-1 SECTION 2. SCP PROCESS COMMANDS ............................ 2-1 ABORT Command ............................................. 2-2 INFO Command .............................................. 2-3 LISTOPENS Command ..............................
NOTATION CONVENTIONS The following list summarizes the conventions for syntax notation in this manual. Notation Meaning UPPERCASE LETTERS Uppercase letters represent keywords and reserved words; enter these items exactly as shown. italics Lowercase italic letters represent variable items that you supply. Brackets [] Brackets enclose optional syntax items. A group of vertically aligned items enclosed in brackets represents a list of selections from which you can choose one or none.
PREFACE This manual describes the Subsystem Control Facility (SCF) interactive interface that allows operators and network managers to configure and control an SCP process. SCF also provides means for examining the configuration and status of an SCP process. SCF is similar in use and function to CMI, described in the Communications Management Interface (CMI) Operator's Guide.
PREFACE Before reading this book, you should be familiar with the reference manuals that describe the data-communications subsystems available at your installation. You should also be familiar with the System Generation Manual; it explains system configuration and SYSGEN. Other GUARDIAN 90 manuals are referred to occasionally in this manual for detailed information on particular topics.
SECTION 1 INTRODUCTION This manual describes the subsystem-specific details for using the Subsystem Control Facility (SCF) to control and inquire about the SCP process. To use SCF to control or inquire about SCP, the SCP process must first be running as described in the Communications Management Programming Manual.
SECTION 2 SCP PROCESS COMMANDS The SCF commands and their modifiers that apply to SCP are described in this section. SCP supports the following commands: Sensitive Commands Nonsensitive Commands ABORT PRIMARY START STOP TRACE INFO LISTOPENS STATUS VERSION For information about TRACE commands applied to other subsystems, see the relevant subsystem description. The TRACE command described in this section applies only to SCP. The syntax for the commands is shown in Appendix A.
SCP PROCESS COMMANDS ABORT Command ABORT COMMAND The ABORT command terminates the operation of the SCP process as quickly as possible--only enough processing is done to ensure the security of the subsystem. The SCP process is left in the STOPPED state. This is a sensitive command. The SUB and SEL options are not supported for the ABORT command.
SCP PROCESS COMMANDS INFO Command INFO COMMAND The INFO command displays the current or default attribute values for the specified SCP process. The DETAIL, SUB, and SEL options are not supported for the INFO command.
SCP PROCESS COMMANDS INFO Command cccccccc is the amount of time this SCP process will allow a file-system open to a subsystem to remain idle before closing it. The format of the value is HHHH:MM:SS.hh where HHHH is hours, MM is minutes, SS is seconds, and hh is hundredths of a second. If the displayed value is -1, the open will be maintained indefinitely. ddd is the number of pages in the secondary memory pool, as specified at initiation time.
SCP PROCESS COMMANDS LISTOPENS Command LISTOPENS COMMAND The LISTOPENS command displays a list of file-system opens that apply to the SCP object. The SUB and SEL options are not supported for the LISTOPENS command. The LISTOPENS command has the following object-spec: object-type object-name PROCESS SCP-process-name The display format of the SCP LISTOPENS command differs from that of the SCF LISTOPENS command described in the Subsystem Control Facility (SCF) Reference Manual.
SCP PROCESS COMMANDS LISTOPENS Command is the CPU and PIN of the opener's backup process if the opener has checkopened SCP. eee is the number of requests from this opener queued within SCP.
SCP PROCESS COMMANDS PRIMARY Command PRIMARY COMMAND The PRIMARY command causes the backup CPU to become the primary CPU and the primary to become the backup. This is a sensitive command. Considerations The effect of the PRIMARY command for 6100 family controllers differs depending on the controller configuration: dual-port CIU, single-port CIU, or single-board (6105, 3605, 6106, or 3606) controller. For details, refer to Appendix D of the Subsystem Control Facility (SCF) Reference Manual.
SCP PROCESS COMMANDS START Command START COMMAND The START command initiates the operation of an SCP process. Successful completion of the START command leaves the process in either the STARTED or STARTING state. This is a sensitive command. The SUB and SEL options are not supported for the START command.
SCP PROCESS COMMANDS STATUS Command STATUS COMMAND The STATUS command displays the dynamic state, last error, and modifiable characteristics of the specified SCP process. STATUS also displays specific SCP attributes and values. The SUB and SEL options are not supported for the STATUS command.
SCP PROCESS COMMANDS STATUS Command Explanation of Symbols aaaaaaaa is the SCP process name. bbbbbbbb is the state of the SCP process. STARTED and STOPPING are the only states supported by SCP. cc,ccc is the CPU and PIN of the SCP primary process. dd,ddd is the CPU and PIN of the SCP backup process. there is none, 0,0 is displayed. eeee is the number of applications processes that have opened SCP. ffff is the number of subsystem server processes that SCP has opened.
SCP PROCESS COMMANDS STOP Command STOP COMMAND The STOP command terminates the activity of an SCP process in a normal manner. It deletes all connections to and from the process in a nondisruptive manner. Upon successful completion, a configured process is left in the STOPPED state and a nonconfigured process is deleted. This is a sensitive command. The SUB and SEL options are not supported for the STOP command.
SCP PROCESS COMMANDS TRACE Command TRACE COMMAND SCP uses the SCF TRACE facility to request the capture of targetdefined data items, alter trace parameters, and end tracing. This is a sensitive command. An SCF trace produces a trace file that can be displayed using the commands available in the PTRACE program. The trace file is created by SCF. The PTRACE program is described in the PTRACE Reference Manual.
SCP PROCESS COMMANDS VERSION Command VERSION COMMAND The VERSION command displays the version level of the SCP process. The format of the VERSION command display without the DETAIL option is: VERSION \SYST1.$ZNET: SCP - T9395C20 - 15FEB89 - 10FEB89 The format of the VERSION command display with the DETAIL option is: Detailed VERSION \SYST1.
APPENDIX A COMMAND SUMMARY ABORT [ /OUT file-spec/ ] [ object-spec ] INFO [ /OUT file-spec/ ] [ object-spec ] [ , DETAIL ] [ , DEFAULT ] [ { , attribute-name } ...
APPENDIX B ERROR MESSAGES The following messages are sent to SCP's home terminal. They indicate that a fatal error was detected during process initiation. SCP \system-name.$SCP-process-name Bad startup message; file error: nnn Probable Cause The startup message could not be read due to the indicated file error. Recommended Action Refer to the System Procedure Errors and Messages Manual for information about the indicated file error.
ERROR MESSAGES SCP \system-name.$SCP-process-name Could not retrieve CRTPID Probable Cause SCP was unable to get its own CRTPID. Recommended Action A problem was encountered in the operating system. system manager. See your SCP \system-name.$SCP-process-name Invalid startup params; file error: nnn Probable Cause The startup parameters specified are invalid. Recommended Action Check the syntax and try again.
ERROR MESSAGES SCP \system-name.$SCP-process-name Must be run as SUPER.SUPER Probable Cause An attempt was made to run SCP with an access ID other than -1. Recommended Action The access ID must be -1 (SUPER.SUPER) to run SCP. SCP \system-name.$SCP-process-name Must be a named process Probable Cause An attempt was made to run SCP as an unnamed process. Recommended Action The SCP process must be named.
ERROR MESSAGES SCP \system-name.$SCP-process-name $RECEIVE open error: nnn Probable Cause $RECEIVE failed to open. Recommended Action A problem was encountered in the operating system. system manager. See your SCP \system-name.$SCP-process-name Allocate segment failed: nnn Probable Cause A call to the ALLOCATESEGMENT procedure failed. Recommended Action Refer to the System Procedure Errors and Messages Manual for information about the indicated error.
ERROR MESSAGES SCP \system-name.$SCP-process-name User segment failed Probable Cause The call to the ALLOCATESEGMENT procedure was successful but the allocated segment could not be accessed. Recommended Action See your system manager.
ERROR MESSAGES SCP Error 00001 The SCP subsystem error messages follow: SCP Error 00001 SCP 00001 STOP failed: SCP process has other openers Probable Cause You tried to stop an SCP that is busy with other requesters. Recommended Action Wait until the other users have closed this SCP. When all requesters have closed this SCP, you can reissue the STOP command. Alternatively, you can determine if the other requesters are actively using this SCP.
ERROR MESSAGES SCP Error 00004 SCP Error 00003 SCP 00003 No information available Probable Cause You have requested information about an object for which there is no information available. Recommended Action Make sure you have specified the object or object type correctly, and reissue the command. SCP Error 00004 SCP 00004 Required Value Missing: value (tnm:S#Z###, Offset: #L##) Probable Cause You did not supply enough information for the command.
ERROR MESSAGES SCP Error 00005 SCP Error 00005 SCP 00005 Trace parameters are not alterable to backup tracing process Probable Cause You cannot supply any modifier in the TRACE command, except STOP, to a backup process that has a trace in progress. Recommended Action Either stop the backup trace, make the backup process a primary process and modify the parameter, or do nothing. SCP Error 00006 SCP 00006 Trace command modifier required.
ERROR MESSAGES SCP Error 00501 SCP Error 00500 SCP 00500 Duplicated modifier: modifier-list Probable Cause You entered a field name twice. Recommended Action Either remove one of the field names, or spell it correctly if you meant to specify a different field. SCP Error 00501 SCP 00501 Attribute is already defined: attribute-list Probable Cause You entered a trace attribute twice. Recommended Action Remove the duplicate attribute.
ERROR MESSAGES SCP Error 00502 SCP Error 00502 SCP 00502 Invalid enumerated value: value (#Z###) Probable Cause You specified a value that is not supported. Recommended Action Determine what values are acceptable and use one of them, or use the English keyword for the value. SCP Error 00503 SCP 00503 Invalid attribute-name value for object-name Probable Cause An illegal attribute value was encountered.
INDEX ABORT command 2-2 syntax A-1 object-spec 2-2 Commands ABORT 2-2 syntax A-1 object-spec INFO 2-3 syntax A-1 object-spec LISTOPENS 2-5 syntax A-1 object-spec overview 2-1 PRIMARY 2-7 syntax A-1 START 2-8 syntax A-1 object-spec STATUS 2-9 syntax A-1 object-spec STOP 2-11 syntax A-1 object-spec syntax summary TRACE 2-12 syntax A-1 object-spec select-spec VERSION 2-13 syntax A-2 Error messages 2-2 2-3 2-5 2-8 2-9 2-11 A-1 2-12 2-12 B-1 Index 1
INDEX INFO command 2-3 syntax A-1 object-spec 2-3 LISTOPENS command 2-5 syntax A-1 object-spec 2-5 Messages error B-1 Object names 1-1 PROCESS 1-1 types 1-1 null 1-1 Object specifications ABORT command 2-2 INFO command 2-3 LISTOPENS command 2-5 START command 2-8 STATUS command 2-9 STOP command 2-11 TRACE command 2-12 PRIMARY command 2-7 syntax A-1 Process SCP 1-1 PROCESS object 1-1 SCP process 1-1 SCP subsystem 1-1, 2-1 Select specifications TRACE command 2-12 START command 2-8 syntax A-1 object-spec 2-8
INDEX TRACE command 2-12 syntax A-1 object-spec 2-12 select-spec 2-12 VERSION command syntax A-2 2-13 null object 1-1 object-spec ABORT command 2-2 INFO command 2-3 LISTOPENS command 2-5 START command 2-8 STATUS command 2-9 STOP command 2-11 TRACE command 2-12 select-spec TRACE command 2-12 Index-3
