ADRLIB merged into ADROUT during previous upgrade.
book
Article ID: 132363
calendar_today
Updated On:
Products
DatacomDATACOM - ADCISCOMMON SERVICES FOR Z/OS90S SERVICESDATABASE MANAGEMENT SOLUTIONS FOR DB2 FOR Z/OSCOMMON PRODUCT SERVICES COMPONENTCommon ServicesCA ECOMETER SERVER COMPONENT FOCEasytrieve Report Generator for Common ServicesINFOCAI MAINTENANCEIPCUNICENTER JCLCHECK COMMON COMPONENTMainframe VM Product ManagerCHORUS SOFTWARE MANAGERCA ON DEMAND PORTALCA Service Desk Manager - Unified Self ServicePAM CLIENT FOR LINUX ON MAINFRAMEMAINFRAME CONNECTOR FOR LINUX ON MAINFRAMEGRAPHICAL MANAGEMENT INTERFACEWEB ADMINISTRATOR FOR TOP SECRETXpertware
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?
Environment
z/os CA Datacom/DB IPC/IDEAL 15.1
Cause
Error during IPC upgrade.
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: @PSSDST@ 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 *** .