Enter Account Number Operation

The Enter Account Number operation exposes the account number of the record to be retrieved. It automatically sets the request type to display information.

1. Click Operation > New.
2. In the Operation Name field, type Enter Account Number.
3. From the Active Screen drop-down list, click ACCTSET.ACCTMNU. This is the name of the main menu of the ACCT application.
4. Leave the default value, ANY SCREEN, in the Previous Screen field.
5. Leave the Transaction ID field blank. This operation does not start a transaction.
6. Leave Create Default Mapping unchecked.
7. Click OK. This returns you to the Service Interfaces Editor and shows the CICS Screen ACCTSET.ACCTMNU.

   We're now ready to map our interface fields and make some assignments for this operation. As we learned from running this application in its original form, we need to provide the application with a D (for display) in the REQUEST TYPE field and an account number in the ACCOUNT field in order to retrieve information about an account. We will start with specifying the input field for the account number.

8. On the CICS Screen pane, locate the ACCTM field by hovering over the entry fields. ACCTM is located to the right of the ACCOUNT label. It is the field where users enter the account number.
9. Click and drag the ACCTM field to the Interface Fields pane and drop it there.

   The name ACCTM is not particularly descriptive. Because this field is really the input field for the account number, we will rename it in the Service Interfaces Editor so that it is more recognizable. The name we use here will appear as the field label in our generated Windows Forms client.

10. In the Interface Fields pane, double-click ACCTM.
11. In the Name field, type AccountNumber. The other fields on this dialog box are accurate so no additional adjusting is necessary here.
12. Click OK.

    Notice that the Mappings pane shows the interface field with its new name, AccountNumber, mapping to the COBOL field ACCTM.

    Now we will make some assignments that automatically set the value for the request to D for display, and set the attention identifier.

13. On the CICS Screen pane, hover over the input field next to the REQUEST TYPE label. Note that the name of the input field is REQM.
14. In the Assignments pane, right-click and select New Assignment from the popup menu.
15. From the Assign to drop-down list, click REQM.
16. In the Field 1/Operand 1 field, type D, which is the value that tells the application to display information.
17. Click OK.
18. In the Assignments pane, right-click and select New Assignment from the popup menu.
19. From the Assign to drop-down list, click ATTENTION ID. This is the field that defines which AID key (for example, Enter, PF8, etc.) should be used.
20. From the Field 1/Operand 1 drop-down list, click ENTER.
21. Click OK.
22. Save the service interface.

    This completes the Enter Account Number operation.