(Page 42 of 42 in this chapter)


SM_CHANNEL_MAINT_RQ

Purpose

Use this structure to send (from NS to MNS) a SERVICE message.

Conn_id

A currently unused id.
Macro

Description

Q.931 IE




4
E
S
S





E
1
0





N
I
2


D
M
S
1
0
0




E
T
S
I





V
N
6





H
K
G

A
U
S
T
E
L
1





N
T
T



K
O
R
E
A




Q
S
I
G

acu_mns_service_action_type

Action type (set to I_MAINTENANCE).

Change Status

x

x

x

acu_mns_service_b_chan

B channel number (only used if acu_mns_service_pref = I_PREF_B_CHANNEL)

Channel id

x

x

x

acu_mns_service_error

Not used.

(Not used.)

acu_mns_service_int_id

Interface id (NAI).

Channel id

x

x

x

acu_mns_service_pref

Service preference (I_PREF_INTERFACE or I_PREF_B_CHANNEL).

Channel id

x

x

x

acu_mns_service_status

New status (I_D_STATE_IS, I_D_STATE_OOS, I_B_CHAN_IN_SERVICE, or I_B_CHAN_OUT_OF_
SERVICE
).

Change Status

x

x

x

To request that a SERVICE message be sent, send the request directly to SM. To do so, set the from_ent, to_ent and to_sapi fields in ISDN_MESSAGE as follows:
Field

Setting

from_ent

ENT_SM

to_ent

ENT_MNS

to_sapi

0

8.3 Data Types and Constants In Primitives

8.3.1 User Rate Values

These values specify the user rate in ACU_CONN_IN, ACU_CONN_RQ, ACU_CONN_RS and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnacu.h.
Rate

Description

ACU_RA_50

0.050 kbits/s CCITT V.6 and X.1

ACU_RA_75

0.075 kbits/s CCITT V.6 and X.1

ACU_RA_75_1200

0.075/1.2 kbits/s CCITT V.6 and x.1

ACU_RA_100

0.100 kbits/s CCITT V.6 and X.1

ACU_RA_110

0.110 kbits/s CCITT V.6 and X.1

ACU_RA_134

0.1345 kbits/s CCITT X.1

ACU_RA_150

0.150 kbits/s CCITT V.6 and X.1

ACU_RA_200

0.200 kbits/s CCITT V.6 and X.1

ACU_RA_300

0.300 kbits/s CCITT V.6 and X.1

ACU_RA_600

0.6 kbits/s CCITT V.6 and x.1

ACU_RA_1200

1.2 kbits/s CCITT V.6

ACU_RA_1200_75

1.2/0.075 kbits/s CCITT V.6 and x.1

ACU_RA_2400

2.4 kbits/s CCITT V.6 and X.1

ACU_RA_3600

3.6 kbits/s CCITT V.6

ACU_RA_4800

4.8 kbits/s CCITT V.6 and x.1

ACU_RA_7200

7.2 kbits/s CCITT V.6

ACU_RA_8000

8 kbits/s CCITT I.460

ACU_RA_9600

9.6 kbits/s CCITT V.6 and x.1

ACU_RA_12000

12 kbits/s CCITT V.6

ACU_RA_14400

14.4 kbits/s CCITT V.6

ACU_RA_16000

16 kbits/s CCITT I.460

ACU_RA_19200

19.2 kbits/s CCITT V.6

ACU_RA_32000

32 kbits/s CCITT I.460

ACU_RA_38400

38.4 kbits/s extended V.14

ACU_RA_38400_NO_ETSI

38.4 kbits/s extended V.14 (VN3) NON ETSI

ACU_RA_48000

48 kbits/s CCITT V.6 and X.1

ACU_RA_56000

56 kbits/s CCITT V.6

ACU_RA_57600

57.6 kbits/s extended V.14 (VN3) NON ETSI NON CCITT

ACU_RA_64000

