NWDPPrinterStateReason

Contains information related to the condition which caused the printer state

Structure

typedef struct {  
   NWDPNameOrOid               identifier;  
   NWDPStateSeverityEnum      severity;  
   NWDPTrainingEnum           trainingLevel;  
   NWDPObjectIdentifier        objectClassOid;  
   NWDPObjectIdentification    objectIdentification;  
   nuint32                    time;  
   pNWDPNameOrOid              messageOptionPtr;  
} NWDPPrinterStateReason, N_FAR *pNWDPPrinterStateReason;

Header File

nwdp_att.h

Fields

identifier

Identifies the problem with the printer.

severity

Specifies the severity level:

1 NWDP_STATE_SEVERITY_OTHER

2 NWDP_STATE_SEVERITY_WARNING

3 NWDP_STATE_SEVERITY_CRITICAL

trainingLevel

Specifies the training level:

1 NWDP_TRAINING_OTHER

2 NWDP_TRAINING_UNKNOWN

3 NWDP_TRAINING_UNTRAINED

4 NWDP_TRAINING_TRAINED

5 NWDP_TRAINING_FIELD_SERVICE

6 NWDP_TRAINING_MANAGEMENT

objectClassOid

Specifies the class of the object which has the problem.

objectIdentification

Specifies the object within the class which has the problem.

time

Specifies the time when the problem was reported.

messageOptionPtr

(Optional) Points to a message which describes the problem.

Remarks

The NWDPPrinterStateReason structure contains problems such as "paper out" or "toner low" only.

The values for severity and trainingLevel are derived from the values in Printer MIB rfc1759.

The identifier field contains an OID that represents a condition that causes the printer agent to be in a given state and can contain a text value to represent a condition that has not been assigned an OID.

The severity field is used by the PSM to determine the impact that the state reason has on the printer agent state. A STATE_SEVERITY_CRITICAL level causes the printer agent to be put in a stopped state (see Printer State and Printer State Reason for more information).

The trainingLevel field is included for information only. The value in this field has no effect on the resulting printer agent state.