STRPASTHR (Start Pass-Through)
STRPASTHR Command syntax diagram
Purpose
The Start Pass-Through (STRPASTHR) command allows pass-through (and sign-on) to a remote system as if attachment is local. This command uses the iSeries 400 advanced program-to-program communications (APPC) and advanced peer-to-peer networking (APPN) support to connect the local display station to the remote system. More information on configuring or operating the pass-through operation is in the Remote Work Station Support book.
Restriction:
- This command cannot be entered at a work station with a display that has 12 lines by 80 characters.
Required Parameters
- RMTLOCNAME
- Specifies, if CNNDEV(*LOC) is specified, the name of the remote location
that is the target of the pass-through session, or if devices are specified on
the CNNDEV parameter, it specifies the first system that does intermediate
pass-through routing.
*CNNDEV: The APPC devices specified on the CNNDEV parameter are used.
remote-location-name: Specify the name of the remote location that is the target of the pass-through session or the name of the first system that does intermediate pass-through routing. The advanced peer-to-peer networking (APPN) support function determines the route to this location.
Optional Parameters
- CNNDEV
- Specifies the names of the device descriptions that connect the first
system that does pass-through routing from the source system to the target
system. If RMTLOCNAME(*CNNDEV) is specified, the first device specified on this
parameter is on the source system. If the RMTLOCNAME parameter is a location,
the first device specified is on the system containing that location. If the
target system is more than one system away and pass-through must establish the
intermediate sessions, a list of APPC device descriptions must be specified.
The APPC device names must be listed in the order that the systems are passed
through to reach the target system.
*LOC: The RMTLOCNAME parameter is used to identify the target of the pass-through session and the path used to reach the target.
APPC-device-name(s): Specify the names of the device descriptions that complete the route from the source system to the target system. Up to 16 names can be specified.
- VRTCTL
- Specifies the name of the virtual controller on the remote system that is
used to do a pass-through session. If a virtual controller is specified, one of
the virtual display devices attached to it is selected to do the pass-through
session. The system tries to compare the device type and model of the physical
display device with an available virtual device. If the same type or a similar
type is not available, a comparison is made with a 5251 Model 11, if available.
Graphics cannot be done with a 5251 Model 11 device; a 5292 Model 2 device is
required. If no virtual devices are available, another virtual controller must
be specified, or the user must try again later.
*NONE: No controller is specified. VRTDEV(*NONE) requests that the target system automatically configures a virtual device.
virtual-controller-name: Specify the name of the virtual controller description on the remote system.
- VRTDEV
- Specifies one or more devices on the remote system that are connected to a
virtual controller used for the pass-through session. A device from the list on
the remote system is selected based on a comparison of device type and model.
If more than one device is in the list, the first available device that closely
matches the type and model of the device on which the command is entered is
used. If the same type or a similar type is not available, a comparison is made
with a 5251 Model 11, if available. Graphics cannot be done with a 5251 Model
11 device; a 5292 Model 2 device is required.
*NONE: No device names are specified. VRTCTL(*NONE) requests that the target system automatically configures a virtual device.
virtual-display-device-name: Specify the names of the virtual display device descriptions on the remote system used for the pass-through session. Up to 32 names can be specified.
- MODE
- Specifies the mode name used for the pass-through session. This parameter
is not valid if RMTLOCNAME(*CNNDEV) is specified. In this case, the system uses
the first mode name specified in the APPC device description.
*NETATR: The pass-through mode in the network attributes is used for the pass-through session.
mode-name: Specify a mode name to use for the pass-through session. Specify BLANK for a mode name consisting of eight blank characters.
- LCLLOCNAME
- Specifies the local location name.
*LOC: The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.
*NETATR: The default location name defined in the Change Network Attributes (CHGNETA) command is used.
local-location-name: Specify the local location name for the source system.
- RMTNETID
- Specifies the network identifier (ID) of the network in which the remote
location resides. This parameter is not valid if RMTLOCNAME(*CNNDEV) is
specified.
*LOC: The remote network identifier (ID) associated with the remote location is used. If several remote network IDs are associated with the remote location, the system determines which remote network ID is used.
*NETATR: The RMTNETID value specified in the system network attributes is used.
*NONE: No remote network identifier (ID) is used.
remote-network-ID: Specify the identifier of the network in which the target system (specified by the RMTLOCNAME parameter) is located.
- SRQ10PGM
- Specifies that the System Request menu or a user-written program starts
when SYSREQ option 10 is selected. The user program displays a menu that allows
selection of the system to access, and then transfers to a group job that sends
the STRPASTHR command to the desired system. More information is in the Remote Work Station Support
book.
*SRQMNU: The System Request menu is displayed.
The name of the program can be qualified by one of the following library values:
-
*LIBL: All libraries in the job's library list are searched until the first match is found.
-
*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
-
library-name: Specify the name of the library to be searched.
program-name: Specify the name of the program that starts when the SYSREQ option 10 is selected.
-
- RMTUSER
- Specifies the user profile for automatic sign-on to the target system. If a
profile is specified for this parameter and password security is active on the
target system, RMTPWD(*NONE) is not valid.
*NONE: No user profile name is sent, and automatic sign-on does not occur.
*CURRENT: The user profile that is currently running is used.
user-profile-name: Specify a user profile name to use that exists on the target system. If the target system allows it, and the user profile exists on the target system, the user is automatically signed on. Otherwise, the user is presented with a sign-on display on the target system or a failure message on the source system, depending upon the configuration of the target system. If a profile is specified and password security is active on the target system, a password must be specified, even if the profile specified is the same as the current profile.
- RMTPWD
- Specifies the password sent to the target system.
*NONE: The system does not pass a password. If a profile is specified on the RMTUSER parameter and password security is active on the target system, this value is not allowed.
password: Specify a password sent to the target system to verify the sign-on of the user specified in the RMTUSER parameter. This password is encrypted before being sent across the communication line.
- RMTINLPGM
- Specifies the program called immediately after sign-on to the system.
*RMTUSRPRF: The initial program specified in the remote user profile is run immediately after the job (which was automatically signed-on) starts.
*NONE: No program is run before the first menu is displayed, even if the first program is specified in the remote user profile.
program-name: Specify the name of a program that is run immediately after automatic sign-on.
- RMTINLMNU
- Specifies the first menu shown when automatically signed on the target
system after the first program is run.
*RMTUSRPRF: The initial menu specified in the remote user profile is shown immediately after the first program is run.
*SIGNOFF: No menu is displayed after the first program is run, even if an initial menu is specified in the remote user profile. After the program runs, the user is signed off, and the program runs.
menu-name: Specify the menu shown immediately after the initial program is run.
- RMTCURLIB
- Specifies the name of the library that becomes the current library in the
library list of the job after automatic sign-on to the system.
*RMTUSRPRF: The current library specified in the remote user profile becomes the current library in the library list after automatic sign-on.
library-name: Specify the name of the library that becomes the current library in the library list before the pass-through session is established.
- PASTHRSCN
- Specifies whether the pass-through display and associated status messages
appear before the pass-through session is established.
*YES: The pass-through display and informal messages are shown before the pass-through session is established.
*NO: The pass-through display and information messages are not shown before the pass-through session is established.
Examples for STRPASTHR
Example 1: Pass-Through to Toronto
STRPASTHR RMTLOCNAME(*CNNDEV) CNNDEV(DET CHI TOR) VRTCTL(VWSC)
This command specifies starting a pass-through to the Toronto system by
going through Detroit and Chicago. More information is in the Remote Work Station Support 
book.
Example 2: Pass-Through to Detroit
STRPASTHR RMTLOCNAME(DETROIT) VRTCTL(VWSC)
This command specifies a pass-through to the Detroit system. APPN establishes the route to Detroit.
Example 3: Pass-Through to Toronto
STRPASTHR RMTLOCNAME(DETROIT) CNNDEV(CHI TOR) VRTCTL(VWSC)
This command specifies another way to pass-through to the Toronto system by going through Chicago and Detroit. APPN establishes the route to Detroit.
Example 4: Pass-Through to Detroit
STRPASTHR RMTLOCNAME(DETROIT) RMTUSER(*CURRENT)
This command specifies a pass-through to the DETROIT system and an automatic sign-on using the user profile with the same name as the one currently used on the source system. It also specifies that the DETROIT system automatically configures a virtual device for the pass-through session, since a virtual controller or virtual device was not specified.
Error messages for STRPASTHR
*ESCAPE Messages
- CPF2702
- Device description &1 not found.
- CPF2703
- Controller description &1 not found.
- CPF5383
- Mode &7 specified for device &4 not valid.
- CPF5536
- System cannot automatically select an APPC device description for the remote location.
- CPF5546
- Class-of-service for device &4 not valid.
- CPF8901
- Virtual device &1 not varied on.
- CPF8902
- Virtual device &1 not available.
- CPF8903
- Device &1 not valid for pass-through.
- CPF8904
- Pass-through request not accepted.
- CPF8905
- Pass-through not allowed on this system.
- CPF8906
- Error during session initialization. Reason code &1.
- CPF8907
- Communications failure for device &1.
- CPF8908
- Controller &1 not varied on.
- CPF8909
- Old software release. Pass-through ended.
- CPF8910
- Controller &1 not valid for pass-through.
- CPF8911
- Communications failure. Session was not started.
- CPF8912
- Pass-through session ended. Reason code &1.
- CPF8913
- Pass-through ended abnormally.
- CPF8916
- Cannot select virtual device &1 at system &2.
- CPF8917
- Not authorized to &1.
- CPF8918
- Job canceled at system &1.
- CPF8919
- Device &1 not accessed by system &2.
- CPF8920
- Pass-through failed. &1 must be varied off and on.
- CPF8921
- APPC failure. Failure code is &3.
- CPF8922
- Negative response from device &1 at system &2.
- CPF8923
- Data stream received at system &1 not valid.
- CPF8924
- No available virtual controller.
- CPF8925
- Device &1 not created.
- CPF8928
- Device &1 could not be changed.
- CPF8929
- Device &1 could not be varied on.
- CPF8931
- Location &1 not an APPC location.
- CPF8932
- Device &1 must be non-networking APPC device.
- CPF8933
- Route to specified location not found.
- CPF8935
- Pass-through not allowed to system &1.
- CPF8936
- Pass-through failed for security reasons.
- CPF8937
- Automatic sign on not allowed.
- CPF8938
- Error in QRMTSIGN program. Pass-through failed.
- CPF8939
- Trying to send too much data.
- CPF8940
- Cannot automatically select virtual device.
- CPF8941
- Incorrect internal use of pass-through.
- CPF8943
- Pass-through not allowed from server TELNET session.
*STATUS Messages
- CPI8901
- No matching device on remote system. Function limited.
- CPI8902
- Pass-through started at system &1.
- CPI8903
- Virtual device &1 selected at system &2.
- CPI8906
- Automatic sign-on not allowed.