64 kbits/s CCITT I.460

8.3.2 Service Values

These values specify the service in ACU_CONN_CO, ACU_CONN_IN, ACU_CONN_RQ, ACU_CONN_RS, ACU_FACILITY_IN, ACU_FACILITY_RQ, ACU_RESUME_CO, ACU_RESUME_RQ, and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnval.h.
Service

Description

FAX_SERVICE

Call for G3 facsimile service

FAX_4_SERVICE

Call for G4 facsimile service

DATA_SERVICE

Call for "data" service

DATA_GCI_SERVICE

Call for "data" service on GCI bus

DATA_56KBS_SERVICE

Call for "data at 56 KBS" service

RAW_DATA_SERVICE

Call for "raw data" service on GCI bus: no MPH_B_INIT_RQ is generated (no B-channel driver is associated)

DATA_TRANS_SERVICE

Call for transparent data service

MODEM_SERVICE

Call for modem data service

AUDIO_7_SERVICE

Call for 7khz Audio service

X25_SERVICE

Call for X.25 circuit-mode service

X25_PACKET_SERVICE

Call for X.25 packet-mode service

VOICE_SERVICE

Call for voice service

VOICE_GCI_SERVICE

Call for voice service on GCI bus

RAW_TELEPHONY_SERVICE

Call for "raw telephony" service on GCI bus: no MPH_B_INIT_RQ generated (no B-channel driver is associated)

VOICE_TRANS_SERVICE

Call for transparent voice service

V110_SERVICE

Call for V.110 service

V120_SERVICE

Call for V.120 service

VIDEO_SERVICE

Call for VIDEO service

TDD_SERVICE

Call for TDD service

DATA_H0_SERVICE

Call for data using H0 (384kbs) channel service (PRI only)

DATA_H11_SERVICE

Call for data using H11 (1536kbs) channel service

DATA_H12_SERVICE

Call for data using H12 (1536kbs) channel service

DATA_MULTIRATE_SERVICE

Call for data using Multirate (2..30*64kbs) channel service

DATA_128KBS_SERVICE

Call for data using 2*64kbs channel service (BRI only)

NO_B_CHAN_SERVICE

Call for no B-channel service (bearer-independent calls - QSIG only)

FAX_RELAY_SERVICE

Call for G3 facsimile service (for use with "Physical Relay" process)

DATA_RELAY_SERVICE

Call for "data" service (for use with "Physical Relay" process)

DATA_56KBS_RELAY_SERVICE

Call for "data at 56 KBS" service (for use with 'Physical Relay' process)

DATA_TRANS_RELAY_SERVICE

Call for data transparent service (for use with "Physical Relay" process)

MODEM_RELAY_SERVICE

Call for modem data service (for use with "Physical Relay" process)

X25_RELAY_SERVICE

Call for X.25 circuit-mode service (for use with "Physical Relay" process)

VOICE_RELAY_SERVICE

Call for voice service (for use with "Physical Relay" process)

VOICE_GCI_RELAY_SERVICE

Call for voice service on GCI bus (for use with "Physical Relay" process)

NO_SERVICE

Undefined service

8.3.3 Number Type Values

These values specify the calling, called, and redirecting number type in ACU_CONN_IN, ACU_SETUP_REPORT_IN, and ACU_ALERT_IN messages.

These values are defined in isdnval.h.
Type

Description

N_TYPE_UNKNOWN (Default for all variants except 4ESS, VN6)

Unknown

N_TYPE_INTERNATIONAL

International number

N_TYPE_NATIONAL (Default for 4ESS and VN6 variants)

National number

N_TYPE_NET_SPF

Network specific number

N_TYPE_SUBSCRIBER

Subscriber number

N_TYPE_LOCAL

AT5 local (directory) number

N_TYPE_ABBREVIATED

Abbreviated number

8.3.4 Plan Values

These values specify the calling, called, and redirecting number plan in ACU_ALERT_IN, ACU_CONN_IN, ACU_CONN_RQ, and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnval.h.
Plan

Description

N_PLAN_UNKNOWN (Default for all variants except VN6)

Unknown

N_PLAN_ISDN (Default for VN6 and AusTel1 variants)

ISDN/telephony numbering plan (CCITT E.164/E.163).

N_PLAN_TELEPHONE

Telephony - not in CEPT

N_PLAN_DATA

Data n. Plan (CCITT x.121)

N_PLAN_TELEX

Telex n. Plan (CCITT f.69)

N_PLAN_NATIONAL

National standard numbering plan

N_PLAN_PRIVATE

Private numbering plan

8.3.5 Screening Indicator Values

These values specify the calling and redirecting number screeening indicator in ACU_ALERT_IN, ACU_ALERT_RQ, ACU_CONN_IN, ACU_CONN_RQ, and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnval.h.
Screening Indicator

Description

N_SCREEN_USER_PROVIDED (Default)

User-provided, not screened

N_SCREEN_USER_PASSED (Default for Austel)

User-provided, verified and passed

N_SCREEN_USER_FAILED

User-provided, verified and failed

N_SCREEN_NETWORK_PROVIDED

Network provided

8.3.6 Redirecting Reason Values

These values specify the redirecting reason in ACU_ALERT_IN, ACU_CONN_CO, ACU_CONN_IN, ACU_CONN_RQ, and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnval.h.
Redirecting Reason

Description

REASON_UNKNOWN (Default)

Unknown

REASON_CALL_FORWARDING_BUSY

Call forwarding busy

REASON_CALL_FORWARDING_NO_REPLY

Call forwarding no reply

REASON_CALL_FORWARDING_DTE_OUT

Call forwarding DTE out of order

REASON_CALL_FORWARDING_BY_CALLED

Call forwarding by called equipment

REASON_CALL_TRANSFER

Call transfer

REASON_CALL_PICKUP

Call pickup

REASON_CALL_FORWARDING_UNCONDITIONAL

Call forwarding unconditional

8.3.7 Location Values

These values specify the location in ACU_ALERT_IN, ACU_ALERT_RQ, ACU_CALL_PROC_IN, ACU_CALL_PROC_RQ, ACU_CLEAR_IN, ACU_CONN_IN, ACU_CONN_RQ, ACU_PROGRESS_IN, ACU_PROGRESS_RQ, and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnval.h.
Location

Description

LOC_USER (Default if partner_equip argument passed to isdnStartProtocol is EQUIPMENT_NT.)

User

LOC_PR_LOCAL_USER

Private network serving the local user

LOC_NETWORK (Default if partner_equip argument passed to isdnStartProtocol is EQUIPMENT_TE.)

Location network (SWD)

LOC_TRANSIT_NET

Transit network

LOC_PU_REMOTE_USER

Public network serving the remote user

LOC_PR_REMOTE_USER

Private network serving the remote user

BEYOND_IWP (Default for DMS100 variant.)

Network beyond interworking point

8.3.8 UUI Protocol Discriminator Values

These values specify the UUI protocol discriminator in ACU_ALERT_RQ, ACU_CLEAR_CO, ACU_CLEAR_RQ, ACU_CLEAR_RS, ACU_CONN_CO, ACU_CONN_IN, ACU_CONN_RQ, ACU_CONN_RS, ACU_SETUP_REPORT_ IN, ACU_USER_INFO_IN, and ACU_USER_INFO_RQ messages.

These values are defined in isdnval.h.
UUI Protocol Discriminator

Description

UUI_USER_SPF (Default for HKG variant)

User specific coding

UUI_OSI

OSI

UUI_X244

Rec. X.244

UUI_SYSTEM_MANAGEMENT

Reserved for system management convergence function

UUI_IA5 (Default)

IA5 characters (ASCII)

UUI_V120

Rec. V.120

UUI_Q931

Rec. Q.931

8.3.9 pcs_user Protocol Discriminator Values

These values specify the pcs_user protocol discriminator (the first byte of the pcs_user string) in ACU_CALL_PROC_IN, ACU_CALL_PROC_RQ, ACU_CLEAR_CO, ACU_CLEAR_IN, ACU_CLEAR_RQ, ACU_CLEAR_RS, ACU_CONN_CO, ACU_CONN_IN, ACU_CONN_RQ, ACU_CONN_RS, ACU_FACILITY_IN, ACU_FACILITY_RQ, ACU_PROGRESS_IN and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnval.h.
pcs_user Protocol Discriminator

Description

PCS_USER_TRANSGROUP

Transgroupe

PCS_USER_PUBLIPHONE

Publiphone

PCS_USER_CALL_ROUTING

Call-routing

8.3.10 Signal Values

These values specify the signal in ACU_ALERT_IN, ACU_ALERT_RQ, ACU_CALL_PROC_IN, ACU_CLEAR_IN, ACU_CLEAR_RQ, ACU_CONN_CO, ACU_INFORMATION_IN, ACU_INFORMATION_RQ, and ACU_PROGRESS_IN messages.

These values are defined in isdnval.h.
Signal Value

Description

ACUDIAL_ON

Dial tone on

ACURING_BACK_ON

Ring back tone on

ACUNET_CONGEST_ON

Network congest tone on

ACUBUSY_ON

Busy tone on

ACUTONES_OFF

Tones off

ACUALERTING_OFF

Alerting off

ACUCREDIT_CARD_TONE_ON

Credit card tone ON

ACUOUT_OF_RANGE_TONE_ON

Out of range tone ON

ACUQUEUING_TONE_ON

Queuing tone ON

ACUAUDIBLE_TONE_ON

Audible tone ON

ACUVISUAL_ALERT_1_ON

Visual alert #1 ON

ACUVISUAL_ALERT_2_ON

Visual alert #2 ON

ACUSATCOM_CALL_NOTIFY

SATCOM call notify

8.3.11 Network-Provided Clearing Cause Values

These values specify the network-provided clearing cause in ACU_CLEAR_CO, ACU_CLEAR_IN, ACU_RESUME_CO and ACU_SUSPEND_CO messages.

These values are defined in isdnacu.h.
Network-Provided Clearing Cause

Description

ACU_CAUSE_ACU_BAD_ADDRESS

Value 0: bad context addressing info, or no free context available

ACU_CAUSE_ACU_BAD_SERVICE

Value 1: bad ACU service value

ACU_CAUSE_ACU_COLLISION

Value 2: incoming call collision

ACU_CAUSE_ACU_FAC_REJECTED

Value 3: Facility request rejected by ACU

ACU_NETWORK_CAUSE_NIL

Value F: unspecified

8.3.12 Clear Code Values

These values specify the clear code in ACU_CLEAR_CO and ACU_CLEAR_IN messages.

These values are defined in isdnacu.h.
Clear Code

Description

ACURC_BUSY

Busy

ACURC_NOPROCEED

No proceed indication (dial tone)

ACURC_NOANSWER

No answer

ACURC_NOAUTOANSWER

No auto-answer tone detected

ACURC_CONGESTED

GSTN or System is congested

ACURC_INCOMING

Incoming call detected while trying to dial

ACURC_NOLINE

Wrong Addressing info, or context already used

ACURC_ERRNUM

Errored number

ACURC_INHNUM

Inhibited number

ACURC_2MNUM

Too many errored/inhibited numbers

ACURC_HUNGUP

Remote has hung up or incident on connection

ACURC_NETWORK_ERROR

Network disconnected us

ACURC_TIMEOUT

Timeout error

ACURC_BAD_SERVICE

Bad service id in ACU_CONN_RQ/RS

