| TITLE | VALUE | |
|---|---|---|
| NAME | LHS CHECK OPTION ACCESS | |
| DESCRIPTION | This RPC uses the Kernel supported API $$ACCESS^XQCHK to verify if a VistA user has access to an option or not. | |
| TAG | OPT | |
| ROUTINE | LHSRPC | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 1 |
| INPUT PARAMETER | USER | |
| DESCRIPTION | This is the user DUZ being checked for option access. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | 20 | |
| INPUT PARAMETERS | SEQUENCE NUMBER | 2 |
| INPUT PARAMETER | OPTION | |
| DESCRIPTION | This is either the IEN or the NAME of an option in the OPTION file #19. | |
| PARAMETER TYPE | LITERAL | |
| REQUIRED | YES | |
| MAXIMUM DATA LENGTH | ||
| RETURN VALUE TYPE | SINGLE VALUE | |
| RETURN PARAMETER DESCRIPTION | The return data is the same as the Kernel API $$ACCESS^XQCHK supported through ICR #10078. -1:no such user in the New Person File -2: User terminated or has no access code -3: no such option in the Option File 0: no access found in any menu tree the user owns All other cases return a 4-piece string stating access ^ menu tree IEN ^ a set of codes ^ key O^tree^codes^key: No access because of locks (see XQCODES below) where 'tree' is the menu where access WOULD be allowed and 'key' is the key preventing access 1^OpIEN^^: Access allowed through Primary Menu 2^OpIEN^codes^: Access found in the Common Options 3^OpIEN^codes^: Access found in top level of secondary option 4^OpIEN^codes^: Access through a the secondary menu tree OpIEN. XQCODES can contain: N=No Primary Menu in the User File (warning only) L=Locked and the user does not have the key (forces 0 in first piece) R=Reverse lock and user has the key (forces 0 in first piece) | |
| AVAILABILITY | RESTRICTED | |
| INACTIVE | ||
| CLIENT MANAGER | ||
| WORD WRAP ON | ||
| VERSION | ||
| SUPPRESS RDV USER SETUP | ||
| APP PROXY ALLOWED | Yes | |