Lucent Technologies Audix Administration And Data Acquisition Guide

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-5 getaalar 
12
Errors 
If no ac tive alarms exist that fit the sp ec ified  searc h, no outp ut is written. 
!CAUTION:
R1AUDIX System only. If op erators on the loc al maintenanc e terminal (LMT) 
and  the loc al ad ministration terminal (LAT) c onc urrently ac c ess the same 
sc reen information, outp ut on either terminal c ould  p rematurely terminate or 
reflec t other und esirab le c hang es. 
Output Format 
Outp ut for the getaalar
 c ommand  when c ommunic ating  with a DEFINITY or    
I
NTUITY AUDIX System is as follows, with one rec ord  for eac h alarm.
Outp ut for the getaalar
 c ommand  when c ommunic ating  with an R1 AUDIX 
System is as follows, with one rec ord  for eac h alarm
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
SystemDEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1resourc e typ eC10D-r1.0+I-r2.0+
2loc ationC11D-r1.0+I-r2.0+
3alarm levelC3D-r1.0+I-r2.0+
4fault/alarm c od eN4D-r1.0+I-r2.0+
5ac knowled g eC1D-r1.0+I-r2.0+
6data alarmedD8D-r1.0+I-r2.0+
7time alarmedT4D-r1.0+I-r2.0+
8date resolvedD8D-r1.0+I-r2.0+
9time resolvedT4D-r1.0+I-r2.0+
10resolve reasonC6D-r1.0+I-r2.0+
11ap plic ationC2I-r2.0+
FIELD       VOICE MAIL VERSIONS
Seq.
No. Field Name TypeMax.
WidthR1
AUDIX
SystemDEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1 date D 8 r1v2+
2 time T 4 r1v2+
3 fault N 4 r1v2+
4 level N 1 r1v2+
5 unit N 3 r1v2+
6 devic e N 2 r1v2+ 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-6 getaalar 
12
Example 
The following  c ommand  retrieves the INTUITY or DEFINITY AUDIX Disp lay Alarms 
sc reen d ata, writes a summary of the transfer statistic s to the sc reen, and  writes 
output to a file named  alarms. 
getaalar -v > aalarms
 
The following data is written to the file: 
ALARM_BD,01B07,MIN,0,n,19941128,1436,,,
This examp le shows one line of output. However, the c ommand  c an return many 
lines of d ata. 
The following c ommand retrieves the R1 AUDIX  maintenanc e : ac tive : alarm : 
sp ec ific ation sc reen d ata, writes a summary of the transfer statistic s to the 
sc reen, and  writes outp ut to a file named  aalarms. 
getaalar -r r1v8 -v > aalarms
 
The following data is written to the file: 
19950121,0849,73,0,116,0 
This examp le shows one line of output. However, the c ommand  c an return many 
lines of d ata. 
RETU RN
NEWLINE
RETU RN
NEWLINE 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-7 getadj 
12
getadj
Get ad junc t mac hine translation d ata 
Syntax 
getadj
 -m
 machine  -r release [-v
] [-w
] [-V
] [> ofile] 
Description 
This c ommand  retrieves the R1 AUDIX (R1V5 and  b eyond ) system : translation : 
mac hine : ad junc t sc reen d ata for the mac hine sp ec ified  in the c ommand  
op tions. 
No inp ut is required . Retrieved  data is written to stand ard outp ut. 
Errors 
An error message appears on the screen if you use this command with the 
I
NTUITY or DEFINITY AUDIX Systems, or the R1 AUDIX System p rior to R1V5. An 
error message also appears if you enter an invalid mac hine name. -m
Mac hine flag ; must b e followed  b y 
machine. 
mac hine Retrieves d ata for the sp ec ified  mac hine. If the mac hine name is 
more than one word  (suc h as 
new york
), the name must b e 
enc losed  in q uotation marks. 
-r
Release flag ; must b e followed  b y 
release. 
release Retrieves d ata for the sp ec ified  release of the R1 AUDIX System 
software (R1V5 and beyond). The default is D-r3.2.
-v
Writes transfer statistic s to the sc reen at the end  of the transfer. 
Pre ss i n g  v
 while the c ommand  is exec uting  send s the upd ated  
transfer status to the sc reen. 
-w
Writes a one-line summary of the exit status of this c ommand  into 
the file, form_req.rc. 
-V
Writes the ADAP version numb er for this c ommand  and  exits 
without transferring  any sc reens data. 
>
 ofileSp ec ifies the name of the file to whic h data is written. The filename 
