Kisco Systems
SafeNet/i : Support : PTF Installation Instructions

SafeNet/i PTF Installation Process for version 11.55 and up

IMPORTANT These instructions are for SafeNet/i version 11.55 and up only. Use these older instructions to install prior version PTFs

SafeNet/i supports distribution of program updates remotely via the Internet. When programs in SafeNet/i are updated or program fixes are required, Kisco Systems can send the updates directly to you via the Internet.

When requested, we will send an email to you with an attached file. This file, when loaded into a folder on your system, can be used to post program updates and changes to your copy of SafeNet/i.

Note: Please make sure to read the detailed text of the email that accompanies the PTF file(s) so you are aware of any special instructions that are specific to this PTF.

When you receive a PTF package from Kisco, you will be given an eight character PTF package name. To load and apply the PTF to your system, follow these steps. If you are installing multiple SafeNet/i PTFs at the same time, they MUST be installed in strict numerical sequence.

The user profile you sign on with to run the PTF must be enrolled in SafeNet/i as a Super Administrator (option 9 on the SN7 menu).

  1. If this is the first time you are installing a PTF from Kisco, create a folder on your system named "/kiscoptf". You can do this with the following command:

    MD DIR(kiscoptf)

  2. From a PC that is attached to your System i, move the PTF package file that you received from Kisco into this folder.

    From a Windows client you can simply use a copy function to accomplish this. A command similar to the following would work:

    copy c:\{PTF name}.ptf i:\kiscoptf

    where {PTF name} is the PTF package name assigned to the file.

    To use Access Client Solutions, double click ‘Integrated File Systems’ and find the "kiscoptf" folder. Open the folder, click on the "Actions" drop down menu and select "Upload". This will let you locate the PTF file and upload it to your system.

  3. After the PTF file has been copied to the KISCO folder, sign on to any terminal or terminal session as QSECOFR.

  4. Type the following command:

    GO PCSECLIB/INSTALL

  5. When the menu is displayed, select Option 6 – Process Kisco PTF Package. This will prompt the KISPTFX command on your terminal session. Enter the eight character name of the PTF package file (without the ".ptf" filename extension). Press ENTER and the PTFs will be loaded and applied to your copy of SafeNet/i.

During the PTF installation process, one or two printouts will be created. One of these is the PTF cover letter documentation and it will always be printed. The other is optional and, if printed, is a fresh update of the Additional Documentation Topics for all SafeNet/i changes. Kisco recommends that you read these documents before starting to use SafeNet/i again.


PTF Removal Instructions

All Kisco PTFs are loaded so that the prior version of any program object is saved. This allows for the effects of a PTF to be reversed at a later time should a defect be identified in the PTF. If you have installed multiple PTFs, you must not remove a PTF out of sequence. If the PTF to be removed is back level, all subsequent PTFs must also be removed, in inverse sequence.

To remove a PTF, please follow these instructions:

  1. Sign on to your system as a security officer

  2. Examine the original PTF install email message for special conditions. If the PTF required special installation conditions, you must repeat those now before removing the PTF.

  3. Restore the library objects that were in effect prior to the PTF installation by running the following command:

    RSTOBJ OBJ(*ALL) SAVLIB(PCSECLIB) DEV(*SAVF) SAVF(PCSECLIB/PTFnnnn) MBROPT(*ALL) ALWOBJDIF(*ALL)

    where nnnn is the number associated with the PTF. When this restore is done, the previous objects that the PTF replaced will be restored to your SafeNet/i library.

  4. Remove the PTF library named PCPTFnnnn from your system

  5. Rename the *FILE object named PTFnnnn in library PCSECLIB to PTFnnnnX.

  6. If you took any special actions at step 2 above, you can now resume normal processing.

Once this has been done, the PTF that you wanted to remove will be undone on your system.