6 – Install Additional Program Temporary Fixes

Install all Program Temporary Fixes available in Mainframe Connector Downloads. Usually, most of the fixes are provided in an accumulated file, which includes multiple PTFs, in the Patches section. Some recent PTFs are provided as Quick Fixes below the Patches section.

  1. Download the PTF for your system and unzip the file on your computer to xxx.TRS.

  2. Allocate the target dataset on the Mainframe Connector using the sample JCL entry below (TRS file allocation job), or use the following allocation to ensure the correct size and allocation of the tersed dataset:

    Copy
    Organization . . . : PS
    Record format . . . : FB
    Record length . . . : 1024
    Block size . . . . : 6144
    1st extent tracks . . . . : 258
    Secondary tracks . . . . : 0

    TRS File Allocation Job

    Copy
    //USERID@1 JOB (SP),CTS,NOTIFY=&SYSUID,MSGCLASS=X
    //******************************************************************
    //*   THIS STEP PRE-ALLOCATES THE INSTALLATION TERSE FILE          *
    //******************************************************************
    //ALLOCAT EXEC PGM=IEFBR14,REGION=2048K
    //TRSFILE  DD  DSN=SP.ALLUNTIL.FSD0172.TRS,
    //             DISP=NEW,CATLG,DELETE),
    //             UNIT=,VOL=SER=,
    //             SPACE=(TRK,(260,0)),
    //             DCB=(LRECL=1024,BLKSIZE=6144,RECFM=FB,DSORG=PS)
    //*
  3. Transfer the unzipped xxx.TRS file to the Mainframe Connector using binary mode for the transfer (using either FTP or a transfer utility).

  4. Unterse the uploaded unzipped file on the Mainframe using the UNTRS JCL entry. Use the following example to help you.

    The example untersed file has the following attributes:

    Copy
    Organization . . . : PS
    Record format . . . : FB
    Record length . . . : 80
    Block size . . .    : 3120
    1st extent cylinders: 90
    Secondary cylinders : 0

    UNTRS the TRS file job:

    Copy
    //USERID@2 JOB (SP),CTS,NOTIFY=&SYSUID,MSGCLASS=X
    //******************************************************************    
    //*  THIS STEP UNTERSES THE INSTALLATION FILE
    //******************************************************************    
    //UNTERSE EXEC PGM=TRSMAIN,PARM=UNPACK
    //SYSPRINT DD SYSOUT=*
    //INFILE   DD DISP=SHR,DSN= SP.ALLUNTIL.FSD0172.TRS
    //OUTFILE  DD DISP=(NEW,CATLG),UNIT=SYSDA,
    //         DSN=SP.ALLUNTIL.FSD0172.UNTRS,
    //         DCB=(DSORG=PS,RECFM=FB),
    //         SPACE=(CYL,(90,0))
  5. Extend the SMPPTS library. The SMPPTS library should have 5,000 blocks as a primary allocation and 200 as a secondary:

    SPACE=(6160,(5000,200,90))

  6. RECEIVE – Perform SMP/E RECEIVE using the S6RCV member in the UPGRADE library from the Mainframe Connector installation:

    1. Update the S6RCV member in the UPGRADE library:

      1. Replace the file set in the SMPPTFIN DD card with the file created by the UNTRS job used earlier.

      2. Change the third line from //* JCLLIB to // JCLLIB. This changes it from a remark to an active JCL card.

      3. In the EXEC card, change the procedure name prefix to CTS, so the JCL EXEC statement should be as follows:

        //RCVACF EXEC CTSASMP

      4. Delete the second step (PURGE) from the JCL.

    2. Submit the job which must end with a condition code of 0 (COND CODE 0000).

  7. APPLY – Perform an APPLY to install the fixes included in the flat-file downloaded with the PTF:

    1. Edit the S7APPLY job from the UPGRADE library:

      1. Update the JOBCARD and add it to the end of REGION=256M:

        //XXXS7 JOB ,SA,CLASS=A,MSGCLASS=X,NOTIFY=&SYSUID,REGION=256M

      2. Change the 3rd line from //* JCLLIB to // JCLLIB. This changes it from a remark to an active JCL card.

      3. In the EXEC card for both steps, change the procedure name prefix to CTS, so the JCL EXEC statement should be as follows:

        //APPLYX EXEC CTSASMP

    2. Submit the S7APPLY job and verify its successful completion.

  8. Submit the member CHNGEPRS from the INSTALL library and verify it completes with a condition code of 0.

  9. Review the FSD0116 description to verify whether any more manual changes are required, such as setting ALLOW_ADMIN_WITHOUT_PSWD in RSSPARM to Y.