The Start Pass-Through Using RSF (STRPASRSF) command is used to start a pass-through or telnet session with a remote server. When you run the STRPASRSF command, the server machine is contacted and a sign-on display is presented.
Note: To end the pass-through session, specify ENDCNN(*YES) when entering the SIGNOFF command on the
remote machine.
The prompted version of the STRPASRSF command is shown below. Click on the image to see parameter descriptions. Start Pass-Through Using RSF (STRPASRSF)
Type choices, press Enter.
Server ID . . . Name
Remote user profile . . . *NONE Name, *NONE, *CURRENT Remote password . . . Name, *NONE
Remote password encryption . . . *DES7 *DES7, *SHA1, *NONE Remote initial program . . . *RMTUSRPRF Name, *RMTUSRPRF, *NONE Remote initial menu . . . *RMTUSRPRF Name, *RMTUSRPRF, *SIGNOFF Remote current library . . . *RMTUSRPRF Name, *RMTUSRPRF
Hang up after this transaction *YES *YES, *NO
Call-back phone number . . . *NONE Message for server . . . *SERVER
The parameters for the STRPASRSF command are described below.
Server id
The name of a server directory entry to be referenced. The entry must have been previously added to the server directory on your machine. See Adding Server Directory Entries for more information. This is a required parameter.
The possible values are:
name: The name of an entry in the server directory on your machine. Remote User Profile
Specify a user profile to use for automatic sign-on to the remote system.
If a valid password is supplied, and if the remote system allows automatic sign-on, you can use this parameter to bypass the sign-on display on the remote system.
This parameter is ignored for TCP/IP connections. The possible values are:
*NONE: Automatic sign-on is not requested.
*CURRENT: The user profile of the user executing this command is used. user-profile-name: Enter a valid user profile name.
Remote Password
Specify a password to send to the remote system along with the user profile for automatic sign-on. The possible values are:
*NONE: No password is sent.
password: Enter the password for the specified user profile. Remote password encryption
Specify, for TCP/IP connections, whether to encrypt the password when initiating the connection. This value is ignored unless:
● A value other than *NONE was specified for the Remote User Profile (RMTUSRPRF) parameter.
● The operating system release level of the source and target machines is V5R1M0 or greater.
The possible values are:
*DES7: The default encryption method is used. If the remote operating system level is V5R1M0 or
greater, a value of '0' or '1' must be specified for the QPWDLVL system value on the remote system.
*SHA1: SHA-1 encryption is used. The remote operating system level must be at V5R1M0 or later, and a
value of '2' or greater must be specified for the QPWDLVL system value on the remote system.
*NONE: No password encryption is used. Remote initial program
Specify the name of an initial program to call when starting the session on the target system. This value is ignored unless:
● A value other than *NONE was specified for the Remote User Profile (RMTUSRPRF) parameter.
● System value QRMTSIGN on the target system is set to *SAMEPRF or *VERIFY.
● For TCP/IP connections, the operating system release level of the source and target machines is V5R1M0 or
greater.
The possible values are:
*RMTUSRPRF: The initial program specified in the user profile on the target machine is used. *NONE: No initial program is called.
program-name: Enter the name of the initial program to call. The program must be found in the target
job's initial library list.
Remote initial menu
Specify the name of an initial menu to call when starting the session on the target system. This value is ignored unless:
● A value other than *NONE was specified for the Remote User Profile (RMTUSRPRF) parameter.
● System value QRMTSIGN on the target system is set to *SAMEPRF or *VERIFY.
● For TCP/IP connections, the operating system release level of the source and target machines is V5R1M0 or
greater.
The possible values are:
*RMTUSRPRF: The initial menu specified in the user profile on the target machine is used. *SIGNOFF: The job is signed off after the initial program completes.
menu-name: Enter the name of the initial menu to use. The menu must be found in the target job's initial
library list.
Remote current library
Specify the name of the current library to use when starting the session on the target system. This value is ignored unless:
● System value QRMTSIGN on the target system is set to *SAMEPRF or *VERIFY.
● For TCP/IP connections, the operating system release level of the source and target machines is V5R1M0 or
greater.
The possible values are:
*RMTUSRPRF: The current library specified in the user profile on the target machine is used. library-name: Enter the name of the initial current library to use.
Hang up after this transaction
Whether RSF should hang up the phone connection at the completion of the transaction. This parameter is ignored for non-switched connections. Click here for a complete description of this parameter.
Call-back phone number
The phone number to pass to the server machine when requesting that the server call your machine back. Click here
for a complete description of this parameter.
Message for server
An ad hoc message to be sent to the server along with the start pass-through request. Click here for a complete description of this parameter.
Contact name, etc.
When you prompt for command parameters with F4, default name, address and telephone information is filled in for you. These are the same defaults the system uses to send PTF orders via Electronic Customer Support.
The possible values are:
contact information: Enter the appropriate information for contact name, address, and phone.