Please enable JavaScript to view this site.

ESL Documentation

Field Types

Returns the list of profile names currently stored in the ESL APPC profile file (ESLAPPCA.INI) used with ESL APPC acceptor programs.

Declaration:

subroutine APPCGetAcceptProfileNames ( string:PROFILE_NAMES )
                              library "eslappc"

Arguments:

PROFILE_NAMES is a string variable that receives all of the profile names currently in the acceptor profile file (ESLAPPCA.INI). The names are returned delimited by forward slashes (/).

Remarks:

One use for this subroutine is to retrieve the profile names and then display them to the user so that the user can select a profile, either to update or to use in an ESL APPC application. When you are updating acceptor profile information, use this subroutine in combination with the APPCGetAcceptProfile and APPCSetAcceptProfile subroutines.

Errors:

APPC_NORMAL_COMPLETION

Normal completion.

APPC_ERR_ON_FILE_OPEN

Error opening file.

APPC_ERR_ON_FILE_READ

Error reading file.

APPC_ERR_OUT_OF_MEMORY

Out of memory.

APPC_ERR_INV_STRING_VAR

Invalid string variable.

APPC_ERR_UNEXPECTED_EASEL_ERROR

Unexpected error on call to ESL routine.

 

Example:

response to Edit_Initiator_Profiles

    call APPCGetAcceptProfileNames ( ProfileNames )