Remote Executor

This chapter describes how to use the Cisco IOS for S/390 Remote Executor. It includes these sections:

• What Is the Remote Executor?

A brief description of the Remote Executor, TCPREXEC.

• The REMCMND Program

Describes how the REMCMND program passes information to the REXEC daemon.

• Running REMCMND Interactively (TCPREXEC)

Describes how to run the REMCMND program from a TSO command line with the TCPREXEC command.

• Running REMCMND In Batch Mode

Describes how to run the remote executor in batch mode. Example JCL is provided.

What Is the Remote Executor?

The Remote Executor, TCPREXEC, uses the REMCMND program to execute a command on a foreign host and receive results on the local host. You can use the TSO command TCPREXEC or you can run TCPREXEC in batch mode using a JCL.

The REMCMND Program

The REMCMND program lets you execute a command on a remote host and receive results on the local host. The REMCMND program can be executed from the TSO command line or from a batch job using a JCL.

An REXEC daemon must be running on the host. The REMCMND client passes the user name, password, and command to the REXEC daemon. The daemon provides logon and user authentication, depending on the parameters set by the user. If authentication fails, an error message displays on the local host.

Running REMCMND Interactively (TCPREXEC)

When executing REMCMND interactively under TSO, you must invoke a REXX EXEC called TCPREXEC to dynamically allocate statements and files. TCPREXEC passes command-line arguments to the host in as-is format (overriding the TSO function which makes all arguments uppercase). The TCPREXEC REXX EXEC is contained in the SAMP library. Copy it to a system CLIST or REXX library to use it.

To execute a command on the foreign host and receive the results on the local host, use the TCPREXEC command as shown here:

Syntax Description

Using the NETRC File with TCPREXEC

REMCMND uses a NETRC (user.FTP.NETRC on MVS) file if you provide one. The NETRC file contains the host name, user ID, and password for multiple machines on your network. It takes this format:

Example:

To have the TCPREXEC program scan your NETRC file for a machine with the host name snoopy, enter this TCPREXEC command:

In this command, snoopy is the host name and ls -l is the command string.

If TCPREXEC does not find user.FTP.NETRC, or does not find the host name in the file, it prompts for the user name and password.

Running REMCMND In Batch Mode

To run REMCMND in batch mode, you must include information in a JCL stream.

If you want to run in batch mode, use the JCL in this example. This example JCL issues an ls -l command on the remote host hostname.

//REMCMND    JOB
//JS01 EXEC PGM=REMCMND,
//  PARM='USER(username) PASS(password) hostname ls -l'
//STEPLIB    DD DISP=SHR,DSN=T01TCP.LINK
//           DD DISP=SHR,DSN=T01TCP.LOAD
//SYSPRINT   DD SYSOUT=A
//SYSTERM    DD  SYSOUT=A
//OUTPUT     DD SYSOUT=A

Output received from the command executed by program REMCMND is written to the OUTPUT DD statement.

Using a NETRC file in Batch Mode

When you run REMCMND in batch mode, REMCMND does not automatically read your NETRC file as it does for the interactive TSO command TCPREXEC. In batch mode, you must include a NETRC statement in your JCL.

The next example uses the user.FTP.NETRC file to provide the user name and password.

//REMCMND     JOB
//JS01 EXEC PGM=REMCMND,PARM='hostname ls -l'
//STEPLIB     DD DISP=SHR,DSN=T01TCP.LINK
//            DD DISP=SHR,DSN=T01TCP.LOAD
//NETRC       DD DSN=uid.FTP.NETRC,DISP=SHR
//SYSPRINT    DD SYSOUT=A
//SYSTERM     DD  SYSOUT=A
//OUTPUT      DD SYSOUT=A

Command Line Arguments

You can use the PARM option on the EXEC statement to pass information to the REMCMND program.

//JS01 EXEC PGM=REMCMND,PARM='host_name cmnd_string'

Combining Commands

On many systems, you can string several commands together on the same line. For example, on UNIX, you can issue two commands on the same line by separating the commands with the semicolon (;) as a delimiter.

Examples

You can use this facility with REMCMND in batch files.

//JS01 EXEC PGM=REMCMND,PARM='hostname ls;date'

Using a SYSIN DD Statement In Your JCL

If the parameter field on the EXEC statement is blank, REMCMND looks for a SYSIN DD statement in the batch JCL. REMCMND reads an 80 byte card from SYSIN and parses it like the command-line arguments.

Include information for username, password, hostname, and command_string in the JCL as shown in this example:

//REMCMND   JOB
//JS01 EXEC PGM=REMCMND
//STEPLIB   DD DISP=SHR,DSN=T01TCP.LINK
//          DD DISP=SHR,DSN=T01TCP.LOAD
//SYSPRINT  DD SYSOUT=A
//SYSTERM   DD  SYSOUT=A
//OUTPUT    DD SYSOUT=A
//SYSIN     DD *
user_name password host_name cmnd_string
//

For frequently used commands, you can include this line in the JCL to create a control file with the pertinent information:

USER(user_name) PASS(password) zulu exec /usr/openwin/bin/xioctetn \
-server telnet -host mvshost -title REMCMND

Using the \ Character for Continuing Long Lines

The backslash character (\) is used to continue a line of text that does not fit on the screen. The backslash may appear anywhere on the line but must be followed by at least one blank space.

 
Caution