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-65 getload 
12
38 port 26 usag e in sec ond s N 6D-r1.0+
39 port 27 usag e in sec ond s N 6D-r1.0+
40 port 28 usag e in sec ond s N 6D-r1.0+
41 port 29 usag e in sec ond s N 6D-r1.0+
42 port 30 usag e in sec ond s N 6D-r1.0+
43 port 31 usag e in sec ond s N 6D-r1.0+
44 port 32 usag e in sec ond s N 6D-r1.0+
45 port 1 p eg  c ount N 6D-r1.0+
46 port 2 p eg  c ount N 6D-r1.0+
47 port 3 p eg  c ount N 6D-r1.0+
48 port 4 p eg  c ount N 6D-r1.0+
49 port 5 p eg  c ount N 6D-r1.0+
50 port 6 p eg  c ount N 6D-r1.0+
51 port 7 p eg  c ount N 6D-r1.0+
52 port 8 p eg  c ount N 6D-r1.0+
53 port 9 p eg  c ount N 6D-r1.0+
54 port 10 p eg  c ount N 6D-r1.0+
55 port 11 p eg  c ount N 6D-r1.0+
56 port 12 p eg  c ount N 6D-r1.0+
57 port 13 p eg  c ount N 6D-r1.0+
58 port 14 p eg  c ount N 6D-r1.0+
59 port 15 p eg  c ount N 6D-r1.0+
60 port 16 p eg  c ount N 6D-r1.0+
61 port 17 p eg  c ount N 6D-r1.0+
62 port 18 p eg  c ount N 6D-r1.0+
63 port 19 p eg  c ount N 6D-r1.0+
64 port 20 p eg  c ount N 6D-r1.0+
65 port 21 p eg  c ount N 6D-r1.0+
66 port 22 p eg  c ount N 6D-r1.0+
67 port 23 p eg  c ount N 6D-r1.0+
68 port 24 p eg  c ount N 6D-r1.0+
69 port 25 p eg  c ount N 6D-r1.0+
70 port 26 p eg  c ount N 6D-r1.0+
71 port 27 p eg  c ount N 6D-r1.0+
72 port 28 p eg  c ount N 6D-r1.0+
73 port 29 p eg  c ount N 6D-r1.0+
74 port 30 p eg  c ount N 6D-r1.0+
75 port 31 p eg  c ount N 6D-r1.0+
76 port 32 p eg  c ount N 6D-r1.0+
77 total storag e used  (hours) N 12.1D-r3.2+
78 total storag e free (hours) N 12.1D-r3.2+
79 messag e storag e used  (hours) N 12.1D-r3.2+
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-66 getload 
12
Example
The following c ommand retrieves the DEFINITY AUDIX List Measurements Load  
Day sc reen d ata for January 3, 1995, writes a summary of the transfer statistic s 
to the sc reen, and  writes outp ut to a file named  d ayload s.
getload -f day -d 010395 -v > dayloads 
The following data is written to the file: 
19950103,2359,0,0,0,1,0,25,8,28743,5509,31682,31544,
31441,31521,31551,30959,31451,31699,0,0,0,0,0,0,0,0,0, 
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,379,365,383,368,354,407, 
375,364,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0, 
0, 16.0 , 3.1 , 12.9 , 1.0 ,20,
2.1 
80 voic ed  name storage used  (hours) N 12.1D-r3.2+
81 perc ent remote N 2D-r3.2+
82 announc ement storag e used (hours) N 12.1D-r3.2+
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
RETU RN
NEWLINE 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-67 getlog 
12
getlog
Get ac tivity log  d ata 
Syntax 
getlog
 [-a
 y/n] -e
 nnnnnnnnnn [-d
 mmddyy [-t hhmm]] 
[-s
 mmddyy [-h
 hhmm]] [-n
 nn] [-r
 release] [-v
] [-w
] [-V
] [> ofile] 
Description 
This c ommand  retrieves d ata for the following sc reens for starting  and  end ing  
d ate, starting  and  end ing  time, and  extension that you sp ec ify: 
nINTUITY AUDIX  Disp lay Ac tivity-Log 
nDEFINITY AUDIX  Disp lay Ac tivity-Log 
nR1 AUDIX (R1V5 and  b eyond )  system : ac tivity log  : disp lay
When used  with an R1 AUDIX System, the following  options are req uired  when 
retrieving  d ata: a
, e, d, t, s, h
. When you want to turn off retrieval only, -a n
 is 
