Novell Documentation: NDPS Libraries for C & Gateway Developer Kit

NDPS Information Object Relationships

The NDPS managed object database (MOD) supports the various relationships among classes of objects such as "object x is contained by object y" or "object x is supported by object y."

See the following topics for further discussions about the relationship between objects and their information:

Unifying DPA and Printer MIB Objects

Printer Pools

Print Device Objects

Object Information

The following figure illustrates the containment relationship. All objects that are connected to the printer are contained by a printer object, which represents the printer agent.

Figure 9
Containment Relationship

Each document object is contained by a job object. Only the objects with connecting lines are contained by another object. All objects except the manager object are referenced by the printer object. Most objects are also referenced by one or more of the objects that are contained by the printer object.

For example, a medium object is referenced by the ndps-att-input-current-medium attribute of an input object. The same object is also referenced by the ndps-att-media-supported and ndps-att-media-ready attributes of the printer object.

The ndps-att-media-ready attribute contains a summary of the values found in the input objects contained by the printer object. The same medium object can also be referenced by other attributes, including the ndps-att-default-medium attribute and the ndps-att-page-media-select attribute of a document object.

While the marker-supplies and marker-colorant classes are contained by the printer class, they are also referenced by an instance of the marker class. This is an example of a support relationship: the marker uses supplies and colorant.

Unifying DPA and Printer MIB Objects

The NDPS architecture must reconcile the following issues to support both the Document Printing Application (DPA) and the Printer MIB standards:

DPA Input Tray Attributes and Printer MIB Input Objects

DPA Output Method and Printer MIB Output Object

DPA Delivery Method and Transfer Method Object

Defaults and Limits Classes

Page Description Language (PDL) Identifier

Printer State and Printer State Reason

Job State

List Object Attribute Scope Rules

Event Notification

DPA Input Tray Attributes and Printer MIB Input Objects

DPA uses id-att-input-trays-ready and id-att-input-trays-supported attributes to identify which input trays are either ready for use or are supported and could be ready. The syntax for these attributes is NWDP_AVT_OBJECT_IDENTIFIER and they can take on OID values indicating things like top, middle, and manual feed. This approach identifies an input tray by location but does not describe any other characteristics of an input tray.

DPA also uses an id-att-input-trays-medium attribute to identify which medium is loaded in each tray.

The Printer MIB includes an input class that describes an input tray more completely, including attributes for physical dimensions, capacity, and current status. The Printer MIB definition includes an optional input media group that describes the medium in the tray.

The NDPS input class is based on the Printer MIB input object. NDPS also implements the DPA medium class to describe the media supported by the printer. Since the medium class describes the media supported by the printer, the optional input media group is not used.

Besides the attributes in the Printer MIB, the input class has an ndps-att-input-location attribute and an ndps-att-input-current-medium attribute. The location attribute can contain any of the values that the two DPA tray attributes could hold. The current medium attribute references an instance of the medium class to identify the medium in the input tray.

NDPS does not support the concept of input-trays-ready or input-trays-supported as DPA does, but it accomplishes the same thing with printer-contained input objects. Those that are contained and have a status of active are ready and those that are contained but have some other status are supported.

DPA Output Method and Printer MIB Output Object

The DPA output-method class is not used. The NDPS output class is used instead, based on the output group in the Printer MIB. The well-known attribute values for output methods are used. The capability for an output object to support these methods is indicated in the features attributes of the output class.

DPA Delivery Method and Transfer Method Object

Instances of the DPA delivery-method and transfer-method classes are identified with well-known OIDs. DPA also specifies attributes to describe the characteristics of the delivery methods and transfer methods that are identified by these objects. NDPS does not implement instances of these object classes, although they are supported.

The well- known identifier attribute values for the methods are used. The well-known transfer-method identifier values are used to populate the ndps-att-printer-transfer-methods-supported attribute, as described in the DPA standard, but this attribute in not implemented. NDPS implements the transfer method value ndps-val-transfer-method-ndps-data to transfer document data to the printer agent.

Defaults and Limits Classes

