%Library.Status

datatype class %Library.Status

ODBC Type: VARCHAR

Many of the methods provided by the class Library return error status information using the %Status data type. The include file, %occStatus.INC, contains several macro definitions that are useful in testing the value of an error code in %Status format.

These macros include:

• $$$ISOK(status:%Status) returns true (1) if the status code status does not represent an error condition.
• $$$ISERR(status:%Status) returns true (1) if the status code status represents an error condition.

You can get a more detailed description of an error by using the system-provided $system.Status.DecomposeStatus(status:%Status,&err,flag) routine.

This routine takes a status code and returns an array of error strings.

For example:

Set status=obj.%Save() If $$$ISERR(status) Do $system.Status.DecomposeStatus(status,.err,"-d") For i=1:1:err Write err(i),!

Method Inventory

• LogicalToOdbc()
• LogicalToXSD()
• XSDToLogical()

ParametersCopy link to this section

parameter JSONTYPE = string; Copy link to this section

JSONTYPE is JSON type used for this datatype.

parameter XSDTYPE = base64Binary; Copy link to this section

Declares the XSD type used when projecting XML Schemas.

MethodsCopy link to this section

classmethod LogicalToOdbc(%val="") as %String [ Language = objectscript ] Copy link to this section

Converts the value of this data type from $List format to a delimited string using the value of the ODBCDELIMITER parameter as a delimiter.

classmethod LogicalToXSD(%val As %Binary) as %String [ Language = objectscript ] Copy link to this section

Converts the %Binary value to the SOAP base64 encoded value.

classmethod XSDToLogical(%val As %String) as %Binary [ Language = objectscript ] Copy link to this section

Converts the SOAP encoded base64 input value to a logical value.