Messages

This chapter contains descriptions of the messages generated and displayed as the direct result of an installation or upgrade. Some messages are generated by the install utility when it is executed with the -e or -w parameter; Thoroughbred Basic generates some after it is installed or upgraded. All messages are alphabetically ordered.

BASIC Installation corrupt. Please reload from media

Explanation: Thoroughbred Basic cannot read at least one of its system files. You cannot run Thoroughbred Basic.

Action: If you have validated Thoroughbred Basic by entering an Activation Key please report this problem to your Thoroughbred dealer.

If you have not validated Thoroughbred Basic by entering an Activation Key you can perform the installation or upgrade procedure described in The installation or upgrade procedure or in Installation and Upgrade Tasks.

As part of the procedure you must remove the tbredbas.nn file from the Thoroughbred Basic home directory. When you reuse the install utility, take notes on what procedures you follow, what messages are displayed, and so on.

If this error recurs, please write down the Thoroughbred Basic software serial number, your operating system, how your system is configured, the actions you took that preceded the error, the error message, and all other relevant information. Please report this problem to your Thoroughbred dealer.

c_chns: was able to open n system channels

Explanation: The install utility displays how many operating system file channels are available for Thoroughbred Basic:

n is the number of available operating system file channels.

Most UNIX systems have at least 20 file channels available.

Action: Because this is an informative message, no action is required.

c_fnl: File name length was found to be n characters

Explanation: The install utility displayed the maximum number of characters your operating system allows in one file name:

n is the maximum length of a file name on your system.

Most UNIX systems enable you to specify file names that are from 1 through 14 characters long, but some enable file names that can be up to 1024 characters long.

Action: Although Thoroughbred Basic can accept file names that are more than 14 characters long, you must consider portability issues when you name files. If you plan to run Thoroughbred Basic under more than one UNIX system, you may need to establish or follow site-naming conventions for files.

c_fnl: System did not return a "Filename too long" error message

Explanation: The install utility determined that your operating system did not generate a warning message when a file name was too long. For example, if your UNIX system allows you to specify file names that are from 1 through 14 characters long, your system will not generate an error message if you create a file name that is at least 15 characters long: your system will just truncate the file name by removing the rightmost characters.

If you use long file names, especially names that differ only in the rightmost positions, such as PLYMOUTHOLDSMOBILE88 and PLYMOUTHOLDSMOBILE98, truncated file names can cause your system to overwrite needed files.

Action: You can determine whether your system can generate a “Filename too long” message. If the system is capable, you may need to reconfigure your system so that it consistently generates this message. In any event, you may need to establish or follow site-naming conventions for files to help avoid the problems this condition can cause.

c_fnl: System does not return "Filename too long" error message

Explanation: The install utility determined that your operating system cannot generate a warning message when a file name is too long. For example, if your UNIX system allows you to specify file names that are from 1 through 14 characters long, your system will not generate an error message if you create a file name that is at least 15 characters long: your system will just truncate the file name by removing the rightmost characters.

Action: You can determine whether your system can generate a “Filename too long” message; if the system is capable, you may need to reconfigure your system so that it consistently generates this message. In any event, you may need to establish or follow site naming conventions for files to help avoid the problems this condition can cause.

c_fnl: System returned a "Filename too long" error message

Explanation: The install utility determined that your operating system can generate a warning message when a file name is too long. For example, if your UNIX system allows you to specify file names that are from 1 through 14 characters long, your system will generate an error message if you create a file name that is at least 15 characters long.

Action: Because this is an informative message, no action is required. However, you may need to establish or follow site-naming conventions for files to avoid the delays or problems this condition can cause.

c_gh: Created 1 shared memory segment for n ghosts.

Explanation: The install utility created a shared memory segment through which background tasks can communicate. This message displays how many ghost tasks can operate through one such segment:

n is the number of ghost tasks that can communicate through the shared memory segment.

Action: Because this is an informative message, no action is required.

c_gh: Created n semaphore ID's

Explanation: The install utility displayed the number of available semaphore IDs:

n is the number of available semaphore IDs.

Each Thoroughbred Basic ghost task requires one semaphore ID, so n is equivalent to the number of background tasks one copy of Thoroughbred Basic can run on your system. Thoroughbred Basic enables you to specify up to 36 concurrent ghost tasks.

