High performance remote commands using TCP/IP (optional)

Remote command submission is available when Remote E/C/D is installed on the workstation. The default remote command submission facility uses and is available when all normal Remote E/C/D host and workstation setup and configuration steps have been followed. You should verify that this has been done and is working correctly before proceeding.

A second remote command facility (high performance command facility) is also available for use when TCP/IP and NFS are used for host communications. The high performance command facility is optional. It typically has better performance than the standard facility which uses but requires additional configuration.

The high performance command facility uses an APPC/MVS transaction to execute remote commands. The workstation invokes a clist (IGYFINIT) on the host which starts the APPC transaction (IGYFSERV) to act as a host server which will execute MVS commands issued from the workstation via TCP/IP. (This means APPC is NOT required on the workstation as it communicates with IGYFSERV via TCP/IP.)

This section describes the additional host and workstation configuration required to enable the high performance command facility, these steps are only required if the intent is to use the high performance command facility.

The high performance command facility is supported only when using TCP/IP and NFS for host access. Each workstation may have at most one active connection to one host at a time.

NOTE to APPC administrators on OS/390 R3

The high performance command facility uses an APPC transaction to execute the remote commands. There is currently an APPC problem on OS/390 R3 such that both partners of an APPC conversation may not be on the same system (i.e. both partners are using a blank partner_LU name). The APPC/MVS APAR number is OW26216. The fix is PTF UW37792.

There is a workaround if you have two LPARs sharing the system (as in USERIDS, RACF, DASD, etc). You'll need to find and modify the partner_LU specification in IGYFINIT and in IGYFSERV. IGYFINIT's partner should be the secondary machine (the system pointed to by the user's MVSINFO.DAT file is the primary machine). IGYFSERV's partner should be the primary machine and the transaction (IGYFTPAD) should be defined on the secondary machine.

If you are using OS/390 R3 and do not have two LPARS sharing the same system, the high performance command facility cannot be enabled until PTF UW37792 is installed.

Host configuration for high performance command facility

The following parts must be available on the host system:

The above CLISTs are in the SIGYCLST data set, and the above sample JCL is in the SIGYSAMP data set. These data sets are supplied with either the host product IBM COBOL for OS/390 & VM V2R1 (with the fix for APAR PQ13212 applied), or the host product IBM COBOL for MVS & VM V1R2 (with the fix for APAR PQ13211 applied),

The first step is to define the APPC transaction that will act as a command server for VisualAge for COBOL. The IGYFTPAD sample JCL, (Figure 1) can be used to define the APPC transaction.

It is expected that the following things have already been done by your system programmer or APPC Administrator and are in place on your system.

Workstation Setup for high performance command facility

On the workstation you need to insure that:

Once the above is done (along with the rest of the setup for Remote E/C/D), you can verify the high performance MVS commands facility by doing

After the drives have been successfully connected, you should see some messages (a couple of dozen or so) about setting up APPC. The last message should end with CONFIRMED succeeded.

Trouble-shooting

The following list points out some of the things to look for if you are unsuccessful in using High Performance Command Facility: