ALERT: Some images may not load properly within the Knowledge Base Article. If you see a broken image, please right-click and select 'Open image in a new tab'. We apologize for this inconvenience.

ADRLIB merged into ADROUT during previous upgrade.

book

Article ID: 132363

calendar_today

Updated On:

Products

Datacom DATACOM - AD CIS COMMON SERVICES FOR Z/OS 90S SERVICES DATABASE MANAGEMENT SOLUTIONS FOR DB2 FOR Z/OS COMMON PRODUCT SERVICES COMPONENT Common Services Datacom/AD CA ecoMeter Server Component FOC EASYTRIEVE REPORT GENERATOR FOR COMMON SERVICES INFOCAI MAINTENANCE IPC UNICENTER JCLCHECK COMMON COMPONENT Mainframe VM Product Manager CHORUS SOFTWARE MANAGER CA On Demand Portal CA Service Desk Manager - Unified Self Service PAM CLIENT FOR LINUX ON MAINFRAME MAINFRAME CONNECTOR FOR LINUX ON MAINFRAME GRAPHICAL MANAGEMENT INTERFACE WEB ADMINISTRATOR FOR TOP SECRET Xpertware

Issue/Introduction

In staging my IPC upgrade, it was noticed, the ADRLIB was merged into ADROUT for this particular region. In all other regions, ADROUT only has the PSS* members.

It has been tried to backup the current (receives out of sequence errors), INIT a new ADROUT, and restore. The restore will only restore the none out of sequence errors.

It has been tried to copy just the PSS* members, but only two out of 9 could be copied (member not found), and yes, hex was also used for the name with the same results.

So, is having the ADRLIB members in ADROUT a big deal? It appears PSS is working just fine on the current system.

If it is a big deal, how do we extract just the PSS members and restore them to a new ADROUT?

Cause

Error during IPC upgrade.

Environment

z/os CA Datacom/DB IPC/IDEAL 15.1 

Resolution

It Is not a big deal because this is a test system but the invalid members are filling up the ADROUT file and will generate a problem sometime in the future, so better to fix it now.

Need to find a window when CICS regions are down as well as no Ideal batch jobs running:

-1 Delete the current ADROUT file.
-2 Allocate a new ADROUT file using same data set name.
-3 Format the new ADROUT via VLSUTIL ( FORMAT BLKSIZE=4000,NAMELEN=11)
-4 INITialize  the new ADROUT  via SCPSUTIL (INIT and LIBRARY)

See *.CAVQSAMP(VQNEW01) steps FMTOUT and SCPSUTL

Re-adjust the IPC setting you had previously via IPCV transaction (see below).

Additional Information

For information:
You may verify your IPC settings the following way:  From release 11.0 but still valid

=>                                                                              
=>                                                                              
=>                                                                              
------------------------------------------------------------------------------- 
IPC:      IPC Verification                                                 MENU 
                                                                                
 Enter desired option number===>          There are    8  options in this menu: 
                                                                                
 1. SET COMMAND SITE  - Set Session Control Facility "site" options             
 2. SET OUT SITE      - Set Print Sub-System "site" options                     
 3. EDIT JOBCARD      - Create a panel/member                                   
 4. DIS OUT DEST      - Display the Output destinations                         
 5. DEF OUT DEST      - Define Output destination                               
 6. DIS OUT STATUS    - Display Output status                                   
 7. DIS INTERR        - Display Internal Error (INTERR:)                        
 8. OFF               - End IPC Verification and Customization session          
