The defService command defines an IRAPI service.
Synopsis
defService [-h] [-n] [-s
servicename
] [-p
process
] [-t P | T] [-a 0 |1 |2 |3 |4] [application]
Description
The defService command is intended to be used by IRAPI application developers to create the registration file for an IRAPI service that is necessary for assigning and deleting the service to and from a channel or DNIS or ANI. For TSM scripts, the output of the tas command serves as the registration file for the script.
If the defService command is entered with no options, defService prompts you for all of the necessary information. You need to respond to fewer prompts if you enter the majority of the information from the command line. The following table describes the options:
Option |
Description |
-h |
Allows you to print the usage statement and exit |
-n |
Uses the default values for all options not specified on the command line. However, no defaults exist for the process and application parameters. |
-s |
When the application is started by the Application Dispatch (AD) process, the IRP_SERVICE_NAME is set to the -s servicename argument if servicename is non-NULL. |
-t |
Specifies whether the process that provides the IRAPI application application is a permanent (P) or transient (T) process. The default is P. |
application |
The setting for IRP_SERVICE_NAME if servicename is NULL (see -s above) |
If the process that provides the IRAPI application application is a permanent process, -p process must be the name the process uses as an argument to irRegister(3irAPI). If the process that provides the IRAPI application application is a transient process, -p process must be the full pathname of the process. No default exists for this option.
When the application is executed on a PRI line, the [-a 0 |1 |2 |3 |4]
option specifies how the ANI should be supplied to the application. The valid values for this option are described in the following table:
Value for -a option |
Description |
0 |
No ANI supplied (default) |
1 |
ANI type billing number only |
2 |
ANI type billing number preferred |
3 |
ANI type calling party (SID) only |
4 |
ANI type calling party (SID) preferred |
The application argument specifies the IRAPI application. No default exists for this argument.
Upon successful completion, the defService command creates the /vs/trans/application.T file.
Files
The following files are associated with the defService command:
/vs/trans/*.T
See also