NDPS does not implement or support the DPA initial-value-job or initial-value-document object classes. Instead, NDPS implements job-defaults and doc-defaults classes, as well as job-limits and doc-limits classes. The defaults classes enable a printer agent to apply a default set of attributes on each print job and document that it creates. The limits classes enable a printer agent to impose limits on the attributes of print jobs and documents when they are created or modified. Defaults and limits can be defined for a printer agent or for each NDS printer object that is associated with a printer agent.

The syntax of the identifier for these classes is NWDP_AVT_PRT_CONFIG_OBJ_ID and is defined as the NWDPPrtConfigObjectId structure.

When a print request is accepted by the printer agent, it applies job defaults and limits as follows:

The printer agent checks to see if the current client session is associated with an NDS printer object that is in turn associated with a job defaults object. If so, the attributes contained in the job defaults object are applied to the newly created print job object. If a defaults object is associated with the printer agent, it is ignored.
If there is no NDPS printer object associated with the printer agent (this is a public access printer agent) or there is no defaults object associated with the NDPS printer object, the printer agent checks for a job defaults object associated with the printer agent. If it finds one, it applies the default attributes to the print job object.
Any attributes in the original print request from the client are applied to the print job object. This replaces any redundant default attributes with the attributes in the print request.
The printer agent checks to see if the current client session is associated with an NDS printer object that is in turn associated with a job limits object. If so, the attributes contained in the newly created print job object are validated against the attributes in the job limits object. If a job limits object is associated with the printer agent, it is ignored.
If there is no NDPS printer object associated with the printer agent or there is no limits object associated with the NDPS printer object, the printer agent checks for a job limits object associated with the printer agent. If it finds one, it validates the print job object with the limits object attributes.

Document default and document limits objects are applied to each document object as it is created, following the same sequence as the print job object.

If one or more attributes of either the job or document fails validation, a list of failed attributes is returned to the client, as part of an error report, and the job or document is not created.

The NWDP_ModifyJob operation and NWDP_Set operation on a job or document object are also validated with the respective limits object, as described for creation of a job or document.

Page Description Language (PDL) Identifier

The Printer MIB identifies each page description language (PDL) or printer control language (PCL) supported by a printer, using an enumeration for the attribute value syntax. DPA represents these same values by appending the Printer MIB enumeration to the object identifier id-vc-document-format. The DPA attribute id-att-document-format attribute uses this syntax, together with optional fields to identify the version and variants of a PDL.

NDPS uses the enumeration from the Printer MIB specification. NDPS does not implement the DPA id-att-document-format attribute.

Printer State and Printer State Reason

The printer agent uses the ndps-att-printer-state object attribute of its printer object to track the operational state of the printer agent. The ndps-att-printer-state attribute also provides information about the state of the interfaces that the printer agent shares with the physical device subsystem (PDS) and port handler (PH), or the gateway.

The ndps-att-printer-state attribute has NWDP_AVT_OBJECT_IDENTIFIER syntax and is single-valued. The following OIDs represent the supported states for a printer agent:

id-val-printer-state-not-connected

id-val-printer-state-idle

id-val-printer-state-printing

id-val-printer-state-paused

id-val-printer-state-paused-not-connected

id-val-printer-state-stopped

id-val-printer-state-paused-stopped

id-val-printer-state-shutdown

The ndps-val-printer-state-active OID is used only in the NDS object (NDPS printer) to represent both the printing state and the idle state. This value is used in the NDS object because the printer can change too rapidly between the two states to continually update the state attribute in the NDS object.

The information in the ndps-att-printer-state attribute is complemented by two additional attributes: ndps-att-printer-enabled and ndps-att-printer-state-reasons.

The ndps-att-printer-enabled attribute has NWDP_AVT_BOOLEAN syntax and is single-valued. The default value for this attribute is TRUE. When the attribute value of ndps-att-printer-enabled is FALSE, the printer agent will not accept requests for new print jobs. Jobs that have already been accepted are allowed to complete submission and processing. Other service provider routines, such as NWDP_ModifyJob, NWDP_Set, and NWDP_ListObjectAttributes, are also unaffected.

The ndps-att-printer-state-reasons attribute has a multi-valued NWDP_AVT_PRINTER_STATE_REASON syntax and is defined as the NWDPPrinterStateReason structure.