req uired . 
When used  with an I
NTUITY or DEFINITY AUDIX System, this c ommand does not 
turn on or off the ac tivity log  (see g etalog p  and  setalog p ). Only the op tion e
 is 
req uired. By d efault, all entries for the ind ic ated  extension are returned . 
The sc reen is up d ated with any of the options you sp ec ify exc ep t r
, v, w, or n
. For 
the R1 AUDIX System, ADAP up dates the system : ac tivity log  : sp ec ific ation 
sc reen with the d ate and  time of the retrieval before retrieving  the data. For 
I
NTUITY or DEFINITY AUDIX Systems, ADAP updates the specification fields of 
the Disp lay Ac tivity-Log  sc reen while retrieving  the d ata. The voic e mail system 
retains the values you supp ly after the retrieval is c ompleted
. 
No inp ut is required . Retrieved  data is written to stand ard outp ut. 
-a
Ac tivity log  (ac tivates log  c ap ab ilities) flag ; must b e followed  b y 
either a 
y or n. 
y/n Ac tivates or d eac tivates the ac tivity log . Availab le only with an 
R1  AU D I X Sys t e m .  
-e
Extension flag ; must b e followed  b y 
nnnnnnnnnn. This flag  is 
req uired for the I
NTUITY or DEFINITY AUDIX System when the -a
 
flag  is 
y. 
nnnnnnnnnn Retrieves d ata for the sp ec ified  extension.  
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-68 getlog 
12
-d
Starting  d ate flag ; must be followed  b y mmdd yy. 
mmdd yy Retrieves d ata starting  at the month, d ay, and  year ind ic ated  b y 
mmdd yy. 
-t
Starting  time flag ; must b e followed  b y 
hhmm. This flag  is only 
availab le if the -d
 flag  is also used . 
hhmm Retrieves d ata starting  from the hour and  minute of the day that 
you have specified already by 
-d  mmd dyy. Mid nig ht is 
rep resented by 0000.
-s
End ing  d ate flag; must b e followed  b y 
mmddyy. 
mmdd yy Stop s retrieving  d ata at the month, d ay, and  year ind ic ated  by 
mmdd yy. 
-h
End ing  time flag ; must b e followed b y 
hhmm. This flag  is only 
availab le if the -s
 flag  is also used. 
hhmm Stop s retrieving  d ata at the hour and  minute of the day that you 
have sp ec ified  alread y b y 
-s mmddyy.  Mid nig ht is rep resented  
b y 0000.
-n
Rec ord  numb er flag ; must b e followed by 
nn. This flag  is 
availab le only for the I
NTUITY and  DEFINITY AUDIX Systems. If 
this flag is not sp ec ified , all rec ord s that meet the sp ec ific ation 
c riteria will b e returned .
nn Retrieves the numb er (
nn) of rec ord s that you sp ec ify. If the 
word  
all is used , all rec ord s that meet the sp ec ific ation c riteria 
will be returned . 
-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 (R1V5 and  b eyond ) System 
software. The DEFINITY AUDIX System d efault is D-r3.2. The 
I
NTUITY AUDIX System d efault 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 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 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-69 getlog 
12
Errors 
If the ac tivity log  was ac tivated  then deac tivated , only the data p rior to the 
d eac tivation date/time is availab le. This is sub jec t to the numb er of entries that 
the system ac tivity log  hold s, as spec ified on the I
NTUITY or DEFINITY AUDIX 
Systems Disp lay System-Parameters Ac tivity-Log  sc reen or on the R1 AUDIX 
system : limits  sc reen. 
If no ac tivity log  d ata exists that fits the sp ec ified  searc h, no outp ut is written. 
!CAUTION:
The following c aution ap p lies only to the R1 AUDIX System: If op erators on 
the loc al maintenanc e terminal (LMT) and the loc al ad ministration terminal 
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 getlog
 c ommand  when c ommunic ating with a DEFINITY or INTUITY 
AUDIX System is formatted  as follows, with one rec ord  for eac h log  entry.
Outp ut for the getlog
 c ommand  when c ommunic ating  with an R1 AUDIX System 