=============================================================================== 
.                                                                               
3. If SCF is installed, enter the following command or select option (1) from   
the main menu:                                                                  
.                                                                               
> SET COMMAND SITE OPTIONS                                                      
.                                                                               
The Session Control Facility (SCF) options screen displays. At this time,       
you can change any of your site options by overtyping the displayed default     
value. For further information on these options, see the Implementation         
Guide.                                                                          
=============================================================================== 
=> set command site options                                                     
=>                                                                              
=>                                                                              
------------------------------------------------------------------------------- 
IPC:         SCF option block           SCF#OPTIONS                    FILL-IN  
.                                                                               
.                                                                               
.                       Set SCF   "site"   options                              
.                       --------------------------     
.                                                                              
Command "comment"   character:      :                                          
Command "delimiter" character:      ;                                          
Command "repeat"    character:      -                                          
Command "reshow"    character:      +                                          
Number of command lines:            3           (0-5)                          
Decimal symbol:                     .           (. ,)                          
Currency symbol:                    $                                          
Date format:                        A           (A, E, I)                      
Region separator:                   -           (N=none, G=grid, other=itself) 
Asynchronous messages:              U           (U=User, N=None)               
Command reshow?                     N           (Y/N)                          
UPPER CASE PANELS AND MESSAGES?     N           (Y/N)                          
.                                                                              
Translate to upper case in batch?   N           (Y/N)                          
Maximum number of regions :         4           (1-4)                          
Maximum number of PF keys :         24          (0-48)                         
Maximum number of PA keys :         2           (0-4)                          
Size of the working buffer:          4000       (4000 - 64000)                 
Log file name :                     ADRL                                       
Trace file name :                   ADRT                                       
Check duplicate user:               N           (Y/N)                          
===============================================================================
.                                                                              
4. If PSS is installed, enter the following command or select option (2) from  
the main menu:                                                                 
.                                                                              
> SET OUTPUT SITE OPTIONS                                                      
.                                                                              
The Print Sub-System (PSS) options screen displays. At this time, you can      
change any of your site options by overtyping the displayed default value.     
For further information on these options, see the Implementation Guide.        
===============================================================================
=> set output site options                                                     
=>                                                                             
=>                                                                             
------------------------------------------------------------------------------ 
IPC:         SET OUT OPT (PSS)          PSS#OPTIONS                    FILL-IN    
                                                                               
                                                                               
                         Set PSS   "site"   options                            
                         ---------------------------                           
                                                                               
                                                                               
Spool name:                          ADROUT                                    
Maximum number of lines:             64000      (1-64k)                        
Default retention period:            02         (1-99)                         
Default number of copies:            01         (1-99)                         
Default print status:                RELEASE    (Release/Hold/Keep)            
Default output width:                120        (1-240)                        
Default network printer width:       133        (0-240)                        
Post successful msg:                 Y          (y/n)                          
Name of the batch JCL proc:          PSSUTIL                                   
Default destination                                                            
        Type:    LIBRARY                        (LIBrary/NETwork/SYStem/MAIl)  
        Name:    ____________________________________________________________  
Date format:                         A          (A, E or I)                    
Directory name:                      $PSSDIR$                                  
Destination table name:              @[email protected]                                  
System name:                         PSS                                       
Prefix name:                         PSS#                                      
Suppress non-display characters      Y          (y/n)                          
Maximum retention period:            99         (1-99)                         
Maximum number of output members     0100       (10-9999)                      
Percent full occupancy warning:      80         (1-99)                         
Multiple CPU environment:            N          (y/n)                          
===============================================================================
.                                                                              
5. Enter the following command or select option (3) from the main menu:        
.                                                                              
> EDIT JOBCARD MASTER                                                          
.                                                                              
The master job statement for this region displays. This job statement is       
used for batch prints when the user does not have a customized job             
statement. If this is a new install, you can now change this job statement to  
fit your site specifications. If this is an upgrade, your master job 
statement was not replaced, so no editing is required.                         
===============================================================================
=> edit jobcard master                                                         
=>                                                                             
=>                                                                             
-------------------------------------------------------------------------------
IPC:         PSS Jobcard            JOB $$$.JOBCARD                        EDIT
                                                                               
Enter or update the following JOB card(s) to be used for all subsequent        
Print jobs:                                                                    
                                                                               
 The MASTER JOBCARD member must be exactly 5 lines.                            
 Do NOT modify in the install batch job.                                       
 After the $$$JOBCARD member has been added in batch                           
 it can be edited online to modify for site JCL                                
 requirements. Use valid comment characters on unused lines.                   
===============================================================================
.                                                                              
6. Enter the following command or select option (3) from the main menu:        
.                                                                              
> EDIT JOBCARD                                                                 
.                                                                              
Your user job statement displays. The user job statement is optional for       
each user and is used for submitting batch prints. As with the master          
jobcard, it is retained during an upgrade procedure, so no editing is          
required for upgrade procedures.                                               
===============================================================================
=> edit jobcard                                                                
=>                                                                             
=>                                                                             
-------------------------------------------------------------------------------
IPC:         PSS Jobcard            JOB uid.JOBCARD                        EDIT
                                                                               
