Connect to the Purdue Home Page

Purdue University

Identity and Access Management

'I' - The Mine Command

The mine command may be used with all DBMs. It requests a report of all information the DBM knows about the person whose key is supplied in a field of the command message.

This is a restricted command -- it may be used only by specific pre-authorized PUIDs. (See DBM ACLs.)


The puidnetd.h symbol for the lookup command is PUIDNETD_CMD_MINE.


The only key for the mine command is the PUID.


If the specified key is found and the PUID making the request is permitted, the reply message will contain a positive acknowledgement (ACK); if not, a negative acknowledgement (NAK).

An ACK will be accompanied by fields containing the information the DBM knows about the PUID.

A NAK may be accompanied by these fields. The field symbols come from puidnetd.h.

e -- an error code (PUIDNETD_DATA_ERRC); it accompanies a NAK reply.
M -- a message (PUIDNETD_DATA_MSG); it accompanies a NAK reply.

Returned Values

The information a DBM returns in response to an authorized mine command depends on the DBM.

Some information is common to all DBMs. Here's a reflector DBM mine request for PUID 34 with the common information that is returned.

I p34

Here's the reply, broken into two lines for readability:

a\tp34\tamickey\h112223333\tNMICKEY MOUSE\c18


a -- is a positive acknowledgement.
p34 -- is the PUID.
amickey -- is the alias, "mickey".
h112223333 -- is the Human Respources ID (HRID), 112223333.
NMICKEY MOUSE -- is the common name.
c18 -- 18 is the creator's PUID.
>983452209.503 -- is the time the DBM record was created. (See DBM Times.)
u26 -- 26 is the last updater's (modifier's) PUID.
U983454182.90 -- 983454182.90 is the last update (modification) time. (See DBM Times).
i0 -- the current attribute bit value is 0 (zero).

Additional fields are specific to the DBMs and may be found in these places:

Feedback | Contact Purdue
Maintained by: IAMO Team

Purdue University, West Lafayette, IN 47907, (765) 494-4600
© 2010 - 2013 Purdue University | An equal access/equal opportunity university | Copyright Complaints
If you have trouble accessing this page because of a disability, please contact the CSC at or (765) 494-4000.