This chapter describes how to install Remote Software Facility, how to include the RSF library in a job's library list, and how to tailor Remote Software Facility for your installation.
After following the instructions in this chapter, see Chapter 4: Making Connections to configure RSF connections to other machines.
If your machine will be servicing incoming requests from remote machines, be sure to see Performance Considerations for tips on fine tuning RSF performance.
To install RSF for the first time, or to upgrade to a new version of RSF:
After completing the installation procedure outlined above, skip to Verifying Installation.
This procedure will:
To install RSF from the distribution media:
After completing the automatic installation procedure outlined above, skip to Verifying Installation.
You should use the Automatic Installation Procedure if at all possible, especially if you are installing to a machine that contains a previous release of RSF.
Use manual installation if you wish to copy the RSF libraries from one machine to another and you do not have the original distribution media. Libraries RSF and RSFTOOLS must have been saved to the media using the SAVLIB command.
Note: If you followed either of the above installation procedures, this step has already been done for you. Skip to Verifying Installation.
When you receive no answer or a busy signal while dialing out from your machine, the system sends an inquiry message such as CPA5712 to the system operator's message queue. The text for this message is "Time limit reached while trying to call controller". These messages must be answered with a "C" for cancel or an "R" for retry. When there is no entry in the system reply list for these messages, your job will wait upon receiving no answer or a busy signal until the message on the operators message queue is explicitly answered. By adding entries to the system reply list for this and similar messages, you can cause the message to be answered automatically.
Several entries are added to your system reply list during the install process. If you delete or change any of these entries, RSF will not automatically add them again. The comparison data for each entry is set to "RSF" so that the messages only effect RSF jobs. The following table shows the reply list entries that RSF adds:
|
Message id |
Reply |
Description |
|
CPA2610 |
G |
Device cannot be varied off at this time. |
|
CPA5712 |
C |
Time limit reached while trying to call controller. |
| CPA5714 |
C |
System cannot call controller &24. No lines available. |
| CPA58DB |
C |
Call to controller &24 on line &23 failed. No answer tone. |
|
CPA58D6 |
C |
Time-out occurred. |
|
CPA58D7 |
C |
Modem aborted call. |
|
CPA58D8 |
C |
Dial tone error. |
|
CPA58D9 |
C |
Remote busy. |
| CPA58DC |
C |
Call to controller &24 on line &23 failed. No answer. |
| CPA5902 |
C |
Controller &24 not contacted. Call out request failed. |
| CPA596D |
C |
Line &23 failed. Probable modem problem. |
You can cause RSF to add relevant entries to your system reply list again at any time by executing the following command:
CALL RSCL038
Note: If you followed the automatic installation procedure, this step has already been done for you. Skip to Verifying Installation.
If you plan to use the server function of RSF (i.e. to answer incoming calls, allowing other AS/400s to access your machine) you must create a user profile for the server function to run under. If you do not plan to have your machine answer incoming calls from remote RSF requesters, you may skip this step.
RSF will attempt to create user profile RSFSRV automatically, the first time you start the server function on your machine using the STRRSFSRV command (option 21 on the RSF menu). *SECADM special authority is required to create a user profile. Therefore, the security officer or another user with *SECADM authority should enter the STRRSFSRV command the first time, in order to have RSF create user profile RSFSRV automatically. Once the profile is created, no special authority is required to execute the STRRSFSRV command. If you prefer to create user profile RSFSRV yourself, follow the instructions below. Otherwise, you may skip this section.
To create the user profile, enter the following command at any command line:
CRTUSRPRF USRPRF(RSFSRV) PASSWORD(RSFSRV) PWDEXP(*NO) + CURLIB(RSF) INLPGM(*NONE) INLMNU(*SIGNOFF) LMTCPB(*YES) + PWDEXPITV(*NOMAX) JOBD(RSF/RSF) + SPCAUT(*IOSYSCFG *JOBCTL *SAVSYS *SPLCTL)
Each command parameter must be specified exactly as shown for the RSF software to function correctly.
Specifying *NONE for INLPGM, and *SIGNOFF for INLMNU insures that no one can sign on with this user profile from any workstation. The profile is only used in RSF communications sessions.
You may specify a different password for the RSFSRV profile if either of the following apply:
To verify installation, run the following command from any command line:
GO RSF/RSF
If the RSF menu is displayed showing "RSF 8.1" in the upper-left, installation is complete.
Library RSF must be in the library list of jobs using Remote Software Facility, or RSF commands must be qualified with the library RSF. Depending on your installation and intended use, do one of the following:
Determine the best method for your installation and perform the changes required.
Note: Changing your system values to include library RSF in either the system library list (QSYSLIBL) or the user library list (QUSRLIBL) is not recommend, as this will make it much more difficult to upgrade to a new release of the product.
You can change many of the parameters that govern the functioning of the Remote Software Facility product. In most cases, the defaults shipped with the product will be adequate for your installation. If you wish to accept all of the default run parameters for RSF, you may skip this section. Refer to this section whenever you want to change the RSF defaults.
The Change RSF Defaults (CHGRSFDFT) command allows you to tailor RSF default values to reflect the preferences of your installation. To access the command prompt, enter the following at any command line:
CHGRSFDFT
Press F4.
When you press F4, the CHGRSFDFT command prompt appears with the current values filled in.
Change RSF Defaults (CHGRSFDFT)
Type choices, press Enter.
Max times access allowed . . . . *NOMAX 1-9999997, *NOMAX, *SAME
Pre-processing program . . . . . *NONE Name, *SAME, *NONE
Library . . . . . . . . . . . Name, *LIBL, *CURLIB
Catalog pre-processing program *NONE Name, *SAME, *NONE
Library . . . . . . . . . . . Name, *LIBL, *CURLIB
Post-processing program . . . . *NONE Name, *SAME, *NONE
Library . . . . . . . . . . . Name, *LIBL, *CURLIB
Normal message queue . . . . . . QSYSOPR Name, *SAME, *NONE
Library . . . . . . . . . . . *LIBL Name, *LIBL, *CURLIB
Error message queue . . . . . . QSYSOPR Name, *SAME, *NONE
Library . . . . . . . . . . . *LIBL Name, *LIBL, *CURLIB
Requester message queue . . . . QSYSOPR Name, *SAME, *NONE
Library . . . . . . . . . . . *LIBL Name, *LIBL, *CURLIB
Max splf pages to rceive . . . . 200 1-9999997, *NOMAX, *SAME
Max save file rcds to receive . 10000 1-9999997, *NOMAX, *SAME
SDLC requester info:
Line description . . . . . . . RSFRQS Name, *SAME
Resource name . . . . . . . . CMN06 Name
Interface type . . . . . . . . *RS232V24 *RS232V24, *V35, *X21...
Line speed . . . . . . . . . . 19200 Character value, 600, 1200...
Modem type . . . . . . . . . . *V54 *NORMAL, *V54, *IBMWRAP...
Auto dial . . . . . . . . . . *YES *YES, *NO
Duplex . . . . . . . . . . . . *HALF *HALF, *FULL
Call-back phone number . . . . '1 206 633 0512'
Switched connection group . . *NONE Name, *NONE
+ for more values
Requester vary on wait (sec.) . 15 15-180, *SAME, *NOWAIT
Redial delay (0.5 sec.) . . . . 10 0-254, *SAME
Dial retry . . . . . . . . . . . 0 0-254, *SAME
SDLC server info:
Line description . . . . . . . RSFSRV Name, *SAME
Resource name . . . . . . . . CMN06 Name
Interface type . . . . . . . . *RS232V24 *RS232V24, *V35, *X21...
Line speed . . . . . . . . . . 19200 Character value, 600, 1200...
Modem type . . . . . . . . . . *V54 *NORMAL, *V54, *IBMWRAP...
Auto dial . . . . . . . . . . *YES *YES, *NO
Duplex . . . . . . . . . . . . *HALF *HALF, *FULL
+ for more values
Server vary on wait (sec.) . . . 30 15-180, *SAME, *NOWAIT
Delay dropping inactive line . . 1800 0-65535, *NOMAX, *SAME
PPP requester info:
Line description . . . . . . . RSFRQP Name, *NONE, *SAME
Resource name . . . . . . . . CMN05 Name
Interface type . . . . . . . . *INTMODEM *RS232V24, *V35, *X21...
Modem type . . . . . . . . . . '2793 Internal Modem '
Call-back phone number . . . . '12066330512'
Switched connection group . . *NONE Name, *NONE
+ for more values
PPP dial attempts . . . . . . . 1 1-10, *SAME
PPP redial delay (sec.) . . . . 15 1-60, *SAME
PPP server info:
Line description . . . . . . . RSFSRP Name, *NONE, *SAME
Resource name . . . . . . . . CMN05 Name
Interface type . . . . . . . . *INTMODEM *RS232V24, *V35, *X21...
Modem type . . . . . . . . . . '2793 Internal Modem '
+ for more values
PPP server IP address . . . . . '10.24.23.22'
PPP server validation list . . . *NONE Name, *NONE, *SAME
Encryption key data area . . . . *NONE Name, *NONE, *SAME
Library . . . . . . . . . . . Name, *LIBL
SSL Status . . . . . . . . . . . *ENABLED *ENABLED, *DISABLED, *SAME
Require client authentication . *NO *YES, *NO, *SAME
TCP/IP send buffer size . . . . 8388608 16384-8388608, *SAME
TCP/IP receive buffer size . . . 8388608 16384-8388608, *SAME
TCP/IP record block size . . . . 1000 1-5000, *SAME
TCP/IP keep-alive interval . . . 10 Number, *SAME, *DFT
Log local commands . . . . . . . *NO *YES, *NO, *SAME
Log switched connections . . . . *NO *YES, *NO, *SAME
Server ID for this machine . . . HOMEBASE Name, *NONE, *SAME
Sync start program . . . . . . . SYNCTOPRD Name, *SAME, *NONE
Library . . . . . . . . . . . RSFUSER Name, *LIBL, *CURLIB
Sync job display program . . . . WRKSYNCJOB Name, *SAME
Library . . . . . . . . . . . RSFUSER Name, *LIBL, *CURLIB
Role swap to backup program . . SWAPTOBKP Name, *SAME, *NONE
Library . . . . . . . . . . . RSFUSER Name, *LIBL, *CURLIB
Role swap to production pgm . . SWAPTOPRD Name, *SAME, *NONE
Library . . . . . . . . . . . RSFUSER Name, *LIBL, *CURLIB
Current replication role . . . . *PROD *SAME, *PROD, *BACKUP...
Outgoing mail server . . . . . . 'smtpauth.earthlink.net'
Outgoing mail port . . . . . . . *SMTP Number, *SAME, *SMTP...
Outgoing mail user ID . . . . . 'MyMailUserID'
Outgoing mail password . . . . .
Outgoing mail from address . . . 'me@MyCompany.com'
Outgoing mail encryption . . . . *NO *SAME, *NO, *YES
Software expiration date . . . . *PERM *SAME
Software release level . . . . . 08.60 *SAME
Optional features . . . . . . . *HA *SAME
F3=Exit F4=Prompt F5=Refresh F10=Additional parameters F12=Cancel
F13=How to use this display F24=More keys
Enter default values to reflect the preferences of your installation and press Enter. Key F12 to cancel the CHGRSFDFT command.
The parameters for the CHGRSFDFT command are described below. Click on a parameter in the figure to jump directly to its description.
The maximum number of times each remote AS/400 can access a given RSF package on your machine. This value may be overridden for individual packages. If a requester attempts to access a package more than the number of times allowed, an error message is sent and the request ends abnormally.
The possible values are:
*NOMAX: There is no system-wide limit to the number of times RSF packages can be accessed by each requester.
1-9999997: The system default for the number of times RSF packages can be accessed by each requester.
The qualified name of a user program to call before granting access to an RSF package. This value can be overridden for individual packages. If specified, this program is called upon receiving a request to download data for an RSF package, before an acknowledgment is sent to the requester. Depending upon how the program returns, access to the package is either granted or denied. See Pre-Processing Programs for more information.
The possible values are:
*NONE: No pre-processing program is called.
program name: The name of a system default pre-processing program to call
The possible library values are:
*LIBL: The job library list is used to locate the program.
*CURLIB: The current library is used to locate the program.
library name: The name of an existing library which contains the specified program.
The qualified name of a user program to call to determine whether information about RSF packages should be sent to the requester for a *CATALOG request. This value can be overridden for individual packages. If specified, this program is called for each RSF package on your machine upon receiving a request for a catalog. Depending upon how the program returns, catalog information about the package is either sent to the requester or not. See Catalog Pre-processing Programs for more information.
The possible values are:
*NONE: No catalog pre-processing program is called.
program name: The name of a system default catalog pre-processing program to call.
The possible library values are:
*LIBL: The job library list is used to locate the program.
*CURLIB: The current library is used to locate the program.
library name: The name of an existing library which contains the specified program.
The qualified name of a user program to call to process RSF packages sent to your machine by remote requesters with the SNDRSFPKG command. This value can be overridden for individual requesters. If specified, this program is called after all of the data associated with the RSF package has been received and only if the data is received successfully. This program can be used to restore objects to your machine from the save file sent for the RSF package. See Post-Processing Programs for more information.
The possible values are:
*NONE: No program is called when RSF data is received.
program name: The name of a system default program to call when an RSF package arrives on your machine, sent by remote requesters with the SNDRSFPKG command.
The possible library values are:
*LIBL: The job library list is used to locate the program.
*CURLIB: The current library is used to locate the program.
library name: The name of an existing library which contains the specified program.
The qualified name of a message queue to receive normal transaction messages. This value can be overridden for individual RSF packages. If specified, information and completion messages generated during a successful RSF request are sent to the message queue.
The possible values are:
*NONE: Information and completion messages generated from successful transactions are not sent.
Name: The name of a system default message queue to which information and completion messages generated from successful transactions are sent.
The possible library values are:
*LIBL: The job library list is used to locate the message queue.
*CURLIB: The current library is used to locate the message queue.
library name: The name of an existing library that contains the specified message queue.
The qualified name of a message queue to receive abnormal transaction messages. This value can be overridden for individual RSF packages. If specified, error messages generated during an unsuccessful RSF request are sent to the message queue.
The possible values are:
*NONE: Error messages generated from unsuccessful transactions are not sent. Error message ids will still appear in the RSF log.
Name: The name of a system default message queue to which error messages generated from unsuccessful transactions are sent.
The possible library values are:
*LIBL: The job library list is used to locate the message queue.
*CURLIB: The current library is used to locate the message queue.
library name: The name of an existing library that contains the specified message queue.
The qualified name of a message queue to receive ad hoc requester messages. This value can be overridden for individual RSF packages. If specified, ad hoc messages sent by requesters using the MSG parameter of one of the RSF commands that initiate a transaction are sent to the message queue.
The possible values are:
*NONE: Ad hoc requester messages are not sent. The messages are still logged in the RSF log and can be viewed with the WRKRSFLOG command.
Name: The name of a system default message queue to which ad hoc requester messages are sent.
The possible library values are:
*LIBL: The job library list is used to locate the message queue.
*CURLIB: The current library is used to locate the message queue.
library name: The name of an existing library that contains the specified message queue.
The maximum number of spooled file pages or cover letter records that requesters can send to your machine. This value may be overridden for individual requesters. If a requester attempts to send more spooled file pages than allowed, an error message is sent and the request ends abnormally.
The possible values are:
*NOMAX: There is no system-wide limit to the number of spooled file pages or cover letter records that requesters can send to your machine.
1-9999997: The system default for the maximum number of spooled file pages and cover letter records a requester can send to your machine, per request.
The maximum number of save file records that requesters can send to your machine. This value may be overridden for individual requesters. If a requester attempts to send more save file records than allowed, an error message is sent and the request ends abnormally.
The possible values are:
*NOMAX: There is no system-wide limit to the number of save file records requesters can send to your machine.
1-9999997: The system default for the maximum number of save file records a requester can send to your machine, per request.
A hex value used to verify the identity of your machine to other users of Remote Software Facility. Only machines that have the same value specified for Communications security id can exchange data using RSF. If a requester attempts to access a server, and their respective settings for Communications security id do not match, the request will end in error.
The possible values are:
*SAME: The current value is not changed.
*STD: This is the recommended value. Your machine is set to the standard communications security id value. This allows your machine to communicate with the greatest number of other machines. You must specify *STD for this parameter to communicate with Bug Busters' AS/400.
*REL1: This is the setting used by machines that have release 1 of Remote Software Facility installed. Specify *REL1 if you wish to use RSF to communicate with a machine which still has RSF release 1 installed.
Enter configuration information for up to eight SDLC requester lines. Each line must have a unique name and must be associated with a unique resource name. Key a plus + in the space labeled "+ for more values" and press Enter to specify additional requester configuration information. Key a less than sign < in this space and press Enter to delete configuration information for a line.
You can enter configuration for more than eight lines by directly editing file RSLF012A in library RSF with a file editor such as DFU.
When attempting to contact a remote server machine, RSF will select the first available line in the list of requester lines you specify.
The name to use when creating a line description for one of the RSF commands that initiates a transaction. RSF creates the line description before sending the request to the server, and deletes the line description at the completion of the transaction. If you specify the name of a pre-existing line description, it will be deleted by RSF.
The possible values are:
RSFRQS: The default name for the requester line description.
Name: The name of a line description to be created at the start of each RSF transaction.
The name of the physical hardware resource to which the line is attached. For Electronic Customer Support (ECS) this is usually CMN01. Use the WRKHDWRSC and WRKHDWPRD commands to determine the resource names on your machine.
The possible values are:
CMN01: The default resource name.
Name: The name of a physical hardware resource on your machine.
The type of physical interface on the input/output adapter of your machine.
The possible values are:
*RS232V24: RS232 physical interface, the default used by most machines.
V35: V.35 physical interface.
X21: X.21 physical interface.
X21BISV24: X.21 bis/V.24 physical interface.
X21BISV35: X.21 bis/V.35 physical interface.
*INTMODEM: An internal modem is used.
The line speed of your modem.
The possible values are:
2400: Specify 2400 if you have an IBM 5853 modem, or equivalent.
9600: Specify 9600 if you have an IBM 7855 modem, or equivalent. The 7855 will select the optimal communications speed for each connection, depending on the capability of the server modem.
other values: Specify the speed of your modem.
The type of modem you will be using to send RSF requests. Check the manual that came with your modem for more information.
The possible values are:
*V54: Use this value with IBM 5853 and 7855 modems. Certain modem diagnostics tests are run.
*NORMAL: No attempt is made to run diagnostic tests on your modem.
*IBMWRAP: For IBM modems with wrap test capabilities.
*IBMLPDA1: For IBM modems Link Problem Determination Aid 1 capabilities.
*IBMLPDA2: For IBM modems Link Problem Determination Aid 2 capabilities.
Indicate whether the modem is capable of V25BIS auto dialing.
The possible values are:
*YES: RSF will pass the phone number directly to the modem and the modem will automatically dial when connecting to remote machines.
*NO: Phone numbers will not automatically be dialed by RSF when using this line for a switched connection. When you initiate a switched connection that uses this line, a message will appear on message queue QSYSOPR indicating that you should manually dial the phone number to contact the other machine.
Indicate whether to communicate using half or full duplex
Not all modems are capable of full duplex communications. Do not specify full duplex unless you are sure that both the requester and server modems are set to full duplex.
The possible values are:
*HALF: Half duplex is used. This is the value you should use when communicating with Bug Busters via RSF.
*FULL: Full duplex is used. Both requester and server modems must be setup to handle full duplex.
The phone number associated with this line. This number is sent to the remote server when callback is requested and *RSFDFT is specified for "Call-back phone number" on one of the RSF commands that initiates a request.
The possible values are:
*NONE: No default callback phone number is associated with this line.
phone number: Enter up to 32 characters for the phone number. The number should include all digits necessary to dial your modem from a remote server, including a leading 1 plus area code where necessary.
The group name associated with the requester line. You can divide requester lines into groups to insure that requests to certain remote locations use a particular group of lines. Click here for more information about tying line groups to a server location.
The possible values are:
*NONE: No group name is associated with the line.
Name: The group name for the line.
The number of seconds RSF waits for the requester line to be varied on when sending a request to a server. If the line cannot be varied on in the time specified, the transaction ends in error.
The possible values are:
15: Wait 15 seconds for the requester line to be varied on before signaling an error.
16-180: Number of seconds to wait for the requester line to be varied on before signaling an error.
*NOWAIT: Do not wait for the line to be varied on. The line is varied on asynchronously.
The amount of time (in half-seconds) to wait before trying to redial a number due to a busy or failed connection when sending a request to a server.
The possible values are:
10: Recommended default.
0-254: Other possible values for redial delay.
The number of times to retry dialing a number due to a busy or failed connection when sending a request to a server.
The possible values are:
0: Default.
1-254: Other possible values for dial retry.
Enter configuration information for up to eight server lines. This information is used for inbound SDLC connections only. Each line must have a unique name and must be associated with a unique resource name. Key a plus (+) in the space labeled "+ for more values" and press Enter to specify additional server configuration information. Key a less than sign (<) in this space and press Enter to delete configuration information for a line.
You can enter configuration for more than eight lines by directly editing file RSLF013A in library RSF with a file editor such as DFU.
The name to use when creating a line description for the STRRSFSRV command. RSF creates the line description when you start the RSF server function, and deletes the line description when you end the server function (ENDRSFSRV). If you specify the name of a pre-existing line description, it will be deleted by RSF.
The possible values are:
RSFSRV: The default name for the server line description.
Name: The name of a line description to be created at the start of the server function (STRRSFSRV).
The name of the physical hardware resource to which the line is attached. For Electronic Customer Support (ECS) this is usually CMN01. Use the WRKHDWRSC and WRKHDWPRD commands to determine the resource names on your machine.
The possible values are:
CMN01: The default resource name.
Name: The name of a physical hardware resource on your machine.
The type of physical interface on the input/output adapter of your machine.
The possible values are:
*RS232V24: RS232 physical interface, the default used by most machines.
V35: V.35 physical interface.
X21: X.21 physical interface.
X21BISV24: X.21 bis/V.24 physical interface.
X21BISV35: X.21 bis/V.35 physical interface.
*INTMODEM: An internal modem is used.
The line speed of your modem.
The possible values are:
2400: Specify 2400 if you have an IBM 5853 modem, or equivalent.
9600: Specify 9600 if you have an IBM 7855 modem, or equivalent. The 7855 will select the optimal communications speed for each connection, depending on the capability of the requester modem.
other values: Specify the speed of your modem.
The type of modem you will be using to receive RSF orders from requesters. Check the manual that came with your modem for more information.
The possible values are:
*V54: Use this value with IBM 5853 and 7855 modems. Certain modem diagnostics tests are run.
*NORMAL: No attempt is made to run diagnostic tests on your modem.
*IBMWRAP: For IBM modems with wrap test capabilities.
*IBMLPDA1: For IBM modems Link Problem Determination Aid 1 capabilities.
*IBMLPDA2: For IBM modems Link Problem Determination Aid 2 capabilities.
Indicate whether the modem is capable of V25BIS auto dialing. For server lines, this parameter is only used when your machine is acting as the server, and your machine is requested to call another machine back.
The possible values are:
*YES: RSF will pass the phone number directly to the modem and the modem will automatically dial when calling back a remote machine.
*NO: The callback number will not automatically be dialed by RSF when using this line for callback. When a callback request is initiated using this line, a message will appear on message queue QSYSOPR indicating that you should manually dial the phone number to call the other machine back.
Indicate whether to communicate using half or full duplex
Not all modems are capable of full duplex communications. Do not specify full duplex unless you are sure that both the requester and server modems are set to full duplex.
The possible values are:
*HALF: Half duplex is used.
*FULL: Full duplex is used. Both requester and server modems must be setup to handle full duplex.
The number of seconds RSF waits for server lines to be varied on when starting the server function (STRRSFSRV). If the line cannot be varied on in the time specified, an error is signaled.
The possible values are:
30: Wait 30 seconds for the server line to be varied on before signaling an error.
16-180: Number of seconds to wait for the server line to be varied on before signaling an error.
*NOWAIT: Do not wait for the line to be varied on. The line is varied on asynchronously.
The number of seconds RSF should wait before hanging up an inactive server line. The timer starts each time RSF answers an incoming call from a remote requester machine. When the timer expires, RSF waits for any active transactions on the line to complete, and then disconnects the line and prepares to answer the next incoming call.
The possible values are:
*NOMAX: The server will not hang up the line. The connection remains active until the requester hangs up. The requester typically disconnects after each transaction. To keep a connection active after the completion of a transaction, HANGUP(*NO) must specified for the requester in the requester directory on the server machine, and HANGUP(*NO) must be specified by the requester on the RSF command that initiates the request. See Adding Requester Directory Entries for more information about requester directory entries. See chapter 6, Requester Operations for more information about commands that initiate a request.
0-65535: The number of seconds to wait before disconnecting an inactive server line.
PPP is the protocol used for dial-up TCP/IP connections. Enter configuration information for up to eight PPP requester lines. Each line must have a unique name and must be associated with a unique resource name. Key a plus + in the space labeled "+ for more values" and press Enter to specify additional server configuration information. Key a less than sign < in this space and press Enter to delete configuration information for a line.
You can enter configuration for more than eight lines by directly editing file RSLF018A in library RSF with a file editor such as DFU.
When attempting to contact a remote server machine, RSF will select the first available line in the list of requester lines you specify.
Enter the name to use when creating a line description for one of the RSF requester commands. RSF creates the line description before sending the request to the server, and deletes the line description at the completion of the transaction. If you specify the name of a pre-existing line description, it will be deleted by RSF.
The possible values are:
RSFRQP: The default name for the requester line description.
Name: Enter the name of a line description to be created at the start of each RSF transaction.
The name of the physical hardware resource to which the line is attached. For Electronic Customer Support (ECS) this is usually CMN01. Use the WRKHDWRSC and WRKHDWPRD commands to determine the resource names on your machine.
The possible values are:
CMN01: The default resource name.
Name: The name of a physical hardware resource on your machine.
Specify the type of physical interface on the Input/Output adapter of your machine. The interface must be valid for the resource name specified above.
The possible values are:
*INTMODEM: An internal modem is used.
*RS232V24: RS232 physical interface.
V35: V.35 physical interface.
X21: X.21 physical interface.
X21BISV24: X.21 bis/V.24 physical interface.
X21BISV35: X.21 bis/V.35 physical interface.
RS449V36: An RS449 physical interface is used.
Specify the type of modem that the line is attached to.
Note: The value specified here must exactly match a value listed in Work With Modem Information display. (Option 22 from the CFGTCP menu, and then select option 11.) Case is significant.
The possible values are:
2771 Internal Modem: The 2771 Internal Modem is used.
Modem-Type: Enter a valid modem type.
The phone number associated with this line. This number is sent to the remote server when callback is requested and *RSFDFT is specified for "Call-back phone number" on one of the RSF commands that initiates a request.
The possible values are:
*NONE: No default callback phone number is associated with this line.
phone number: Enter up to 32 characters for the phone number. The number should include all digits necessary to dial your modem from a remote server, including a leading 1 plus area code where necessary.
The group name associated with the requester line. You can divide requester lines into groups to insure that requests to certain remote locations use a particular group of lines. Click here for more information about tying line groups to a server location.
The possible values are:
*NONE: No group name is associated with the line.
Name: The group name for the line.
Enter the number of times to try dialing a number to establish a
connection.
The possible values are:
1-10: Specify a number greater than 1 if you want to try dialing again when the remote modem is busy or does not answer.
Enter the amount of time (in seconds) to wait before trying to redial a number due to a busy signal or no answer.
This parameter is ignored unless a value greater than 1 is specified for PPP Dial Attempts.
The possible values are:
15: Wait 15 seconds before trying a busy number again.
1-60: Enter the the number of seconds to wait before trying a busy number again.
PPP is the protocol used for dial-up TCP/IP connections. Enter configuration information for up to eight PPP server lines. Each line must have a unique name and must be associated with a unique resource name. Key a plus + in the space labeled "+ for more values" and press Enter to specify additional server configuration information. Key a less than sign < in this space and press Enter to delete configuration information for a line.
You can enter configuration for more than eight lines by directly editing file RSLF017A in library RSF with a file editor such as DFU.
Enter the name to use when creating a line description for the STRRSFSRV command. RSF creates the line description when you start the RSF server function, and deletes the line description when you end the server function (ENDRSFSRV).
The possible values are:
RSFSRP: The default name for the server line description.
Name: Enter the name of a line description to be created at the start of each RSF transaction.
The name of the physical hardware resource to which the line is attached. For Electronic Customer Support (ECS) this is usually CMN01. Use the WRKHDWRSC and WRKHDWPRD commands to determine the resource names on your machine.
Note: The resource name specified here can be the same as one of the resource names specified for PPP Requester Information. In that case, RSF intelligently shares the resource and modem between the requester and server functions.
The possible values are:
CMN01: The default resource name.
Name: The name of a physical hardware resource on your machine.
Specify the type of physical interface on the Input/Output adapter of your machine. The interface must be valid for the resource name specified above.
The possible values are:
*INTMODEM: An internal modem is used.
*RS232V24: RS232 physical interface.
V35: V.35 physical interface.
X21: X.21 physical interface.
X21BISV24: X.21 bis/V.24 physical interface.
X21BISV35: X.21 bis/V.35 physical interface.
RS449V36: An RS449 physical interface is used.
Specify the type of modem that the line is attached to.
Note: The value specified here must exactly match a value listed in Work With Modem Information display. (Option 22 from the CFGTCP menu, and then select option 11.) Case is significant.
The possible values are:
2771 Internal Modem: The 2771 Internal Modem is used.
Modem-Type: Enter a valid modem type.
Specify an IP address to use to identify this machine to remote PPP clients. The address must be specified in nnn.nnn.nnn.nnn format, where nnn is a number from 1 to 255.
It is good practice to begin this type of IP address with 10, indicating that it is part of a private network. (For example 10.222.223.224).
Note: When a central machine will be contacting many remotes via PPP, each remote must have a unique value for this parameter.
The possible values are:
*CALC: RSF calculates a pseudo-unique IP address based on the machine model and serial number. After pressing Enter, prompt the Change RSF Defaults command again to view the calculated IP address.
IP-address: Specify a valid IP address.
Specify a validation list to use to authenticate user ID and password information sent by PPP clients.
The validation list is stored in library QUSRSYS. If it does not already exist, the validation list is created the next time you start the RSF server function (RSF menu option 21.)
There are two ways to add user IDs and passwords to your validation
list:
1. Edit the validation list using Operations Navigator. Select Network/Point-to-Point/Connection Profiles. Right click on an existing answer profile or create a new answer profile. Select "Properties". Select the Authentication tab. Check "Require remote system identification", select your validation list from the drop down box and click "Open".
2. Use RSF commands ADDRSFVE and RMVRSFVE to and/remove validation list entries for your RSF PPP server configuration. Prompt either command and press F1 for more information.
The possible values are:
*NONE: No user ID or password is required to establish a connection. However, after connecting, the client must still supply a valid user ID and password to establish a telnet or ftp session.
name: Specify a validation list name.
Enter the qualified name of a data area containing the basic encryption key to use. The data area must be at least 128 bytes long.
This parameter is only used for TCP/IP connections where the client requests *BASIC encryption. The client specifies TCP/IP encryption options with the Add/Change Server directory Entry commands. See Adding Server Directory Entries for more information.
The first 128 bytes of the data area are used as the encryption key. Trailing blanks in the key are ignored. The key can be from 1 to 128 bytes long and may contain any valid hex or character data. Longer keys provided greater security.
The data area does not need to exist at the time this command is run but it must exist at the time of transmission.
The possible values are:
*NONE: No data area is used. A default key is supplied by RSF.
Data-area-name: The name of a data area to use.
The possible library values are:
*LIBL: The job library list is used to locate the data area.
Library-name: The name of the library containing the data area.
Specify whether to enable or disable RSF's Secure Sockets Layer (SSL) support. SSL is used to encrypt TCP/IP connections.
When SSL support is enabled, RSF modules that handle TCP/IP connections are linked to SSL run-time routines. This linkage will only be successful if the SSL run-time routines exist on your system. The SSL run-time routines are included with the Internet Connection Secure Server licensed program from IBM (US version: 5769NC1; International version: 5769NCE.) Therefore, RSF's SSL support can only be enabled if the ICSS licensed program is installed.
Note: If you enable RSF's SSL support, and later delete the ICSS licensed program, be sure to then disable RSF's SSL support. Otherwise you will not be able to connect via TCP/IP.
The possible values are:
*DISABLED: SSL encryption is not available.
*ENABLED: SSL encryption can be used over TCP/IP connections.
Specify whether to perform client as well as server authentication for TCP/IP connections encrypted using the Secure Sockets Layer (SSL) protocol.
This parameter is only used for TCP/IP connections where the client requests *SSL encryption. The client specifies TCP/IP encryption options with the Add/Change Server directory Entry commands. See Adding Server Directory Entries for more information.
Note: In order to use SSL encryption, The Internet Connection Secure Server licensed program must be installed on both the client and server machines. (US version: 5769NC1. International version: 5769NCE.) Contact your IBM sales representative for more information.
The possible values are:
*NO: Only server authentication is performed during the SSL handshake.
*YES: Client and server authentication are performed.
Specify the send buffer size to use when sending or retrieving objects over TCP/IP connections. Increasing the buffer size requires more memory during a transmission, but it can improve performance.
This value affects the requester job when sending data, and the server job when retrieving data.
The possible values are:
65536: The default value is used.
number: Enter a valid send buffer size, from 16384 to 8388608.
Specify the receive buffer size to use when sending or retrieving objects over TCP/IP connections. Increasing the buffer size requires more memory during a transmission, but it can improve performance.
This value affects the server job when sending data, and the requester job when retrieving data.
The possible values are:
65536: The default value is used.
number: Enter a valid send buffer size, from 16384 to 8388608.
Specify the number of records to transmit at once when sending or retrieving objects over TCP/IP connections.
Increasing the block size can improve performance. However, specifying too large a block size could degrade performance if it becomes difficult for TCP/IP to keep up. You must experiment to determine the best setting for your environment.
Setting this parameter on a given machine controls the block size to use when sending data from or retrieving data from that machine.
Note: A value of 1 is assumed for this parameter if the RSF release of the other machine is less than 7.2.1, or if a non-TCP/IP connection is used.
The possible values are:
1000: This is a reasonable starting point for block size. Experiment to determine the optimal value for your environment.
number: Enter a valid block size, from 1 to 5000.
Specify the number of minutes between keep-alive messages.
When sending data with RSF over a TCP/IP connection, the target machine sends keep-alive messages after the data has been received, until the data has been restored or processed. This ensures that the connection is not dropped for inactivity before the target can report the final status back to the source machine.
Be sure to set this value on the target machine in order to have the desired effect for a send operation.
This value only effects RSF jobs and does not effect other TCP/IP applications on your system.
Note: This parameter is ignored for machines running an earlier version of the operating system than V6R1. In such a case, use the Change TCP/IP Attributes (CHGTCPA) command on the target machine to set the keep-alive interval globally.
The possible values are:
10: A keep-alive signal is sent every ten minutes when the RSF transmission is otherwise idle for that long.
*DFT: The default keep-alive interval set by the Change TCP/IP Attributes (CHGTCPA) command is used.
number: Enter the number of minutes between keep-alive messages.
Specify whether an entry should be placed in the RSF log each time one of the RSF commands that initiates a request is executed on your machine.
The possible values are:
*NO: Local commands are not logged. Only requests received from remote machines are logged.
*YES: Local commands and requests received from remote machines are both logged.
Specify whether an entry should be placed in the RSF log each time RSF dials a remote server from your machine.
The possible values are:
*SAME: The current value is not changed.
*NO: Switched connections are not logged.
*YES: An entry is placed in the RSF log for each switched RSF connection initiated by your machine. The log entry shows the number called, the start date, start time and end time.
Enter the server ID that other machines would typically use to contact this machine. The server ID must still be defined in the server directories of other machines.
Certain RSF functions will pass this ID to remote machines so that those machines can contact this machine back at a later time.
At install time, RSF initially sets this value to the system name.
The possible values are:
*SAME: The current value is not changed.
name: Enter the ID that other systems should use to contact this one. This should match the value specified for server ID in the server directory of other machines, for the entry that points to this machine.
Enter the qualified name of a user-written program to call to start High Availability synchronization.
See the help text for the Start Synchronization (STRSYNCRSF) command for more information about the user-written program and about starting synchronization.
The possible single values are:
*NONE: No default synchronization start program is specified.
The possible program values are:
name: Enter a valid program name.
The possible library values are:
*LIBL: The library list is used to find the program.
*CURLIB: The program is found in the current library.
name: Enter the name of the library containing the program.
Enter the qualified name of a user-written program to call to work with active and submitted synchronization jobs. The specified program is called when F9 is pressed from the Work With Sync Attributes (WRKRSFSA) display.
The program should accept no parameters.
A model program, WRKSYNCJOB, is provided in library RSFTOOLS. The source can be
found in RSFTOOLS/QCLSRC. To modify the program, copy the source to another
library (such as RSFUSER) and make your changes to the copy.
The possible program values are:
WRKSYNCJOB: This is the default program provided in RSFTOOLS.
name: Enter a valid program name.
The possible library values are:
RSFTOOLS: The default program is located in library RSFTOOLS.
*LIBL: The library list is used to find the program.
*CURLIB: The program is found in the current library.
name: Enter the name of the library containing the program.
Enter the qualified name of a user-written program to call to perform a role swap from production to backup.
See the help text for the Role Swap to Backup (SWAPBKPRSF) command for more information about the user-written program and about role swapping. See also Role Swap section in High Availability chapter.
The possible single values are:
*NONE: No production-to-backup role swap program is specified.
The possible program values are:
name: Enter a valid program name.
The possible library values are:
*LIBL: The library list is used to find the program.
*CURLIB: The program is found in the current library.
name: Enter the name of the library containing the program.
Enter the qualified name of a user-written program to call to perform a role swap from backup to production.
See the help text for the Role Swap to Production (SWAPPRDRSF) command for more information about the user-written program and about role swapping. See also Role Swap section in High Availability chapter.
The possible single values are:
*NONE: No backup-to-production role swap program is specified.
The possible program values are:
name: Enter a valid program name.
The possible library values are:
*LIBL: The library list is used to find the program.
*CURLIB: The program is found in the current library.
name: Enter the name of the library containing the program.
Specify the replication role of this machine.
Note: This value is changed automatically during a role swap.
The possible values are:
*PROD: This machine is currently acting in the production (source) role.
*BACKUP: This machine is currently acting in the backup (target) role.
Specify the address of your outgoing mail server.
The possible values are:
address: Enter a valid mail server address. For example:
smtpauth.earthlink.net
Specify the port to use to connect to the outgoing mail server.
The possible values are:
*SMTP: The default SMTP port of 587 is used.
*SMTPSSL: Port 465 is used and an encrypted connection is required. Note that most SMTP servers prefer to handle both encrypted and non-encrypted connections using port 587 (*SMTP).
*SMTPOLD: The older SMTP port of 25 is used.
port: Enter a valid port number.
Specify the user ID to use when verification is required by the mail server.
The possible values are:
*NONE: No user ID or password are sent. However, depending on the mail server, a user ID and password may be required.
user-ID: Enter a character string of up to 128 characters. Case is significant.
Specify the password to use when verification is required by the mail server.
The possible values are:
password: Enter a character string of up to 128 characters. Case is significant.
Specify the default email address from which mail from this system is sent. This is the email address to which replies to your outgoing email will be directed.
Note: You can use the Change RSF User Options (CHGRSFUO) command to override this value for individual users.
The possible values are:
email-address: Enter the email address to which replies should be directed. For example:
fred.jones@your_company.com
Indicate whether to use SSL/TLS to encrypt the connection to your mail server.
Note:
- Some mail servers, such as smtp.gmail.com, require encryption; most mail servers do not.
- Because internet mail is relayed from one server to another as it makes its way from the source to the target, an encrypted connection to the initial mail server does not guarantee that the message will remain encrypted as it moves through the Internet.
- To use an encrypted connection, you must configure SSL on your iSeries for use with RSF mail. See Appendix G for details.
The possible values are:
*NO: Outgoing mail is not encrypted.
*YES: Outgoing mail is encrypted.
If you upgrade your iSeries after installing RSF, use the following procedure to ensure that RSF is installed correctly on the new machine.
If your upgrade replaces your AS/400 hardware
with a new AS/400, you will need to obtain a new RSF authorization code from Bug
Busters. If your RSF maintenance coverage is up to date, there is no
additional charge for this service.
To obtain a new authorization code, send an email, listing the upgrade
circumstances, the old AS/400 serial number and the new AS/400
serial number, to support@bugbusters.net.
(Use the DSPSYSVAL QSRLNBR command to determine the system serial number.)
If you are upgrading the operating system only, you do not need a new RSF authorization code. However, you should run the following command after upgrading to ensure that user profile RSFSRV continues to have authority to itself:
GRTOBJAUT OBJ(RSFSRV) OBJTYPE(*USRPRF) USER(RSFSRV) AUT(*ALL)
If you are migrating to a new machine and you have obtained a new authorization code from Bug Busters: