The ETCRE macro builds a program-call entry table based upon descriptions of each entry. A token representing the created entry table is returned to the requestor. You must use this token in all subsequent references to the entry table.
ETDEF, ETDES, ETCON, and ETDIS
These are the requirements for the caller:
Environmental factor | Requirement |
---|---|
Minimum authorization: | Supervisor state or PKM 0-7 |
Dispatchable unit mode: | Task or SRB |
Cross memory mode: | PASN=HASN=SASN or PASN¬=HASN¬=SASN |
AMODE: | 24- or 31-bit |
ASC mode: | Primary |
Interrupt status: | Enabled for I/O and external interrupts |
Locks: | No locks held |
Control parameters: | Must be in primary address space |
Before issuing ETCRE, the caller must create the ETD parameter list that ETCRE uses as input. The parameter list defines the names and characteristics of the program call (PC) routines that the entry table will define. To create the parameter list, the caller can issue the ETDEF macro or can code the data constants needed to define the list. If data constants are coded, the caller can use mapping macro IHAETD to map them.
The created entry table is owned by the cross memory resource ownership task in the current home address space. When the cross memory resource ownership task terminates, entry tables are disconnected and freed.
None.
After the caller issues the macro, the macro might use some registers as work registers or might change the contents of some registers. When the macro returns control to the caller, the contents of these registers are not the same as they were before the macro was issued. Therefore, if the caller depends on these registers containing the same value before and after issuing the macro, the caller must save these registers before issuing the macro and restore them after the system returns control.
None.
The ETCRE macro is written as follows:
Syntax | Description |
---|---|
name | name: Symbol. Begin name in column 1. |
␢ | One or more blanks must precede ETCRE. |
ETCRE | |
␢ | One or more blanks must follow ETCRE. |
ENTRIES=addr | addr: RX-type address or register (0) - (12). |
,RELATED=value | value: Any valid macro keyword specification. |
The parameters are explained as follows:
An entry index value that does not have a description results in an invalid entry in the entry table. If the program name field in an ETD entry contains zeros, an invalid entry is created for that entry index. A program call to an invalid entry causes the caller to be abnormally terminated. The ETCRE caller is abnormally terminated if any of the reserved fields are nonzero or if the system cannot locate the specified program name.
052
053
See z/OS MVS System Codes for an explanation and programmer responses for this code.
When ETCRE macro returns control to your program, GPR 15 contains a return code.
Hexadecimal Return Code | Meaning |
---|---|
00 | Meaning: The entry table is successfully
created. Action: None required. |
*
* CREATE THE ENTRY TABLE
*
.
.
LA 2,ETSTART
ETCRE ENTRIES=(2)
.
.
*
* DEFINE START OF ETD
*
ETSTART ETDEF TYPE=INITIAL START ETD
*
* DEFINE ENTRIES
*
ETEX2 ETDEF TYPE=ENTRY,PROGRAM='PROGRAM1',AKM=(0:15)
ETDEF TYPE=ENTRY,PROGRAM='PROGRAM2',AKM=(0:7)
*
* DEFINE END OF ETD
*
ETDEF TYPE=FINAL