If you have a second copy of Thoroughbred Basic on your system with a different Inter-Process Communication (IPC) key that copy can have its own set of up to 36 ghost tasks.

Action: If the displayed number of semaphore IDs seems low, check your system. If other tasks and users are active, some other processes may be using some of the semaphore IDs. You can use a system program such as ipcs to check current semaphore ID use.

You can also check the values specified for some tunable parameters against the recommended values listed below:

SEMMAP (entries in semaphore map): 62
SEMMNI (semaphore identifiers): 62
SEMMNS (semaphores in system): 186

If other software products require shared memory, you can use the PRM IPCKEY statement to enable Thoroughbred Basic and the other products to concurrently use memory resources. For more information on the PRM IPCKEY statement, please refer to the Thoroughbred Basic Customization and Tuning Guide.

After you get the relevant information, you can decide how to configure your system so that you can run more ghost tasks.

c_gh: Failed to create shared memory segment

Explanation: The install utility could not create a shared memory segment through which background tasks can communicate. Thoroughbred Basic cannot run ghost tasks without this segment.

Action: If you plan to run ghost tasks, you can review your operating system documentation and current configuration to determine why your system could not create a shared memory segment. After you fix the problem, you can use the install -e command to verify that the problem is solved.

c_gh: System cannot support ghosts!

Explanation: The install utility determined that your system cannot currently support Thoroughbred Basic background tasks.

Action: Because each Thoroughbred Basic ghost task requires one semaphore ID, the number of background tasks you can run is equivalent to the number of semaphore IDs currently available on your system. Check your system: if your system is not clear of other tasks and users, some other processes may be using the semaphore IDs. You can use a system program such as ipcs to check current semaphore ID use.

You can also check the values specified for some tunable parameters against the recommended values listed below:

SEMMAP (entries in semaphore map): 62
SEMMNI (semaphore identifiers): 62
SEMMNS (semaphores in system): 186

After you get the relevant information, you can decide how to configure your system so that you can run more ghost tasks.

c_gh: System should support n ghosts

Explanation: The install utility displayed the number of background tasks Thoroughbred Basic can currently support:

n is the number of ghost tasks.

Thoroughbred Basic enables you to specify up to 36 concurrent ghost tasks.

Action: Because each Thoroughbred Basic ghost task requires one semaphore ID, the number n is equivalent to the number of semaphore IDs currently available on your system. If the displayed number of ghost tasks seems low, check your system. If other tasks and users are active, some other processes may be using some of the semaphore IDs. You can use a system program such as ipcs to check current semaphore ID use.

You can also check the values specified for some tunable parameters against the recommended values listed below:

SEMMAP (entries in semaphore map): 62
SEMMNI (semaphore identifiers): 62
SEMMNS (semaphores in system): 186

After you get the relevant information, you can decide how to configure your system so that you can run more ghost tasks.

c_lcks: Warning: Need x locks, system supports y locks

Explanation: The install utility has determined that your system does not have enough system locks. It displayed the number of system locks your operating system requires and the number of locks it could create:

x is the number of locks.
y is the number of users Thoroughbred Basic can support.

The install utility assumes that each user requires 30 locks, which is the recommended value for Thoroughbred Basic.

Action: If the number y seems low, check your system. If your system is not clear of other tasks and users, some other processes may be using the locks.

You can also check the value specified for the NFLOCKS tunable parameters against the recommended value listed below:

NFLOCKS (locks for entire operating system): 30 per user

After you get the relevant information, you can decide how to configure your system so that your operating system and Thoroughbred Basic can support more users.

c_lcks: Warning: Not enough locks to fully support this BASIC

Explanation: The install utility has determined that your operating system does not have enough system locks to reliably support Thoroughbred Basic. The install utility assumes that each user requires 30 locks, which is the recommended value for Thoroughbred Basic.

If you don’t have enough system locks, Thoroughbred Basic will run but it will generate Error 0 messages.

Action: Check your system: if your system is not clear of other tasks and users, some other processes may be using the locks. You can also check the value specified for the NFLOCKS tunable parameters against the recommended value listed below:

NFLOCKS (locks for entire operating system): 30 per user

After you get the relevant information, you can decide how to configure your system so that your operating system and Thoroughbred Basic can support more users.

c_lcks: We were able to create x locks, this should support y users

