Almcall
From Jaymzworld
Contents |
Name
almcall - set the telephone numbers to services, enable or disable alarm abbreviation on those numbers, and interval between retries. The switch reports Major and Minor alarms by placing an automatic call to Operations Support System (OSS) telephone number or numbers depending on how it is administered.
Synopsis
almcall [-f first-number] [-a [y|n]] [-s second-number] [-b [y|n]] [-t [alarm-abbreviation-timer]] [-i [interval]] | [-?]
Description
Set the phone numbers and retry strategy for the system to dial alarms out.
- no parameters
- Display the administered information: first and second phone numbers, alarm abbreviation settings, and the interval between retries. If you enter the command almcall with out defining any parameters, the command will display all of the field information that is currently administered.
- -f first-number
- Set the first number to dial out to first-number. This will be the first telephone number used by the system for dialing out alarms to an Operations Support System (OSS). The number can have 30 characters, including digits (0-9) and "," for a pause. Entering dashes is allowed but they will be ignored by the system.
- -a [y|n]
- Set alarm abbreviation on ((y)es) or off ((n)o) for the first telephone number. When this parameter is set to yes, abbreviated alarming will be turned on for alarms sent out over the first telephone number administered (first-number).
- -s second-number
- Set the second number to dial out to second-number. This will be the second telephone number used by the system for dialing out alarms to an OSS, if the first telephone number fails. The number can have 30 characters, including digits (0-9) and "," for a pause. Entering dashes is allowed but they will be ignored by the system.
- -b [y|n]
- Set alarm abbreviation on ((y)es) or off ((n)o) for the second telephone number. When this parameter is set to yes, abbreviated alarming will be turned on for alarms sent out over the second telephone number administered (second-number).
- -t [alarm-abbreviation-timer]
- Set the alarm abbreviation timer. The timer can be a value between 1 and 24 hours. By default, the system has a timer set to 4 hours. To reset the timer to the default value, issue the command without a value, for example: almcall -t
- -i interval
- Set the interval between retries in minutes. If "retries" is set to 0, this value will be ignored. This is the number of minutes that the system must wait before attempting another call origination to an OSS. The interval can be between 1 and 20 minutes. The default value is 7 minutes. To reset the interval to the default value, issue the command without a value, for example: almcall -i
- -?
- Display the command usage.
Diagnostics
If these values appear to be ignored, please run productid and almenable commands to verify that all pertinent parameters are set. The following errors may be produced:
- 1 Error reading existing parameters
- This message is displayed when there is a problem reading the configuration file. Please try later. If the problem persists, please contact support.
- 2 Invalid parameters entered
- To see what parameters the command will recognize, please type almcall -?
- 3 The file is in use by someone else. The parameters were not saved
- This message indicates that another person is attempting to modify the administration for alarming. Please try again later. If the problem persists, please contact support.
- 4 You do not have permission to execute this command
- In order to modify alarm parameters, you must be a super user.
- 5 Error saving parameters
- This error message indicates a problem with the configuration file. Please try later. If the problem persists, please contact support. To verify that the file is not corrupted, please run the command without parameters to display their values:
- 6 Invalid First OSS telephone number
- The telephone number was not entered in a recognized format. Please see the description of -f first-number above for more details on the format the phone number should take.
- 7 First OSS number, no telephone number entered
- The user must type in a telephone number with -f
- 8 Invalid parameter for alarm abbreviation on first OSS number
- The flag -a can only take the values "y" or "n". "y" will enable alarm abbreviation when alarms are sent to the first phone number. "n" will disable alarm abbreviation.
- 9 Invalid Second OSS telephone number
- The telephone number was not entered in a recognized format. Please see the description of -s second-number above for more details on the format the phone number should take.
- 10 Second OSS number, no telephone number entered
- The user must type in a telephone number with -s
- 11 Invalid parameter for alarm abbreviation on second OSS number
- The flag -a can only take the values "y" or "n". "y" will enable alarm abbreviation when alarms are sent to the second phone number. "n" will disable alarm abbreviation.
- 12 Invalid value for Alarm Abbreviation Timer
- The timer must be a numeric value between 1 and 24. Please see the description of -t [alarm-abbreviation-timer] above for further details.
- 13 Invalid interval between retries
- The valid interval between retries must be a value between 1 and 20. Please see the description of -i [interval] above for further details.
- almcall
- If the values are not displayed properly, the file may be corrupted. Please contact support.
- 14 Unable to allocate a socket resource
- This error message is displayed when the command could not allocate a system resource. Make sure all processes are up and running by the following command: statapp
- 15 Unable to connect to the assigned socket
- This message is displayed when the command could not connect to GMM process. Make sure GMM process is running by the following command: statapp
- 16 Unable to send data on the assigned socket
- This message is displayed when the request message can not be sent to GMM process. Make sure GMM process is running by the following command: statapp