must b e p rec ed ed by the symb ol > . If no outp ut file is sp ec ified , 
d ata is written to the sc reen.  
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-8 getadj 
12
Output Format
Outp ut for the getadj
 c ommand  is formatted  as follows.
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1 mac hine name C 10 r1v5+
2 password C 10 r1v5+
3 mac hine type (c /t) C 1 r1v5+
4 network c onnec tion type C 6 r1v5+
5 data rate N 5 r1v5+
6 c hannel C 1 r1v5+
7 dial string C 65 r1v5+
8 sc hed ule 1 start hour N 2 r1v5+
9 sc hed ule 1 start minute N 2 r1v5+
10 sc hed ule 1 end  hour N 2 r1v5+
11 sc hed ule 1 end  minute N 2 r1v5+
12 sc hed ule 1 interval hour  N 2 r1v5+
13 sc hed ule 1 interval minute N 2 r1v5+
14 sc hed ule 2 start hour N 2 r1v5+
15 sc hed ule 2 start minute N 2 r1v5+
16 sc hed ule 2 end  hour N 2 r1v5+
17 sc hed ule 2 end  minute N 2 r1v5+
18 sc hed ule 2 interval hour  N 2 r1v5+
19 sc hed ule 2 interval minute N 2 r1v5+
20 sc hed ule 3 start hour N 2 r1v5+
21 sc hed ule 3 start minute N 2 r1v5+
22 sc hed ule 3 end  hour N 2 r1v5+
23 sc hed ule 3 end  minute N 2 r1v5+
24 sc hed ule 3 interval hour  N 2 r1v5+
25 sc hed ule 3 interval minute N 2 r1v5+
26 purge text servic e q ueue L 1 r1v5+
27 new mac hine name C 10 r1v5+ 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-9 getadj 
12
Example 
The following c ommand retrieves the R1 AUDIX system : translation : mac hine : 
ad junc t sc reen d ata, writes a summary of the transfer statistic s to the sc reen, and  
writes outp ut to a file named  ad jd ata. 
getadj -m miami -r r1v8 -v > adjdata 
The following data is written to the file: 
miami,,c,dcp,19200,0,13052258330,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,n, 
RETU RN
NEWLINE 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-10 getalogp 
12
getalogp
Get ac tivity log  d ata 
Syntax 
Description 
This c ommand  retrieves the following  main sc reens: 
nINTUITY AUDIX  Disp lay System-Parameters Activity-Log  
nDEFINITY AUDIX  Disp lay System-Parameters Ac tivity-Log
No inp ut is required . Retrieved  data is written to stand ard outp ut. 
getalogp
 [-r release] [-v
] [-w
] [-V
] [> ofile]
-r
Release flag ; must b e followed  b y 
release. 
release Retrieves d ata for the sp ec ified  release of the I
NTUITY AUDIX or 
DEFINITY AUDIX System software. The d efault for the DEFINITY 
AUDIX System is D-r3.2. The d efault for the I
NTUITY A U D I X Sy st e m  
is I-r5.0. 
-v
Writes transfer statistic s to the sc reen at the end  of the transfer. 
Pre ss i n g  v
 while the c ommand  is exec uting  send s the upd ated  
transfer status to the sc reen. 
-w
Writes a one-line summary of the exit status of this c ommand  into 
the file, form_req.rc
. 
-V
Writes the ADAP version numb er for this c ommand  and  exits 
without transferring  any sc reens data. 
>  ofile Sp ec ifies the name of the file to whic h d ata will b e written. The 
filename must b e p rec ed ed  by the symb ol >  . If no outp ut file is 
sp ec ified , data is written to the sc reen.  
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-11 getalogp 
12
Errors 
If you use this c ommand  with an R1 AUDIX System, an error messag e ap p ears 
on the sc reen. 
Output Format
Outp ut for the getalogp
 c ommand  when c ommunic ating  with an INTUITY AUDIX 
System and  DEFINITY AUDIX System is formatted  as follows, with one rec ord  for 
eac h ac tivity log  entry.
Example 
The following c ommand retrieves the Disp lay System-Parameters Ac tivity-Log  
d ata, writes a summary of the transfer statistic s to the sc reen, and  writes outp ut 
to a file named  ac tivity. 
getalogp -v > activity 
The following data is written to the file: 
y,n,10000 
This examp le shows one line of output. This c ommand  always returns only a 
sing le line of d ata. 
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1 ac tivity log  enab led L 1
D-r1.0+ I-r2.0+
2 rec ord ing  MWI up dates L 1
D-r1.0+ I-r2.0+
3 max number of ac tivity log  entries N 5
D-r1.0+ I-r2.0+
RETU RN
NEWLINE 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-12 getannc 
12
getannc
Get system announc ement d ata 
Syntax 
getannc
  -f
 frag ment numb er [-n
 nnnn] -r release [-v
] [-w
] [-V
] [> ofile]
Description 
This c ommand  retrieves the following  sc reens for the frag ment numb er from the 
ac tive announc ement set that you sp ec ify: 
nR1 AUDIX (R1V3 and  b eyond ) system : announc ement : d etail 
No inp ut is required . Retrieved  data is written to stand ard outp ut. 
-f
Fragment number flag; must be followed by the fragment number. 
frag ment 
numb er
Retrieves d ata for the sp ec ified  fragment numb er. Frag ment 
numb ers are displayed  in Ap p end ix E of 
AUDIX Ad ministration, 
585-305-501. 
-n
Frag ment numb er flag ; must b e followed  b y 
nnnn. 
nnnn Retrieves the numb er (
nnnn) of fragment rec ord s that you spec ify. 
For examp le, if you enter 5
 for 
