DGASCONV – Secure Parameter File Conversion Utility

When upgrading from a release of IBM Connect:Direct prior to 5.2 and using Secure Plus, the Secure Parameter and Secure Access files must be converted to the new file format. The SPAdmin tool cannot open a secure parameter file created in a release prior to 5.2.

The DGASCONV utility performs the conversion by allocating a new secure parameter file and using the old secure parameter file as input. Due to the possibility of secure passwords with Strong Password Encryption (SPE) being enabled in the previous release, this utility also uses the DGADTQFX and IDCAMS to convert the TCQ/TCX, copy the NETMAP and copy the AUTH file.

Sample JCL, DGAJCONV, in the SDGAJCL data set should be tailored to your environment and executed to perform this conversion. Use the instructions within the DGAJCONV JCL to assist with this JCL tailoring.

The execution of DGAJCONV with produce a report in the output DD called REPORT. Use this report to determine the scope of the changes made by the utility and to make recommended manual updates to any action produced in the report.

You must also specify the new secure parameter file as SECURE.DSN within your initialization parameters. This utility produces a diagnostic trace to the DD called TRACEO, which is a comment in the sample JCL. If you do not want to execute the diagnostic trace, leave the DD as a comment.