HP 3000 Manuals

Panels Status Values [ COBOL/HP-UX Operating Guide for the Series 700 and 800 ] MPE/iX 5.0 Documentation


COBOL/HP-UX Operating Guide for the Series 700 and 800

Panels Status Values 

The following is a list of values that can be returned in the status
field PPB-Status by a call to Panels.

Status Code           Meaning 

0                     Function requested was successful.

1                     The panel required does not exist.  This value is
                      returned if you attempt to perform a function on a
                      panel that has not yet been created.  You must
                      create a panel before it can be used.

2                     The panel identifier is outside the range of valid
                      panel identifiers.  The maximum number of panels
                      that can be visible at one time is 254.  If you try
                      to enable more than this, a value of 2 is returned
                      in PPB-Status.

3                     The update parameters supplied do not define
                      an area that is inside the panel.  The
                      specified values of PPB-Update-Start-Row or
                      PPB-Update-Start-Col are outside the panel (that
                      is, they are greater than the height and/or width
                      of the panel).

4                     The function number given in PPB-Function is not a
                      valid function number.

5                     The program is trying to create too many panels.
                      The maximum number of panels have already been
                      created.  This error will occur on a create
                      function if too many panels have already been
                      created.

6                     The panel is too large.  This value will be
                      returned on a create function if the program has
                      specified a panel size that is too large.  Either:

                         a.  The program is trying to create a panel that
                             is too large, that is:

                             PPB-Panel-Width * PPB-Panel-Height > 65535

                         b.  The width of the panel is greater than 2000.

                         c.  There is insufficient memory available to
                             hold the panel text and attribute buffers.

7                     The value supplied in PPB-Scroll-Direction is not
                      in the range 0 to 3.

8                     You are trying to scroll too many rows or columns.
                      The specified value of PPB-Scroll-Count is greater
                      than the number of rows or columns in the panel
                      (depending on the direction of scroll).

9                     Panels cannot initialize.  This is a fatal error
                      which occurs only on the first call to Panels made
                      by a program in your system.  It means that for
                      some reason, Panels cannot initialize.



MPE/iX 5.0 Documentation