Explanation: The install utility displayed the number of system locks it could create and the number of users your operating system can manage with that number of locks:

x is the number of locks.
y is the number of users Thoroughbred Basic can support.

The install utility assumes that each user requires 30 locks, which is the recommended value for Thoroughbred Basic.

Action: If the numbers x and y seem low, check your system. If your system is not clear of other tasks and users, some other processes may be using the locks.

You can also check the value specified for the NFLOCKS tunable parameters against the recommended value listed below:

NFLOCKS (locks for entire operating system): 30 per user

After you get the relevant information, you can decide how to configure your system so that your operating system and Thoroughbred Basic can support more users.

c_mlck: Advisory Locking in effect

Explanation: The install utility determined that your operating system can support advisory file locking.

Action: Because this is an informative message no action is required. For more information on advisory locking, please refer to the description of the PRM READONLY statement in the Thoroughbred Basic Customization and Tuning Guide.

c_mlck: Mandatory locking in effect

Explanation: The install utility determined that your operating system can support mandatory file locking.

Action: Because this is an informative message no action is required. For more information on mandatory locking, please refer to the description of the PRM READONLY statement in the Thoroughbred Basic Customization and Tuning Guide.

c_mlck: Unable to fork

Explanation: The install utility could not create a child process to test mandatory or advisory locking procedures. If this condition persists, Thoroughbred Basic cannot run on your system.

Action: Check your system: if your system is not clear of other tasks and users, some other processes may be using too many system locks. You can also check the value specified for the NFLOCKS tunable parameters against the recommended value listed below:

NFLOCKS (locks for entire operating system): 30 per user

If your system has too few system locks, specify a new value for NFLOCKS before you try to reuse the install utility. If your system has enough system locks, reuse the install utility and take notes on what procedures you follow, what messages are displayed, and so on.

If the error recurs, please write down the Thoroughbred Basic software serial number, your operating system, how your system is configured, the actions you took that preceded the error, the error message, and all other relevant information. Please report this problem to your Thoroughbred dealer.

c_mlck: Unable to lock test record

Explanation: The install utility could not secure a lock on a file to test mandatory or advisory file locking. If this condition persists, Thoroughbred Basic cannot run on your system.

NFLOCKS (locks for entire operating system): 30 per user

c_use: Cannot determine user/validity count

Explanation: The install utility could not determine just how many users Thoroughbred Basic can support on this system.

Action: Leave the install utility, return to the operating system prompt in the Thoroughbred Basic home directory, and enter install -e or install -w. Take notes on what procedures you follow, what messages are displayed, and so on.

c_use: ok status

Explanation: The install utility reported positive results for internal diagnostic tests.

Action: Because this is an informative message, no action is required.

c_use: Unable to fork

Explanation: The install utility could not create a child process to test mandatory or advisory locking procedures. If this condition persists, Thoroughbred Basic cannot run on your system.

NFLOCKS (locks for entire operating system): 30 per user

c_use: Unable to lock test record

Explanation: The install utility could not secure a lock on a file to test mandatory or advisory file locking. If this condition persists, Thoroughbred Basic cannot run on your system.

NFLOCKS (locks for entire operating system): 30 per user

ERROR occurred during installation. Installation must be done as root from a
      terminal.

Explanation: You did not log in as root before you installed or upgraded Thoroughbred Basic. The installation or upgrade is not valid and Thoroughbred Basic will not run.

Action: You can use the information in Installation and Upgrade Tasks, to perform a valid installation or upgrade.

ERROR: TERMINAL file cannot be opened. Contact your authorized Thoroughbred
      Dealer or Thoroughbred's Product Support department at: phone:
      (800)524-0430 or (732)560-1377.

Explanation: Thoroughbred Basic cannot read its TERMINAL file. The TERMINAL file contains specifications for the site terminals available to Thoroughbred Basic.

Action: The Thoroughbred Basic home directory contains the TERMINAL file. If the file exists make sure that the user who received this error message has the set of permissions needed to run Thoroughbred Basic.

If the file does not exist and you have a backup copy of the TERMINAL file, you can restore the file, check the sets of permissions for the TERMINAL file and the user, and try again. If you do not have a backup copy of the TERMINAL file you can use the information in Installation and Upgrade Tasks to reinstall Thoroughbred Basic.

