SQL/MP Programming Manual for COBOL

Character Processing Rules (CPRL) Procedures
HP NonStop SQL/MP Programming Manual for COBOL—529758-003
11-2
COBOLEXT File
COBOLEXT File
To call the CPRL procedures, which are written in TAL, use the COBOL ENTER TAL
statement. The COBOLEXT file contains source declarations for these procedures (as
well as for other system procedures). You might need to check with your system
administrator to make sure the COBOLEXT file for the procedures you use in your
program are available on your system. For more information about the COBOLEXT file
and the ENTER TAL statement, see the COBOL85 for NonStop Systems Manual.
CPRL Error Codes
Each CPRL procedure returns specific error codes, which are listed in each procedure
description. An error code of zero (0) indicates that the operation was successful.
All other CPRL error codes are less than zero, so they can be distinguished from
file-system errors, which are always positive. The condition code (CC) setting has no
meaning after the execution of a CPRL procedure.
CPRL_GETCHARCLASSTABLE_ Extracts character class information from an SQL
collation or collation object
CPRL_GETDOWNSHIFTTABLE_ Extracts downshift information from an SQL collation
or collation object
CPRL_GETFIRST_ Finds the first string of a specified length according to
an SQL collation or collation object
CPRL_GETLAST_ Finds the last string of a specified length according to
an SQL collation or collation object
CPRL_GETNEXTINSEQUENCE_ Finds the next string after a specified string according
to an SQL collation or collation object
CPRL_GETNUMTABLE_ Extracts numeric character class information from an
SQL collation or collation object
CPRL_GETSPECIALTABLE_ Extracts SPECIALS character class information from
an SQL collation or collation object
CPRL_GETUPSHIFTTABLE_ Extracts an array that can be used for upshifting
CPRL_INFO_ Returns information about a collation contained in an
SQL collation or collation object
CPRL_READOBJECT_ Reads an collation object (with file code 199) from a
Guardian file into a buffer
CPRL_UPSHIFT_ Upshifts a character string according to the upshift
rules in the specified SQL collation or collation object
Table 11-1. Character Processing Rules (CPRL) Procedures (page 2 of 2)
Procedure Description