**** START OF SPECIFICATIONS ***************************************** 00010000 * * 00020000 **** MODULE NAME = APSGMAC3 * 00030000 * * 00040000 * COMP(APS) PROD(PSF) : RELEASE 3.3.0 * 00050000 * * 00060000 **** DESCRIPTIVE NAME = PSF FOR OS/390 & z/OS MESSAGES AND CODES * 00070000 * UPDATES * 00080000 * * 00090000 **** STATUS = VERSION 3, RELEASE 3, LEVEL 0 * 00100000 * * 00110000 **** FUNCTION = * 00120000 * * 00130000 * THIS MODULE CONTAINS ALL OF THE UPDATES TO THE PSF FOR * 00140000 * OS/390 & z/OS MESSAGES AND CODES SINCE THE LAST PUBLISHED * 00150000 * VERSION OF THE MANUAL. * 00160000 * * 00170000 * THE UPDATES ARE PUT IN THE SAME FORMAT AS THEY WERE BEING * 00180000 * PUT IN THE DOC ++HOLDS. * 00190000 * * 00200000 * EACH TIME A NEW APAR HAS UPDATES THE CHANGE ACTIVITY WILL * 00210000 * BE UPDATED AND A NEW SECTION WILL BE ADDED TO THE END OF * 00220000 * THIS MODULE PRECEDED BY A LINE THAT DENOTES THE APAR NUMBER. * 00230000 * * 00240000 * DO NOT GO PAST COLUMN 64 WITH YOUR DOC CHANGES. THE END OF * 00250000 * THE DASHED LINES WITH YOUR APAR NUMBER IN THE TEXT INDICATE * 00260000 * COLUMN 64. * 00270000 * * 00280000 **** RESTRICTIONS * 00290000 * * 00300000 * DO NOT EDIT OR UPDATE THIS FILE ON SAMPLIB AS THE * 00310000 * NEXT APAR THAT CHANGES THIS MODULE WILL DO A TOTAL REPLACE * 00320000 * OF IT THUS OVERLAYING YOUR CHANGES. IF YOU WISH TO MAKE * 00330000 * CHANGES TO THIS MODULE THEN DO IT IN YOUR OWN COPY OF THIS * 00340000 * MODULE. * 00350000 * * 00360000 * *** CHANGE ACTIVITY = * 00370000 * $B0=LAPS0009, HPRF330,020131,BDKURLD: Initial Version * 00380000 * $01=OW53285, HPRF330,020131,BDKURLD: Rollup d-apar * 00390000 * $02=OW53830, HPRF330,020403,BDKUMLC: No NPRO with DISCINTV * 00400000 * $03=OW54452, HPRF330,020430,BDKURLD: Add message for exit 07 * 00400000 * changing AFPSTATS parameter * 00410000 * $04=OW54627, HPRF330,020508,BDKURLD: Add ERRNO to APS6501I * 00400000 * $EY=OW52748, HPRF330,020516,BDKUEAS: Copy group level sheet * 00400000 * collection finishing * 00400000 * $05=OW54885, HPRF330,020523,BDKUEAS: MFCC AE - no changes * 00400000 * * 00410000 **** END OF SPECIFICATIONS ******************************************* 00420000 00430000 All of the following changes are for the PSF for 00440000 OS/390 & z/OS Messages and Codes (G544-5627-03). 00450000 00460000 -----------CHANGES FOR OW53285---------------------------------- 00470000 00480000 1. Add the following four new messages. 00490000 00500000 APS1500I A bin_type BIN NUMBER HAS NOT BEEN SPECIFIED FOR 00510000 INPUT BIN NUMBER bin_number IN INSTALLATION EXIT 7. 00520000 00530000 EXPLANATION: An Installation Exit 7 requested side and edge 00540000 sensitive paper handling for the input bin, but did not 00550000 specify a bin_type bin number. bin_type can be simplex or 00560000 duplex. 00570000 00580000 SYSTEM ACTION: PSF ignores the request for bin substitution for 00590000 input bin number bin_number, but performs all other bin 00600000 substitutions requested in this Installation Exit 7. 00610000 00620000 USER RESPONSE: If the printed output is not acceptable, 00630000 contact your system programmer. 00640000 00650000 SYSTEM PROGRAMMER RESPONSE: Correct the Installation 00660000 Exit 7 to specify both a simplex and a duplex bin for each 00670000 input bin that requires substitution. 00680000 00690000 OPERATOR RESPONSE: Inform your system programmer. 00700000 00710000 PROBLEM DETERMINATION: None. 00720000 00730000 00740000 00750000 APS1501I THE SIDE AND EDGE SENSITIVE PAPER HANDLING FUNCTION HAS BEEN00760000 DEACTIVATED BECAUSE NO BINS WERE SPECIFIED FOR SUBSTITUTION.00770000 00780000 EXPLANATION: An Installation Exit 7 requested side and edge 00790000 sensitive paper handling, but did not specify a bin 00800000 number that requires substitution. 00810000 00820000 SYSTEM ACTION: PSF ignores the request for side and edge 00830000 sensitive paper handling and does not perform bin 00840000 substitution. PSF then generates this informational message 00850000 and continues processing. 00860000 00870000 USER RESPONSE: If the printed output is not acceptable, 00880000 contact your system programmer. 00890000 00900000 SYSTEM PROGRAMMER RESPONSE: Correct the Installation Exit 00910000 7. Either turn off the XTP7SENS flag, which indicates that 00920000 bins are to be substituted for side and edge sensitivity 00930000 processing, or correctly specify bins that require 00940000 substitution. 00950000 00960000 OPERATOR RESPONSE: Inform your system programmer. 00970000 00980000 PROBLEM DETERMINATION: None. 00990000 01000000 01010000 01020000 APS2058I YOU HAVE REQUESTED PSF'S SIDE AND EDGE SENSITIVE PAPER 01030000 HANDLING BUT THE PRINTER OR INPUT BIN NUMBER bin_number, 01040000 WHICH WAS SPECIFIED FOR DUPLEX PRINTING, CANNOT HANDLE 01050000 DUPLEX. 01060000 01070000 EXPLANATION: Duplexing was requested but is not supported by 01080000 the printer or the input bin that was specified. The support 01090000 for duplex might not be installed on this printer or it might 01100000 be disabled. Since side and edge sensitive paper handling has 01110000 been specified, PSF does not try to do any bin substitution. 01120000 01130000 SYSTEM ACTION: PSF stops processing the current data set and 01140000 issues a message identifying the position of the error 01150000 in the input data stream. PSF issues additional messages that 01160000 identify the processing environment when the error was found. 01170000 It then releases the current data set back to JES and requests 01180000 that it be held by the system. 01190000 01200000 USER RESPONSE: If the printed output is not acceptable, 01210000 contact your system programmer. 01220000 01230000 SYSTEM PROGRAMMER RESPONSE: If the bin number specified in 01240000 Installation Exit 7 for printing duplex is correct, submit 01250000 this print request to a printer that can duplex from the 01260000 requested bin. 01270000 If the bin number specified in Installation Exit 7 for 01280000 printing duplex does not exist or is incorrect for the printer 01290000 you are using, change Installation Exit 7 to specify the 01300000 correct bin. 01310000 01320000 OPERATOR RESPONSE: If you are running under JES, use the JES 01330000 data set release commands to release the data set to a printer 01340000 that supports this function. To find a JES command to release 01350000 the data set for printing, refer to the JES publication for the 01360000 level of JES you are using. 01370000 01380000 PROBLEM DETERMINATION: None. 01390000 01400000 01410000 01420000 APS2059I YOU HAVE REQUESTED PSF'S SIDE AND EDGE SENSITIVE PAPER 01430000 HANDLING BUT INPUT BIN NUMBER bin_number, WHICH WAS 01440000 SPECIFIED FOR SIMPLEX OR DUPLEX PRINTING, CANNOT BE 01450000 FOUND OR IS DISABLED. 01460000 01470000 EXPLANATION: PSF was directed to use bin number bin_number 01480000 instead of the one specified in the form definition or JCL, but 01490000 PSF cannot find that bin on this printer or it is disabled. 01500000 Since side and edge sensitive paper handling has been specified, 01510000 PSF does not try to do any bin substitution. 01520000 01530000 SYSTEM ACTION: PSF stops processing the current data set and 01540000 issues a message identifying the position of the error 01550000 in the input data stream. PSF issues additional messages that 01560000 identify the processing environment when the error was found. 01570000 It then releases the current data set back to JES and requests 01580000 that it be held by the system. 01590000 01600000 USER RESPONSE: If the printed output is not acceptable, 01610000 contact your system programmer. 01620000 01630000 SYSTEM PROGRAMMER RESPONSE: If the bin number specified in 01640000 Installation Exit 7 for printing simplex or duplex is correct, 01650000 submit this print request to a printer that has this bin 01660000 enabled or enable this bin on the printer being used. 01670000 If the bin number specified in Installation Exit 7 for printing 01680000 simplex or duplex does not exist or is incorrect for the printer 01690000 you are using, change Installation Exit 7 to specify the correct 01700000 bin. 01710000 01720000 OPERATOR RESPONSE: If you are running under JES, use the JES 01730000 data set release commands to release the data set to a printer 01740000 that supports this function. To find a JES command to release 01750000 the data set for printing, refer to the JES commands publication 01760000 for the level of JES you are using. 01770000 01780000 PROBLEM DETERMINATION: None. 01790000 01800000 2. Change the text, Explanation, and User Response for APS283I to 01810000 read: 01820000 01830000 APS283I MEDIUM MAP medium map name IN A FORMDEF RESOURCE 01840000 REQUESTED N-UP n, BUT IT IS NOT SUPPORTED BY THIS 01850000 PRINTER. THE OUTPUT IS PRINTED N_UP m. 01860000 01870000 EXPLANATION: The Medium Modification Control (MMC) structured 01880000 field requested N_UP n, but the device does not support N_UP 01890000 printing or it does not support n pages on a sheet side. 01900000 01910000 USER RESPONSE: If the output is not acceptable, submit the print 01920000 request to a printer that supports N_UP printing with n pages per 01930000 sheet side. If you created the structured fields for the form 01940000 definition, correct the MMC structured field and resubmit the 01950000 print request. For more information about the structured field, 01960000 refer to Advanced Function Presentation: Programming Guide and 01970000 Line Data Reference and Mixed Object Document Content Architecture 01980000 Reference. If the MMC structured field has no errors, the error 01990000 might be a PSF logic error. If you used a program to create the 02000000 structured fields for the form definition, consult your system 02010000 programmer. 02020000 02030000 3. Remove message APS2043I. 02040000 02050000 02060000 -----------CHANGES FOR OW53830---------------------------------- 02070000 02080000 On page 267, msg APS929I, add the following section: 02090000 02100000 Operator Response: If this message is displayed frequently 02110000 for a TCP/IP-attached printer that is not shared by multiple 02120000 host systems, notify your system programmer. 02130000 02060000 -----------CHANGES FOR OW54452---------------------------------- 02070000 02080000 1. Add APS7004I. INSTALLATION EXIT 7 HAS CHANGED THE VALUE OF THE AFPSTATS OUTPUT STATEMENT PARAMETER TO (yes|no). Explanation: Exit 7 has changed the value of the AFPSTATS Output statement parameter. It has either changed it from yes to no or from no to yes. System Action: This message is placed in the message data set and PSF processing continues. User Response: If this change is not acceptable, consult your System Programmer. System Programmer Response: If you want exit 7 to control whether the AFP Statistics Report is written, no response is necessary. If not, remove or modify exit 7. Operator Response: No response is necessary. Problem Determination: Items 1,8. 00460000 -----------CHANGES FOR OW54627---------------------------------- 00470000 00480000 1. Add the following to ERRNO 61 under APS934I. It also could happen when the port number (PORTNO) at the host and printer do not match. 2. Add the following as one of the reasons for SOCKET CONNECT FAILED under APS934I. - The port number (PORTNO) at the host and printer do not match. 3. Add the following to ERRNO 61 under APS935I. It also could happen when the port number (PORTNO) at the host and printer do not match. 4. Add the following as one of the reasons for SOCKET CONNECT FAILED under APS935I. - The port number (PORTNO) at the host and printer do not match. 5. Change APS6501I to read as follows. APS6501I AN UNEXPECTED COMMUNICATION FAILURE OCCURRED. PRINTING WILL BE RESTARTED AT A PREVIOUS CHECKPOINT, AND PAGES MIGHT BE DUPLICATED. ERRNO = errno. 6. Change the EXPLANATION for APS6501I to read as follows. Explanation: PSF detected a communication failure with the printer; for example, the session was lost during page processing. Printing is restarted at the most recent checkpoint or the beginning of the dataset; therefore, some pages might be reprinted. PSF could issue this message when TCP/IP is recycled. This message appears on the operator console. ERRNO = errno indicates the TCP/IP error. To interpret the ERRNO, refer to OS/390 SecureWay Communications Server: IP and SNA Codes (SC31-8571) (TCP/IP 3.2) or PSF for OS/390 & z/OS: Security Guide (TCP/IP 3.4 and above). Common ERRNOs associated with this message are: 0 This indicates that the partner has closed its end of the socket connection. Determine why the remote partner has closed the connection. This may involve a microcode trace at the printer. 7. Add APS6510I. APS6510I AN UNEXPECTED COMMUNICATION FAILURE OCCURRED. PRINTING WILL BE RESTARTED AT A PREVIOUS CHECKPOINT, AND PAGES MIGHT BE DUPLICATED. Expalanation: PSF detected a communication failure with the printer; for example, the session was lost during page processing. Printing is restarted at the most recent checkpoint or the beginning of the dataset; therefore, some pages might be reprinted. This message appears on the operator console. System Action: The data set being printed at the time of the error is restarted from the most recent checkpoint before the interrupt. If no checkpoints have been reached, the data set is reprinted from the beginning. User Response: Examine your output for duplicate pages. System Programmer Response: No response is necessary. Operator Response: To determine an appropriate response, see the specific error conditions described in any accompanying console messages. Problem Determination: Items 1, 25, 26, 27. -----------CHANGES FOR OW52748---------------------------------- 02070000 02080000 1. Add APS083I. THE CHECKPOINT AREA FOR THE DATA SET THAT WAS TO RESTART FROM A CHECKPOINT DID NOT CONTAIN THE REQUIRED SHEET COLLECTION FINISHING INFORMATION AT THE COPY GROUP LEVEL. THE DATA SET WAS RESTARTED FROM THE BEGINNING. Explanation: The information for the sheet collection finishing at the copy group level, which is used in printing this data set, was too large to fit into the checkpoint record that PSF had previously written to JES. This can happen when too many finishing operations are nested inside a copy group, and the checkpoint record becomes too large to write to JES. PSF must then write the checkpoint record to JES without any of this finishing information. Because this data set needs the sheet collection finishing information at the copy group level in order to restart from a checkpoint, but the JES checkpoint record given back to PSF does not contain this information, PSF must restart this data set from the beginning. This lets the finishing information be rebuilt, and the data set prints correctly. System Action: PSF issues this message to the operator console and the message data set, and continues processing from the beginning of the data set. User Response: Examine your output for unfinished pages and duplicate pages. System Programmer Response: No response is necessary. Operator Response: If you know which page the printing should restart on, issue a forward space command. Problem Determination: None. 00460000