Conference iosg::all-in-1_v30

If you use ALL-IN-1 Job Services or Manage Jobs and Queues to display the 
job status the message text will be displayed.

You can also look in a link map to translate message codes.  You should 
find that 011FA622 is the value for the symbol OA$_BF_INVPARAMS.  

This status suggests that there is a problem with the OA$PARAMS parameter 
of the OA$FORMATTER job.  Please supply the complete output from a $ show
entry/full if you need me to investigate further.


Richard

    Hi Richard,          
    
    I have to say that I had forgotten about the JS option and the message
    translated into "%OA-E-BF_INVPARAMS, invalid or missing OA$PARAMS".  I
    would like to point out that the Stars article "Debugging the Background
    Formatter - Some Tips" is out of date, the error Message code and value
    do not match OA$_BF_INVPARAMS 011FFF32.
    
    The customer did a sh entry/full and got the following information:
    
      Entry  Jobname         Username     Blocks  Status
      -----  -------         --------     ------  ------
        897  EMPEROR_MINING_TEST_2
                             FAVERO           29  Retained on error
           %NONAME-E-NOMSG, Message number 011FA622
             On idle server queue OA$FORMATTER
    Submitted 13-APR-1993 09:27 /NOBURST /NOFLAG /FEED/FORM=DEFAULT
    /PARAM=("OA$PARAMS=100,PRINTER3,GLX-HP,1,HPPLUS,VAXDISK:[FAVERO.A1.TABLES]"
    ,"OA$FMTCTL=2") /PRIORITY=100 /NOTRAILER
             File: _$1$DIA1:[VAXUSERS.FAVERO.A1.OA$TEMP]FAV016667.WPL;1
    /NOBURST /DELETE /FEED /NOFLAG /NOTRAILER
             Completed 13-APR-1993 09:27 on queue OA$FORMATTER 
    
    By the way I have sent a comment regarding the article, requesting that
    it should be updated.  I would be grateful if you could provide me with
    a description of the parameters for OA$PARAMS, some of them are
    obvious others aren't, like p1, p4, p5 and p7.  I looked in the
    documentation and could not find this documented unless I have missed
    it.
    
    Thanks for your help.
    Regards,
    
    Sunil
    
    PS - Had a cold Easter here it was 25c ;-).

The value of global symbols for messages, such as OA$_BF_INVPARAMS, will 
normally change for each version of ALL-IN-1.  If the Stars article lists 
the values it should say which version of ALL-IN-1 they are for.


The reason for the 'Invalid or missing OA$PARAMS' is a problem with the
Device parameter 'GLX-HP'.  The '-' character is not allowed in a Device
Type name.  The allowed characters are 'A-Z', '0-9', '$' and '_'; 'a-z' are
accepted but not distinguished from 'A-Z'. 

The Device Type parameter is processed by the WPS-PLUS formatter as the
file name part of an RMS file specication.  When I wrote the OA$FORMATTER
parameter parsing code in 1987 '-' was not allowed as part of an RMS file
name and therefore was not allowed in a Device Type name.  Since then '-'
has been allowed in an RMS file name and so as a (probably unplanned)
consequence WPS-PLUS Device Types names can contain a '-'. 

I have created an Internal Problem Report so we have a record of the 
problem.

As a workaround I suggest that the customer change the Device Type name to
'GLX_HP'. 


Section 13.7 of the ALL-IN-1 V3.0 Management Guide describes setting up the
Background Formatter, and includes an explanation of the error messages and 
a pointer to the file OA$DO:WPPBGFORMAT.SCP which contains a detailed 
description of the parameters.


Richard

    Hi Richard,
    
    >Device parameter 'GLX-HP'.  The '-' character is not allowed in a
    >Device
    
    I would never have guessed as you have pointed out that "-" were not
    allowed in file names previously.  I just couldn't see where the
    problem was, you live and learn :-).
    
    Thanks,
    
    Sunil