InfoConnect API Guide
Attachmate.Reflection.Emulation.IbmHosts Namespace / IIbmTerminal Interface / GenerateDeviceNames Property


In This Topic
    GenerateDeviceNames Property
    In This Topic
    Gets or sets a value indicating whether the terminal automatically generates device name values based on values you specify for the DeviceName property.
    Syntax
    'Declaration
     
    
    Property GenerateDeviceNames As Boolean
    'Usage
     
    
    Dim instance As IIbmTerminal
    Dim value As Boolean
     
    instance.GenerateDeviceNames = value
     
    value = instance.GenerateDeviceNames
    bool GenerateDeviceNames {get; set;}

    Property Value

    The default value is True.
    Exceptions
    ExceptionDescription
    This exception is thrown when you modify a property that was secured via the Permissions Manager or that can only be modified by an Administrator.
    Remarks

    GenerateDeviceNames is only available for 5250 Telnet sessions.

    You can include any of the following characters as part of the value you specify for DeviceName:

    Character How this value is used
    * Replaced by "A", "B", "C", and so on for each new session. If the entire alphabet is used, the generated device names continue with "AA", "AB", "AC", and so on.
    % Replaced by "P" for printer sessions and "S" for display sessions.
    = Replaced by "1", "2", "3", and so on.
    &COMPN Replaced by the local workstation name. If the generated name exceeds 10 characters, the excess characters are trimmed from the left (unless + is also used). This character cannot be used with ";ampUSERN".
    &USERN Replaced by the local user name, left-trimmed if the generated name exceeds 10 characters. If the generated name exceeds 10 characters, the excess characters are trimmed from the left (unless + is also used). This character cannot be used with ";ampCOMPN".
    + Used with ";ampUSERN" or ";ampCOMPN" to specify trimming from the right instead of from the left. This can be placed anywhere in the string.

    You can use only one string literal in combination with these characters. If you use separated strings, the second string is dropped.

    See Also