SQL/MP Programming Manual for COBOL

Character Processing Rules (CPRL) Procedures
HP NonStop SQL/MP Programming Manual for COBOL—529758-003
11-22
CPRL_UPSHIFT_
filename pic X(filenamelength) input
is the Guardian file name in external format containing the collation object. The file
code for filename must be 199.
filenamelength pic S9(4) input
is the length in bytes of filename.
cprladdr pic S9(9) output
is the address of the collation object if 0 (zero) is returned. Otherwise, cprladdr
is set to an invalid address.
CPRL_UPSHIFT_
The CPRL_UPSHIFT_ procedure upshifts a character string according to the upshift
rules in the specified SQL collation or collation object.
The CPRL_UPSHIFT_ procedure returns these error codes:
inputstring pic X(inputstringlength) input
is an array containing the data to be upshifted.
inputstringlength pic S9(4) input
is the number of bytes in inputstring to be upshifted.
shiftedstring pic X(shiftedstringmaxlength) output
is an array in which CPRL_UPSHIFT_ returns the upshifted string.
The values for inputstring and shiftedstring can be equal, but other
values can cause unpredictable results.
ENTER TAL "CPRL_UPSHIFT_" USING
inputstring,
inputstringlength,
shiftedstring,
shiftedstringmaxlength,
shiftedstringlength,
cprladdr
GIVING errorcode.
Code Description
0 The operation was successful.
–2 The SQL collation or collation object is invalid.
–4 The version of the SQL collation or collation object is not supported.
–20 The user-specified buffer is not large enough to receive the returned string.