The highest level of severity present in the ndps-att-printer-state-reasons attribute values at any given time determines the resulting effect on the printer agent state. For example, if one value has a STATE_SEVERITY_WARNING level and another value has a STATE_SEVERITY_CRITICAL level, the effect on the printer agent state is critical, and the state goes to stopped. Many of these OIDs are derived from Printer MIB alerts (for example, inputMediaTrayMissing and markerInkEmpty).

The following table shows the state transitions that can occur from each printer agent state and the combined effect of the ndps-att-printer-enabled attribute and the ndps-att-printer-state attribute. Entries that include the disabled condition reflect the combination of the two attributes (for example, there is no printer state OID for id-val-printer-state-disabled-paused).

	not con-nect	idle	print	pause	pausenot con-nect	stop	pause stop	shut-down	dis- able not connect	dis-able idle	dis- able print-ing	dis-able pause	dis-able stop	disable not connect pause	dis-able pause stop
not_ connected	N/A	X			X			X	X
idle	X	N/A	X	X		X		X		X
printing	X	X	N/A	X		X		X			X
paused		X	X	N/A	X		X	X				X
paused_ not_connected	X			X	N/A			X						X
stopped		X	X			N/A	X	X					X	X
paused_ stopped				X		X	N/A	X							X
shutdown	X	X	X	X				N/A		X	X	X			X
disabled_ not_connected	X							X	N/A	X	X	X	X		X
disabled_ idle		X						X	X	N/A	X	X	X
disabled_ printing			X					X	X	X	N/A	X	X
disabled-paused				X				X		X	X	N/A		X	X
disabled_ stopped						X		X	X	X	X		N/A		X
disabled_not_ conn_paused					X			X	X			X		N/A
disabled_ paused_stopped							X	X				X	X		N/A

Job State

The NDPS job ndps-att-current-job-state-object attribute is used to represent the state of a print job. Additional information about the state of the job is provided by the related attributes ndps-att-previous-job-state and ndps-att-job-state-reasons.

The ndps-att-current-job-state and ndps-att-previous-job-state attributes have NWDP_AVT_OBJECT_IDENTIFIER syntax and are single-valued. Job state value OIDs represent the supported states for a job. The following job state value OIDs are supported:

id-val-job-state-pre-processing

id-val-job-state-held

id-val-job-state-paused

id-val-job-state-pending

id-val-job-state-processing

id-val-job-state-interrupted

id-val-job-state-completed

id-val-job-state-retained

The ndps-att-job-state-reasons attribute has NWDP_AVT_OBJECT_IDENTIFIER syntax and is multi-valued. This attribute is not used to determine the current job state. It is updated when the current job state changes. The same is true for the ndps-att-previous-job-state attribute.

The following table lists the state transitions that can occur from each job state:

	pre-processing	held	paused	pending	processing	interrupted	retained	completed
pre-processing	N/A	X		X				X
held		N/A	X	X			X	X
paused		X	N/A	X			X	X
pending		X	X	N/A	X		X	X
processing			X		N/A	X	X	X
interrupted					X	N/A	X	X
retained							N/A	X
completed								N/A

List Object Attribute Scope Rules

The NWDP_ListObjectAttributes operation is based on the DPA standard list object attributes (LOA) operation. There are three ways to specify the object instances to query:

Set the listOperator to NWDP_LIST_OP_ORDERED_JOBS. This option lists scheduled print jobs but does not include jobs that are being created or retained jobs.
Set the listOperator to NWDP_LIST_OP_ATTRIBUTES and specify the identifiers of specific object instances. If the value of the scope field is set to 1, any objects contained by a specified object are included. However, print jobs are not included with a printer object.
Set the listOperator to NWDP_LIST_OP_ATTRIBUTES and do not specify the identifiers of specific object instances. If the value of the scope field is set to 1, any objects contained by each object are included. However, print jobs are not included with a printer object.

When a specified object class is contained by the printer class and the client is bound to the PSM, all object instances of that class are listed. If the client is bound to a printer agent, only the object instances contained by that printer agent are listed. When the job class is specified, retained jobs are listed after current jobs. Retained jobs are listed as members of the job class, with a retained job state. To list only retained jobs, the retained-job class can be specified, or the job class can be specified with a filter for the retained job state, although filtering is much less efficient.

Event Notification

