The PAGE command is a notification command that issues an alphanumeric page to designated personnel using a dial-up modem connection to an alphanumeric paging service, according to TAP protocol.
This command has the following format:
ADDRESS VOX "PAGE PAGERID(number) TONESTRING(phonenumber) MESSAGE(message)
[BATCH(YES|NO)]
[BAUDRATE(baudrate)]
[ {COMPORT(portnumber) | TAPIDEVICEID(numeric tapi deviceid)} ]
[DATABITS(databits)]
[INITSTRING(modeminitstring)]
[PAGERPW(password)]
[PARITY(NONE|EVEN|ODD|MARK|SPACE)]
[STOPBITS(stopbits)]
[SYSTEM(sysname)]"
Specifies the pager ID number of the remote party. This number must contain between four and ten tone digits. Valid characters are: 0 1 2 3 4 5 6 7 8 9 -
Default: There is no default.
Specifies the telephone number or other special digits (tonestring) to dial. Valid characters are: 0 1 2 3 4 5 6 7 8 9 * # a b c d & - , T P M I X
Default: There is no default.
Specifies the alphanumeric message to display on the beeper of the recipient. The maximum length of the pager ID plus the message must be less than 240 characters.
Default: There is no default.
(Optional) Specifies the serial communications port to use, regardless of an existing connection on another device.
Normally, if there is already an established connection to the specified pager service, notification server issues a new page over the existing connection to enhance performance. Specifying the COMPORT parameter overrides existing port connections.
Use any valid communications port name (COM1, COM2, COM3, and so on). COMPORT and TAPIDEVICEID are mutually exclusive.
Default: Selects the first available communications port enabled for use by the notification server.
Note: To view the list of available communications ports, see the Alphanumeric Paging Options dialog in Configuration Manager.
(Optional) Valid values are:
Executes the command by writing the command to an internal notification server input queue where it is processed in batch mode.
Specifies that the issuing process is to wait for the return code and responses before returning to the issuer.
Note: If issued with BATCH(YES), the return code you receive indicates only whether the command was properly queued for batch mode execution-it is not the completion code for the command.
Default: NO
(Optional) Specifies the baud rate that your modem uses to connect to your paging service. Valid values are: 300, 1200, 2400, 4800, and 9600.
Default: 9600
(Optional) Specifies the number of data bits per character used by the modem. The TAP protocol specifies that this must be set to 7. Valid values are: 4, 5, 6, 7, and 8.
Default: 7
(Optional) This modem initialization command string should include the default modem initialization strings and any additional modem commands.
Default: ATZ; AT&C1&D2; ATV1Q0X4; ATS0=0S2=128S7=55
(Optional) Specifies the alphanumeric character password of the remote party. This six-character password is an access code for the pager service.
(Optional) A method used by the modem for error checking. The TAP protocol specifies that this must be set to E. Valid values are: N (None), E (Even), O (Odd), M (Mark), S (Space)
Default: E
(Optional) A number that represents the time between transmitted characters used by the modem. The TAP protocol specifies that this must be set to 1. Valid values are: 0 (for 1.5), 1, and 2.
Default: 1
(Optional) Specifies the name of the system that is running the notification server to which you want to direct the command. The sysname value can contain up to eight alphanumeric characters.
Default: The local system name
(Optional) Specifies the numeric ID of the Telephony Application Programming Interface (TAPI) device or modem, (installed on the notification server) you want to use. This parameter overrides existing connections on another device.
Normally, if there is already an established connection to the specified pager service, notification server issues a new page over the existing connection to enhance performance.
Note: To view all of the Telephony Application Programming Interface (TAPI) devices that are installed under Windows on the Notification Server, issue the GETTAPIDEVICELIST command.
TAPIDEVICEID and COMPORT are mutually exclusive.
Default: The first available TAPI device
Notes:
Return Information:
After the PAGE command executes, it sets the special REXX return code variable RC.
Note: If the page completes successfully for a given paging service, these non-zero return codes can be disregarded.
Usage Note:
You can send pages to numeric pagers with the PAGE command if your paging service provider supplies a telephone number to support a TAP protocol dial-up.
Examples:
DO FOREVER
ADDRESS VOX "PAGE baudrate(1200) comport(com2) pagerid(123-4567)"||,
"tonestring(9-999-9999) message(Please call 555-1212)"
IF rc=5322 |, /* BUSY signal */
rc=5323 /* NO ANSWER */
THEN ITERATE
ELSE LEAVE
END
IF rc=0 THEN SAY "Page got through."
ELSE SAY "Page failed with rc="rc "message="vox.error
/* Find first available tapi device from list and send page using
its deviceID */
address VOX "GETTAPIDEVICELIST"
if rc = 0 then
if datatype(VOX.GETTAPIDEVICELIST.0) = "NUM" then
do
do i = 1 to VOX.GETTAPIDEVICELIST.0
parse var VOX.GETTAPIDEVICELIST.i deviceid":"modemdescription
if datatype(deviceid) = "NUM" then
do
say "Sending page using modem:"modemdescription
/* Send a TAPI page with a specific deviceID */
address VOX "PAGE MESSAGE(SAMPLE)" ,
"PAGERID(111111) TONESTRING(5550987)" ,
"TAPIDEVICEID("deviceid")"
if rc <> 0 then say vox.error
return
end
end
end
say "No TAPI devices available to send PAGE"
exit
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|