is formatted  as follows, with one rec ord  for eac h log  entry
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1date D 8
D-r1.0+ I-r2.0+
2time T 4
D-r1.0+ I-r2.0+
3 ac tivity C 9
D-r1.0+ I-r2.0+
4 desc rip tion C 100
D-r1.0+ I-r2.0+
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1 date D 8 r1v5+
2 time T 4 r1v5+
3 ac tivity desc ription C 130 r1v5+ 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-70 getlog 
12
Example 
The following c ommand retrieves the INTUITY or DEFINITY AUDIX Disp lay 
Ac tivity-Log sc reen d ata for extension 3101 for Novemb er 22, 1994, and  writes 
output to a file named  ac tlog . 
getlog -e 3101 -d 112294 -s 032294 > actlog 
The following data is written to the file, one line for eac h ac tivity: 
19941122,1822,log-in,message counts: new=0, 
unopened=0, old=0 
The following c ommand retrieves the R1V8 AUDIX system : ac tivity log  : display 
sc reen d ata for extension 53541 from 8:05 a.m. to 9:30 a.m. on Aug ust 27, 1994, 
writes a summary of the transfer statistic s to the sc reen, and  writes outp ut to a file 
named  ac tlog . 
getlog -r r1v8 -a y -e 53541 -d 082794 -t 0805 -s 082794 -h 0930 -v > 
actlog 
The following data is written to the file, one line for eac h ac tivity: 
19940827,0926,Message to 53541 delivered at 08/27/94 
08:15 deleted. 
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-71 getmaint 
12
getmaint
Get maintenanc e log  d ata 
Syntax 
getmaint
 [-d mmddyy [-t hhmm]] [-c
 event id] [-f search string] [-A
 ap p lic ation]  
[-a
 
alarm resolution] [-E
 errors] [-e
 events] [-R rep orting -resourc e-typ e]                 
[-T 
resourc e-typ e [-L loc ation]] [-n nnnn] [-r release] [-v
] [-w
] [-V
] 
[
> ofile] 
Description 
This c ommand  retrieves all p ag es for the d ate, time, and  searc h information that 
you sp ec ify for the following  sc reens: 
nINTUITY AUDIX Disp lay Events
ADAP up d ates the sp ec ific ation field s of the I
NTUITY AUDIX Disp lay 
Maintenanc e-Log  sc reen while retrieving the data. 
If you omit the op tions and  their q ualifiers then 
all rec ords from and including the 
sp ec ified  d ate and  time are returned . For c omp lete lists of errors and  resourc e 
types, see the ap p rop riate voic e mail system maintenanc e manual. No inp ut is 
req uired. All errors retrieved  are written to stand ard  output.
NOTE:
The g etmaint c ommand  req uires the craft login for the INTUITY AUDIX     
Sy st e m .
-d
Date flag ; must b e followed  b y 
mmddyy. This flag  is req uired  for 
I
NTUITY AUDIX System. The d efault retrieves entries for all d ates. 
mmdd yy Retrieves d ata for the month, d ay, and  year ind ic ated b y 
mmddyy. 
For examp le, 072294
, retrieves d ata for July 22, 1994. 
-t
Time of the d ay flag ; must b e followed  b y 
hhmm. Req uired  for 
I
NTUITY AUDIX System. The d efault retrieves all entries starting  at 
the sp ec ified  d ate. 
hhmm Retrieves errors from the sp ec ified  hour and  minute to the c urrent 
time. For examp le, if you enter 1512
 at 6:00 p .m. (for retrieval on 
the same d ay), the d ata from 3:12 p .m. to 6:00 p .m.is retrieved . 
-c
Event id  flag ; must b e followed  b y 
event id. 
event id Retrieves errors matc hing  the error c od e that you sp ec ify. See the 
ap p ropriate voic e mail system maintenanc e manual for a list of 
event ids.  
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-72 getmaint 
12
-f
Searc h string  flag ; must b e followed  b y searc h string. 
searc h 
stringRetrieves errors c ontaining  the searc h string  you specify. The 
maximum string  leng th for I
NTUITY AUDIX Systems is 78 c harac ters. 
-A
Ap p lic ation flag ; must b e followed  with 
ap p lication. 
ap p lic ation Retrieves only rec ord s logg ed  ag ainst this ap p lic ation (mod ule), 
i.e. VM.
Se e  INTUITY Platform Ad ministration and Maintenanc e for 
Release 3.0-
585-310-557 
-a
RES alarm resolution information flag ; must b e followed  b y either 
y 
or 
n. The d efault is y. 
alarm 
resolutionRetrieves or d oes not retrieve alarm RES (resolution) information. 
-E
ERR (error) information flag ; must b e followed by 
y or n. Default is 
y. 
errors Retrieves or d oes not retrieve ERR (error) information. 
-e
EVN (event) information flag ; must b e followed  by either 
y or n. The 
d efault is 
y. 
events Retrieves or d oes not retrieve EVN (event) information. 
-R
Retrieves record s log ged  b y the resourc e typ e.
rep orting - 
resource- 
typeRetrieves rec ord s log ged  b y the resourc e typ e (mod ule) that you 
sp ec ify. See the ap p rop riate voic e mail system maintenanc e 
manual for a list of resourc e typ es. 
-T
Resourc e typ e flag ; must b e followed  with 
resource-typ e. 
resource-
typeRetrieves rec ord s log ged  ag ainst the resourc e typ e that you 
sp ec ify. See the ap p rop riate voic e mail system maintenanc e 
manual for a list of resourc e typ es. 
-L
Loc ation flag ; must b e followed  with 
loc ation. 
loc ation Retrieves errors log g ed  ag ainst resourc es at the sp ec ified  loc ation. 
The T
 