NDPS uses the abstract-event class to report events that occur on print jobs and the printer. Each printer agent contains six abstract event objects that enable a client to list the available abstract events and to register interest in those events. The types of events supported by these objects are the following:

Printer errors
Printer reports
Printer warnings
Print job errors
Print job reports
Print job warnings

The syntax of the identifier for this class is NWDP_AVT_EVENT_OBJECT_ID and is defined as the NWDPEventObjectId structure.

An NDPS client can indicate interest in specific events by registering a notification profile with the printer agent. The notification profile specifies the object identifier for the event type and lists the attributes for the desired events. The notification profile can also register interest in all events of the specified type without listing the individual attributes of that type.

The identifier for each attribute of an abstract event object is the object identifier for an event. For example, the identifier for the event to report that the printer is off-line is ndps-att-alert-printer-off-line.

The syntax of abstract event object attribute values is NWDP_AVT_OBJECT_IDENTIFIER. The attribute value for each event normally contains the object identifier for the job class for print job events or the printer class for printer events.

Event attributes within an abstract event object can be grouped for filtering by adding an attribute whose identifier is the OID defined for the desired filter group. The filter identifier is also placed in the attribute value of each attribute for the events to be included in the filter group.

For example, a filter attribute can be created for paper jam events. Then, events for paper jams in different components of the printer can be grouped together by placing the identifier of the filter attribute in the attribute value for each of the paper jam events. Interest in the filter group is registered by specifying the identifier for the filter attribute in a notification profile.

A notification profile can also register for notification of a change in the value of any object attribute in the MOD. This is accomplished by specifying the class and identifier of the desired object instead of one of the abstract event objects.

The notification profile can list the object attributes to flag for events, or it can specify interest in value change events for all attributes of the object.

A notification profile can be registered directly with the printer agent or it can be an attribute of a print job. A notification profile that is an attribute of a print job is registered when the print job is scheduled for printing or is being processed by the printer agent. The notification profile is de-registered when the print job is in a held state or is scheduled to print after a specified time in the future. The notification profile is registered when the hold is removed or the print-after time expires.

The scope of print job events that are specified in a notification profile (an attribute of a print job) can be controlled by the identification used. The notification profile includes a containingObjectId field. If this field contains the identifier of the printer agent, the print job events that it specifies will be reported for all print jobs processed by the printer agent, while the notification profile is registered. If the field contains the identifier of the print job, print job events will be reported only for that print job. The administrative utilities specify the syntax for the print job identifier in the containingObjectID field so that the client received job events only for the job containing the notification profile.

Printer Pools

The Printer Pool class enables a group of printer agents to share print jobs. A printer pool has its own job pool and binds to a scheduler in the same way as a standalone printer does. When a printer agent is added to a printer pool, the printer agent is unbound from its assigned scheduler.

Because a printer agent user belongs to a printer pool, they can install the printer in the same manner as a standalone printer agent.

Print jobs are managed by the scheduler that is associated with the printer pool. Each printer agent in the printer pool requests print jobs from the printer pool scheduler.

Print Device Objects

When a printer agent is bound to a physical print device through a gateway, it is the responsibility of the gateway to create and populate the objects that describe the features and capabilities of the print device These objects are created and their object attributes are populated by submitting requests to the printer agent.

Some print devices support a comprehensive information model, such as a printer MIB. Others only report essential status information, such as online/offline and a generic error state. The information that is maintained about a print device can obviously be more complete for a print device that supports a more comprehensive information model. However, there are a few objects and attributes that should be supported whenever possible. These are useful in enabling users to select a desired printer and operators to manage the printer.

Some of the object attributes that describe the print device are used by the printer agent to provide information about the capabilities of the printer. Certain attributes of objects that are contained by a printer object are summarized into related attributes of the printer object. Some printer object attribute values are replicated in the corresponding attributes of the NDPS printer objects that are associated with the printer agent and are as follows:

ndps-att-input-current-medium

ndps-att-prtInterpreterLangFamily

ndps-att-prtMarkerAddressabilityFeedDir

ndps-att-prtMarkerAddressabilityXFeedDir

ndps-att-prtMarkerAddressabilityUnit

ndps-att-prtMarkerMarkTech

ndps-att-prtMediaPathMaxSpeed

