CEEFTCH macro — Generate a FTCHINFO mapping
CEEFTCH is used to generate a mapping for the FTCHINFO storage area. Module information can be returned from the CEEFETCH macro in a FTCHINFO storage area. No label can be specified for this macro.
The FLAG information provided for AMODE 64 modules is limited to the AMODE, if Language Environment-conforming, if XPLINK, and if SEGMENTED. A target that is recognized as an AMODE 24 or AMODE 31 DLL, will have the MAIN and SUB bits turned OFF. The EP address for an AMODE 31 target will have the high order bit turned off and the EP64 address for an AMODE 64 target will have the low-order bit turned off.
When the ENTRYPT keyword is used with CEEFETCH in the CICS® environment (running on the QR TCB), the load point address, load length, and module segment information will not be provided in the FTCHINFO storage area. The module segment information will also not be provided when the FTCHINFO keyword is used without ENTRYPT keyword in the CICS environment.
The user must set the CEEFTCH_VERSION field in CEEFTCH before invoking the CEEFETCH macro to return module information. (Currently the only valid value for CEEFTCH_VERSION is 1.) An unsupported version will result in the CEE3DV feedback code from CEEFETCH. See the CEEFTCH tables below for supported mapping versions.
Syntax >>-CEEFTCH--+-------------+------------------------------------>< +-DSECT=--YES-+ '-DSECT=--No--'
- DSECT=YES
- Indicates that a DSECT mapping should be generated. This is the default for the mapping if the DSECT option is not specified.
- DSECT=NO
- Indicates that a data area mapping should be generated.
The following tables show the format of the CEEFTCH mapping Version 1 (CEEFTCH_VERSION = 1).
| OFFSET Dec | OFFSET Hex | Type | Len | Name (Dim) | Description |
|---|---|---|---|---|---|
| 0 | (0) | STRUCTURE | 64 | CEEFTCH | Start of CEEFTCH |
| 0 | (0) | CHARACTER | 8 | CEEFTCH_EYE_CATCHER | eyecatcher |
| 8 | (8) | UNSIGNED | 2 | CEEFTCH_VERSION | Version requested |
| 10 | (A) | BIT(8) | 1 | CEEFTCH_FLAGS1 | CEEFTCH flags1 |
| 10 | (A) | BIT(1) | 1 | CEEFTCH_A24 | X'80' target is AMODE 24 |
| 10 | (A) | BIT(1) POS(2) | 1 | CEEFTCH_A31 | X'40' target is AMODE 31 |
| 10 | (A) | BIT(1) POS(3) | 1 | CEEFTCH_A64 | X'20' target is AMODE 64 |
| 10 | (A) | BIT(1) POS(4) | 1 | CEEFTCH_XPLINK | X'10' target is XPLINK |
| 10 | (A) | BIT(1) POS(5) | 1 | CEEFTCH_LE | X'08' target is Language Environment® conforming |
| 10 | (A) | BIT(1) POS(6) | 1 | CEEFTCH_MAIN | X'04' target is MAIN |
| 10 | (A) | BIT(1) POS(7) | 1 | CEEFTCH_SUB | X'02' target is a SUB |
| 10 | (A) | BIT(1) POS(8) | 1 | CEEFTCH_DLL | X'01' target is DLL |
| 11 | (B) | BIT(8) | 1 | CEEFTCH_FLAGS2 | CEEFTCH flags2 |
| 11 | (B) | BIT(1) | 1 | CEEFTCH_SEGMENTED | X'80' target module is divided into multiple initial load segments (deferred load segments, if any, are not counted) |
| 11 | (B) | BIT(1) POS(2) | 1 | CEEFTCH_CICS | X'40' CICS environment |
| 11 | (B) | BIT(6) POS(3) | 1 | * | Available |
| 12 | (C) | SIGNED | 4 | * | Available |
| 16 | (10) | ADDRESS | 8 | CEEFTCH_CEESTART64 | Address of 64bit CEESTART |
| 16 | (10) | SIGNED | 4 | * | |
| 20 | (14) | ADDRESS | 4 | CEEFTCH_CEESTART | Address of 31-bit CEESTART |
| 24 | (18) | ADDRESS | 8 | CEEFTCH_MOD64 | Address of 64-bit target |
| 24 | (18) | SIGNED | 4 | * | |
| 28 | (1C) | ADDRESS | 4 | CEEFTCH_MOD | Address of 31-bit target |
| 32 | (20) | SIGNED | 8 | CEEFTCH_MOD_LEN64 | Length of 64-bit target |
| 32 | (20) | SIGNED | 4 | * | |
| 36 | (24) | SIGNED | 4 | CEEFTCH_MOD_LEN | Length of 31-bit target |
| 40 | (28) | ADDRESS | 8 | CEEFTCH_EP64 | Address of 64-bit EntryPt |
| 40 | (28) | SIGNED | 4 | * | |
| 44 | (2C) | ADDRESS | 4 | CEEFTCH_EP | Address of 31-bit EntryPt |
| 48 | (30) | UNSIGNED | 8 | * | Available |
| 56 | (38) | UNSIGNED | 8 | * | Available |
| Name | Offset | Level |
|---|---|---|
| CEEFTCH | 0 | 1 |
| CEEFTCH_A24 | A | 3 |
| CEEFTCH_A31 | A | 3 |
| CEEFTCH_A64 | A | 3 |
| CEEFTCH_CEESTART | 14 | 3 |
| CEEFTCH_CEESTART64 | 10 | 2 |
| CEEFTCH_CICS | B | 3 |
| CEEFTCH_DLL | A | 3 |
| CEEFTCH_EP | 2C | 3 |
| CEEFTCH_EP64 | 28 | 2 |
| CEEFTCH_EYE_CATCHER | 0 | 2 |
| CEEFTCH_FLAGS1 | A | 2 |
| CEEFTCH_FLAGS2 | B | 2 |
| CEEFTCH_LE | A | 3 |
| CEEFTCH_MAIN | A | 3 |
| CEEFTCH_MOD | 1C | 3 |
| CEEFTCH_MOD_LEN | 24 | 3 |
| CEEFTCH_MOD_LEN64 | 20 | 2 |
| CEEFTCH_MOD64 | 18 | 2 |
| CEEFTCH_SEGMENTED | B | 3 |
| CEEFTCH_SUB | A | 3 |
| CEEFTCH_VERSION | 8 | 2 |
| CEEFTCH_XPLINK | A | 3 |