The Start RSE Server (STRRSESVR) command starts the Remote System Explorer (RSE) communications server if it is not already started and associates the current interactive job with the specified RSE connection.

The purpose of STRRSESVR command is to associate an emulator with an RSE connection for running and debugging interactive applications. The job is locked for the exclusive use of the associated RSE connection. The job can be released either by disconnecting the associated RSE connection or using the Release Interactive Job action for the RSE connection.

Parameters

Keyword	Description	Choices	Notes
NAME	Connection name	Character value, *PRV	Optional, Positional 1
WRKLIB	Working library	Name, *PRV, *DFT	Optional, Positional 2
RMTLOCNAME	Remote location name	Character value, *RESOLVE, *PRV	Optional, Positional 3
PORT	TCP/IP port	1-65534, *PRV, *DFT	Optional

Top

Connection name (NAME)

Specifies the RSE connection which should be associated with this interactive job. The connection name can be specified by itself or optionally qualified with the RSE profile name.

*PRV

The connnection name specified in the previous invocation of the STRRSESVR command is used. The connection name must be specified if no previous invocation exists.

character-value

Specify the connection name that should be associated with this job.

Working library (WRKLIB)

Specifies the library where the STRRSESVR command will create a data queue to communicate with the RSE server.

*PRV

The library name specified in the previous invocation of the STRRSESVR command is used. Until a library is specified, QGPL is used.

*DFT

Library QGPL is used.

name

Specify the name of the library to be used.

Remote location name (RMTLOCNAME)

Specifies the TCP/IP hostname or IP address of the client machine where the RSE communications daemon is running.

*RESOLVE

Attempt to have the STRRSESVR command resolve the remote location name. This value is recommended for TCP/IP DHCP users.

*PRV

The hostname specified in the previous invocation of the STRRSESVR command is used. Until a hostname is specified, *RESOLVE is used.

character-value

Specify the TCP/IP host name or IP address for the client machine.

TCP/IP port (PORT)

Specifies the port number where the RSE communications daemon is listening.

*PRV

The port number specified in the previous invocation of the STRRSESVR command is used. Until a port number is specified, port 4300 is used.

*DFT

The default port (4300) is used.

1-65534

Specify the TCP/IP port number to be used.

Examples

Example 1: Start RSE Server Specifying Only a Connection Name

STRRSESVR  NAME(DEVELOPMENT)

This command associates the current interactive job with the RSE connection whose name is DEVELOPMENT.

Example 2: Start RSE Server Specifying Connection Name and Additional Parameters

STRRSESVR   NAME(TEST.DEVELOPMENT)  RMTLOCNAME('192.168.1.45')
            WRKLIB(DEVLIB)

This command associates the current interactive job with the RSE connection named DEVELOPMENT in the TEST profile on the client machine with the specified IP address. The data queue used to communicate between this job and the RSE is created in the library DEVLIB.

Error messages

*ESCAPE Messages

RSE2001

Error connecting to Remote Systems Explorer

RSE2002

Connection name not defined.

RSE2003

Connection defined for different hostname.

RSE2004

Error creating data queue.

RSE2005

Working library is not valid.

RSE2006

RSE server failed to start or connect.

RSE2007

Error accessing data queue.

RSE2008

Data queue could not be deleted.

RSE2009

Error resolving remote location IP address.

RSE2010

Connection already in use.

RSE2011

Socket Error

RSE2012

Error retrieving job information.

RSE2013

No previous connection name exists.