Enter or update the following JOB card(s) to be used for all subsequent        
Print jobs:                                                                    
                                                                               
//myuserid JOB (125100000,3012),'ONLINE DQBATCH 4 uid', 
//myuserid JOB (125100000,3012),'ONLINE DQBATCH 4 uid',                        
//         CLASS=K,MSGCLASS=X,MSGLEVEL=(1,1),NOTIFY=myuserid                   
//CAL2UP   OUTPUT FORMDEF=P2G111,PAGEDEF=32D3,CHARS=(GT20),COPIES=01,          
//            JESDS=ALL,DEFAULT=Y                                              
//MY JCLLIB ORDER=datacom.CTSrrr.IPC11SPn.CUSPROC                              
===============================================================================
.                                                                              
7. Enter the following command or select option (5) from the main menu:        
.                                                                              
> DEFINE OUTPUT DESTINATION SYS xxxxxx                                         
.                                                                              
A system printer is defined where xxxxxx is the HASP/JES system printer        
identification. Repeat this step to define additional system printers.         
===============================================================================
=> define output destination sys uspl3545                                      
=>                                                                             
=>                                                                             
1-ICPSMSGS41I - DESTINATION successfully ADDED                                 
-------------------------------------------------------------------------------
IPC    DISPLAY OUTPUT         OUT DSPDESTS (00020)                      DISPLAY
                                                                               
+-----------------------------------------------------------------------------+
|                            D E S T I N A T I O N                            |
+---------------+--------+-----------+--------+---------+------+----+---------+
|   TYPE.NAME   |  DISP  | BLK/WIDTH | HEADER | TRAILER | LINES| FF | PERTASK |
+---------------+--------+-----------+--------+---------+------+----+---------+
   SYS.LOCAL      READY                                                        
   NET.P5C2       READY                  YES      YES            YES           
   NET.PX5A       READY                  YES      YES            YES           
   SYS.USPLN5C2   READY                                                        
   SYS.USDAPX5A   READY                                                        
===============================================================================
.                                                                              
8. Enter the following command or select option (5) from the main menu:        
.                                                                              
> DEFINE OUTPUT DESTINATION NET xxxx                                           
.                                                                              
If your site intends to use network printers, issue this command, where xxxx
is the TP monitor network printer identification. Repeat this step to define   
additional network printers.                                                   
===============================================================================
=> define output destination net pl45                                          
=>                                                                             
=>                                                                             
1-ICPSMSGS41I - DESTINATION successfully ADDED                                 
-------------------------------------------------------------------------------
IPC    DISPLAY OUTPUT         OUT DSPDESTS (00020)                      DISPLAY
                                                                               
+-----------------------------------------------------------------------------+
|                            D E S T I N A T I O N                            |
+---------------+--------+-----------+--------+---------+------+----+---------+
|   TYPE.NAME   |  DISP  | BLK/WIDTH | HEADER | TRAILER | LINES| FF | PERTASK |
+---------------+--------+-----------+--------+---------+------+----+---------+
   SYS.LOCAL      READY                                                        
   NET.P5C2       READY                  YES      YES            YES           
   NET.PX5A       READY                  YES      YES            YES           
   SYS.USPLN5C2   READY                                                        
   SYS.USDAPX5A   READY                                                        
===============================================================================
.                                                                              
9. Enter the following command or select option (4) from the main menu:        
.                                                                              
> DISPLAY OUTPUT DESTINATION                                                   
.                                                                              
Any printers currently defined to PSS are displayed. This information is not   
retained during an upgrade or after reinitializing the PSS spool (ADROUT).     
===============================================================================
=> display output destination                                                  
=>                                                                             
=>                                                                             
-------------------------------------------------------------------------------
IPC    DISPLAY OUTPUT         OUT DSPDESTS (00024)                      DISPLAY
                                                                               
+-----------------------------------------------------------------------------+
|                            D E S T I N A T I O N                            |    
+---------------+--------+-----------+--------+---------+------+----+---------+
|   TYPE.NAME   |  DISP  | BLK/WIDTH | HEADER | TRAILER | LINES| FF | PERTASK |
+---------------+--------+-----------+--------+---------+------+----+---------+
   SYS.LOCAL      READY                                                        
   NET.P5C2       READY                  YES      YES            YES           
   NET.PX5A       READY                  YES      YES            YES           
   SYS.USPL3545   READY                                                        
   NET.PL45       READY                  YES      YES            YES           
   SYS.USPLN5C2   READY                                                        
   SYS.USDAPX5A   READY                                                        
