File structures and definitions
The CICS® catalog manager example application uses two VSAM files: the catalog file which contains the details of all items stocked and their stock levels, and the configuration file which holds user-selected options for the application.
Catalog file
The catalog file is a KSDS VSAM file which contains all information relating to the product inventory.
Records in the
file have the following structure:
| Name | COBOL data type | Description |
|---|---|---|
| WS-ITEM-REF-NUM | PIC 9(4) | Item reference number |
| WS-DESCRIPTION | PIC X(40) | Item description |
| WS-DEPARTMENT | PIC 9(3) | Department identification number |
| WS-COST | PIC ZZZ.99 | Item price |
| WS-IN-STOCK | PIC 9(4) | Number of items in stock |
| WS-ON-ORDER | PIC 9(3) | Number of items on order |
Configuration file
The configuration file is a KSDS VSAM file which contains information used to configure the example application.
The configuration file is a KSDS VSAM file with 3 distinct records, General Information, Outbound URL, and Catalog file information, as shown in the following tables:
| Name | COBOL data type | Description |
|---|---|---|
| PROGS-KEY | PIC X(9) | Key field for the general information record,
containing 'EXMP-CONF' |
| filler | PIC X | |
| DATASTORE | PIC X(4) | A character string that specifies the type of
data store program to be used. Values are:
|
| filler | PIC X | |
| DO-OUTBOUND-WS | PIC X | A character that specifies whether the dispatch
manager is make an outbound Web service request. Values are:
|
| filler | PIC X | |
| CATMAN-PROG | PIC X(8) | The name of the catalog manager program |
| filler | PIC X | |
| DSSTUB-PROG | PIC X(8) | The name of the dummy data handler program |
| filler | PIC X | |
| DSVSAM-PROG | PIC X(8) | The name of the VSAM data handler program |
| filler | PIC X | |
| ODSTUB-PROG | PIC X(8) | The name of the dummy order dispatcher module |
| filler | PIC X | |
| ODWEBS-PROG | PIC X(8) | The name of the outbound Web service order dispatcher program |
| filler | PIC X | |
| STKMAN-PROG | PIC X(8) | The name of the stock manager program |
| filler | PIC X(10) |
| Name | COBOL data type | Description |
|---|---|---|
| URL-KEY | PIC X(9) | Key field for the general information record,
containing 'OUTBNDURL' |
| filler | PIC X | |
| OUTBOUND-URL | PIC X(255) | Outbound URL for the order dispatcher Web service request |
| Name | COBOL data type | Description |
|---|---|---|
| URL-FILE-KEY | PIC X(9) | Key field for the general information record,
containing 'VSAM-NAME' |
| filler | PIC X | |
| CATALOG-FILE-NAME | PIC X(8) | Name of the CICS FILE resource used for the catalog file |