VA API Changes (V9.0)

VA API Changes (V9.0)

VA: Verify Access 


Elliott V9.0 supports a series of 999 security flags to control access by users to specific features in the software.  At runtime, the VA,nnn API is sent (where nnn is a number identifying the security flag) and either “Y” or “N” is returned in SCREEN-ANSWER, indicating whether or not the user has authority to perform the function.  In addition, the security literal is returned in SCREEN-LITERAL.

The VA API will search for a flag setting in the following order:

The company-specific record for the user in the SYRIGHTS file.
The company-00 record for the user in the SYRIGHTS file.
The company-wide default setting in SYRIGHTS.

If the record is not found, then the API will continue to the next scenario.  The company-specific and company-00 settings for a user can be set using the Security Setup menu under Password Setup from the Utilities menu on the main menu.

The company-wide default settings can be set using the Global Security Setup menu under System after selecting Global Setup under Utilities on the main menu.

The changes displayed in bold below are changes to the API for V9.0. 

Screen Parameters: VA,00 

Clears the NS Control File Cache, called whenever the Company changes. 

This function is no longer necessary in v9.0. 

Screen Parameters: VA,PG,by,01,02,PK

Verifies whether or not SMA-USER-NAME has access to the specified menu option, (e.g., VA,PG,M ,03,00,AR Screen-Alpha-Field=ARCUSMNT for delete mode of Customer File Maintenance)


by = passed byte for program (M for maintenance, P for Posting, I for Inquiry, etc.)

01 = menu level

02 = submenu-level

PK = Package indicated in the SYSEGUID table

Screen-Alpha-Field = program name to check

Returns Y or N in SCREEN-ANSWER  and the menu literal in SCREEN-LITERAL.

CLS


    • Related Articles

    • FA API Changes (V9.0)

      FA: File Access (Without File Handling) This API can be used to retrieve an individual field from a specific record in a file without specifying the file in the program and without opening and closing the file. In its simplest form, one can, for ...

    • DD API Changes (V9.0)

      DD: Drill Down The Drill Down API allows the developer to drill down to another Elliott application. The information provided in SCREEN-PARAMETERS will give the system the correct information to determine if the user has rights to the application ...

    • Preliminary Programming Changes for Elliott 8.6

      Eliminate DAT Files Users will have the option to eliminate DAT files in Elliott V8.6 so the only files that will be in the Elliott DATA directory will be the BTR files. Some of the known DAT files are control files like ARCTLFIL.DAT, ARPCTLFIL.DAT, ...

    • LF API

      Release Date: 9/7/2021 Versions: 8.0 and higher This API takes a filespec, like C:\WINDOWS\*.*, and returns the next file in the specified directory for each successive call. Screen Parameters Comment LF,nn Input: SCREEN-LITERAL contains the ...

    • Avalara Source Code Integration - AV API Call

      Release Date: 11/16/21 Revised: 05/23/22 Version: 8.6 and Above This article is intended for Elliott Business Software developers. This API call will allow the programmer to pass a value to indicate which Avalara function is to be performed. The ...