Chapter 2A. Device-Independent Messages (1-98)

Explanation: A second call to GPOPPH was made using the non-reentrant interface without an intervening call to GPCLPH

System Action: The subroutine call in error is ignored.

Programmer Response: Correct the program so that GPOPPH is not called when the graPHIGS API is initialized already.

Error Number: 1

Explanation: One of the following conditions exists:

• GPOPPH was not invoked successfully before the graPHIGS API function was called. Previous initialization failed, and GPOPPH was never called.
• The Application Anchor Block (AAB), which passed through the reentrant or system programmer interface (SPI), does not contain the same storage anchor value that was set at the initialization of the graPHIGS API
• An application program using the non-reentrant interface was link edited so that multiple copies of that module were used.
• An application program was link edited so that calls to the graPHIGS API are resolved by mixtures of reentrant and non-reentrant interface modules.

System Action: The subroutine call in error is ignored.

Programmer Response: Correct the program in one of the following ways:

• Be sure the graPHIGS API is properly initialized.
• Be sure the AAB is preserved and passed correctly on each call.
• Be sure only one copy of the graPHIGS API non-reentrant interface module is used in link editing.
• Be sure the application program is link edited with the correct graPHIGS API module(s).

Error Number: 2

Explanation: A graPHIGS API subroutine was invoked with no open workstations.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Check for possible failure of GPOPWS or GPCRWS calls. Check the code sequence to be sure a workstation is open when this subroutine is invoked.

Error Number: 3

Explanation: The subroutine invoked operates on structure content and, therefore, requires an open structure. However, no structure is currently open.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Check the code sequence to be sure a structure is open when this subroutine is invoked.

Error Number: 4

Explanation: The subroutine invoked operates on structure content or sends structure elements to the workstation. However, no structure is opened or Begin Structure (GPBGST) has not been issued.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Check the code sequence to be sure a structure has been opened or GPBGST has been issued.

Error Number: 5

Explanation: A subroutine was invoked that requires the current archive state to be set to Archive Open (AROP).

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Issue GPOPAR to open a graPHIGS API archive file, which sets the current archive state to AROP.

Error Number: 7

Explanation: GPBGST or GPOPST was invoked while a structure was open. This subroutine requires all structures to be closed.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Check the code sequence to be sure all structures are closed before this subroutine is invoked.

Error Number: 11

Explanation: A subroutine was invoked that requires a structure store to be selected either implicitly or explicitly. Use GPOPPH for implicit selection of a structure store. Use GPSSS for explicit selection of a structure store.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. The application can use this subroutine only after a structure store has been selected.

Error Number: 12

Explanation: GPSSS was invoked before the application issued, either implicitly or explicitly, at least one GPCRSS or GPATR for a structure store. This subroutine requires at least one structure store to be implicitly or explicitly open.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. The application can use this subroutine only after it has issued either an implicit or explicit structure store open function.

Error Number: 13

Explanation: GPBGST, GPDRI2, or GPENTR was invoked that requires the workstation to be selected using the Begin Traversal (GPBGTR) subroutine call to receive the explicit traversal command. However, no workstation has been selected.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Issue GPBGTR to select the workstation before issuing the explicit traversal subroutine.

Error Number: 14

Explanation: An explicit traversal subroutine was invoked that results in subsequent structure elements being sent to the workstation for immediate processing. A Begin Structure (GPBGST) subroutine must also be issued to set the structure state to NROP. However, GPBGST has not been issued.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Issue GPBGST before sending the immediate data to the workstation.

Error Number: 15

Explanation: GPDRI2, or GPENTR was invoked that cannot be processed by the workstation, but must be processed by the structure store manager. However, the subroutine was issued within a Begin Structure (GPBGST) - End Structure (GPENST) sequence, and was sent to the workstation for processing.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Issue the subroutine outside of a GPBGST - GPENST sequence so that the subroutine can be processed by the structure store manager.

Error Number: 16

Explanation: GPOPWS or GPCRWS was called and one of the following conditions exists:

• The External Defaults File (EDF) resolved a nickname to an invalid connection identifier connid
• The workstation specified by the connection identifier is not available.
• The correct definition of the device was not performed.
• The workstation specified by the connection identifier is not in the system configuration.

System Action: The subroutine call in error is ignored.

Programmer Response: Correct the program in one of the following ways:

