How to Use the Text-based Search Engine

These are instructions for the "Search Family of Parts" program located at /usr2/aux12/etc/pgms/find/search_family_parts. This program is used to find a part in the Family of Parts Library, and generate it if necessary. The text in a fixed-with font is displayed by the search program, and text in bold is an example of text entered by a user.

At the first prompt, enter the string you want to find. This string is checked against both the part name and part description.

    Family Selection
 
    Enter LIST to get a list of all families.
    Spaces match any character.  Search is case-insensitive.
    Enter string to match against family names and comments
    or q to quit (e.g. 38999, T55164, connector): connector
 
    Matches: 
     1: fpts.d38999-24
            Connectors, Electrical, Circular, Receptacle, Jam-Nut Mounting,
            Removable, Crimp Contacts, Series III
 
     2: fpts.d38999-28
            Connectors, Electrical, Circular, Nut, Hexagon, Connector Mounting,
            Series III and IV

At the next prompt, enter the number of the family that contains the part you need. If none of them match, enter 0 and the search will end. You can then try again with a different string.

    Enter desired master part number (e.g 1, 2, 3) (0 to exit): 1

Once you have selected a family, a message like this will appear:

    These parts only include the shell of the connector.  A space
    has been left in the center for an insert if necessary.  The
    matching nut for each connector is listed in the variable
    Nut_Filename.  The matching nuts are also a family: d38999-28.
    The Member_name is the one-letter Shell Size Code.
 
    View an image of the part? (y/N) 

This tells you important information about the part. If an image of the part is available, the last line will appear. If you enter y, the image will appear on your screen. In any yes/no question, the default answer is capitalized. Thus, for this question, the image is not displayed unless the first letter of the answer is y or Y. If no image is available, or once you answer this question if one is available, a listing of the fields that you can search is presented. From this point on, when you exit a search, you will be given the option to perform a new search using the same family.

    The following variables are defined for this part: 
     1: Member_name
     2: A
     3: B
     4: B2
     5: G_2
     6: HH_2
     7: J
     8: P
     9: Min_RearHt
    10: S
    11: T_2
    12: W
    13: Full_Filename
    14: Nut
    15: Nut_Filename

Enter the number of the fields you want to search, separated by spaces. You will then be prompted for a string to match in each field.

    Enter the numbers of the variables you want to search, 
    separated by spaces (e.g. 1 2 5 12) (0 to quit): 1 2
 
    This is a string comparison.
    Spaces match any character.  Search is case-insensitive.

    Examples: given the values 8.0, 18.0, 28.0, 8.125 and 1.825,
    8 will match 8.0, 18.0, 28.0, 8.125 and 1.825
    8. will match 8.0, 18.0, 28.0, and 8.125, but not 1.825
    8.0 will match 8.0, 18.0, 28.0, but not 8.125 or 1.825.
    ^8. will match 8.0, and 8.125 but not 18.0, 28.0, or 1.825.

    Enter string to match in variable Member_name: d
    Enter string to match in variable A: 1.6

Then, each part that matches the strings you entered will be displayed, one at a time. After each, you will be asked if you want to see if this part exists.

    There were 1 parts found matching all the search strings.
    The matched entries will be displayed one at a time.
    At the y/N/q prompt, enter y to see if the part exists,
    q to exit this search, or anything else to see the next entry.
    Press Return to continue.

    Matched entries: 
 
    Member_name         : D
    A                   : 1.6370
    B                   : 1.0660
    B2                  : 0.5000
    G_2                 : 0.5512
    HH_2                : 0.4000
    J                   : 0.0590
    P                   : 0.5780
    RearHt              : 0.0000
    S                   : 1.5160
    T_2                 : 0.5770
    W                   : 0.0870
    Full_Filename       : fpts.d38999-24-family.D
    Nut                 : 4
    Nut_Filename        : fpts.d38999-28-family.4X
 
    Do you want to see if this part exists? (y/N/q) 

If you answer n, the next matching part is displayed. If you answer q, the search ends. If you answer y, you will see one of the following two responses.

 
    Member D has not been generated.
    Do you want to generate it now (y/N)?

This response is returned if the part doesn't exist yet. If you answer yes, the program will attempt to generate the part for you. Depending on the complexity of this part, and the number of requests the server is currently processing, it may take several minutes to complete your request. If it is successful, you will receive a response telling you so, and giving you the command to activate the part.

    Part generation in progress, please wait.....
    Member 1XP was generated successfully.
    To activate the part, use the command
    activate part fpts.d38999-28-family.1xp

If it fails, mail will be sent to the person in charge of the families of parts with the master part name and member name. This person will receive all the details of the failure and attempt to correct the problem. You will be contacted when the problem has been resolved.

    This part has been generated.
    To activate the part, use the command
    activate part fpts.d38999-24-family.d

This response is returned if the part does exist. You can copy this command into CADDS to activate the part, the same as with the other searches on the system.

You will then be asked if you wish to continue the search. If you do, any more matching parts will be displayed in the same manner. If not, this search will exit and you can perform another.