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

    • 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 ...

    • 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 ...

    • AP API

      AP API This API returns various values from the Shared Memory Area. For example: MOVE "AP" TO SCREEN-PARAMETERS MOVE "EDITOR" TO SCREEN-LITERAL PERFORM SCREEN-ROUTINE This returns the user’s preferred Editor in SCREEN-ALPHA-FIELD. The following ...

    • Alpha Document Number Support (V8.5/V9.0)

      V8.5/V9.0 offers support for alpha numeric document numbers. This gives the user more flexibility on the number of alphabetic characters in next document number. For example, in the scenario of the following “Starting Invoice Number” in A/R Setup: ...

    • 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 ...