If the error recurs, you can use the information in the Thoroughbred Basic Customization and Tuning Guide to check or recreate the TERMINAL file. If the TERMINAL file and the necessary permission sets are valid and you continue to receive this message, please write down the Thoroughbred Basic software serial number, your operating system, how your system is configured, the actions you took that preceded the error, the error message, and all other relevant information. Please report this problem to your Thoroughbred dealer.

ERROR: TERMINAL file cannot be opened

Explanation: Thoroughbred Basic cannot read its TERMINAL file. The TERMINAL file contains specifications for the site terminals available to Thoroughbred Basic.

Action: In most cases, this message is the result of a permissions violation.

Make sure that the user who received this error message has the set of permissions needed to run Thoroughbred Basic. If the set of permissions is valid and you have a backup copy of the TERMINAL file, you can restore the file, check the sets of permissions for the TERMINAL file and the user, and try again. If you do not have a backup copy of the TERMINAL file you can use the information in the Thoroughbred Basic Customization and Tuning Guide to create a TERMINAL file. As a last resort, you can use the information in Installation and Upgrade Tasks to reinstall Thoroughbred Basic.

If the error recurs, you can use the information in the Thoroughbred Basic Customization and Tuning Guide to check the TERMINAL file. If you continue to receive this message, please write down the Thoroughbred Basic software serial number, your operating system, how your system is configured, the actions you took that preceded the error, the error message, and all other relevant information. Please report this problem to your Thoroughbred dealer.

ERROR: TERMINAL FILE IS NOT PRESENT

Explanation: Thoroughbred Basic cannot read its TERMINAL file. The TERMINAL file contains specifications for the site terminals available to Thoroughbred Basic.

If the file does not exist and you have a backup copy of the TERMINAL file, you can restore the file, check the sets of permissions for the TERMINAL file and the user, and try again. If you do not have a backup copy of the TERMINAL file you can use the information in the Thoroughbred Basic Customization and Tuning Guide to create a TERMINAL file. As a last resort, you can use the information in Installation and Upgrade Tasks to reinstall Thoroughbred Basic.

ERROR: TERMINAL file specifies too many terminals. Remove extra terminal
      specifications from file.

Explanation: The TERMINAL file contains too many terminal definitions. You can specify up to 930 terminals in the TERMINAL file.

Action: The TERMINAL file is located in the Thoroughbred Basic home directory. You can use the information in Establish your system console or the Thoroughbred Basic Customization and Tuning Guide to remove unnecessary terminal specifications from this file. Make sure the TERMINAL file contains no more than 930 terminal definitions before you run Thoroughbred Basic

ERROR: This terminal is not defined in TERMINAL file

Explanation: You tried to run Thoroughbred Basic on a terminal that is not defined in the TERMINAL file. Thoroughbred Basic cannot run on an undefined terminal.

Action: The TERMINAL file is located in the Thoroughbred Basic home directory. You can use the information in Establish your system console or the Thoroughbred Basic Customization and Tuning Guide to add relevant terminal specifications to this file. After you add a valid definition for the terminal you can run Thoroughbred Basic on that terminal.

ERROR: This terminal is not defined in TERMINAL file. This terminal cannot be
      used to execute BASIC since it is not listed in the TERMINAL file. The
      file must be modified if you wish to run BASIC from this terminal.

Explanation: You tried to run Thoroughbred Basic on a terminal that is not defined in the TERMINAL file. Thoroughbred Basic cannot run on an undefined terminal.

Action: The TERMINAL file is located in the Thoroughbred Basic home directory. You can use the information in Establish your system console or the Thoroughbred Basic Customization and Tuning Guide to add relevant terminal specifications to this file. After you add a valid definition for the terminal you can run Thoroughbred Basic on that terminal.

ERROR: Too many users running Basic.

Explanation: Only a certain number of users can concurrently run Thoroughbred Basic. When that limit is reached you cannot log on. For example, if your site has an eight-user version of Thoroughbred Basic and eight users are running the program, a ninth user will not be able to log on to Thoroughbred Basic.

Action: After another user stops running Thoroughbred Basic you can log on to the program. If this problem persists you may want to purchase an upgrade to increase the maximum number of users who can simultaneously run Thoroughbred Basic.

From the Thoroughbred Basic for UNIX and Linux Installation Guide, version 8.9.1. Open this page in the PDF