**** START OF SPECIFICATIONS ***************************************** 00010000 * * 00020000 **** MODULE NAME = APSGDGN3 * 00030000 * * 00040000 **** COMP(APS) PROD(PSF) : RELEASE 3.3.0 * 00050000 * * 00060000 **** DESCRIPTIVE NAME = PSF FOR OS/390 & z/OS DIAGNOSIS UPDATES * 00070000 * * 00080000 **** STATUS = VERSION 3, RELEASE 3, LEVEL 0 * 00090000 * * 00100000 **** FUNCTION = * 00110000 * * 00120000 * THIS MODULE CONTAINS ALL OF THE UPDATES TO THE PSF FOR * 00130000 * OS/390 & z/OS DIAGNOSIS SINCE THE LAST PUBLISHED VERSION OF THE * 00140000 * MANUAL. * 00150000 * * 00160000 * THE UPDATES ARE PUT IN THE SAME FORMAT AS THEY WERE BEING * 00170000 * PUT IN THE DOC ++HOLDS. * 00180000 * * 00190000 * EACH TIME A NEW APAR HAS UPDATES THE CHANGE ACTIVITY WILL * 00200000 * BE UPDATED AND A NEW SECTION WILL BE ADDED TO THE END OF THIS * 00210000 * MODULE PRECEDED BY A LINE THAT DENOTES THE APAR NUMBER. * 00220000 * * 00230000 * DO NOT GO PAST COLUMN 64 WITH YOUR DOC CHANGES. THE END OF * 00240000 * THE DASHED LINES WITH YOUR APAR NUMBER IN THE TEXT INDICATE * 00250000 * COLUMN 64. * 00260000 * * 00270000 **** RESTRICTIONS * 00280000 * * 00290000 * DO NOT EDIT OR UPDATE THIS FILE ON SAMPLIB AS THE * 00300000 * NEXT APAR THAT CHANGES THIS MODULE WILL DO A TOTAL REPLACE * 00310000 * OF IT THUS OVERLAYING YOUR CHANGES. IF YOU WISH TO MAKE * 00320000 * CHANGES TO THIS MODULE THEN DO IT IN YOUR OWN COPY OF THIS * 00330000 * MODULE. * 00340000 * * 00350000 * *** CHANGE ACTIVITY = * 00360000 * $B0=LAPS0009, HPRF330,020131,BDKURLD: Initial version * 00370000 * $01=OW53285, HPRF330,020131,BDKURLD: Rollup d-apar * 00380000 * $02=OW54452, HPRF330,020430,BDKURLD: Add message for exit 07 * 00390000 * changing AFPSTATS parameter * 00400000 * $03=OW54627, HPRF330,020508,BDKURLD: Add ERRNO to APS6501I * 00410000 * $EY=OW52748, HPRF330,020521,BDKUEAS: Medium Level Finishing * 00420000 * $04=OW54885, HPRF330,020523,BDKUEAS: MFCC AE - no change * 00430000 * $05=OW56333, HPRF330,020716,BDKUMJU: Trace entry mappings * 00440000 * $06=OW56201, HPRF330,020924,BDKULD : IM1 to IOCA, add * 00450000 * message APS2062I * 00460000 * $07=OW56366, HPRF330,021011,BDKUPG: Doc change for the MODIFY * 00470000 * DISPLAY STATUS=TCPIP command * 00480000 * $08=OW54565, HPRF330,021106,BDKULMM: Finishing Fidelity support * 00470000 * $09=OW55002, HPRF330,021212,BDKULMM: UP3I support * 00470000 * * 00490000 **** END OF SPECIFICATIONS ******************************************* 00500000 00510000 All of the following changes are for the PSF for 00520000 OS/390 & z/OS Diagnosis (G544-5623-03). 00530000 00540000 -----------CHANGES FOR OW53285---------------------------------- 00550000 00560000 1. On pages 33 and 34 add the following to the end of 00570000 entries "INITIALIZING TCP/IP", "TERMINATING TCP/IP", "TCP/IP 00580000 INTERFACE CONNECTED", "PRINTER CONNECTED", "PRINTER IN SESSION", 00590000 "CLOSE", "GETHOSTBYNAME", "INITAPI", "IOCTL", "RECV", "SELECT 00600000 WRITE", "SEND", "SETSOCKOPT", "SHUTDOWN", "SOCKET", and "TERMAPI" 00610000 in Table 9 "TCP/IP Status, Sub-Status, and Pending Command 00620000 Descriptions". 00630000 00640000 See NOTE. 00650000 00660000 2. On page 34 add the following note after Table 9. 00670000 00680000 Note: If this problem is only occurring on one TCP/IP-attached 00690000 printer, then this problem is most likely a printer problem. If 00700000 this problem is occurring on all or multiple TCP/IP-attached 00710000 printers, then contact your TCP/IP Administrator because the 00720000 problem is most likely a problem with TCP/IP. 00730000 00740000 3. Add the following new messages to the Message-to-Module 00750000 cross-reference table: 00760000 00770000 APS1500I APSDDOC 00780000 APS1501I APSDDOC 00790000 APS2058I APRMSGEX 00800000 APS2059I APRMSGEX 00810000 00820000 4. Add the following new reason codes to the PSF Reason Codes 00830000 table: 00840000 00850000 X'08140277' Printer or input bin number specified APRMSGEX 00860000 for duplex cannot handle duplex 00870000 X'08140278' Input bin number cannot be found or is APRMSGEX 00880000 disabled 00890000 00900000 5. Remove the following reason code from the PSF Reason Codes 00910000 table: 00920000 00930000 X'08140363' An attribute XMD pointer value will APRMSGEX 00940000 casue an infinite loop. 00950000 00960000 6. Add the following text to page 104 before "Printer 00970000 Information from ..." 00980000 00990000 PSF Printer Information Report - 3.3.0 LEVEL 0000 01000000 01010000 7. Add the following on page 112 before the line beginning with 01020000 "HEADING Printer Information ..." 01030000 01040000 REPORTLVL PRTINFO 3.3.0 0000 PSF Printer Information Report 01050000 01060000 8. Add the following section to page 120 after the Heading section 01070000 but before the DateTime record section. 01080000 01090000 ================================================================== 01100000 The Report Level record contains the information relevant to 01110000 uniquely identify the report's format. 01120000 01130000 OFFSET OFFSET 01140000 DECIMAL HEX TYPE LENGTH DESCRIPTION 01150000 ======== ======== ========= ======== ========================== 01160000 0 (0) CHARACTER 10 Layout ID value: REPORTLVL 01170000 10 (A) CHARACTER 1 Column Separator 01180000 11 (B) CHARACTER 8 Report Identifier 01190000 19 (13) CHARACTER 1 Column Separator 01200000 20 (14) CHARACTER 8 PSF version, release, and 01210000 modification 01220000 28 (1C) CHARACTER 1 Column Separator 01230000 29 (1D) CHARACTER 4 Report Level Identifier 01240000 33 (21) CHARACTER 1 Column Separator 01250000 34 (22) CHARACTER 30 Report Description 01260000 01270000 9. Add the following text on page 132 after "APS6508I PRTINFO ..." 01280000 01290000 REPORTLVL PRTINFO 3.3.0 0000 PSF Printer Information Report 01300000 01310000 10. Remove the following message from the Message-to-Module 01320000 cross-reference table: 01330000 01340000 APS2043I APRMSGEX 01350000 01360000 -----------CHANGES FOR OW54452---------------------------------- 01370000 01380000 1. Add the following to Table 13: "Message-to-Module 01390000 Cross-Reference". 01400000 01410000 APS7004I APSUREXT 01420000 01430000 -----------CHANGES FOR OW54627---------------------------------- 01440000 01450000 1. Add the following to the "Message-to-Module Cross-Reference" 01460000 table. 01470000 01480000 APS6510I APSCSNA 01490000 01500000 -----------CHANGES FOR OW52748---------------------------------- 01510000 01520000 1. Add the following to Table 13: "Message-to-Module 01530000 Cross-Reference". 01540000 01550000 APS083I APSPPDVP 01560000 01570000 -----------CHANGES FOR OW56333---------------------------------- 01580000 01590000 On page 64 add a new section to Chapter 4 "Working With PSF Traces" 01600000 as follows. 01610000 01620000 Determining Trace Entry Layouts 01630000 01640000 The trace mapping structures for PSF internal and external traces 01650000 are defined in these control blocks: 01660000 01670000 APSGITM Internal trace mapping structure 01680000 APSGXTM External trace mapping structure 01690000 01700000 An IBM Support Center representative can determine the layouts (or 01710000 descriptions) of internal trace entries in APSGITM or external trace 01720000 entries in APSGXTM. The prologs of APSGITM and APSGXTM describe how 01730000 to find the trace entry layouts. 01740000 01750000 -----------CHANGES FOR OW56201------------------------------------ 01760000 01770000 Add the following new message to the 01780000 Message-to-Module Cross-Reference table: 01790000 01800000 APS2062I APRIPSEX 01810000 01820000 -----------CHANGES FOR OW56366---------------------------------- 01830000 1. Page 31, "Displaing TCP/IP Status" section. Change the 1st paragraph 01840000 to: 01850000 01860000 A system programmer or operator who needs to know the status of a 01870000 TCP/IP connection can do so without taking a PSF trace. By using the 01880000 display function in PSF, you can display the TCP/IP status on the 01890000 console and system log. The display function is specified with the PSF 01900000 operator interface. This interface can dynamically display information 01910000 on the console and system log. You can use the MVS MODIFY command to 01920000 display the printer information on the console and system log; however, 01930000 it can only be used in deferred-printing mode. 01940000 01950000 2. Page 32, add the following text and figure after Figure 18: 01960000 01970000 Figure xx shows a sample of the TCP/IP status output displayed on the 01980000 system log with the APS699I message when the MVS MODIFY command is 01990000 entered with the DISPLAY and STATUS=TCPIP parameters. 02000000 02010000 _______________________________________________________________________ 02020000 F WTRES600,DISPLAY,PRT619,STATUS=TCPIP 02030000 APS639I WTRES600 WTRES600 *** COMMAND (DISPLAY) 948 02040000 (CONT.) ACCEPTED. 02050000 APS699I TCP/IP DISPLAY STATUS 949 02060000 PENDING 02070000 PRINTER........... TCP/IP STATUS....................... COMMANDS..... 02080000 PRT619 READY TCP/IP IS ACTIVE 02090000 PRINTER ATTACHED 02100000 _______________________________________________________________________ 02110000 02120000 3. Page 32 and 33, change the last paragraph on page 32 to: 02130000 02140000 The TCP/IP status output displayed on the console and system log 02150000 consists of a primary TCP/IP status and might consist of one or two 02160000 sub-statuses and a pending command. Table 9 on page 33 describes the 02170000 primary TCP/IP statuses, sub-statuses, and pending commands that 02180000 might be displayed on the console and system log. 02190000 02200000 4. Page 34 and 35, change the last paragraph on page 34 to: 02210000 02220000 When the TCP/IP status is displayed on the console and system log, it 02230000 might be displayed in combination with a sub-status or a pending 02240000 command. Each sub-status might have another sub-status, pending 02250000 command, or both that is displayed with it. Table 10 shows the possible 02260000 combinations of TCP/IP statuses, sub-statuses, and pending commands 02270000 that can be displayed on the console and system log. 02280000 02290000 -----------CHANGES FOR OW54565---------------------------------- 1. Add the following reason codes to the PSF Reason Codes table: X'080B0500' Printer does not support group level APRBPGEX MFC structured fields. Data set is terminated. X'080B0600' Printer does not support sheet level APRBPGEX MFC structured fields. Data set is terminated. 2. Add the following to Table 13: "Message-to-Module Cross-Reference". APS2063I APRBPGEX APS2064I APRBPGEX APS2583I APSESNTB APS2584I APSERRM --------------------CHANGES FOR OW55002 ---------------------- 1. Add the following to the message-to-module cross-reference table: APS2065I APRBPGEX APS2066I APRBPGEX APS2067I APRBPGEX APS2068I APRBPGEX APS2069I APRBPGEX APS2587I APSEMSG APS2589I APSEATCD APS2592I APSEATCD APS2597I APSEATCD APS2599I APSESNTB APS2600I APSEMSG 2. Add the following to the PSF Reason Codes table in Appendix C: X'080B0700' The X'8E' triplet is unsupported APRBPGEX and finishing fidelity is set to Do Not Stop. X'080B0800' The X'8E' triplet is unsupported APRBPGEX and finishing fidelity is set to Stop. X'080B0900' The X'85' triplet is unsupported APRBPGEX and finishing fidelity is set to Do Not Stop. X'080B1000' The X'85' triplet is unsupported APRBPGEX and finishing fidelity is set to Stop. X'080B1100' A Finishing operation is not APRBPGEX supported and finishing fidelity is set to Stop. X'0C050000' The length of the message to be APSMMSG buffered exceeded the size of the corresponding buffer. The message was truncated. X'0C060000' CRTMSV processing failed because APSMMSG storage for a MSV could not be getmained. X'0C070000' A WRITEMSV request to the message APSMMSG data set wasn't performed because the message needed to be rerouted to the console and MSV messages can't be routed to the console.