Connect to the Purdue Home Page

Purdue University

Identity and Access Management

'c' - Look Up Authorization Characteristic Command

Given a characteristic number or its name, the PUIDNETD_CMD_CHLKUP command ('C') will provide the corresponding name or number.

This lookup operation is equivalent to the visual scan possible through the characteristics list.

The authorizer DBM uses an indexed version of the flat characteristics file available via the characteristics list.

When a lookup succeeds, a positive acknowledgement reply (ACK) results. It contains the located information.

Caution

Here are some cautions about characteristic names.

  • Spacing is important -- "CS" is not the same as "C S".
  • Prefixes are important -- "C S 180" is not a course characteristic name; it's "Course: C S 180".

Example

Here is an example of looking up the characteristic for "C S 180" and then looking up the name for its number.

Note that spacing is very important, particularly in department names -- "CS" is not the same as "C S".

External protocol command to look up by name:

C zCourse: C S 180

The Reply:

a Z1003722

External protocol command to look up by number:

C Z1003722

The Reply:

a zCourse: C S 180

Note that "Course: " is part of the name and must be included when a name is specified.

Errors

Errors receive a negative acknowledgement reply (NAK), accompanied by an appropriate error number and message.

Here's an example where "C S" was mistakenly entered as "CS":

External protocol command to look up by name:

C zCourse: CS 180

The Reply:

n e17 MCharacteristic number not found (266)

17 is the external protocol error number (PUIDNETD_EDBME), indicating the DBM returned an error. 266 is the DBM's internal protocol error number, expanded in the message (PUIDNETD_DATA_MSG) field.

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.