===============================================================================
.                                                                              
10. Enter the following command or press PF3 or PF15.                          
.                                                                              
> PRINT SCREEN                                                                 
.                                                                              
A hard-copy print image of the currently displayed menu is written to the      
PSS spool.                                                                     
===============================================================================
=> print screen                                                                
=>                                                                             
=>                                                                             
1-ICPSMSGS31I - Command successfully processed       OUTPUT NUMBER=     25     
-------------------------------------------------------------------------------
IPC    DISPLAY OUTPUT         OUT DSPDESTS (00024)                      DISPLAY
                                                                               
+-----------------------------------------------------------------------------+
|                            D E S T I N A T I O N                            |
+---------------+--------+-----------+--------+---------+------+----+---------+
|   TYPE.NAME   |  DISP  | BLK/WIDTH | HEADER | TRAILER | LINES| FF | PERTASK |
+---------------+--------+-----------+--------+---------+------+----+---------+
   SYS.LOCAL      READY                                                        
   NET.P5C2       READY                  YES      YES            YES           
   NET.PX5A       READY                  YES      YES            YES           
   SYS.USPL3545   READY                                                        
   NET.PL45       READY                  YES      YES            YES           
   SYS.USPLN5C2   READY 
   SYS.USDAPX5A   READY                                                         
=============================================================================== 
.                                                                               
11. Enter the following command or select option (6) from the main menu:        
.                                                                               
> DISPLAY OUTPUT STATUS                                                         
.                                                                               
The PSS output status screen displays and verifies that you have output on      
the spool. At this time, you should have a member displayed with the name       
PRSCREEN                                                                        
=============================================================================== 
=> display output status                                                        
=>                                                                              
=>                                                                              
------------------------------------------------------------------------------  
Actions: D=display, Z=delete, P=print, R=ready, L/K=Leave/Keep                  
A NUM   UID NAME     CP RT DISP  DATE_CRE TIME DESCRIPTION  NRECS DST DST_NAME  
= ===== === ======== == == ===== ======== ==== ============ ===== === ========  
_    25 MT9 PRSCREEN 01 02 READY 09/24/08 0956 DISPLAY OUTP    18 LIB           
=============================================================================== 
.                                                                               
12. Enter the following command:                                                
.                                                                               
> DISPLAY OUTPUT PRSCREEN                                                       
.                                                                               
The output member displays what you just printed.                               
=============================================================================== 
=> display output prscreen                                                      
=>                                                                              
=>                                                                              
                                                                                
--------------------------------------------------------------------------------
IPC    DISPLAY OUTPUT         OUT PRSCREEN (00025)                      DISPLAY 
                                                                                
================================ T O P =========================================
                                                                                
 => PRINT SCREEN   
 =>                                                                            
 =>                                                                            
 ------------------------------------------------------------------------------
 IPC    DISPLAY OUTPUT         OUT DSPDESTS (00024)                      DISPLA
 +-----------------------------------------------------------------------------
 |                            D E S T I N A T I O N                            
 +---------------+--------+-----------+--------+---------+------+----+---------
 |   TYPE.NAME   |  DISP  | BLK/WIDTH | HEADER | TRAILER | LINES| FF | PERTASK 
 +---------------+--------+-----------+--------+---------+------+----+---------
    SYS.LOCAL      READY                                                       
    NET.P5C2       READY                  YES      YES            YES          
    NET.PX5A       READY                  YES      YES            YES          
    SYS.USPL3545   READY                                                       
    NET.PL45       READY                  YES      YES            YES          
    SYS.USPLN5C2   READY                                                       
    SYS.USDAPX5A   READY                                                       
============================== B O T T O M ====================================
===============================================================================
.                                                                              
13. Enter the following command:                                               
.                                                                              
> KEEP OUT                                                                     
.                                                                              
This retains the output member currently displayed on the PSS spool.           
===============================================================================
=> keep output;display output status                                           
=>                                                                             
=>                                                                             
                                                                               
