Cabletron Systems W85 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

Ir para a página of

Bom manual de uso

As regras impõem ao revendedor a obrigação de fornecer ao comprador o manual com o produto Cabletron Systems W85. A falta de manual ou informações incorretas fornecidas ao consumidor são a base de uma queixa por não conformidade do produto com o contrato. De acordo com a lei, pode anexar o manual em uma outra forma de que em papel, o que é frequentemente utilizado, anexando uma forma gráfica ou manual electrónicoCabletron Systems W85 vídeos instrutivos para os usuários. A condição é uma forma legível e compreensível.

O que é a instrução?

A palavra vem do latim "Instructio" ou instruir. Portanto, no manual Cabletron Systems W85 você pode encontrar uma descrição das fases do processo. O objetivo do manual é instruir, facilitar o arranque, a utilização do equipamento ou a execução de determinadas tarefas. O manual é uma coleção de informações sobre o objeto / serviço, um guia.

Infelizmente, pequenos usuários tomam o tempo para ler o manual Cabletron Systems W85, e um bom manual não só permite conhecer uma série de funcionalidades adicionais do dispositivo, mas evita a formação da maioria das falhas.

Então, o que deve conter o manual perfeito?

Primeiro, o manual Cabletron Systems W85 deve conte:
- dados técnicos do dispositivo Cabletron Systems W85
- nome do fabricante e ano de fabricação do dispositivo Cabletron Systems W85
- instruções de utilização, regulação e manutenção do dispositivo Cabletron Systems W85
- sinais de segurança e certificados que comprovam a conformidade com as normas pertinentes

Por que você não ler manuais?

Normalmente, isso é devido à falta de tempo e à certeza quanto à funcionalidade específica do dispositivo adquirido. Infelizmente, a mesma ligação e o arranque Cabletron Systems W85 não são suficientes. O manual contém uma série de orientações sobre funcionalidades específicas, a segurança, os métodos de manutenção (mesmo sobre produtos que devem ser usados), possíveis defeitos Cabletron Systems W85 e formas de resolver problemas comuns durante o uso. No final, no manual podemos encontrar as coordenadas do serviço Cabletron Systems na ausência da eficácia das soluções propostas. Atualmente, muito apreciados são manuais na forma de animações interessantes e vídeos de instrução que de uma forma melhor do que o o folheto falam ao usuário. Este tipo de manual é a chance que o usuário percorrer todo o vídeo instrutivo, sem ignorar especificações e descrições técnicas complicadas Cabletron Systems W85, como para a versão papel.

Por que ler manuais?

Primeiro de tudo, contem a resposta sobre a construção, as possibilidades do dispositivo Cabletron Systems W85, uso dos acessórios individuais e uma gama de informações para desfrutar plenamente todos os recursos e facilidades.

Após a compra bem sucedida de um equipamento / dispositivo, é bom ter um momento para se familiarizar com cada parte do manual Cabletron Systems W85. Atualmente, são cuidadosamente preparados e traduzidos para sejam não só compreensíveis para os usuários, mas para cumprir a sua função básica de informação

