The REXEC server command processing selection (RXCS0100) exit point allows you to specify which command processor the REXEC server uses for interpreting and running your commands.
The RXCS0100 exit program enables you to select: - Which command processor runs the command that the REXEC client user provides
- Whether the REXEC server converts data between ASCII and EBCDIC (for Qshell commands or spawn path names)
| Parameter | Description | Input or output | Type and length |
|---|---|---|---|
| 1 | User profile | Input | Char(10) |
| 2 | Remote IP address | Input | Char(*) |
| 3 | Length of remote IP address | Input | Binary(4) |
| 4 | Command string | Input | Char(*) |
| 5 | Length of command string | Input | Binary(4) |
| 6 | Command processor identifier | Output | Binary(4) |
| 7 | Character conversion option | Output | Binary(4) |
Exit point format name: RXCS0100
Exit point name: QIBM_QTMF_SVR_SELECT
Note: Character
data passes to the exit program in the coded character set identifier (CCSID)
of the job. If the job CCSID is 65535, the server uses the default CCSID of
the job.
Required parameter group
- User profile
- INPUT; CHAR(10) The user profile under which the requested operations is run.
- Remote IP address
- INPUT; CHAR(*) The Internet protocol (IP) address of the REXEC client system. This string is in dotted decimal format, left justified.
- Length of remote IP address
- INPUT; BINARY(4) Indicates the length (in bytes) of the remote IP address.
- Command string
- INPUT; CHAR(*) The command to be run as specified by the REXEC client.
- Length of command string
- INPUT; BINARY(4) Indicates the length (in bytes) of the command string.
- Command processor identifier
- OUTPUT; BINARY(4) Indicates the command processor that you want the server
to use for interpreting and running the command. The following values are
valid:
Table 2. Valid values Value Operation 0 i5/OS™ control language — The server processes the command as an i5/OS control language (CL) command. This is the default value. 1 Qshell command — The Qshell command interpreter processes the command. The server uses the spawn() application programming interface (API) to call Qshell as a child job. 2 Spawn path name — The server treats the command name as a path name and passes it to the spawn() application programming interface (API), which runs as the child job. - Character conversion option
- OUTPUT; BINARY(4) Indicates whether the REXEC server performs ASCII-EBCDIC
character conversion for data that is passed on the stdin, stdout, and stderr
streams. These values are valid:
Table 3. Valid values Value Operation 0 Do not convert data. The server transfers all data on the stdin, stdout, and stderr streams without converting it. 1 Convert data. This is the default. - The server converts data in the stdin stream from the ASCII CCSID that the CHGRXCA command specifies to the job CCSID. If the job CCSID is 65535, the server uses the default CCSID of the job.
- The server converts data in the stdout and stderr streams from the job CCSID to the ASCII CCSID that the CHGRXCA command specifies. If the job CCSID is 65535, the server uses the default CCSID of the job.
Usage notes
- If you add exit programs to both the QIBM_QTMX_SERVER_REQ and QIBM_QTMX_SVR_SELECT exit points, REXEC server first calls the exit program that you add to the QIBM_QTMX_SERVER_REQ exit point. If this program allows the operation, the server then calls the exit program that you add to the QIBM_QTMX_SVR_SELECT exit point.
- When you set the Command processor identifier parameter to 0 (i5/OS control language command), the conversion option is ignored. The server always performs character conversion for the CL commands.
- When you set the command processor identifier to 1 (Qshell Command),
the server sets these environment variables:
- TERMINAL_TYPE=REMOTE
- PATH= /usr/bin:
- LOGNAME= user (where user is the user profile)
- HOME= homedir (where homedir is the user's home directory)