ndps-att-prtMediaPathMaxSpeedPrintUnit

ndps-att-prtMediaPathType

ndps-att-printer-color-supported

Object Information

The NDPS objects in NDS store the following types of information:

Object Instance

Each object instance must have a unique identifier so it can be unambiguously referenced and stored in the MOD. Each class has a supported identifier attribute with a defined syntax. The identifier is not implemented for some classes, since the object descriptor that contains the attribute set for each object contains an identifier for the object.

The following table lists the NDPS object class identifier attributes and their syntaxes.

NDPS Object Class	Identifier Attribute	ID Attribute Syntax	Object ID Syntax
ndps-oc-abstract-event	ndps-att- abstract-event-id	NWDP_AVT_EVENT_ OBJECT_ID	NWDP_OBJ_ID_EVENT_ OBJECT_ID
ndps-oc- accounting	ndps-att-job- identifier	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc- auxiliary-sheet	ndps-att- auxiliary-sheet- identifier	NWDP_AVT_ NAME_OR_OID	NWDP_OBJ_ID_NAME_OR_OID
ndps-oc- auxiliary-sheet-package	ndps-att- auxiliary-sheet-package- identifier	NWDP_AVT_OBJECT_ IDENTIFIER	NWDP_OBJ_ID_OBJECT_ IDENTIFIER
ndps-oc-buffer	ndps-att- buffer-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-channel	ndps-att-channel-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-cover	ndps-att-cover-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc- delivery-method	ndps-att- delivery- method- identifier	NWDP_AVT_OBJECT_ IDENTIFIER	NWDP_OBJ_ID_ OBJECT_IDENTIFIER
ndps-oc-doc- defaults	ndps-att-doc- defaults-id	NWDP_AVT_PRT_ CONFIG_OBJECT_ID	NWDP_OBJ_ID_PRT_CONFIG_ OBJ_ID
ndps-oc-document	ndps-att- document-sequence-number	NWDP_AVT_ POSITIVE_INTEGER	NWDP_OBJ_ID_DOCUMENT_ IDENTIFIER
ndps-oc-document	ndps-att-job- identifier	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_DOCUMENT_ IDENTIFIER
ndps-oc-document-limits	ndps-att-doc-limits-id	NWDP_AVT_PRT_ CONFIG_OBJECT_ID	NWDP_OBJ_ID_PRT_CONFIG_ OBJ_ID
ndps-oc-finisher-device	ndps-att-finisher-device-id	NWDP_AVT_PRT_CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_CONTAIND_OBJ_ID
ndps-oc-finisher-supply	ndps-att-finisher-supply-id	NWDP_AVT_PRT_CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_CONTAIND_OBJ_ID
ndps-oc-printer-pool	ndps-att-printer-pool-name	NWDP_AVT_SIMPLE_NAME	NWDP_OBJ_ID_SIMPLE_NAME
ndps-oc-font	ndps-att-font- identifier	NWDP_AVT_ FONT_REFERENCE	NWDP_OBJ_ID_SIMPLE_NAME
ndps-oc-generic		NWDP_AVT_ NAME_OR_OID	NWDP_OBJ_ID_NAME_OR_OID
ndps-oc- imposition	ndps-att- imposition-identifier	NWDP_AVT_ NAME_OR_OID	NWDP_OBJ_ID_NAME_OR_OID
ndps-oc-input	ndps-att-input-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc- interpreter	ndps-att- interpreter-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-job	ndps-att-job- identifier	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-job- defaults	ndps-att-job-defaults-id	NWDP_AVT_PRT_ CONFIG_OBJECT_ID	NWDP_OBJ_ID_PRT_CONFIG_ OBJ_ID
ndps-oc-job-limits	ndps-att-job-limits-id	NWDP_AVT_PRT_ CONFIG_OBJECT_ID	NWDP_OBJ_ID_PRT_CONFIG_ OBJ_ID
ndps-oc-light	ndps-att-light-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-manager	ndps-att- manager-name	NWDP_AVT_ QUALIFIED_NAME	NWDP_OBJ_ID_QUALIFIED_ NAME
ndps-oc-marker	ndps-att-marker-id	NWDP_AVT_PRT_CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_CONTAIND_ OBJ_ID
ndps-oc-marker- colorant	ndps-att-marker- colorant-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-marker-supplies	ndps-att-marker- supplies-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-media-path	ndps-att-media-path-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-medium	ndps-att-medium- identifier	NWDP_AVT_ NAME_OR_OID	NWDP_OBJ_ID_NAME_OR_OID
ndps-oc- notification-method
ndps-oc-output	ndps-att- output-id	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-printer	ndps-att-printer-agent-name	NWDP_AVT_ SIMPLE_NAME	NWDP_OBJ_ID_SIMPLE_NAME
ndps-oc-resource	ndps-att- resource-name	NWDP_AVT_ NAME_OR_OID	NWDP_OBJ_ID_NAME_OR_OID
ndps-oc- retained-job	ndps-att-job- identifier	NWDP_AVT_PRT_ CONTAINED_OBJ_ID	NWDP_OBJ_ID_PRT_ CONTAIND_OBJ_ID
ndps-oc-scheduler	ndps-att- scheduler-identifier	NWDP_AVT_ NAME_OR_OID	NWDP_OBJ_ID_NAME_OR_OID
ndps-oc- transfer-method	ndps-att- transfer- method- identifier	NWDP_AVT_OBJECT_ IDENTIFIER	NWDP_OBJ_ID_ OBJECT_IDENTIFIER