------------------------------------------------------------------------------ 
Actions: D=display, Z=delete, P=print, R=ready, L/K=Leave/Keep                 
A NUM   UID NAME     CP RT DISP  DATE_CRE TIME DESCRIPTION  NRECS DST DST_NAME 
= ===== === ======== == == ===== ======== ==== ============ ===== === ======== 
_    25 MT9 PRSCREEN 01 02 KEEP  09/24/08 0956 DISPLAY OUTP    18 LIB          
===============================================================================
.                                                                              
14. Enter the following command: 
.                                                                               
> PRINT OUTPUT PRSCREEN DEST SYS xxxxxx                                         
.                                                                               
The value of xxxxxx is one of the valid system printer identifiers. Be sure     
this job executes successfully since it verifies that both the internal         
reader and the PSSUTIL PROC are working properly.                               
=============================================================================== 
=> print output prscreen dest sys uspl3545                                      
=> display output status                                                        
=>                                                                              
1-ICPSMSGS31I - Command successfully processed       OUTPUT NUMBER= 0025        
------------------------------------------------------------------------------  
Actions: D=display, Z=delete, P=print, R=ready, L/K=Leave/Keep                  
A NUM   UID NAME     CP RT DISP  DATE_CRE TIME DESCRIPTION  NRECS DST DST_NAME  
= ===== === ======== == == ===== ======== ==== ============ ===== === ========  
_    25 MT9 PRSCREEN 01 02 KEEP  09/24/08 0956 DISPLAY OUTP    18 SYS USPL3545  
=============================================================================== 
.                                                                               
15. Enter the following command:                                                
.                                                                               
> PRINT OUTPUT PRSCREEN DEST NET xxxx                                           
.                                                                               
The value of xxxx is one of the valid network printer identifiers. Be sure      
the output prints successfully on your network printer.                         
=============================================================================== 
=> print output 25 dest net pl45                                                
=> display output status                                                        
=>                                                                              
1-ICPSMSGS31I - Command successfully processed       OUTPUT NUMBER= 0025        
------------------------------------------------------------------------------  
Actions: D=display, Z=delete, P=print, R=ready, L/K=Leave/Keep                  
A NUM   UID NAME     CP RT DISP  DATE_CRE TIME DESCRIPTION  NRECS DST DST_NAME  
= ===== === ======== == == ===== ======== ==== ============ ===== === ========  
_    25 MT9 PRSCREEN 01 02 KEEP  09/24/08 0956 DISPLAY OUTP    18 NET PL45      
=============================================================================== 
.                                                                               
16. Enter the following command: 
.                                                                               
> DELETE OUTPUT PRSCREEN                                                        
.                                                                               
The output member is deleted from the PSS spool.                                
=============================================================================== 
=> delete output prscreen                                                       
=> display output status                                                        
=>                                                                              
1-ICPSMSGS45W - No outputs found with your user id                              
------------------------------------------------------------------------------- 
IPC:      IPC Verification                                                 MENU 
                                                                                
 Enter desired option number===>          There are    8  options in this menu: 
                                                                                
 1. SET COMMAND SITE  - Set Session Control Facility "site" options             
 2. SET OUT SITE      - Set Print Sub-System "site" options                     
 3. EDIT JOBCARD      - Create a panel/member                                   
 4. DIS OUT DEST      - Display the Output destinations                         
 5. DEF OUT DEST      - Define Output destination                               
 6. DIS OUT STATUS    - Display Output status                                   
 7. DIS INTERR        - Display Internal Error (INTERR:)                        
 8. OFF               - End IPC Verification and Customization session          
=============================================================================== 
.                                                                               
17. Enter the following command to exit from CA-IPC r11 and return to CICS.     
.                                                                               
> OFF                                                                           
.                                                                               
=============================================================================== 
.                                                                             
.                       IIIIIIII   PPPPPPP     CCCCCC                         
.                      IIIIIIII   PPPPPPPP   CCCCCCCC                         
.                        II      PP    PP   CC                                
.                       II      PPPPPPPP   CC                                 
.                      II      PPPPPPP    CC                                  
.                     II      PP         CC                                   
.                 IIIIIIII   PP         CCCCCCCC                              
.                IIIIIIII   PP          CCCCCC      Verification              
.                                                                             
.                                                                             
.                           Release: 11.0                                     
.                                                                             
.                                                                             
.Time: hh:mm:ss                                                 Date: mm/dd/yy
.                                                                             
.      ***  IPC Verification and Customization has been signed off  ***       
.