(c) Digital Equipment Corporation. 1994. All rights reserved.

Name

dsX_trace_object − Displays an explanation of the content of an object on the current output device. 
 
 
 

Syntax

 
(void) dsX_trace_object(Object)
 

Argument@Data Type@Access  
 
 
Object@OM_object@T{ read T}

C Binding

 
 
dsX_trace_object(object)
 
 

 
OM_object@T{ object T}  

Arguments

OM_object
 
 
The object whose content you want to inspect.
 
 
 

Description

 
 
This function displays on the current output device information about the content of an OM object, as follows:
 
 
 

•
 
A full expansion of a public object
 

•
 
The type of a private object
 

•
 
Details of the content of an error object
 

•
 
For a name object or AVA encoded in ASN.1, both the ASCII and hexadecimal representations of the ASN.1 encoding
 

 
The routine also checks for null pointers.
 
 
 
 

Errors

 
 
This function does not return any errors.
 
 
 
 

Example

 
 
The following code extract shows an example call to the Trace Object function:

Exhibit 0-0.

 
{
  OM_workspace workspace;
  OM_return_code status;
  OM_object session = NULL;
 
  status = om_create(DS_C_SESSION,OM_TRUE,workspace,&session);
 
  if (status == OM_SUCCESS)
    {
      dsX_trace_object(session);
    } }