Some NDPS operations reference different object classes at different times. For example, the NWDP_ListObjectAttributes operation can list attributes for any object in the MOD. The flexibility to reference the identifiers for different object classes is supported by the NWDPObjectIdentification structure.

Printer Object Information

The information stored in the NDPS printer object enables NDPS clients to search specific capabilities by using NDS. The results of these searches enable an NDPS user to select an appropriate printer. Some of these attributes are replicated information from the MOD for the associated printer agent. The table below shows which attributes from the MOD are replicated in NDS. (See Attribute Types and the printer class specification for a definition of the MOD attributes.) The role attributes control access to services provided by the associated printer agent.

NDPS Printer ObjectAttribute	NDS Attribute Syntax	MOD Printer Agent Printer Attribute	Printer Agent AttributeSyntax	Note
Inherited Mandatories
CN	SYN_CI_ STRING	N/A	N/A
NDPS Mandatories
NDPS Operator Role	SYN_CI_ STRING	N/A	N/A	Trustees of this attribute are operators for this printer agent.
NDPS User Role	SYN_CI_ STRING	N/A	N/A	Trustees of this attribute are users for this printer agent.
Printer Status	SYN_ OCTET_ STRING	ndps-att-printer-state	NWDP_AVT_OBJECT_ IDENTIFIER	The NDS object attribute is a summary of the MOD object attribute. It is not a 1-1 mapping. (See Printer State Values.)
Inherited Optionals
Description	SYN_CI_ STRING	ndps-att- descriptor	NWDP_AVT_ DESCRIPTOR	The MOD attribute is used for public access printers. The NDS attribute is used for controlled access printers. The values can be different among multiple NDPS printer objects.
Host Device	SYN_ DIST_ NAME	N/A	N/A
Locality (L)	SYN_CI_ STRING	ndps-att-printer-locations	NWDP_AVT_TEXT	The MOD attribute is used for public access printers. The NDS attribute is used for controlled access printers. The values can be different among multiple NDPS printer objects.
Network Address	SYN_ NET_ ADDRESS	N/A	N/A
NDS Object Class	SYN_ CLASS_ NAME	N/A	N/A
NDPS Optionals
Client Install Candidate	SYN_ BOOLEAN	N/A	N/A	This is used to flag printers to be installed automatically when NDPS is installed on a client.
Color Supported	SYN_ BOOLEAN	ndps-att-printer-color-supported	NWDP_AVT_ BOOLEAN	This indicates whether the printer supports color.
Datapool Location	SYN_ TYPED_ NAME	N/A	N/A	This specifies the file path to save document data files.
IPP URI	SYN_CI_LIST	ndps-att-uri-supported	NWDP_AVT_OCTET_STRING	Lists URLs and optional related information for the printer agent.
Maximum Speed	SYN_ INTEGER	ndps-att-printer-max-speed	NWDP_AVT_ CARDINAL	This is the highest speed value found in the ndps-att-prtMediaPathMaxSpeed attribute in the media path objects in the MOD.
Maximum Speed Units	SYN_ INTEGER	ndps-att-printer-max-speed-unit	NWDP_AVT_ ENUMERATION	This is the unit of the maximum speed attribute. This value comes from the ndps-att-prtMedia PathMaxSpeed PrintUnit attribute in the media path objects in the MOD.
NDPS Accountant Role	SYN_ CI_STRING	N/A	N/A	Trustees of this attribute are accounting operators for this printer agent.
NDPS Job Configuration	SYN_ STREAM	N/A	N/A	This can contain one or more unique print job configurations.
NDPS Printer Queue List	SYN_ TYPED_ NAME	N/A	N/A	This lists QMS queues to be serviced by the associated printer agent.
NDPS Printer Siblings	SYN_ DIST_ NAME	N/A	N/A	This contains a list of other NDPS printer objects that are also associated with the same printer agent. This attribute is not used. See the Printer to PA ID Mappings attribute.
Notification Consumers	SYN_ TYPED_ NAME	N/A	N/A	This is used by the Notification Service to track operators or users of this object that are registered for notification events.
Notification Profile	SYN_ STREAM	N/A	N/A	This is used by the Notification Service to store persistent event notification profiles that are registered by operators or users of this object.
Page Description Languages	SYN_ INTEGER	ndps-att-pdls-supported	NWDP_AVT_ ENUMERATION	This is a summary of the values found in the ndps-att-prtInterpreterLang Family attribute in the interpreter objects in the MOD.
Preferred Resource Services	SYN_ TYPED_ NAME	ndps-att-printer-preferred-resource-services	NWDP_AVT_ TYPED_NAME	This contains the NDS name of NDPS brokers containing the preferred resource services for this printer agent and are used when the Primary Notification Service is unavailable.
Primary Notification Service	SYN_ TYPED_ NAME	ndps-att-printer-primary-notification-service	NWDP_AVT_ QUALIFIED_NAME	This contains the NDS name of the NDPS broker that contains the primary Notification Service for this printer agent.
Primary Resource Service	SYN_ TYPED_ NAME	ndps-att-printer-primary-resource-service	NWDP_AVT_ QUALIFIED_NAME	This contains the NDS name of the NDPS broker that contains the primary resource service for this printer agent.
Printer Agent Name	SYN_ OCTET_ STRING	ndps-att- printer-agent-name	NWDP_AVT_ SIMPLE_NAME	This is the name of the printer agent that is associated with the NDPS printer object.
Printer Manufacturer	SYN_CI_ STRING	ndps-att-printer- manufacturer	NWDP_AVT_TEXT
Printer Mechanism Types	SYN_ INTEGER	ndps-att-printer-types	NWDP_AVT_ OBJECT_IDENTIFIER	This is a list of the marking technologies found in the ndps-att-prtMarkerMarkTech attribute in the marker objects in the MOD.
Printer Model	SYN_CI_ STRING	ndps-att-printer-model	NWDP_AVT_TEXT
Printer to PA ID Mappings	SYN_ TYPED_ NAME	N/A	N/A	This associates NDPS printer objects with the printer agent. This attribute replaces the NDPS Printer Siblings attribute.
PSM Name	SYN_ DIST_ NAME	ndps-att- printer- manager-name	NWDP_AVT_ QUALIFIED_NAME	This is the NDPS manager object name for the PSM containing the associated printer agent.
Resolution	SYN_ INTEGER	ndps-att-printer-max- resolution	NWDP_AVT_ CARDINAL	This attribute contains the highest resolution in dots-per-inch, computed from the values in the ndps-att-prtMarkerAddressibilityFeed Dir and ndps-att-prtMarkerAddressibilityXfeedDir attributes in the MARKER objects in the MOD. The resolution attribute value is dots-per-inch, derived from the ndps-att-prtMarkerAddressabilityUnit attribute.
Sides Supported	SYN_ INTEGER	ndps-att-sides-supported	NWDP_AVT_SIDES	If any value of the ndps-att-prtMediaPathType attribute in the media path objects in the MOD is longEdge BindingDuplex or shortEdge BindingDuplex, the value is 2. Otherwise, the value is 1.