ACURC_INTERNAL

Other internal error

8.3.13 Facility Code Values

These values specify the facility code in ACU_FACILITY_RQ, ACU_FACILITY_IN, and ACU_FACILITY_RQ messages.

These values are defined in isdnacu.h.
Facility Code

Description

ACU_FAC_CALL_FORWARDING

Premise transfer

ACU_FAC_CALL_DEFLECTION

Terminal transfer

ACU_FAC_CHARGING

Charging

ACU_FAC_CHARGING_TOTAL

Charging total cost

ACU_FAC_HOLD

Call hold

ACU_FAC_RETRIEVE

Call retrieve

ACU_FAC_ALTERNATE

To and from facility

ACU_FAC_TRF

Transfer

ACU_FAC_THREE_PARTY

Conferencing

ACU_FAC_MALICIOUS_CALL_ID

Malicious call identification

ACU_FAC_RECALL

Recall facility (ETSI)

ACU_FAC_TRANSPARENT

Transparent facility for CC&NS

ACU_FAC_CALL_APPEAR

Call appearence request

ACU_FAC_FEATURE_ACT

Feature activation request

ACU_FAC_DROP

Drop call

ACU_FAC_FEATURE_IND

Feature indication (NT->TE only)

ACU_FAC_PCS_USER_ONLY

Send PCS-user information only, with no other facility request. Only for VN6, within ACU_FACILITY_RQ.

8.3.14 Action Code Values

These values specify the action code in ACU_FACILITY_IN, ACU_SET_MODE_CO, ACU_SET_MODE_RQ, ACU_TEST_CO, and ACU_TEST_RQ messages.

These values are defined in isdnacu.h.
Action Code

Description

ACU_RQ_ACTIVATE

Activate or register action

ACU_RQ_CLEAR

Deactivate or clear action

ACU_RQ_ENQUIRY

Enquiry action

ACU_IN_TX

Transmission

ACU_CO_ACK

Acknowledgement

ACU_CO_REJ

Reject

8.3.15 Mode Code Values

These values specify the mode code in the acu_set_mode_code macro in ACU_SET_MODE_RQ messages.

These values are defined in isdnacu.h.
Code

Description

ACU_MODE_NA_OUT_OF_ORDER

Allow/forbid calls on NAI given by R_msg_nai.

ACU_MODE_CALL_OUT_OF_ORDER

Allow/forbid calls on NAI/CONN_ID given by R_msg_nai/R_msg_conn_id.

ACU_MODE_CHANI_OUT_OF_ORDER

Allow/forbid usage of the B channel given by Acu_set_mode_data_chani.

ACU_MODE_ALL_NA_OUT_OF_ORDER

Allow/forbid calls on all NAIs.

8.3.16 Error Cause Values

These values specify the error code in the acu_err_in_cause macro in ACU_ERR_IN messages.

These values are defined in isdnacu.h.
Cause Code

Description

ACUER_PRIMITIVE_CODE

Unknown primitive code

ACUER_PARAM_VAL

Invalid parameter

ACUER_MANDATORY_PARAM_MISSING

Mandatory parameter missing

ACUER_PARAM_TYPE

Incorrect parameter type

ACUER_PARAM_LGTH

Incorrect parameter length

ACUER_UNEXPECTED_PRIMITIVE

Unexpected primitive

ACUER_PRIMITIVE_NOT_IMPLEMENTED

SSDU primitive not implemented

ACUER_NO_TIMER_AVAILABLE

No more space to allocate new timer cells

ACUER_CONGESTION

Resource congestion

8.3.17 Progress Description Values

These values specify the progress description in ACU_ALERT_IN, ACU_ALERT_RQ, ACU_CALL_PROC_IN, ACU_CALL_PROC_RQ, ACU_CLEAR_IN, ACU_CONN_IN, ACU_CONN_RQ, ACU_PROGRESS_IN, ACU_PROGRESS_RQ, and ACU_SETUP_REPORT_IN messages.

