PNAgent application

An application of the type PNAgent (Program Neighborhood Agent) enables users to access published resources through a server running a XenApp Services site. Published resources can be published applications, published desktops, or published contents (files).

Customizable options for all users are defined in the configuration file config.xml which is stored on the Web Interface server (by default in the directory //Inetpub/wwwroot/Citrix/PNAgent). When a user starts one of the published programs, the application reads the configuration data from the server. The configuration file can be configured to update the settings and user interface regularly.

The config.xml file affects all connections defined by the XenApp Services site. For further information, see the Citrix eDocs on

Defining a PN Agent application

HTTPS connections require the relevant SSL certificates on the device.

  1. Add a new application (see Adding applications) and select the application type PNAgent.

  2. Edit the following fields:
    Option Description
    Name Name of the application
    Server Specify the address of the configuration file on the Web Interface server (URL).
    If you use the default directory and port 80, the server address is sufficient.


    Login The user is automatically logged on to the Web Interface server by using the specified credentials (username, password, domain).
    Pass-through logon The user is logged on to the store via single sign-on. The AD user credentials are used.

    Note: Kerberos authentication is no longer supported with Citrix Receiver for Linux 13.x.and later versions.

    Autostart application/folder Specify the names of those applications you want to have started automatically.

    Alternatively, you can specify an autostart folder containing the relevant published applications. The folder must have already been created on the Web Interface server.

    Show last user The user credentials (except for password) of the last logon are displayed in the PNAgent logon dialog.
    This option has no effect if you specify fixed user credentials for automatic logon under Logon.
    Allow cancel Allows the user to close the PNAgent logon dialog.
    Application restart
    Start automatically
    Desktop icon

    See Adding applications

    Free parameters (optional) Individual parameters for application start

    Example: PNATimeout=60 brings Citrix Workspace-App to try for 60 seconds to enumerate the published applications and desktops.

    To configure dual-monitor mode, you can also use the Free parameters, see below.

    For further information, see Defining free application parameters.

  3. To configure further settings, click Advanced and edit the following fields:

    Option Description
    Window properties For resolution/window size, color depth and audio output, select Use default (server settings) or select one of the values from the list-field.
    Timed logoff To enable automatic logoff from the Web Interface server, select the Logoff after option and specify a delay in seconds. Automatic logoff does not affect the launched desktop.

    Alternatively, automatic logoff can be configured to be performed after the last PNAgent application has been closed.

    Application reconnection

    Determine the actions to be done on a reconnect to the Web Interface server

    Do not reconnect: The connection to the desktop or the published applications is not restored (default).

    Disconnected sessions only: The connection to a disconnected session is restored.

    Active and disconnected sessions: The connection to a disconnected or active session is restored.

    Manual logoff Determine the actions to be carried out upon logoff from the Web Interface server

    Logoff only server: Logoff is performed only from the Web Interface server

    Logoff server and applications: Logoff is performed from the Web Interface server and from the virtual desktop or published applications.

    Logoff server and disconnect session: Logoff is performed from the Web Interface server but the virtual desktop session is only disconnected. This enables users to reconnect later on.

    Access to the advanced settings can be defined via the object rights.1

  4. Confirm with Apply and OK.


Program Neighborhood variables

For example, variables can be used to define a unique device name for a Citrix XenApp session. To log on to a Web Interface server with Program Neighborhood, you can use the following variables:

$ICAUSER Username
$ICADOMAIN Domain for this user
$ICAAPPLICATION Name of the PNAgent application definition


Creating a domain list

For PNAgent applications, you can create a domain list from which the user can select a domain.

  1. Create the text file icadomains without file name extension.
  2. Enter the required domain names, one domain per line.
  3. Save the file to the Scout installation directory.
  4. Transfer the file to the /Setup directory on the devices by using the Scout feature Files configured for transfer.

If some of the configuration data are missing when a PNAgent application is started, the missing data are requested by a Citrix Web Interface logon dialog. The defined domains are listed in a drop-down list.

In the PNAgent application definition, you can predefine a specific domain.


Settings for dual monitor mode

For PNAgent sessions, you can configure a dual-monitor mode by using one of the following methods. The Citrix session can be transferred to the first monitor, to the second monitor, or to both of them.

Method 1:

Method 2:


The values mean the following:

-1 both monitors
 0 first monitor
 1 second monitor