nnnn and you have req uested  
-f  86
, frag ment information for frag ments 86 through 90 will b e 
displayed. 
-r
Ind ic ates that the arg ument following  is the name of the release. 
This arg ument must b e followed  b y 
release. 
release Retrieves d ata for the sp ec ified  release of the R1 AUDIX (R1V3 
and  b eyond ) System software. The default is D-r3.2. 
-v
Writes transfer statistic s to the sc reen at the end  of the transfer. 
Pressing  v
 while the c ommand  is exec uting  send s the up d ated  
transfer status to the sc reen. 
-w
Writes a one-line summary of the exit status of this c ommand  into 
the file, form_req.rc
. 
-V
Writes the ADAP version numb er for this c ommand  and exits 
without transferring  any sc reens d ata. 
>  ofile Sp ec ifies the name of the file to whic h d ata will b e written. The 
filename must b e p rec ed ed  b y the symb ol > . If no outp ut file is 
sp ec ified , d ata ap p ears on the sc reen.  
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-13 getannc 
12
Errors 
If you try to use this c ommand  with the INTUITY or DEFINITY AUDIX Systems, or 
with AUDIX R1V2 System, an error messag e ap p ears. 
Output Format
Outp ut for the getannc
 c ommand  is as follows, with one rec ord  for eac h 
frag ment.
Example 
The following  c ommand  retrieves the system : announc ement : d etail sc reen d ata 
for one frag ment, writes a summary of the transfer statistic s to the sc reen, and  
writes outp ut to a file named  frag 86. 
getannc -f 86 -r r1v8 -v > frag86 
The following data is written to the file: 
,disk10.V5ana457,,0,,,86,1,n,,1600,0,0,  
,0,0 
NOTE:
Field  12, c ac hed, and  Field  16, measure fragment hit rate, are rep orted  as 
numeric  zero for the AUDIX R1V5 System and  b eyond .
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1 filesystem name C 19 r1v3+
2 ac tive announc ement d ata filesystem C 19 r1v3+
3 ad min announc ement d ata filesystem C 19 r1v3+
4 announc ement numb er N 4 r1v3+
5 announc ement mod ified L 1 r1v3+
6 announc ement c omp osition C 55 r1v3+
7 fragment numb er N 4 r1v3+
8 fragment issue N 4 r1v3+
9 fragment mod ified L 1 r1v3+
10 x to remove frag ment C 1 r1v3+
11 fragment size N 5 r1v3+
12 c ac hed L 1 r1v3+
13 hit rate N 3 r1v3+
14 c op y from filesystem C 19 r1v3+
15 c op y from frag ment numb er N 4 r1v3+
16 measure frag ment hit rate L 1 r1v3+
RETU RN
NEWLINE 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-14 getatt 
12
getatt
Get attend ant list 
Syntax 
getatt
 [-r release] [-v
] [-w
] [-V
] [> ofile] 
Description 
This c ommand  retrieves all p ag es for the following  sc reens: 
nINTUITY AUDIX  List Attend ants
nDEFINITY AUDIX  List Attend ants 
nR1 AUDIX (R1V3 and  b eyond ) list : attend ant 
No inp ut is required . Retrieved  data is written to stand ard outp ut. 
Errors 
If you try to use this c ommand  with an AUDIX R1V2 System, an error messag e 
ap p ears. -r
Release flag ; must b e followed  b y 
release. 
release Retrieves d ata for the sp ec ified  release of the I
NTUITY AUDIX, 
DEFINITY AUDIX, or R1 AUDIX (R1V3 and  b eyond ) System 
software. The d efault for the DEFINITY AUDIX System is D-r3.2. The 
d efault for the I
NTUITY AUDIX System is I-r5.0. 
-v
Writes transfer statistic s to the sc reen at the end  of the transfer. 
Pre ss i n g  v
 while the c ommand  is exec uting  send s the upd ated  
transfer status to the sc reen.
-w
Writes a one-line summary of the exit status of this c ommand  into 
the file, form_req.rc
. 
-V
Writes the ADAP version numb er for this c ommand  and  exists 
without transferring  any sc reens data. 
>
 ofileSp ec ifies the name of the file to whic h d ata is written. The filename 
must b e p rec ed ed by the symb ol > . If no outp ut file is sp ec ified , 
d ata is written to the sc reen.