After upgrade to IPC 15.1 PSS output destinations missing

Products

• Ideal
• IPC
• Datacom
• Datacom/AD
• Datacom/DB

Issue/Introduction

After upgrading to IPC 15.1, IPCV option 4 - DIS OUT DEST, only has the SYS.LOCAL output destination.

The rest of the printer output destinations are missing.

 

Environment

Release: 15.1
Component: IPC

Cause

The PSS Destination Table is a member in the ADROUT dataset. The 15.1 upgrade process creates a new ADROUT but does not copy the contents of the previous release ADROUT. Also the PSS and SCF options are reset to default values.

This is explained in z/OS New Install/Upgrade in the README for IPC 15.1: 

Sites that are upgrading may need to reset various options since the upgrade process will reset PSS and SCF options to default values. 
Use the PRINT SCREEN command to save the following displays:
 SET COMMAND SITE (SCF#OPTIONS)
 SET OUT SITE (PSS#OPTIONS) 

ADRPNL members SCF#OPTIONS and PSS#OPTIONS are restored to default values by the upgrade. 
Since there are release dependent changes in 15.1, the prior release members cannot be used in your 15.1 ADRPNL. 

The PSS Destination Table needs to be rebuilt after ADROUT is initialized. 
Ideal sites should maintain a MEMBER with the CREATE OUT DESTINATION commands to be executed after the upgrade.

Resolution

The internal structure of the PSS destination table did not change in 15.1. 
As an alternative to having a member with the DEFINE OUTPUT DESTINATION commands, you can just copy the destination table member from the previous version to the new 15.1 ADROUT . The default name of the destination table member is PSS@PSSDST@.

Perform the following steps:

1. Set the PSS options as they were in the previous release.
   In the previous IPC release CICS system use IPCV or IDEAL and enter the following command.
   
   SET OUT SITE
   
   
2. If you have already upgraded to IPC 15.1 and the previous IPC release CICS system is no longer available do the following:
   • Restore the previous release ADRPNL and ADROUT libraries from a backup
   • Run an IDEAL batch job using the previous release software to enter the above command. The ADRPNL DD statement in the JCL should point to the previous release ADRPNL library.
     
     
3. Look for the following options:
   

   Destination table name:             $PSSDST$
   System name:                        PSS
   Prefix name:                        PSS#

4. PSS is the default system name and PSS# the default prefix. If they are different, then the same values have to be set in the 15.1 system.
   In 15.1 use IPCV or IDEAL and  issue command:
   
   SET OUT SITE
   
   
5. To change system and prefix names overtype the values and press enter. For example to change to BBB:
   

   Destination table name:              $PSSDST$
   System name:                         BBB 
   Prefix name:                         BBB#        

6. Shut down the IPC 15.1 CICS system.
   
   
7. If you changed the prefix and system name in step 5, the ADROUT needs to be reinitialized by running the VLSUTIL FORMAT function and the SCPSUTIL INIT function. 
   

   //FORMAT  EXEC PGM=VLSUTIL
   //STEPLIB  DD DISP=SHR,DSN=hlq.ipc.CUSLIB
   //         DD DISP=SHR,DSN=hlq.CAVQLOAD
   //SYSPRINT DD SYSOUT=*
   //AUXPRINT DD SYSOUT=*
   //VLSFILE  DD DSN=hlq.ADROUT,DISP=OLD               
   //SYSIN    DD *                                           
   FORMAT BLKSIZE=4000,NAMELEN=11                            
   /*
   //INIT EXEC PGM=VLSUTIL
   //STEPLIB  DD DISP=SHR,DSN=hlq.ipc.CUSLIB
   //         DD DISP=SHR,DSN=hlq.CAVQLOAD
   //SYSPRINT DD SYSOUT=*
   //AUXPRINT DD SYSOUT=*
   //ADROUT   DD  DSN=hlq.ADROUT,DISP=SHR
   //ADRPNL   DD  DSN=hlq.ADRPNL,DISP=SHR           
   //SYSIN    DD *                                           
    INIT    
    LIBRARY                       
   /* 

8. Copy the destination table from the previous release ADROUT using VLSUTIL:
   

   //VLSCOPY  EXEC PGM=VLSUTIL
   //STEPLIB  DD DISP=SHR,DSN=hlq.ipc.CUSLIB
   //         DD DISP=SHR,DSN=hlq.CAVQLOAD
   //OLDOUT   DD  DSN=old.version,ADROUT,DISP=OLD
   //NEWOUT   DD  DSN=new.15.1.ADROUT,DISP=OLD
   //SYSPRINT DD SYSOUT=*
   //AUXPRINT DD SYSOUT=*
   //SYSIN DD  *
    DDNAMES VLSFILE=OLDOUT,VLSCOPY=NEWOUT
    COPY    PSS@PSSDST@
   /* 

   Note if the system name was changed in step 5 above then the destination table name would be BBB@PSSDST@. In this case the SYSIN would be:
   

   //SYSIN DD  *
   DDNAMES VLSFILE=OLDOUT,VLSCOPY=NEWOUT
   COPY    BBB@PSSDST@
   /* 

9. Start the IPC 15.1 CICS system.
   
   
10. In IPCV or IDEAL issue the command:
    
    DISPLAY OUTPUT DESTINATION
    
    You should now see all the destinations as in the previous release.

Additional Information

See the Datacom Tools documentation sections Set PSS Site and Session Options,  Configuring IPC