II02481: JES2INFO : FCB / UCS SETUP CRITERIA FCBLOAD UCSB FOLD

APAR status

• Closed as canceled.

Error description

• THIS INFORMATION APAR HAS BEEN CREATED TO ADDRESS KNOWN
  QUESTIONS AND CONCERNS REGARDING JES2'S CRITERIA IN USING
  FCBs and UCSs.  THIS APAR WILL ALSO ADDRESS MESSAGES
  THAT CUSTOMER'S OFTEN SEE WHEN EXPERIENCING PROBLEMS
  WITH PRINTERS, LOCAL or RJE.
  

Local fix

Problem summary

Problem conclusion

Temporary fix

Comments

• *********
  *  FCB  *
  *********
     CHANNEL ONE IN FCB POSITION ONE IS A JES2 REQUIREMENT.  THIS
  CRITERIA MUST BE MET FOR ALL FCBs (LOCAL or RJE)  USED BY JES2.
  THIS REQUIREMENT IS DOCUMENTED IN THE SPL: JES2 INIT AND TURNING
  MANUAL, UNDER "3211 INDEXING", AS WELL AS IN THE OS/VS2 SPL:
  SYSTEM DATA ADMINISTRATION, UNDER "3211 INDEXING FEATURE".  THIS
  REQUIREMENT PERTAINS TO ANY FCB USED BY ALL PRINTERS THAT JES2
  SUPPORTS, NOT JUST THE 3211.  FOLLOWING ARE POSSIBLE SYMPTOMS
  SEEN, WHEN NOT HAVING CHANNEL 1 IN POSITION 1:
  
  A.  OUTPUT STARTS TO PRINT AT OTHER THAN THE TOP OF A PAGE.
      ADDITIONALLY: INCORRECT PRINT ALIGNMENT CAN BE CAUSED BY
      THE SETTING OF THE $LINECT=  OR THE PRINTDEF LINECT=xx
      PARAMETERS.  THE LINECT VALUE IS USED TO INSERT A SKIP TO
      CHANNEL ONE, WHEN THE VALUE IS REACHED.  IT MAY BE
      DESIRABLE TO HAVE THIS VALUE SET TO ZERO SO NO SKIPPING
      IS DONE, EXCEPT FOR WHAT IS INCLUDED BY THE APPLICATION
      PROGRAM.  /*JOBPARM K=0 .
  
  B.  OUTPUT USING THE FIRST FCB LOADED MAY PRINT OKAY (BECAUSE
      PAPER HAS BEEN MANUALLY ALIGNED TO THE TOP OF PAGE), BUT
      IF A SECOND FCB IS LOADED AND NO MANUAL PAPER ALIGNMENT
      IS DONE, THE OUTPUT DOES NOT NECESSARILY START AT THE TOP
      OF THE PAGE.
  
  C.  THE FIRST PAGE OF A FORM MAY PRINT OKAY, BUT REMAINING
      PAGES MAY PRINT INCORRECTLY.
  ****************************************************************
  DEFAULT FCBs  (STD1, STD2) DO NOT HAVE CHANNEL ONE IN POSITION
  ONE.  THEY MUST BE MANUALLY ALTERED TO REFLECT THIS REQUIREMENT.
  THIS IS DOCUMENTED IN THE OS/VS2 SPL: DATA ADMINISTRATION MANUAL
  UNDER "3211 INDEXING FEATURE" AS WELL AS IN THE SPL: JES2 INIT
  AND TUNING GUIDE, UNDER "3211 INDEXING".
  ****************************************************************
  MAXIMUM LENGTH OF A 3211 STYLE FCB CANNOT EXCEED 255 LINES (FF).
  THE 3211 FORMAT FCBs ARE PREFIX WITH FCB2.
     4248 GENNED PRINTERS CAN USE FCB4 PREFIXED IMAGES.  FOR 4248
  GENNED PRINTERS, HASPPRPU WILL FIRST ISSUE AN FCB REQUEST WITH
  THE FCB4 PREFIX, IF REQUEST FAILS, HASPPRPU WILL REISSUE THE
  REQUEST WITH THE FCB2 PREFIX (EX: FCB46 then FCB26).
  (NOTE: THE XEROX 9700 IS A LASER PRINTER THAT IS GENNED
         TO MVS AS D/T3211, IN AS SUCH USES FCB2 PREFIX)
  ****************************************************************
  
  DEFAULT FCB DESCRIPTION:  FOR IMPACT PRINTERS, TO ALLOW AN FCB
  TO BECOME THE DEFAULT FCB, SET THE DEFAULT BIT IN THE FCB IMAGE
  PER THE MVS/DFP SYSTEM DATA ADMINISTRATION GUIDE SC26451502 ..
     WHEN A JOB DOES NOT REQUEST A SPECIFIC FCB, JES2 WILL USE
  THE FCB SPECIFIED ON PRT DEVFCB.  IF NO DEVFCB HAS BEEN SET,
  THEN JES2 WILL USE THE FCB ALREADY LOADED ON THE PRINTER IF
  THE FCB HAS THE DEFAULT BITS SET, OTHERWISE, JES2 WILL USE THE
  DEFAULT PRINTDEF PRTFCB= PARM.  IT IS RECOMMENDED THAT THIS
  PARAMETER BE SET TO A VALID DEFAULT FCB.  JES2 WILL CONSIDER
  PRINTDEF FCB=xxx   TO BE A DEFAULT/STD IMAGE.
  
  **********************************
  * FCBs / UCSs  IN SYS1.IMAGELIB: *
  **********************************
  THE UCSs  USED BY JES2 ARE INCLUDED IN SYS1.IMAGELIB AT SYSTEM
  GENERATION TIME.  THIS IS TRUE FOR ALL JES2 SUPPORTED PRINTERS,
  EXCEPT THE 4245, 6262 and 4248 FOR THESE PRINTERS, THE BANDS
  ARE CONTAINED IN AN IMAGE TABLE WHICH IN TURN GETS LOADED INTO
  SYS1.IMAGELIB.  SEE DATA MANAGEMENT INFORMATION APAR II02221
  FOR INFORMATION ON HOW TO ADD FCB'S AND UCS'S TO SYS1.IMAGELIB.
  
  MEMBER NAMES FOR UCS'S:
  UCS1 for 1403,  UCS2 for 3211,  UCS3 for 3203,  UCS5 for 4245,
  UCS6 for 4248 , 6262 and 3262 mod5
  
  OLD PRINTER CONFIGURATIONS:
  CU= 2821 DEV= 1403 TRAIN= 1416
  CU= 3203 DEV= 3203 TRAIN= 1416
  CU= 3811 DEV= 3211 TRAIN= 3216
  
  ADDITIONAL NOTE:  THE NAME OF THESE TABLES MUST REMAIN AS SHOWN
  ABOVE (WITH NO ADDITIONAL CHARACTERS) OR MSGIEC122D AND ALSO
  MSGHASP670 WILL SHOW UCS IMAGE NOT FOUND. THE MVS  SYSTEM DATA
  ADMINISTRATION MANUAL SAYS THAT ADDITIONAL CHARACTERS MAY BE
  ADDED AS LONG AS THE FIRST CHARACTERS MATCH THOSE ABOVE. THE
  NAME OF THE TABLE CANNOT HAVE THESE ADDITIONAL CHARACTERS. YOU
  MAY ALSO RUN INTO ABEND112 AND MSGHASP078 IN TRYING TO RECOVER.
  FOLLOW THE EXAMPLES IN THE DATA ADMINISTRATION MANUAL WHEN YOU
  ARE ADDING AN IMAGE TO THE TABLE.(IGGUCSIT ON P.168 OF THE
  GC264010 2   FOR THE 4245 MANUAL FOR EXAMPLE). AMK.
  
  NOTE:  ALL 6262 and 3262-5  MUST BE GENNED AS A 4248.  THIS IS
  DOCUMENTED IN THE MVS/370 DFP INSTALLATION MANUAL, UNDER
  "CONSIDERATIONS FOR AVAILABLE PRINTER BANDS".
  IEBIMAGE IS USED TO BUILD THE 3800 CONTROL MODULES (FCB, CHAR
  ARRANGEMENT TABLE) AS WELL AS THE 4248 6262 and 3262 mod5.
  IGGUCSIT IS USED TO BUILD 4245, 4248, 3262-5 CONTROL MODULES,
  PLACE THEM IN THE IMAGE TABLE WHICH IS LOADED INTO SYS1.IMAGELIB
  ASSEMBLY AND LINKEDIT IS DONE TO PLACE THE CONTROL MODULES FOR
  THE 1403, 3211, AND 3203 PRINTERS INTO SYS1.IMAGELIB.
  
  NOTE:  ALL D/T3800 PRINTER FCB'S and UCS'S ARE CONSIDERED
       'STD', AND WILL DISPLAY AS SUCH IN MSGHASP628.  SETTING
       THE FCB/UCS WITH THE $T COMMAND WILL CAUSE THE NEW
       FCB/UCS TO BE THE DEFAULT (PER COMMAND MANUAL).
  
  NOTE:  TO MAKE THIS ABIT CLEARER;  WHATEVER FCB/UCS
       IS CURRENTLY IN THE D/T3800 IS CONSIDERED TO BE THE
       STANDARD, THUS THE $DU WILL ALWAYS REFLECT A FCB/UCS
       OF STD (AGAIN, WITH THE D/T3800 YOU DO NOT HAVE AN
       OPTION OF STANDARD OR NONSTANDARD.  IT IS ALWAYS
       STANDARD.).
  
  ****************************************************************
  * MORE INFO REGARDING D/T3800 CRITERIA:                        *
  ****************************************************************
     AS STATED EARLIER, WHEN A $T TO CHANGE THE UCS OR FCB ON THE
  D/T3800, IT IS NOW THE ACTUAL DEFAULT (UNLIKE IMPACT PRINTERS).
  IF A CUSTOMER ENTERS A $T TO CHANGE BOTH THE CLASS AND FCB OF
  THIS PRINTER, "ALL" WORK OF THE NEW CLASS WILL BE PRINTED
  WHETHER IT MATCHES THE FCB OR NOT.  THE FCB IS VIRTUALLY
  IGNORED.  IF THE CUSTOMER WISHES TO PRINT A PARTICULAR CLASS OF
  WORK THAT CONTAINS A SPECIFIC FCB, THEN HE WILL NEED TO SET
  ASIDE A SPECIAL CLASS WHICH ONLY PRINTS THE SPECIFIC FCB.
  THIS IS TRUE ONLY FOR FOR D/T3800'S, NOT IMPACT PRINTERS!!!!
  
  ADDITIONAL NOTE: PRINTDEF UCS=0 PREVENTS ANY UCS LOAD TO A
  PRINTER.  THIS ALSO PREVENTS THE BLOCK DATA CHECK COMMAND
  FROM BEING ISSUED TO THE PRINTER BY JES2.  MSGIOS000I
  DATA CHECK SENSE 08 WILL OCCUR ON UNPRINTABLE CHARACTERS.
  UCS=0 WILL ALSO PREVENT JES2 FROM ISSUING SETPRT FOR BAND
  LOAD ON BAND PRINTERS LIKE D/T4245 D/T4248 D/T6262 .
  IF THE BLOCK DATA CHECK HASN'T BEEN ISSUED.  IT IS
  RECOMMENDED THAT A VALID UCS BE SPECIFIED ON THE PRTnn OR
  PRINTERnn STATEMENT REQUIRING A UCS LOAD.  THIS MAY BE
  ACCOMPLISHED BY EITHER A SETPRT OR BLDL/LOAD OPERATION.
  DEVICE SETUP IN HASPPRPU WILL THEN PERFORM THE BLOCK DATA
  CHECK CCW.  RLT STJ2.
  
  $TPRTn T=0 WILL RESULT IN THE FOLLOWING SEQUENCE OF EVENTS:
  1)  THE DCT FIELD WILL BE CHANGED TO AN ID OF X'F0' (DCTUCS)
  2)  JES2 INVOLKES BLDL PROCESSING WHICH TRIES TO FIND A UCS
      OF 0 IN SYS1.IMAGELIB.
  3)  UCS 0 IS NOT IN IMAGELIB, SO JES2 ISSUES MSGHASP670
      UCS NOT FOUND.
  4)  OPERATOR IS REQUIRED TO ENTER A VALID UCS.  IF THE
      OPERATOR DOES NOT ENTER A VALID UCS, THE DCT UCS ID
      REMAINS 0, AND ALL SUBSEQUENT UCS LOADS ARE BYPASSED.
  
  THIS IS NORMAL JES2 PROCESSING, THEREFORE IT IS RECOMMENDED
  THAT COMMAND  $TPTRx,T=0  NOT BE USED.
     In ESA, operation related to UCS has been modified.  See
  APARS OY41580 and OY56563 for changes.
     When $TPRTn,T=0 is specified, MSGHASP150 and MSGIEC168I
  CHARACTER ARRANGEMENT TABLE 0 NOT IN LIBRARY is issued.
  The $DU,PRTn will show CHAR(N)=0 in the MSGHASP603
  DISPLAY RESPONSE.
     $TPRTn,CHAR(n)=NAME needs to be issued to change the
  proper UCS NAME.  This command should be issued only
  if the above mentioned message is received.
  
  *****************************
  * UPPER LOWERCASE FOLDING : *
  *****************************
     FOLD IS THE TERM USED TO INDICATE WHETHER YOU WISH TO CONVERT
  LOWER TO UPPER CASE.  IF YOU DESIRE FOLD, YOU MUST ALTER THE
  FIRST BYTE OF THE UCS.  JES2 DOES NOT SUPPORT FOLD USING THE
  'FOLD' KEYWORD ON THE UCS PARAMETER OF THE DD STATMENT!!!!!!
  
  X'80' INDICATES A DEFAULT IMAGE
  X'40' INDICATES THE OUTPUT IS TO BE FOLDED
  X'C0' INDICATES DEFAULT IMAGE AND FOLDING
  X'00' INDICATES IMAGE IS NOT A DEFAULT
  
  THERE ARE TWO TYPE OF PRINT TRAINS: AN UPPERCASE ONLY TRAIN,
  AND AN UPPERCASE/LOWERCASE TRAIN.
  THERE ARE THREE IMPORTANT ELEMENTS THAT DETERMINE WHAT TYPE
  OF PRINT DATA YOU ARE GOING TO SEE.  THEY ARE:
  
  1.  THE TYPE OF TRAIN YOU USE
  2.  WHAT IS SPECIFIED IN THE FIRST BYTE OF THE UCS
  3.  IF YOU ARE SENDING UPPERCASE AND LOWERCASE DATA TO YOUR
      PRINTER.
  
  THE FOLLOWING ARE RESULTS THAT YOU WILL SEE BASED ON THE
  ABOVE THREE ELEMENTS:
  1.  IF YOU HAVE AN "UPPERCASE ONLY" TRAIN, WITH THE FOLD
      BYTE "ON", AND YOU ARE SENDING "UPPERCASE AND LOWERCASE
      CHARACTERS", YOUR CHARACTERS WILL ALL PRINT IN UPPERCASE.
  2.  IF YOU HAVE AN "UPPERCASE ONLY" TRAIN, WITH THE FOLD
      BYTE "OFF", AND YOU ARE SENDING "UPPERCASE AND LOWERCASE
      CHARACTERS", YOUR UPPERCASE CHARACTERS WILL PRINT IN
      UPPERCASE, BUT YOUR LOWERCASE CHARACTERS WILL PRINT AS
      BLANKS!!
  3.  IF YOU HAVE AN "UPPERCASE/LOWERCASE" TRAIN, WITH THE FOLD
      BYTE "ON", AND YOU ARE SENDING "UPPERCASE AND LOWERCASE
      CHARACTERS", YOUR CHARACTERS WILL BE IN UPPERCASE AND
      LOWERCASE, UNLESS THE BAND DOES NOT HAVE THE LOWERCASE
      CHARACTER.  THOSE CHARACTERS WILL BE CONVERTED TO
      UPPERCASE.
  4.  IF YOU HAVE AN "UPPERCASE/LOWERCASE" TRAIN, WITH THE FOLD
      BYTE "OFF', AND YOU ARE SENDING "UPPERCASE AND LOWERCASE
      CHARACTERS", YOUR DATA WILL PRINT IN UPPERCASE AND
      LOWERCASE.
  
  NOTE: For 4245 4248 6262 band printers, to accomplish the
        FOLD operation, reply 'FOLD' to the MSGIEC120A
        SETPRT request.
  
  *****ADDITIONAL INFORMATION ON PRINTER FOLDING*****
     REMOTELY ATTACHED D/T4245-D20, D/T4245-20, D/T4245 DAS
  PRINTERS WILL PRINT UPPERCASE ONLY WITH AN UPPERCASE ONLY
  TRAIN, EVEN WHEN LOWERCASE DATA IS SENT TO THE PRINTER.
  AN UPPERCASE/LOWERCASE TRAIN WILL PRINT BOTH UPPER AND LOWER
  CASE BASED ON THE MODE SETTING AT THE DEVICE (MONO/DUAL).
  THESE PRINTERS ARE REFERRED TO AS BEING IN DCA MODE.
  ADDITIONAL KEYWORDS: JES328X JSX RJE
  
  *************
  * MESSAGES: *
  *************
  MSGHASP626  THIS MESSAGE MAY BE THE RESULT OF THE DEVICE NOT
              BEING AVAILABLE AT JES2 STARTUP.  IE. DEVICE HAD
              A HARDWARE FAILURE AND WAS OFFLINE, AND UNIT=
              WAS ALLOWED TO DEFAULT.  THIS MESSAGE MAY BE
              PREVENTED BY SPECIFYING A UNIT=NNN ON THE PRTNNNN
              PARAMETER STATEMENT.  IF HARDWARE IS SUSPECTED
              AND NO UNIT= WAS SPECIFIED, ADD THE UNIT=NNN FOR
              THE PRINTER UCB ADDRESS TO THE PRINTER INIT
              STATEMENT AND RESTART JES2.  ALSO SEE DOC APAR
              OZ67963.  RLT STJ2.
  
  MSGHASP628  THE JOBNAME OF THE 'LAST' JOB PRINTED ON THE
              D/T3800 WILL CONTINUE TO BE DISPLAYED UNTIL
              A NPRO IS DONE.  THIS IS BECAUSE THE JOB MUST
              REACH THE STACKER BEFORE THE 'JOBNAME' IN THE
              MESSAGE WILL CLEAR.
  
  MSGHASP628  ADDITIONAL INFORMATION ON THE JOBNAME FIELD
              AS DISPLAYED IN THE HASP628 MESSAGE.  THIS
              FIELD CAN BE SET WITH THE PRINTERN JOBNAME=
              AND THEN THE 'JOB' KEYWORD USED IN THE WORK
              SELECTION.  IF IT IS ALLOWED TO DEFAULT, THEN
              MODULE HASPJOS WILL PLACE THE NAME OF THE
              JOB BEING SELECTED FOR PRINTING INTO DCTJOBNM
              AND MODULE HASPSERV PLACES THIS NAME INTO THE
              MESSAGE TEXT FOR MSGHASP628.  THE DEFAULT FOR
              JOBNAME IS 'NULL' BUT WILL BE CHANGED FOR
              EVERY NEW SYSOUT SELECTED FOR THE PRINTER.
  
  MSGHASP670 IS ISSUED WHEN A FCB/UCS CANNOT BE FOUND IN
             SYS1.IMAGELIB.  THIS IS FREQUENTLY DUE TO THE UCS/FCB
             NOT DEFINED PROPERLY (MEMBER NAME/ALIAS) IN
             SYS1.IMAGELIB, OR NOT IN THE IMAGE TABLE (4245, 4248)
  
  MSGHASP157 IS A MESSAGE ISSUED FROM JES2 WHEN WE RECEIVE A
             BAD RETURN CODE FROM SETPRT.  THE RETURN CODE THAT
             IS ISSUED WITH THIS MESSAGE SHOULD BE ANALYZED
             FURTHER USING THE MVS/370 DATA MANAGEMENT MACRO
             INSTRUCTIONS MANUAL, UNDER "SETPRT RETURN CODES".
  
  MSGHASP191 IS AN INFORMATION MESSAGE THAT JES2 ISSUES WHEN
             AN ERROR IN I/O HAS OCCURED.  THE I/O ERROR
             MESSAGE PRECEEDING THE MSGHASP191 SHOULD BE
             ANALYZED TO DETERMINE THE CAUSE OF THE PROBLEM
             (I.E. MSGIEA000I, MSGIOS000I DCK ).
  
  MSGIEC120A AND MSGIEC121D IS ISSUED VIA SETPRT.  BEING JES2
             INVOKES SETPRT, THIS MESSAGE WILL BE ENCOUNTERED
             WHEN USING JES2 CONTROLLED LOCAL BAND PRINTERS
             LIKE 4245 4248 and 6262 (MVS GENNED AS 4248).
             ONCE ISSUED, THESE MESSAGES MUST BE RESPONDED TO.
  
  MSGHASP180 and MSGHASP190 :
             THE FOLLOWING RECOVERY PROCEDURE WILL ALLOW
             THE USER TO GET OUT OF A SEQUENCE OF MESSAGES
             MSGHASP180 AND MSGHASP190.  THIS SEQUENCE IS
             USUALLY ENTERED BECAUSE AN INVALID FCB (OR UCS)
             HAS BEEN REQUESTED VIA THE $TPRTn COMMAND.
             WHEN MSGHASP190 IS DISPLAYED AWAITING A $S OF
             THE PRINTER, ENTER A $IPRTN, FOLLOWED BY A $TPRTn,
             FCB= (OR UCS=) A VALID FCB (OR UCS) AND THEN
             RESPOND WITH A $SPRTN.  CN JES2 L2.
  
  MSGHASP190 A MSGHASP190 WILL NOT BE ISSUED FOR
             D/T3203, D/T3211, D/T4245, D/T4248 and
             D/T3800   WHEN THE ONLY SETUP CRITERIA CHANGE IS
             MADE FOR AN FCB.  SINCE AN FCB CHANGE
             FOR ANY OF THESE PRINTERS DOES NOT
             REQUIRE MANUAL OPERATOR INTERVENTION,
             THE MSGHASP190 SETUP WILL NOT BE ISSUED.
                THE ASSUMPTION THAT WHEN AN FCB CHANGE
             IS NEEDED, A UCS AND/OR A FORM CHANGE WILL
             ALSO BE NECESSARY AND THE MSGHASP190 WILL
             BE ISSUED FOR THE UCS AND/OR FORMS IS NOT TRUE.
                THE JES2 WORK SELECTION SETUP CRITERIA ITEMS THAT
             CAUSE THE $HASP190 TO BE ISSUED ARE :
                PRMODE
                FORMS
                TRAIN (UCS or BAND)
                FCB   (1403 carriage tape)
                BURST and FLASH (3800 NON-IMPACT PRT).
  
             THE HASP190 SETUP MESSAGE IS ISSUED TO INFORM THE
             OPERATOR TO SETUP THE PRINTER TO MATCH THE SETTINGS
             OF THE DATASET THAT HAS BEEN SELECTED FOR PROCESSING.
                NOTE:  THE MSGHASP190 WILL BE ISSUED FOR
                       A D/T1403 and RJE PRINTERS.  ALL RJE PRTs
                       NOT SET WITH THE FCBLOAD PARM ARE TREATED
                       LIKE 1403 BY HASPPRPU LOGIC.
  ADDITIONAL KEYWORDS:
   D/T1403, D/T3211, D/T3203, D/T3262, D/T4245, D/T4248, D/T3800,
   CHN1, CHANNEL1, POSITION1, EJECT, FORMFEED
  
  REPINNED ATEXT RP87/09/30 UPDATE PG14 ITEM3 REGARDING
  PRINTING LOWERCASE CHARACTERS AS UPPERCASE IF NOT ON BAND.  RLT.
  REPINNED ATEXT RP87/11/12 ADD INFO ON REMOTE D/T4245 FOLD. RLT.
  REPINNED ATEXT RP87/12/03 ADD INFO ON LINECT PARM.  RLT STJ2.
  REPINNED ATEXT RP88/01/05 ADD PRINTDEF PRTDEF INFO. RLT STJ2.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

Applicable component levels