The state of the printer agent is summarized in the associated NDPS printer objects by mapping possible values of the ndps-att-printer-state attribute of the printer object in the MOD to the printer status attribute of the NDPS printer object in NDS.

Active - ndps-val-printer-state-active

id-val-printer-state-idle

id-val-printer-state-paused

id-val-printer-state-printing

Error Printing - ndps-val-printer-state-stopped

ndps-val-printer-state-stopped

ndps-val-printer-state-paused-stopped

Not Bound - ndps-val-printer-state-not-connected

ndps-val-printer-state-not-connected

ndps-val-printer-state-paused-not-connected

Shut Down - id-val-printer-state-shutdown

id-val-printer-state-shutdown

NOTE: When the ndps-att-printer-enabled attribute of the printer object is set to FALSE, the printer agent rejects a request to create a new print job. This attribute is separate from the ndps-att-printer-state attribute and is not reflected in the NDPS printer object in NDS.

Manager Object Information

This is the information stored in the NDPS manager object in NDS. No attributes of the manager object in the Managed Object Database are replicated in NDS.

NDPS Manager Object Attribute	NDS Attribute Syntax	Note
Inherited Mandatories
CN	SYN_CI_STRING
NDPS Mandatories
Database Dir Path	SYN_CI_STRING	This specifies the directory path for the MOD.
Database Volume Name	SYN_DIST_NAME	This specifies the volume for the MOD.
NDPS Manager Status	SYN_OCTET_STRING	The OID values are val-manager-status-*.
NDPS Operator Role	SYN_CI_STRING	Trustees of this attribute are operators for this PSM.
Inherited Optionals
Description	SYN_CI_STRING
Host Device	SYN_DIST_NAME
Locality (L)	SYN_CI_STRING
Network Address	SYN_NET_ADDRESS
NDS Object Class	SYN_CLASS_NAME
Revision	SYN_COUNTER
Version	SYN_CI_STRING
NDPS Optionals
Printer to PA ID Mappings	SYN_TYPED_NAME	This associates NDPS printer objects with the printer agent identifiers.
Datapool Locations	SYN_TYPED_NAME	This associates the Datapool volume object name for print job document data with the printer agent identifier.

