PLBDBG_LOGON Keyword

PLBWIN, PLBCE or PLBLinux

PLBDBG_LOGON={IP}[:port]

 

This keyword specifies a socket IP address that allows the 'plbdbug.plc' character debugger to automatically logon to the 'dbgiface.plc' GUI debugger that was started and is waiting using the '-listen' mode. The {port} is an optional port number that defaults to a value of '24240' if it is not specified.

Note:

  1. This keyword can be specified in the [Environment] section of the '.ini' configuration files for 'plbwin.ini', 'plbserve.ini', and 'plbwebsrv.ini'.

  2. When the 'dbgiface.plc' GUI debugger is started using the '-listen' parameter, the GUI debugger must find this keyword IP address to create a socket which is listening for a logon from the 'plbdbug.plc' character debugger.

    3. Example PLBWIN.INI setting:

     

    [Environment]

    #

    #PLBDBG_LOGON=127.0.0.1:12345 //Not used in this case

    #

    PLBDBG_LOGON=127.0.0.1

     

    Since the keyword is NOT specifying the port number the listening socket is created using the IP address of '127.0.0.1' with a default port number of '24240'.

    Example Execution of 'dbgiface.plc' GUI debugger:

     

    plbwin dbgiface -listen

     

    In this case, the 'dbgiface.plc' GUI debugger looks for the 'PLBDBG_LOGON' keyword and optional port number to create a listening socket. The GUI debugger waits until a 'plbdbug.plc' character session establishes a socket logon session.

     

  3. When a PLB program is started using a runtime command line '-dr' command, the PLB runtime starts by executing the 'plbdbug.plc' character debugger which first looks for the PLBDBG_LOGON keyword The character debugger uses the PLBDBG_LOGON IP address and optional port number to establish a socket connection with the GUI debugger which is waiting to start a debug session. After the debug socket connection is successfully established, the GUI debugger is activated and the GUI debug session is started.

    4. Example runtime command lines to invoke a debug session:

     

    plbwin -dr myprog

     

    In this case, the PLBDBG_LOGON keyword must be specified in the 'plbwin.ini' configuration file used by both the 'dbgiface.plc' and 'plbdbug.plc' debuggers.

     

    plbclient -dr myprog

     

    In the case, the PLBDBG_LOGON keyword must be specified in the 'plbwin.ini' configuration file which is used by the 'dbgiface.plc' program. Also a PLBDBG_LOGON keyword MUST be specified in the 'plbserve.ini' configuration file which is used by the 'plbdbug.plc' program.

     

    http://127.0.0.1:8081/myprog?runopt=-dr

     

    In the case, the PLBDBG_LOGON keyword must be specified in the 'plbwin.ini' configuration file which is used by the 'dbgiface.plc' program. Also a PLBDBG_LOGON keyword must be specified in the 'plbwebsrv.ini' configuration file which is used by the 'plbdbug.plc' program.

     

  4. When executing a PLB program using a GUI debug session, both the 'dbgiface.plc' and 'plbdbug.plc' programs must be using the same '.sdb' debug file created by the PLB compiler. Otherwise, unexpected debug behaviors and errors will occur.

 

 

See Also: PLBWIN Keywords, PLBLinux Environment Variables, Compiler and Runtime Options

 


Compiler and Runtime Options PLB_LOGON Keyword PLB_MAXDMRECVTIME Keyword