Copy VPN Configuration File (CPYVPNCFGF)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Copy VPN Configuration File (CPYVPNCFGF) command is used to copy the VPN configuration from a stream file to the database (import), copy the VPN configuration from the database to a stream file (export), or validate the VPN configuration in a stream file.
Restrictions:
You must have input/output system configuration (*IOSYSCFG) special authority to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| OPTION | Option | *EXPORT, *IMPORT, *VALIDATE | Required, Positional 1 |
| STMF | Stream file | Path name | Required, Positional 2 |
| Top |
Option (OPTION)
Specifies whether the VPN configuration is to be imported, exported, or validated.
- *EXPORT
- The VPN configuration will be exported to the stream file.
- *IMPORT
- The VPN configuration will be imported from the stream file. The import will clear all of the VPN configurations, except for QVPN01IBM1 and QVPN01IBM2, currently on the system. It is recommended to save the current VPN connections before doing an import.
- *VALIDATE
- The VPN configuration in the stream file will be verified to be correct.
| Top |
Stream file (STMF)
Specifies the path name of the stream file from which the VPN configuration is imported, exported, or validated.
- path-name
- Specify the path name of the stream file. The path name must be 512 characters or less.
For more information on specifying path names, refer to "Object naming rules" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/.
Note: This parameter is Unicode-enabled. See "Unicode support in CL" in the CL topic collection in the Programming category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for additional information.
| Top |
Examples
Example 1: Import from a Stream File
CPYVPNCFGF OPTION(*IMPORT) STMF('/MyDir/vpncfg')
This command imports the VPN configuration from stream file /MyDir/vpncfg.
Example 2: Export to a Stream File
CPYVPNCFGF OPTION(*EXPORT) STMF('/MyDir/vpncfg')
This command exports the VPN configuration to stream file /MyDir/vpncfg.
Example 3: Validate the Configuration in a Stream File
CPYVPNCFGF OPTION(*VALIDATE) STMF('/MyDir/vpncfg')
This command validates the VPN configuration in stream file /MyDir/vpncfg.
| Top |
Error messages
*ESCAPE Messages
- TCP8651
- Import of VPN configuration failed.
- TCP8652
- Export of VPN configuration failed.
- TCP8654
- Validate of VPN configuration failed.
| Top |