Broker Object Information

This information is stored in the NDPS broker object in NDS. Since there is no broker in the MOD, there is no relationship between the NDPS broker object and the MOD (as there is with the NDPS printer object).

NDPS Broker Object Attribute	NDS Attribute Syntax	Note
Inherited Mandatories
CN	SYN_CI_STRING
NDPS Mandatories
NDPS Operator Role	SYN_CI_STRING	Trustees of this attribute are operators for this broker.
Inherited Optionals
Description	SYN_CI_STRING
Host Device	SYN_DIST_NAME
Locality	SYN_CI_STRING
Network Address	SYN_NET_ADDRESS
NDS Object Class	SYN_CLASS_NAME
Revision	SYN_COUNTER
Status	SYN_INTEGER
Version	SYN_CI_STRING
NDPS Optionals
Delivery Methods Installed	SYN_CI_STRING
GW API Gateway Directory Path	SYN_CI_STRING
GW API Gateway Directory Volume	SYN_DIST_NAME
MHS Send Directory Path	SYN_CI_STRING
MHS Send Directory Volume	SYN_DIST_NAME
Notification Service Enabled	SYN_BOOLEAN
Notification Srvc Net Address	SYN_NET_ADDRESS
Registry Advertising Name	SYN_CI_STRING
Registry Service Enabled	SYN_BOOLEAN
Registry Srvc Net Address	SYN_NET_ADDRESS
Resource Mgmt Service Enabled	SYN_BOOLEAN
Resource Mgr Database Path	SYN_CI_STRING
Resource Mgr Database Volume	SYN_DIST_NAME
Resource Mgmt Srvc Net Address	SYN_NET_ADDRESS

Container Object Information

NDPS adds an attribute, NDPS default printer, to the organization object and the organizational unit object in NDS. When this attribute contains the name of an NDPS printer object, that printer is made the default printer when it is installed on a client that supports a default printer.

NDPS Container Object Attribute	NDS Attribute Syntax	Description
NDPS Optionals
NDPS Default Printer	SYN_DIST_NAME	NDPS printer object name for the default printer.