The first two lines of DBTS/DBTX display provide a limited breakdown of the Request Area. The purpose of each field is described in the following:
Enter the CA Datacom/DB command to execute, for example, REDKY, ADDIT, or UPDAT. After execution, the command name you enter here is displayed in the first five positions of the Request Area. With DBTX, you may not enter commands which update the database.
Note: Two non CA Datacom/DB commands have been added to use for syncpoint testing. Use SYNPT to issue a CICS SYNCPOINT and SYNRB to issue a CICS SYNCPOINT ROLLBACK. You can also use the ABEND command to perform a transaction backout.
Enter the CA Datacom/DB table name to which the command applies. After execution, the table name you enter here is displayed after the command name in the Request Area.
Enter the database ID as a numeric value without leading zeros if the specified table name appears in two or more databases. If you make no entry, CA Datacom CICS Services displays the ID of the database containing the table you specified after the command has executed.
Enter the key name used to access the table. After execution, the key name you enter here is displayed in the Request Area after the command and table name.
The entry point used to access CA Datacom/DB, for example, DBNTRY. Once a request has been executed, the entry point is protected and cannot be altered.
Identify the area to display by entering an alphabetic character or blank which you previously established as a shorthand identifier for a set of CA Datacom/DB arguments which identify the required area.
For example, you might associate A with a set of statements which would enable you to retrieve the PMF table in sequential mode and B with a set of statements which would enable you to access the PAY table for random retrieval. Once defined, you could enter A in the AREA field to retrieve the PMF table, then enter B to accomplish random retrieval in the PAY table, then enter A to return to the PMF table to continue the original operation.
Since areas are saved in CICS temporary storage, they are released when the transaction terminates. We recommend using auxiliary storage for temporary storage. You can save the Request Area, Element List and Work Area and then create another group. To create another group, enter a single character after AREA and press Enter. The default identifier for AREA is blank.
(DBTS Only) Enter Y to specify the transaction is conversational. Entry of any CA Datacom/DB update command invokes conversational mode.
The remaining lines display the contents of the following:
The lines displaying the character and hexadecimal values found in the Request Area are protected to avoid extraneous entry. To obtain access to the hexadecimal portion of the Request Area for the purpose of entering data, use the ALLOW operand with the initiating transaction. Some of the displayed fields permit you to enter values; others are used by CA Datacom CICS Services to display information after your requests have been executed.
The Key Value, Work Area, Element List and Request Qualification Area each contain three fields for data entry. The first field accepts character values; the second and third fields accept the 2-byte hexadecimal values corresponding to the previously displayed character values. Enter data by over-typing either the character or the hexadecimal fields. If you enter data in the character fields, use the ERASE EOF key to clear out the extraneous question marks (?). If you use the space bar to erase data in the character fields, CA Datacom CICS Services reads blanks (hexadecimal '40').
If you change both character and hexadecimal data, the transaction honors the hexadecimal input.
Five similar areas fill the remainder of the screen:
Make no entry. CA Datacom CICS Services uses the first 15 characters of this field to display the contents of the following fields: DB CMD, TABLE, DBID, and KEYNM. (If you need to enter data in the Request Area field, see the description of the DBTS ALLOW parameter.)
When the input screen is displayed, you may enter a complete value, a partial value, or no value. Valid values include whole or partial data which appears in one or more records in the fields associated with the Key for the table. Make no entry to begin access with the first record in the table.
For example, if you enter the LOCKY command for a table which is sorted with the key STZIP (containing state and zip code fields), your options and results can be summarized as follows:
Accesses first record in table, with the lowest STZIP value.
Accesses the first record which begins with the letters TX.
Accesses the first record which begins with the listed data, if it exists.
CA Datacom CICS Services uses this field to return the data from records when you issue any of the Read commands. For DBTS, when data is displayed, you may overwrite the displayed data after issuing a command to update.
Enter the elements to be retrieved from the database or processed by CA Datacom/DB.
Element security code, if used, must be entered in hex.
Enter the set-at-a-time selection criteria for SELxx commands.
Position Field
If no entry is made in the Position field of any of the four areas, CA Datacom CICS Services displays the current starting position. Alter the position value to indicate the next starting position for the display of the area up to maximum size of the area.
Input Errors
When an input error is encountered, the following message is displayed in the upper-right corner of the screen:
** ERROR FIELDS IN NORMAL INTENSITY **
The position of the cursor indicates the first field containing an error.
Forcing a Transaction to Abend
Forcing a transaction to abend, releases any resources it has under exclusive control and any temporary set which CA Datacom/DB built to satisfy its request. To force a transaction abend, enter ABEND in the command field. CA Datacom CICS Services responds with a user transaction abend.
|
Copyright © 2015 CA Technologies.
All rights reserved.
|
|