Kernel V. 8.0 APIs Banner [skip navigation]
VHA Office of Information - Health Systems Design and Development (HSD&D) Banner

$$HANDLE^XUSRB4(): Return Unique Session ID String

Reference Type: Supported, Category: Signon/Security, Integration Agreement: 4770

Description

(This API is made available with Kernel Patch XU*8.0*395.) This extrinsic function returns a unique Caché cluster string for a VistA system for use by HealtheVet Desktop applications.

Format

  $$HANDLE^XUSRB4("namespace"[,timetolive])

Input Parameters

"namespace":

(required) This input parameter should start with the VistA software namespace. In addition, users can add any additional application/software identifiers.
timetolive:

(optional) This input parameter indicates the number of days that this handle will be available for use. Possible values range from 1 to 7. The default is 1. XTMP requires that the zero node hold the save through date. This value gets cleaned up via the XQ82 routine (i.e., Clean old Job Nodes in XUTL option [XQ XUTL $J NODES]).

Output

returns:

Returns the unique Vista system Caché cluster string. The value generated includes the data entered in the namespace input parameter and $J and $H. If this value is already defined, a new value is generated.

Example

In this example, we are creating a unique session ID for the RPC Broker namespace (i.e., "XWB"):

>S HDL=$$HANDLE^XUSRB4("XWB-CCOW")

>W HDL
XWB-CCOW928-57785_0

When checking the ^XTMP temporary global you would see:

^XTMP("XWB-CCOW928-57785_0",0) = 3050805^3050804

 

VA (Internet) / VA (Intranet) / OI / HSD&D / Site Map / Terms of Use / VA Privacy Policy / Accessibility

Reviewed/Updated: December 14, 2005

If you have questions, need more information, or are having accessibility problems with this website, please contact us by E-Mail: Webmasters, Phone: 510-768-6800, or FAX: 510-768-6850.