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

$$KCHK^XUSRB(): Check If User Holds Security Key

Reference Type: Controlled Subscription, Category: User, Integration Agreement: 2120

Description

This extrinsic function checks to see if a user holds a given security key.

Format

  $$KCHK^XUSRB(key[,ien])

Input Parameters

key:

(required) The name of the security key to be checked.
ien:

(optional) Internal Entry Number (IEN). It defaults to DUZ.

Output

returns:

Returns:

  • 1—User holds security key.

  • 0—User does not hold security key.

Example 1

The following example illustrates the results when a user holds a security key input:

>S X=$$KCHK^XUSRB("XUPROGMODE")

>W X
1

Example 2

The following example illustrates the results when a user does not hold the security key input:

>S X=$$KCHK^XUSRB("XUMGR")

>W X
0

Example 3

The following example illustrates the results when checking if another user holds a security key input by including their IEN:

>S X=$$KCHK^XUSRB("XUPROGMODE",30)

>W X
1

 

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

Reviewed/Updated: January 18, 2007

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.