These values are defined in isdnval.h.
Progress Description

Description

NO_PROGRESS_DESCR

No progress information to be stored.

PROGRESS_DESCR_NON_END_TO_ END_ISDN

Call is not end-to-end ISDN; further call progress information may be available.

PROGRESS_DESCR_CALL_RETURNED_ISDN

Call has returned to the ISDN.

PROGRESS_DESCR_IN_BAND_NOW

In-band information or appropriate pattern now available.

8.3.18 Charging Type Values

These values specify the charging type in ACU_CLEAR_CO, ACU_CLEAR_IN, ACU_CLEAR_RQ, ACU_CLEAR_RS, ACU_CONN_CO, ACU_CONN_RS, ACU_INFORMATION_IN, and ACU_INFORMATION_RQ messages.

These values are defined in isdnacu.h.
Charging Type

Description

ACUCHARG_TYPE_FREE_OF_CHARGE

Free of charge (N/A in VN6/FRANCE)

ACUCHARG_TYPE_CHARGE_ON_DURATION

Charge on duration (N/A in VN6/FRANCE)

ACUCHARG_TYPE_CHARGE_ON_ANSWER

Charge on answer (N/A in VN6/FRANCE)

ACUCHARG_TYPE_CHARGE_INCREMENT

Charge increment (N/A in VN6/FRANCE)

ACUCHARG_TYPE_SUB_TOTAL_CHARGE

Sub-total charge

ACUCHARG_TYPE_TOTAL_CHARGE

Total charge

8.3.19 Endpoint ID Values

These values are defined in isdnacu.h.
Endpoint ID

Description

ACU_ACTION_NO_ENDPOINT_ID

Don't send any Endpoint Id (ACU_CONN_RQ)

ACU_ACTION_SND_USID

SPID was OK, send the Endpoint Id info

ACU_ACTION_NO_SPID_NEGOTIATION

SPID negotiation is not supported

ACU_ACTION_INVALID_SPID

The received SPID is wrong

ACU_ACTION_PROMPT_INFO

Need a SPID from the terminal

ACU_INTERPRETER_0

Terminal is selected if it is assigned the indicated TID and USID value

ACU_INTERPRETER_1

Terminal is selected if it is NOT assigned the indicated TID but is assigned the indicated USID value

8.4 LAPD Primitives

The following is a summary of supported LAPD primitives:
Message Type

Description

DL_DA_IN

Indicates that a packet of "acknowledged" data has been received by the trunk from the remote party.

DL_DA_RQ

This message is sent by the application to the AG ISDN protocol stack to request the stack to transmit a packet of "acknowledged" data.

DL_EST_CO

This message indicates that equipment on the remote side of the ISDN trunk has acknowledged a SABME message sent by the ISDN protocol stack, and has sent back a UA message indicating that the data link is established.

DL_EST_IN

This message indicates that a SABME message has been received by the AG ISDN protocol stack. The stack automatically acknowledges the message by sending back a UA message, and establishes the data link.

DL_EST_RQ

This message is sent by the application to the AG ISDN protocol stack to request the stack to establish a data link. The stack transmits a SABME message over the trunk.

DL_REL_IN

If the AG ISDN software is in the IDLE state, this message indicates that an establishment request sent by the AG ISDN protocol stack was not successfully answered. If the software is in the DATA_LINK_ESTABLISHED state, this message indicates that the data link has been broken.

DL_U_DA_IN

This message indicates that a packet of "unacknowledged" data has been received by the trunk from the remote party.

DL_U_DA_RQ

This message is sent by the application to the AG ISDN protocol stack to request the stack to transmit a packet of "unacknowledged" data.



(Page 42 of 42 in this chapter)


tech_support@nmss.com
Copyright © 1999, Natural MicroSystems, Inc. All rights reserved.