resource-typ e arg ument must also b e sp ec ified . See  INTUITY 
AUDIX 
System R3.3 Ad ministration and  Feature Operations 
(585-310-552) for the format of loc ation. 
-n
Numb er of rec ord s flag ; must be followed  by 
nnnn.If this flag  is not 
sp ec ified , retrieves all rec ords meeting  sp ec ific ation c riteria. 
nnnn Retrieves the numb er (
nnnn) of rec ord s that you specify. 
-r
Release flag ; must b e followed  b y 
release. 
release Retrieves d ata for the spec ified  release of the I
NTUITY AUDIX 
System software. For the I
NTUITY AUDIX System the d efault is I-r5.0.  
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-73 getmaint 
12
Errors 
If no errors matc h the sp ec ified  searc h, no outp ut is written. 
Output Format
Outp ut for the getmaint
 c ommand  is formatted  as follows. -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 outp ut file; filename must b e p rec eded  
b y >  . If no output file is sp ec ified, d ata is written to the sc reen. 
FIELD       VOICE MAIL VERSIONS
Seq. 
No. Field Name TypeMax.
WidthR1
AUDIX 
System 
DEFINITY
AUDIX 
SystemI
NTUITYAUDIX 
System
1 problem resourc e, typ e C 14
I-r2.0+
2 problem resourc e, instanc e C 3
I-r2.0+
3 problem resourc e, loc ation C 11
I-r2.0+
4 message type C 3
I-r2.0+
5 rep orting  resourc e, typ e C 14
I-r2.0+
6 rep orting  resourc e, instanc e C 3
I-r2.0+
7 rep orting  resourc e, sourc e C 19
I-r2.0+
8 ap plic ation C 2
I-r2.0+
9 event id C 14
I-r2.0+
10 date D 8
I-r2.0+
11 time T 4
I-r2.0+
12 c ount C 3
I-r2.0+
13 text C 78
I-r2.0+ 
						

							AUDIX Administration and Data Acquisition Package  585-302-502  Issue 14
May 1999
Command Line Database Retrieval Commands 
12-74 getmaint 
12
Example 
The following c ommand retrieves the INTUITY AUDIX Disp lay Events d ata from 
12:25 p .m. on Sep temb er 14, 1994, to the hour and  minute the c ommand  was 
entered , writes a summary of the transfer statistic s to the sc reen, and writes 
output to a file named  errors. 
getmaint -d 091494 -t 1225 -v > errors 
The following data is written to the file: 
SOFTWARE,1,,ERR,MCM,1,3222,VM,
SOFTWARE0602,19940914,1225, 1,
AUX1/2=0/0,109-ALARM-LOG:RAISING MIN ALARM 602 ON 
SOFTWARE/1 
RETU RN
NEWLINE