• Be sure the CONNIDs in the External Defaults File (EDF) that specify the valid connection identifiers are resolved to valid TOCONNIDs.
• Be sure all TOCONNIDs specify valid connection identifiers or nicknames which in turn specify valid connection identifiers.
• Be sure the device is connected and functioning before calling GPOPWS or GPCRWS
• Contact your system programmer to ensure that the device is defined correctly to the operating system.

Error Number: 21

Explanation: A subroutine requiring a workstation type as an input parameter has received an invalid workstation type.

System Action: The subroutine call in error is ignored.

Programmer Response: Correct the problem in one of the following ways:

• Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the invalid workstation type parameter.
• Make sure the workstation type is valid.
• See The graPHIGS Programming Interface: Writing Applications, The graPHIGS Programming Interface: Technical Reference or use the inquiry subroutine, GPQWST or GPQRCT, to determine valid workstation types.
• If the call is GPOPWS, or GPCRWS, ensure that the specified parameter is mapped either to a valid workstation type or to a nickname, which, in turn, specifies a valid workstation type.

Error Number: 23

Explanation: GPATR, GPOPWS or GPCRWS was invoked with a workstation identifier that is already being used.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the workstation identifier. Use another workstation identifier or close the specified workstation.

Error Number: 24

Explanation: Specified workstation is closed and the subroutine requires an open workstation.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the error that caused the closed workstation. For example, a previous error may have closed the workstation. A call to GPOPWS or GPCRWS may have been omitted or failed. Make sure GPCLWS or GPDTR is called with the proper identifier.

Error Number: 25

Explanation: GPOPWS or GPCRWS has failed because one of the following conditions exists:

• The device is not operational.
• The device is defined at the wrong address.
• The device cannot be allocated by the operating system.

System Action: The subroutine call in error is ignored.

Programmer Response: Correct the problem in one of the following ways:

• Be sure the device is connected, powered on, and functional.
• Be sure the 5080 device is at the correct address.
  • On MVS, be sure the DD statement specifies the correct UNIT.
  • On VM/CMS, be sure the FILEDEF contains the correct virtual device address.
• Be sure GPOPWS or GPCRWS is not called more than once for the same connection identifier.
• Be sure the desired device is present and defined at that address. Contact your system support to be sure the hardware for the device is correct and functional.

Error Number: 26

Explanation: An output related subroutine has been invoked for a workstation with no OUTPUT capabilities.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Be sure the workstation is correct for the application.

Error Number: 35

Explanation: An output related subroutine has been invoked for a workstation without OUTIN capabilities.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which specific function caused the error. Be sure the workstation is correct for the application.

Error Number: 37

Explanation: An input related subroutine has been invoked for a workstation with no INPUT capabilities.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Be sure the workstation is correct for the application.

Error Number: 38

Explanation: An explicit traversal subroutine was invoked for a workstation that does not support explicit control by the application.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Use the inquiry subroutine GPQART to determine if the workstation supports explicit control by the application.

Error Number: 39

Explanation: GPQGDP was invoked, but the workstation does not support the specified Generalized Drawing Primitive (GDP).

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPQGDP that caused the error. This error can only be returned on an inquiry function. Therefore, it can be detected only by checking the error indicator parameter after invoking the inquiry function. Use another GDP that is supported by your workstation. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQGD for the complete set of supported GDPs.

Error Number: 41

Explanation: A subroutine was invoked with a bundle index greater than the bundle table size.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the bundle index parameter. See The graPHIGS Programming Interface: Technical Reference or use the appropriate inquiry function to determine the available bundle sizes.

Error Number: 43

Explanation: A subroutine was invoked with a window definition that has one of the maximum values less than or equal to the corresponding minimum value.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the window definition parameter. See The graPHIGS Programming Interface: Understanding Concepts for an explanation of window definition.

Error Number: 44

Explanation: GPHR was invoked with a hatch index greater than the hatch table size.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQHF to inquire the size of the workstation's hatch table.

Error Number: 47

Explanation: GPPAR, GPQPAR or GPQPPR, was invoked with a pattern index greater than the pattern table size.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or the error indicator parameter, as appropriate, to determine which function caused the error. Correct the pattern index parameter. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQLW to determine the available pattern indexes.

Error Number: 48

Explanation: GPCR or GPXCR was invoked with a color index value greater than the color table size.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the color index parameter. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQCCH or GPQLW to determine the available color indexes.

Error Number: 49

