Zimbra api question. please Help!!

[stevendada]

hey guys, i am very new to Soap and Zimbra. here are my questions:

1. I was reading the API and I was trying to create and get distribution list

<CreateDistributionListRequest>
<name>...</name>
<a n="...">...</a>+
</CreateDistributionListRequest>

<GetDistributionListRequest [limit="{limit}"] [offset="{offset}"]
[sortAscending="{sort-ascending}"]>
<dl by="id|name">...</dl>
</GetDistributionListRequest>

so my question is that what are these tags 'a', 'n' and 'dl' mean, and what should go inside of 'a' and 'dl' tag.(those ... thingy )


2. s = SOAP::RPC:river.new('https://mail.twistage.com:7071/service/admin/soap/','urn:zimbraAdmin')
s.add_method('GetDistributionListRequest',"dl")
s.GetDistributionListRequest('test')

this will generate
<GetDistributionListRequest>
<dl xsi:type="xsd:string">test</dl>
</GetDistributionListRequest>

so my question is that how do i add attribute inside dl like 'by'
<dl by=''></dl>

Please help. Thanks in advance.