Índice do manual

  • Página 1

    HSIM-W85 CPU L S L S L S L S L S L S L S L S Title Page HSIM-W85 User’ s Guide 9032842-01[...]

  • Página 2

    [...]

  • Página 3

    HSIM-W85 User’ s Guide i NOTICE Cabletron Systems reserves the right to make changes in specifications and other information contained in this document without prior notice. The reader should in all cases consult Cabletron Systems to determine whether any such changes ha ve been made. The hardware, firmware, or software described in this manual[...]

  • Página 4

    Notice ii HSIM-W85 User’ s Guide FCC NOTICE This device complies with P art 15 of the FCC rules. Operation is subject to the following tw o conditions: (1) this device may not cause harmful interference, and (2) this de vice must accept any interference receiv ed, including interference that may cause undesired operation. NO TE: This equipment ha[...]

  • Página 5

    Notice HSIM-W85 User’ s Guide iii VCCI NOTICE This is a Class A product based on the standard of the V oluntary Control Council for Interference by Information T echnology Equipment (VCCI). If this equipment is used in a domestic en vironment, radio disturbance may arise. When such trouble occurs, the user may be required to tak e correctiv e act[...]

  • Página 6

    Notice iv HSIM-W85 User’ s Guide 4. EXPORT REQUIREMENTS. You understand that Cabletron and its Affiliates are subject to regulation by agencies of the U.S. Government, including the U.S. Department of Commerce, which prohibit export or diversion of certain technical products to certain countries, unless a license to export the product is obtained[...]

  • Página 7

    Notice HSIM-W85 User’ s Guide v CABLETRON SYSTEMS SALES AND SERVICE, INC. PROGRAM LICENSE AGREEMENT IMPOR T ANT : THIS LICENSE APPLIES FOR USE OF PRODUCT IN THE UNITED ST A TES OF AMERICA AND BY UNITED ST A TES OF AMERICA GO VERNMENT END USERS. BEFORE OPENING OR UTILIZING THE ENCLOSED PR ODUCT , CAREFULL Y READ THIS LICENSE A GREEMENT . This docu[...]

  • Página 8

    Notice vi HSIM-W85 User’ s Guide component of a plant, export to Country Groups D:1 or E:2 the direct product of the plant or a major component thereof, if such foreign produced direct product is subject to national security controls as identified on the U.S. Commerce Control List or is subject to State Department controls under the U.S. Munitio[...]

  • Página 9

    Notice HSIM-W85 User’ s Guide vii IF Y OU HA VE ANY QUESTIONS ABOUT THIS AGREEMENT , CONT A CT CABLETRON SYSTEMS (603) 332-9400. Attn: Legal Department. 1. LICENSE. You have the right to use only the one (1) copy of the Program provided in this package subject to the terms and conditions of this License Agreement. Y ou may not copy , reproduce or[...]

  • Página 10

    Notice viii HSIM-W85 User’ s Guide 6. EXCLUSION OF WARRANTY. Except as may be specifically provided by Cabletron in writing, Cabletron makes no warranty, expressed or implied, concerning the Program (including its documentation and media). CABLETR ON DISCLAIMS ALL W ARRANTIES, O THER THAN THOSE SUPPLIED T O YOU BY CABLETR ON IN WRITING, EITHER EX[...]

  • Página 11

    HSIM-W85 User’ s Guide ix CONTENTS CHAPTER 1 INTRODUCTION 1.1 Firmware Revision ....................................................................... 1-1 1.2 Using This Manual ....................................................................... 1-2 1.3 Overview..................................................................................[...]

  • Página 12

    Contents x HSIM-W85 User’ s Guide CHAPTER 5 T R OUBLESHOOTING 5.1 Troubleshooting the HSIM-W85 .................................................. 5–1 5.1.1 Hardware Troubleshooting ............................................. 5–1 5.1.2 Investigating Software Configuration Problems ............. 5–3 5.1.3 Problems with the Firmware Image ..[...]

  • Página 13

    HSIM-W85 User’ s Guide 1-1 CHAPTER 1 INTR ODUCTION W elcome to the Cabletron Systems HSIM-W85 User’s Guide . This manual describes the HSIM-W85 and provides information concerning features, installation, the use of management, troubleshooting, and specifications. A general working kno wledge of W ide Area Networking (W AN), including T1 Netw o[...]

  • Página 14

    Chapter 1: Introduction 1-2 HSIM-W85 User’ s Guide 1.2 USING THIS MANUAL Reading through this manual completely will help you understand the features and capabilities of the HSIM-W85. The follo wing list provides an ov ervie w of each section of this manual: Chapter 1 , Introduction , outlines the contents of this manual, describes the HSIM-W85 f[...]

  • Página 15

    Overview HSIM-W85 User’ s Guide 1-3 1.3 OVERVIEW The HSIM-W85 extends the functionality of certain Cabletron Systems platforms by providing an interf ace for W ide Area Network (W AN) DS1 services. The HSIM-W85 is a High Speed Interf ace Module (HSIM) used to provide W AN services using the SmartSwitch series of products as a platform. The HSIM-W[...]

  • Página 16

    Chapter 1: Introduction 1-4 HSIM-W85 User’ s Guide The second mode of operation is using Cabletron Systems In verse Multiplex er (IMUX) functionality to aggregate multiple DS1 connections into single higher bandwidth W AN connections. T o operate in this mode, the user configures the appropriate IMUX groups containing the DS1 connections. Along [...]

  • Página 17

    Features HSIM-W85 User’ s Guide 1-5 • DS1 MIB Support • LANVIEW LEDs 1.5.1 Connectivity The HSIM-W85 module supports W AN technology using eight li ve full duplex T1 connections. The primary function of the HSIM-W85 is to provide LAN-to-W AN access. W AN physical connecti vity will be supported through the use of a T1 interface. LAN-to-W AN c[...]

  • Página 18

    Chapter 1: Introduction 1-6 HSIM-W85 User’ s Guide 1.5.3 In verse Multiplexing (IMUX) Cabletron Systems In verse Multiplexing (IMUX) feature pro vides enhanced throughput for users by follo wing this process: • The IMUX function e venly distrib utes a data packet stream from the LAN interface through multiple full T1 W AN interfaces on the HSIM[...]

  • Página 19

    Features HSIM-W85 User’ s Guide 1-7 1.5.5 DS1 Alarm The DS1 Error Threshold Alarm Monitor allo ws the user to set error thresholds. The monitor notifies the user of potential DS1 problems with SNMP trap e vents. The ds1alarm Monitor feature can be enabled in management, using Network T ools. Refer to the ds1alarm command in the Management chapte[...]

  • Página 20

    Chapter 1: Introduction 1-8 HSIM-W85 User’ s Guide 1.6 DOCUMENT CON VENTIONS The follo wing con ventions are used throughout this document: NO TE Note symbol. Calls the reader’ s attention to any item of inf ormation that may be of special impor tance. ! CA UTION Caution symbol. Contains inf ormation essential to avoid damage to the equipment. [...]

  • Página 21

    Related Documentation HSIM-W85 User’ s Guide 1-9 1.7 RELATED DOCUMENTATION The documentation for the host platform in which the HSIM-W85 is to be installed provides additional information about the setup of the HSIM-W85. The host documentation is not listed belo w , as there can be many dif ferent host platforms. This user’ s guide may referenc[...]

  • Página 22

    Chapter 1: Introduction 1-10 HSIM-W85 User’ s Guide 1.8 GETTING HELP For additional support related to this de vice or document, contact Cabletron Systems using the follo wing methods: Before calling Cabletron Systems, have the following information ready: • Y our Cabletron Systems service contract number • A description of the failure • A [...]

  • Página 23

    HSIM-W85 User’ s Guide 2-1 CHAPTER 2 INSTALLATION T o install the HSIM-W85 the following items are required: • Antistatic wrist strap (shipped with the HSIM-W85) • Phillips scre wdri ver 2.1 UNPACKING THE HSIM-W85 Unpack the HSIM-W85 as follo ws: 1. Remove the HSIM-W85 from the shipping box. 2. Leave the module in its antistatic bag until you[...]

  • Página 24

    Chapter 2: Installation 2-2 HSIM-W85 User’ s Guide 2.2 INSTALLING THE HSIM-W85 An HSIM-W85 can be installed in any Cabletron Systems de vice that supports HSIM technology (e.g., 2H252-25R, 2E42-27, 6E132-25). The follo wing subsections provide instructions for installing an HSIM-W85 in a host platform. Refer to the specific interface module or s[...]

  • Página 25

    Installing the HSIM-W85 HSIM-W85 User’ s Guide 2-3 Figure 2-1 Removing the HSIM Co verplate 6. Refer to Figure 2-2 and place the HSIM-W85 behind the module faceplate. Faceplate Mounting Screws HSIM Coverplate 2555_03 Host Platform[...]

  • Página 26

    Chapter 2: Installation 2-4 HSIM-W85 User’ s Guide Figure 2-2 Installing the HSIM-W85 7. Align the connector on the HSIM-W85 with the pins on the module. 8. Press down firmly on the connector area of the HSIM-W85 until the connector slides all the way onto the pins. Ensure that the standoffs on the interface module align with the standoff screw h[...]

  • Página 27

    Installing the HSIM-W85 HSIM-W85 User’ s Guide 2-5 10. Secure the HSIM-W85 to the module standoffs using the standoff screws included in the HSIM-W85 shipping materials. 11. Reinstall the interface module in the chassis. 12. Reattach the network cabling to the interface module. 2.2.2 Installing the HSIM-W85 in a Standalone Device T o install an H[...]

  • Página 28

    Chapter 2: Installation 2-6 HSIM-W85 User’ s Guide 8. Press down firmly on the HSIM-W85 until the connector slides all the way onto the HSIM pins. Ensure that the standoffs on the standalone device align with the standoff screw holes on the HSIM-W85. 9. Secure the HSIM-W85 to the module faceplate using the mounting screws saved in step 5 . 10. Se[...]

  • Página 29

    HSIM-W85 User’ s Guide 3-1 CHAPTER 3 LANVIEW LEDs 3.1 LANVIEW LEDS This chapter describes ho w to use the LANVIEW LEDs to monitor the HSIM-W85 status and diagnose HSIM-W85 problems. Figure 3-1 sho ws the location of the HSIM-W85 LEDs. Figure 3-1 HSIM-W85 LANVIEW LEDs NO TE The terms flashing , blinking , and solid used in T able 3-1 indicate the [...]

  • Página 30

    Chapter 3: LANVIEW LEDs 3-2 HSIM-W85 User’ s Guide T able 3-1 HSIM-W85 LEDs LED Color Definition Processor (CPU) Off P ower Off Green (solid) Fully operational Red (solid) System in reset mode (temporary) Link (L) Red No Link or Receive signal Amber T raffic on at least one por t Green Link Status (S) Off Normal (not in loopback) Red Red Alarm-[...]

  • Página 31

    HSIM-W85 User’ s Guide 4-1 CHAPTER 4 MANAGEMENT This chapter describes Local Management and the Network T ools utility . Local Management allo ws access to statistics screens that apply to the HSIM-W85 through the host platform. Network T ools allows access to a command set from which you can configure and manage the HSIM-W85. This chapter provi[...]

  • Página 32

    Chapter 4: Management 4-2 HSIM-W85 User’ s Guide Figure 4-1 T ypical Hierarch y of Local Management Screens NO TE Diff erent v ersions of the firmware may displa y a different hierarch y . Chec k the host platf or m manual if the hierarch y displa yed does not match the one in Figure 4-1 . The HSIM/VHSIM Statistics menu option below the De vice [...]

  • Página 33

    Network T ools HSIM-W85 User’ s Guide 4-3 4.2 NETWORK T OOLS The Network T ools utility allows management of objects in the HSIM-W85 Management Information Bases (MIBs). MIBs are databases of objects used for managing the de vice and configuring the HSIM-W85. The commands within the MIB Navigator allo w the user to view and modify a de vice’ s[...]

  • Página 34

    Chapter 4: Management 4-4 HSIM-W85 User’ s Guide Only the pre vious commands, which are particular to the HSIM-W85, will be described in the follo wing sections. The host platform’ s manual describes the other commands that are not particular to the HSIM-W85. Refer to the host platform manual for information on the other commands. 4.2.1 Command[...]

  • Página 35

    Network T ools HSIM-W85 User’ s Guide 4-5 Figure 4-2 Network T ools Help Screen The Network T ools functions are performed using a series of commands. Entering commands in Network T ools in v olves typing the command at the Network T ools prompt, adding any required parameters, and pressing ENTER to ex ecute the command. There are two cate gories[...]

  • Página 36

    Chapter 4: Management 4-6 HSIM-W85 User’ s Guide The commands are presented in the follo wing format: command Syntax: Sho ws the required command format. It indicates where arguments, if an y , must be specified. Description: Briefly describes the command and its uses. Options: Lists any additional fields in the appropriate format that may be [...]

  • Página 37

    Network T ools HSIM-W85 User’ s Guide 4-7 4.2.2 Built-in Commands The built-in commands listed in this section acti vate configuration and vie wing functions on the HSIM-W85. imux Syntax: imux <IMUXID> imux <IMUXID> -[ea | da] imux <IMUXID> -[eg | dg] <GR OUPID> imux <IMUXID> -[ac | dc] <GR OUPID> <INTERF A[...]

  • Página 38

    Chapter 4: Management 4-8 HSIM-W85 User’ s Guide Options: imux <IMUXID> (with no options) displays status information. -ea enables the In verse Multiplex er Application designated by IMUXID. -da disables the In verse Multiplex er Application designated by IMUXID. -eg <GR OUPID> enables the In verse Multiplex er group designated by GR [...]

  • Página 39

    Network T ools HSIM-W85 User’ s Guide 4-9 wanpq Syntax: wanpq wanpq -ea wanpq -da wanpq -aip <IP ADDRESS> wanpq -dip <IP ADDRESS> Description: W AN IP Priority Queuing is used to prioritize IP packets from a specified IP address. IP ADDRESS is the Internet Protocol (IP) address being added to or remov ed from the W ide Area Network P[...]

  • Página 40

    Chapter 4: Management 4-10 HSIM-W85 User’ s Guide ds1alarm Syntax: ds1alarm ds1alarm -[ea | da] <W ANID> ds1alarm -[et | dt] <W ANID> ds1alarm -sec <W ANID> <V ALUE> ds1alarm -sei <W ANID> <V ALUE> ds1alarm -sbr <W ANID> <V ALUE> ds1alarm -sbi <W ANID> <V ALUE> ds1alarm -mr <W ANID>[...]

  • Página 41

    Network T ools HSIM-W85 User’ s Guide 4-11 Example: dsx1 Syntax: dsx1 dsx1 near dsx1 near <1..96> dsx1 linetype <ESF|D4> <line> dsx1 loopback <no|payload|line> <line> dsx1 txclksrc <loop|local> <line> dsx1 <line> dsx1 <line> <ES|SES|SEFS|U AS|CSS|PCV|LES|BES|DM|LCV> Description: This com[...]

  • Página 42

    Chapter 4: Management 4-12 HSIM-W85 User’ s Guide Options: dsx1 (with no options) lists a summary of the DS1 configuration. dsx1 near lists a summary of the statistics for the de vice on your side of the W AN line. dsx1 near <1..96> lists a summary of the statistics for the de vice on your side of the W AN line for a specific time interv [...]

  • Página 43

    Network T ools HSIM-W85 User’ s Guide 4-13 ds1ext Syntax: ds1ext ds1ext crc <CRCV AL> <LINE> ds1ext linecode <LCV AL> <LINE> ds1ext lbo <LBO V AL> <LINE> Description: This command allo ws the user to modify v arious ds1 parameters that are extensions to RFC 1406. The follo wing is an explanation of the v arious[...]

  • Página 44

    Chapter 4: Management 4-14 HSIM-W85 User’ s Guide Example: 4.2.3 Special Commands done, quit, exit Syntax: done quit exit Description: The done, exit, or quit command enables the user to e xit from Network T ools and return to the Main Menu screen. All three commands perform the same function. Options: Not Applicable Example: Screen returns to pr[...]

  • Página 45

    Sample IMUX Configuration HSIM-W85 User’ s Guide 4-15 4.3 SAMPLE IMUX CONFIGURATION The follo wing is a sample of a common configuration. T o perform an IMUX configuration for the setup shown in Figure B-1 , in Appendix B , follo w these steps: 1. To add channels to an IMUX group: Enter: imux 1 -ac 1 29 (This adds interface 29 to the group id [...]

  • Página 46

    Chapter 4: Management 4-16 HSIM-W85 User’ s Guide Figure 4-4 Enabling the IMUX Gr oup 3. The next step is to enable the imux application for imux 1: Enter: imux 1 -ea The screen in Figure 4-5 displays the response to the command. Figure 4-5 Enabling the IMUX Application imuxsetup2 -> imux 1 # # W AN Inverse Multiplexer 1 Status: Disabled # # I[...]

  • Página 47

    Sample IMUX Configuration HSIM-W85 User’ s Guide 4-17 This configuration is complete. More groups can be added as needed. The commands dsx1 and/or ds1alarm can be used to verify the interf ace numbers configured. Done, exit, or quit may be used after v erification to leav e Network T ools.[...]

  • Página 48

    Chapter 4: Management 4-18 HSIM-W85 User’ s Guide[...]

  • Página 49

    HSIM-W85 User’ s Guide 5-1 CHAPTER 5 T ROUBLESHOOTING 5.1 T ROUBLESHOOTING THE HSIM-W85 The follo wing sections detail some of the problems encountered in hardware, software, and firmw are setups and the possible solutions. If a problem persists, contact Cabletron Systems. Refer to Section 1.8 . 5.1.1 Hard ware T r oubleshooting No LEDs on • C[...]

  • Página 50

    Chapter 5: T roubleshooting 5-2 HSIM-W85 User’ s Guide • Check with the W AN Service Provider to ensure that the circuit has been configured by them and is acti ve. Status (S) LED is OFF The port is operating normally . If it is not, and this LED is OFF , the port may be disabled. Use management to make sure that the W AN interface on the HSIM[...]

  • Página 51

    T r oubleshooting the HSIM-W85 HSIM-W85 User’ s Guide 5-3 5.1.2 In vestigating Software Configuration Problems Software problems usually occur when your software configuration contains incomplete or incorrect information. Device not f orwar ding packets • Ensure that the proper DS1 transmit clock source is configured using the dsx1 command i[...]

  • Página 52

    Chapter 5: T roubleshooting 5-4 HSIM-W85 User’ s Guide[...]

  • Página 53

    HSIM-W85 User’ s Guide A-1 APPENDIX A SPECIFICATIONS This chapter lists the specifications and regulatory requirements for the HSIM-W85. Cabletron Systems reserves the right to change these specifications at any time without notice. A.1 PHYSICAL PR OPERTIES WAN Interface 8 DS1 por ts Physical Interface RJ45 connectors Cable Type T wisted pair M[...]

  • Página 54

    Appendix A: Specifications A-2 HSIM-W85 User’ s Guide A.2 EN VIR ONMENTAL REQUIREMENTS A.3 REGULATOR Y COMPLIANCE This equipment meets the follo wing safety and electromagnetic compatibility (EMC) requirements: Operating Temperature 5°C to 40°C (41°F to 104°F) Storage Temperature -30°C to 73°C (-22°F to 164°F) Operating Relative Humidity[...]

  • Página 55

    HSIM-W85 User’ s Guide B-1 APPENDIX B T YPICAL CONFIGURATION The HSIM-W85 can be used to aggregate up to eight T1 connections to the backbone, which may be linked to a head-end consisting of an HSIM-W87 in a platform. The HSIM-W85 is compatible with an y Cabletron Systems product that runs HDLC W AN protocol. NO TE In Figure B-1 , the 2E42-27 is [...]

  • Página 56

    Appendix B: T ypical Configuration B-2 HSIM-W85 User’ s Guide Figure B-1 HSIM-W85 IMUX Operational M13 T elco Cloud Up to 28 T1 Lines T3 configW85 2E42-27 with HSIM-W85 2E42-27 with an HSIM-W87 CSX400 T1 Configuration IMUX Configuration CSX400 CSX400 CSX400 HSIM-W85 CPU L S L S L S L S L S L S L S L S HSIM-W85 CPU L S L S L S L S L S L S L S L S[...]

  • Página 57

    HSIM-W85 User’ s Guide C-1 APPENDIX C FCC P ART 68 - USER’ S INFORMATION The follo wing instructions are provided to ensure compliance with the Federal Communications Commission (FCC) Rules, Part 68. 1. All direct connections to T1 lines must be made using standard plugs and jacks. 2. Before connecting your unit, you must inform the telephone c[...]

  • Página 58

    Appendix C: FCC P AR T 68 - User’ s Information C-2 HSIM-W85 User’ s Guide 7. The attached affidavit must be completed by the installer. 8. In the event of equipment malfunction, all repairs should be performed by our Company or an authorized agent. It is the responsibility of the users requiring service to report the need for service to our Co[...]

  • Página 59

    FCC P ART 68 - User’ s Inf ormation HSIM-W85 User’ s Guide C-3 AFFIDAVIT FOR THE CONNECTION OF CUSTOMER EQUIPMENT TO 1.544 MBPS AND/OR SUBRATE DIGITAL SERVICES For the w ork to be performed in the certified territory of T elco’ s name: State of: Country of: I , , o f (Name of Authorized Representative) (Customer Name) , (Customer’ s Addres[...]

  • Página 60

    Appendix C: FCC P AR T 68 - User’ s Information C-4 HSIM-W85 User’ s Guide I attest that the operator(s) maintainer(s) of the digital CPE responsible for the establishment, maintenance and adjustment of the encoded analog content and billing information has (hav e) been trained to perform these functions by successfully completing one of the fo[...]