Explanation: GPDMR or GPQDMR was invoked with a data mapping index value greater than the data mapping table size.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the data mapping index parameter. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function (GPQWDT) to determine the available data mapping indexes.

Error Number: 50

Explanation: GPEVM3, GPVMP3 or GPXVR was invoked with the projection reference point (PRP) situated on the view plane.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the PRP and/or the view plane distance parameters. See The graPHIGS Programming Interface: Understanding Concepts for an explanation of viewing parameters.

Error Number: 55

Explanation: GPVPLN or GPVUP was invoked and received a vector with all components equal to zero. The function requires a vector of non-zero length.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the vector definition.

Error Number: 56

Explanation: GPCVMT or GPDFCO failed because the up direction cannot be determined when the up vector is normal to the specified plane.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. f GPCVMT caused the error, check the utility state list values. See The graPHIGS Programming Interface: Understanding Concepts for an explanation of utility functions. If GPDFCO caused the error, correct the parameter.

Error Number: 58

Explanation: A subroutine was invoked with a view index less than zero. All view table indexes must be equal to or greater than zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or the error indicator parameter, as appropriate, to determine which function caused the error. Correct the view index parameter.

Error Number: 59

Explanation: A subroutine was invoked with a bundle table index value less than one. The bundle table index must be greater than or equal to one.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the bundle table index parameter.

Error Number: 60

Explanation: A subroutine was invoked with an invalid length parameter.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the length parameter. See The graPHIGS Programming Interface: Subroutine Reference for valid parameter values.

Error Number: 61

Explanation: GPLTR was invoked with an invalid number of pattern sections.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPLTR that caused the error. Correct the number of pattern sections. See The graPHIGS Programming Interface: Subroutine Reference for valid parameter values.

Error Number: 62

Explanation: A subroutine was invoked with a linetype value less than one. The linetype must be greater than zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the linetype parameter.

Error Number: 63

Explanation: A subroutine was invoked and the target workstation does not have the requested linetype available.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the linetype parameter. See The graPHIGS Programming Interface: Technical Reference or use an inquiry function, either GPQEF or GPQPLF, to determine the supported linetypes.

Error Number: 64

Explanation: GPCAC or GPTCAC was invoked with an invalid curve approximation criteria.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the curve approximation criteria. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQCDF to determine the supported curve approximations.

Error Number: 65

Explanation: GPCAC, GPTCAC, or GPSAC was invoked with an invalid control value.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the control value. The control value is a multiplier applied to the tessellation value. The value may be less than one for fewer tessellations, or greater than one for more; however, it may not be less than zero.

Error Number: 66

Explanation: GPPHEC was invoked with an invalid culling mode parameter.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific function of GPPHEC that caused the error. Correct the culling mode parameter.

Error Number: 67

Explanation: A subroutine was invoked with a marker type value less than one. The marker type value must be greater than zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the value assigned to the marker type parameter.

Error Number: 69

Explanation: GPMTR, GPPMR, GPQMTR, or GPXPMR was invoked and the specified workstation generating the error does not have the requested polymarker type available.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or the error indicator parameter, as appropriate, to determine which function caused the error. Correct the polymarker type parameter. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQPMF to determine the supported marker types.

Error Number: 70

Explanation: GPHR, GPLNR, or GPMTR was invoked with an invalid field in the marker definition data.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of the subroutine that caused the error. Correct the marker definition data. See The graPHIGS Programming Interface: Subroutine Reference for a description of marker definition data.

Error Number: 71

Explanation: A subroutine was invoked with the text font value less than one. The text font value must be greater than zero and less than 256.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the text font parameter.

Error Number: 75

Explanation: GPCHLS was invoked with an invalid scale parameter. The scale parameter must be greater than or equal to zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPCHLS that caused the error. Correct the scale parameter.

Error Number: 76

Explanation: GPCHXP, GPTXR, or GPXTXR was invoked with the character expansion factor value less than or equal to zero. The character expansion factor must be greater than zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the character expansion factor parameter.

Error Number: 77

Explanation: GPAH, GPCHH or GPCHL2 was invoked with character height less than or equal to zero. The character height must be greater than zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the character height parameter.

Error Number: 78

Explanation: GPAUP or GPCHUP was invoked with a character up vector of zero length. The character up vector identifies the up direction for text and cannot be a zero length vector.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the character up vector parameter.

Error Number: 79

