Change REXEC Attributes (CHGRXCA)

The Change REXEC Attributes (CHGRXCA) command changes the configuration of the TCP/IP Remote Execution (REXEC) servers. You can change REXEC attributes when REXEC servers are active. Changes take effect the next time an REXEC server connection is made. Existing connections are not changed, but keep the attributes they had when the connection was established.

Restrictions:

You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Parameters

Keyword	Description	Choices	Notes
AUTOSTART	Autostart servers	YES, NO, *SAME	Optional, Positional 1
NBRSVR	Number of initial servers	1-20, SAME, DFT	Optional
INACTTIMO	Inactivity timeout	1-2147483647, SAME, DFT	Optional
CCSID	Coded character set identifier	1-65533, SAME, DFT	Optional

Top

Autostart servers (AUTOSTART)

Specifies whether to automatically start the REXEC servers when TCP/IP is started by the Start TCP/IP (STRTCP) command or STRTCPSVR SERVER(*AUTOSTART) command. When REXEC is started by the Start TCP/IP Server (STRTCPSVR) command, and SERVER(*AUTOSTART) is omitted, this parameter is ignored and the number of servers defined is started regardless of the value of this parameter.

*SAME: The autostart value that was previously set does not change; otherwise, *NO is used.
*NO: Do not start the number of servers defined in the NBRSVR parameter when the STRTCP command is called. If you do not plan to use REXEC, set AUTOSTART to *NO.
*YES: Start the number of servers defined in the NBRSVR parameter.

Number of initial servers (NBRSVR)

Specifies the minimum number of REXEC servers to start initially when REXEC is started by either the Start TCP/IP (STRTCP) or Start TCP/IP Server (STRTCPSVR) commands. These servers allow new clients to connect to the server without having to wait for the overhead associated with starting a new server.

*SAME The number of servers that was previously set does not change; otherwise, *DFT is used.

*DFT: The number of servers is set to the default value of 2.
number-of-servers: The number of servers requested to start. Valid values range from 1 through 20 servers.

Inactivity timeout (INACTTIMO)

Specifies the number of seconds of inactivity between the client and server jobs before the server assumes the client has stopped communicating and disconnects the client. When this event occurs, the server does not run any command for the client user.

*SAME: The time-out value does not change if it was previously set; otherwise, *DFT is used.
*DFT: The time-out value is set to the default of 300 seconds (5 minutes).
inactive-timeout: Specify an inactive time-out period in seconds. Valid values range from 1 through 2147483647 ((2**31)-1) seconds.

Coded character set identifier (CCSID)

Specifies the ASCII coded-character set identifier (CCSID) that is used for conversion of data received from and sent to the REXEC client.

*SAME: The CCSID value that was previously set does not change; otherwise, *DFT is used.
*DFT: The CCSID value is chosen to be the related default single-byte PC ASCII equivalent of the CCSID specified by the QCCSID system value (or, if the QCCSID system value is 65535, the ASCII equivalent of the default CCSID associated with the language specified by the QLANGID system value).
CCSID-value: The requested CCSID value is used. This value is validated to ensure that a valid ASCII CCSID has been requested.