Previous Topic: NMTAP MethodNext Topic: NMVOICE Method


NMTAP Parameter Descriptions

AnswerWait

Specifies the number of seconds that NMPTAP should wait for an answer (using a call-in) before allowing NMFIND to try the next method of contacting someone.

Setting this parameter to a higher value allows the person who was paged more time to handle the problem before Notification Manager attempts to contact someone else. Therefore, you should set the value high when it is important for a particular person to answer the problem. Setting a lower value means that you are more likely to get a quick response to a problem.

Default: 300

BatchPage

Determines whether the page should be batched (that is, sent on the same phone call to the paging service) with any other pages that are currently being sent to the same paging service. Values are:

YES

Allow the page to be batched

NO

Do not allow the page to be batched

Default: NO

BatchWait

Specifies the number of seconds that batch processing should hold on to the paging service while waiting for another page to come in for that service. For most instances, this value should not be greater than 30 seconds.

Note: This parameter is valid only when BatchPage(YES) is specified.

Default: 30

BaudRate

Specifies the baud rate at which to set the modem. Valid values are: 300, 1200, 2400, 4800, and 9600.

Default: 9600

Comport

Specifies the communications port to use when dialing the pager service.

Default: Selects the first available communications port.

DataBits

Specifies the data bits to which to set the modem. The TAP protocol requires this value to be set to 7. Valid values are: 4, 5, 6, 7, and 8.

Default: 7

Debug

Determines whether Notification Manager is to generate debugging messages at the command prompt or the AXCREXX window and in the ASOTRACE log. Possible values are YES and NO.

Default: NO

Greeting

Specifies the message to present at the top of the pagers display (before the TELL and ASK messages are presented). The argument can be either a string or voice file. If the argument is a voice file, the name of the voice file must not contain any blanks and the last four characters must be .VOX.

Default: NM CALLING - CALL nnn-nnnn ABOUT ITEM nnnn

MaxMsgLen

Specifies the maximum length of the message to be sent to the pager.

If the message is longer than the maximum length allowed, it is truncated (but the page is still sent). If the message is truncated and the call-in feature (NMANSWER) is configured, the message will be prefixed with call-in information so that the full message may be accessed using the call-in feature.

Default: 100 for an alphanumeric pager, Numeric=NO, and 20 for a numeric pager, Numeric=YES.

ModeCmd

Specifies the name of the mode command that should be used to set the mode for the serial COM port.

You should specify this parameter if you are using specialized piece of hardware that requires a proprietary MODE command.

Default: MODE

ModemInitString

Specifies the string to pass to the modem to initialize it before it makes the call.

The semicolons in the string are used to delimit the separate strings that will be passed to the modem (with a one second wait between each string).

Default: ATZ;AT&C1&D2;ATV1Q0X4;ATS0=0S2=128S7=55

ModeString

The default processing of the ModeCmd parameter generates a string that uses the syntax of the Windows MODE command. If you are using a proprietary MODE command that has a different syntax, you should specify the entire MODE command, including the command name at the front.

Note: If this parameter is specified, the ModeCmd parameter is ignored.

NMfindWait

Note: Make sure that you understand the AnswerWait parameter (described previously) before reading this description. The AnswerWait parameter controls the number of seconds that Notification Manager waits for a paged person to answer the page before it attempts to contact anyone else. Once the wait time has expired, Notification Manager attempts to contact other people.

The NMfindWait parameter forces NMFIND to guarantee that the person who was paged has at least a certain additional amount of time to call-in to answer the page. The value is in seconds.

You should set this value higher if it is difficult for the person paged to reach a phone and lower if it is easy. The actual effect of this parameter is to cause NMFIND to postpone running the FailureRexx command (if necessary) to guarantee that the person paged has adequate time to reach a phone and answer the page using a call-in.

Default: 900

Numeric

Specifies whether the pager is numeric or alphanumeric. Numeric pages are limited to messages containing the numbers 0 through 9, hyphens, parentheses, and commas.

Valid values are:

YES

The page device is a numeric pager.

NO

The page device is an alphanumeric pager

Note: When Numeric is set to YES, set TellExact to YES to send a valid numeric message to the numeric page device. Set TellExact to NO to send a numeric message containing a call-in phone number and notification item number. The receipt of the page must use the call-in feature to retrieve the actual TELL message.

When Numeric is set to YES, the TELL message is not prefixed with a greeting.

Default: NO

PageRetry

If a page request fails, PageRetry specifies the number of times a page is retried, provided the page fails with a return code specified by the RetryRCList parameter. The total number of attempts to resubmit a page will be one more than the value of PageRetry.

Default: 3

PagerID

Specifies the pager ID of the paging device that NMTAP requests the pager service to page.

PagerPW

(Optional) Specifies the password required by the paging service. (Most paging services do not require a password.)

PageWait

Specifies the number of seconds to wait between retries of the page.

Default: 60

Parity

Specifies the method used by the modem for error checking. The TAP protocol requires this value to be set to E. Valid values are: N (None), E (Even), O (Odd), M (Mark), S (Space).

Default: E

Phone

Specifies the phone number of the pager service.

StopBits

Specifies the time between transmitted characters used by the modem. The TAP protocol requires this value to be set to 1. Valid values are: 0 , 1, and 2.

Default: 1

TellExact

Determines whether the TELL text from the NMFIND command is to be written verbatim. Values are:

YES

The TELL text is written verbatim

NO

Additional information is added to the TELL text

Default: NO