Previous Topic: Function Key AssignmentsNext Topic: DBTS/DBTX Key Value Panel (PF5)


Field Descriptions

The Request Area panel fields corresponding to Main DBTS/DBTX panel fields include the following:

For explanations of these fields, see DBTS/DBTX Main Panel. If you made an entry in any of these fields on the Main panel, CA Datacom CICS Services automatically transfers your entries to the Request Area panel.

CA Datacom CICS Services uses the following fields to display information passed by CA Datacom/DB:

RTN CDE

If CA Datacom/DB executes the command successfully, it returns blanks to this field. Otherwise, it returns one of the numeric return codes documented in the CA Datacom/DB Message Reference Guide.

INTRNL

Many CA Datacom/DB return codes are followed by a hexadecimal internal return code which clarify their meaning. These codes are documented in the CA Datacom/DB Message Reference Guide.

FEEDBACK

Contains the following:

SECTION

For errors involving Compound Boolean Selection commands, CA Datacom/DB returns the first Request Qualification Area section containing an error.

ENTRY

For errors involving Compound Boolean Selection commands, CA Datacom/DB returns the number of the entry with the indicated section where it detected the error.

URI

CA Datacom/DB returns the URI (Unique Record Identifier) of the located record to this field.

RECID FLID BLK RECID

CA Datacom/DB returns the ID of the located record to this field.

UPDATE INTENT

This is physically the same field as the internal return code field. CA Datacom/DB Compound Boolean Selection commands and several other commands use this field to determine whether to hold the retrieved record for update. After command execution, CA Datacom/DB uses this field to return an internal error code, if any.

Use the following fields to pass CA Datacom/DB data in the Request Area. Enter the data as a decimal number. CA Datacom CICS Services converts it to hexadecimal and places it in the Request Area.

SKP CNT

(Compound Boolean Selection Commands Only) Enter a number of records for CA Datacom/DB to skip before returning the next record when a SELNR command is issued. Use negative values to skip backwards and positive values to skip forward within the set of records built to satisfy a SELFR command.

SET REC CNT

(Compound Boolean Selection Commands Only) When CA Datacom/DB executes a Compound Boolean Selection command which requires building a temporary set or which specifies the CNT parameter, CA Datacom/DB returns the number of records in the set to this field.

SET NUMBER

(Compound Boolean Selection Commands Only) An ID number assigned by CA Datacom/DB to identify a temporary set built to satisfy a SELFR command.

MAX CNT

(CNTKY and CNTKR Only) Specify a number to limit the number of records that CA Datacom/DB counts.

I/O CNT

CA Datacom/DB returns a number indicating the total number of start I/Os issued to satisfy this request.