Description:

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

Declaration:

 subroutine APPCGetInitProfileNames(string:PROFILE_NAMES) 

                                                    library "eslappc" 

Arguments:

•PROFILE_NAMES is a string variable that receives all of the profile names currently in the initiator profile file (ESLAPPCI.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 initiator profile information, use this subroutine in combination with the APPCGetInitProfile and APPCSetInitProfile subroutines.

Errors:

Example:

subroutine PopulateProfileList(string: ListBox_SV) is

string   ProfileNames_LSV

         Name_LSV

 
   call APPCGetInitProfileNames ( ProfileNames_LSV )

   while (ProfileNames_LSV != "") loop

      extract from ProfileNames_LSV

         take to "/" Name_LSV

         skip by "/"

         take to last ProfileNames_LSV

      add to ListBox_SV

          insert Name_LSV

   end loop