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.)

Symbol

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

Keys

The only key for the mine command is the PUID.

Reply

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
>983452209.503\tu26\tU983454182.90\ti0\r\n

Where:

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 | Style Standards
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 itap@purdue.edu or (765) 494-4000.