Explanation: GPCHUB was invoked with the up and base vectors incorrectly put on the same line.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPCHUB that caused the error. Correct the up or the base vector.

Error Number: 80

Explanation: GPCHPM was invoked with an invalid character positioning mode.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPCHPM that caused the error. Correct the positioning mode parameter. See The graPHIGS Programming Interface: Subroutine Reference for valid character positioning values.

Error Number: 81

Explanation: GPAS was invoked with an invalid annotation style.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPAS that caused the error. Correct the annotation style parameter. See The graPHIGS Programming Interface: Subroutine Reference for valid annotation style values.

Error Number: 82

Explanation: GPIR or GPXIR was invoked and the specified workstation does not have the requested interior style.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the interior style parameter. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQIF to determine the supported interior styles.

Error Number: 83

Explanation: GPIR, GPISI, GPQHR, or GPXIR was invoked with an interior style index value less than one. The interior style index must be greater than or equal to one

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the interior style index parameter.

Error Number: 84

Explanation: GPPAR, GPQPAR, or GPQPPR was invoked with the pattern index value less than one. The pattern index must be greater than or equal to one.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the pattern index value parameter.

Error Number: 85

Explanation: GPSAC was invoked with an invalid surface approximation criteria parameter.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPSAC that caused the error. Correct the surface approximation criteria parameter. See The graPHIGS Programming Interface: Subroutine Reference for valid surface approximation values.

Error Number: 86

Explanation: GPPGC was invoked with an invalid culling mode parameter.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPPGC that caused the error. Correct the culling mode parameter.

Error Number: 87

Explanation: GPFDMO was invoked with an incorrect face distinguish mode parameter.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPFDMO that caused the error. Correct the face distinguish mode parameter.

Error Number: 88

Explanation: GPHR was invoked with the hatch index value less than one. The hatch index parameter must be greater than or equal to one.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPHR that caused the error. Correct the hatch index value parameter.

Error Number: 89

Explanation: GPQPAR or GPQPPR was invoked and the specified workstation does not support patterns as an interior for polygons.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of the function that caused the error. This error can be returned only on an inquiry function. Therefore, it can be detected only by checking the error indicator parameter after invoking the inquiry function. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function GPQIF to determine the supported interior styles.

Error Number: 90

Explanation: A subroutine was invoked with a starting point or a dimension less than one. For functions that accept or return a grid of information (for example, pixel and pattern functions), all dimensions and start locations must be greater than zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log or error indicator parameter, as appropriate, to determine which function caused the error. Correct the parameter in error.

Error Number: 91

Explanation: A subroutine was invoked with a color index value less than zero. All color table indexes must be greater than or equal to zero.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the color index parameter.

Error Number: 92

Explanation: A subroutine that accepts one color index or a list of color indexes has found index values greater than the table size. The indexes must be within the table range.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the color index parameter. See The graPHIGS Programming Interface: Technical Reference or use the inquiry function, either GPQCCH or GPQLW, to determine the supported color index range.

Error Number: 93

Explanation: GPEMO was invoked with an invalid error handling mode.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPEMO that caused the error. Correct the error handling mode. See The graPHIGS Programming Interface: Subroutine Reference for valid values and The graPHIGS Programming Interface: Understanding Concepts, for an explanation of the error handling mode.

Error Number: 94

Explanation: GPPLSM was invoked with an invalid polyline shading method parameter value.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPPLSM that caused the error. Correct the polyline shading method parameter. See The graPHIGS Programming Interface: Subroutine Reference and The graPHIGS Programming Interface: Understanding Concepts for more information on polyline shading.

Error Number: 95

Explanation: A subroutine was invoked with one or more color parameters out of range (zero to one inclusive).

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the color parameter(s). See The graPHIGS Programming Interface: Understanding Concepts for an explanation of the color range and components.

Error Number: 96

Explanation: A subroutine was invoked with an invalid color format parameter.

System Action: The subroutine call in error is ignored.

Programmer Response: Check the error log to determine which function caused the error. Correct the color format parameter.

Error Number: 97

Explanation: GPCCM was invoked with an invalid convexity checking mode parameter value.

System Action: The subroutine call in error is ignored.

Programmer Response: Locate the specific invocation of GPCCM that caused the error. Correct the convexity checking mode parameter. See The graPHIGS Programming Interface: Subroutine Reference for more information on convexity checking.

Error Number: 98