PGP_DECODE

This activity will PGP decode the contents of a specified file and write the decoded content to another file.

PGP (Pretty Good Privacy) is a widely-used standard for data encryption and decryption.  It may be used to securely encrypt a variety of data stores, but in the context of this activity and the PGP_ENCODE activity, it is used for encrypting and decrypting the contents of a file in the file system.  Once encrypted, of course, you may do all sorts of things with the encrypted file, including sending it via email, FTP or another transport mechanism.

You should use your organisation's standard procedures for creating, storing and managing the security keys used with PGP.  If you are new to PGP however, you can refer to the following heading for some information to get you started with PGP encryption and decryption:

• Quick Start – Getting Started with PGP

 

Note: Some users running LANSA Composer on IBM i servers have reported that they found it necessary that the LANSA Integrator JSM be executing on a JVM at Java 7 or above for this activity to execute successfully.

 

INPUT Parameters:

PGPSOURCE: Required

This parameter must specify the full path and file name of the file whose contents are to be PGP decoded.

PGPTARGET: Optional

This parameter specifies the full path and file name for the file to which the decoded file contents are to be written.  The default, if not specified, is the special value *AUTO.

If the special value *AUTO is used, the activity will use the path and file name specified in the PGPSOURCE parameter but replacing the file extension with an extension of '.decode'.  For example, if you specify /myfolder/myfile.dat in the PGPSOURCE parameter, then the activity will write the decoded contents to the file /myfolder/myfile.decode.

PGPPASSWORD: Required

This parameter must specify the password required to extract the private key from the secret key. The secret key is automatically selected using the recipient public keys within the encrypted message.

PGPREPLACE: Optional

This parameter specifies what the activity should do if the output file already exists.  The default value *NO will cause the activity to end in error if the output file already exists.  Alternatively you can specify *YES to cause the existing file to be replaced.

OUTPUT Parameters:

PGPDECODED:

Upon successful completion, this parameter will contain the actual path and file name of the output file containing the decoded contents of the file specified by the PGPSOURCE parameter.